Yauaa: Yet Another UserAgent Analyzer

This is a java library that tries to parse and analyze the useragent string (and when available the User-Agent Client Hints) and extract as many relevant attributes as possible.

Works with Java, Scala, Kotlin and provides ready for use UDFs for several processing systems.

The full documentation can be found here https://yauaa.basjes.nl

If you just want to give it a quick try then you can do that with your own browser here: https://try.yauaa.basjes.nl/ (runs on a very slow and rate limited machine).

Significant change happened in Apple iPads

Since about February 2025 the Apple iPads no longer are reported as a Tablet because their useragent has switched to reporting a Desktop:

A known device which was previously reporting these useragents

Mozilla/5.0 (iPad; CPU OS 18_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148
Mozilla/5.0 (iPad; CPU OS 18_3_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko)

is now reporting this one

Mozilla/5.0 (Macintosh; Intel Mac OS 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15

This last one is identical to an Apple Mac Desktop and this makes it impossible to determine that this is really a Tablet.

Currently (April 2025) it seems that this effect is different depending on the used browser. Browsers like Chrome, Edge, Opera, Aloha and Yandex still report iPad Tablet, but browsers like Safari, Brave, Firefox, DuckDuckGo and Arc Search report MacOS Desktop

HIGH Profile release notes:

These are only the highlights for the last few releases, the full changelog can be found here.

NEXT RELEASE

  • New/improved detections:
    • …

Version v7.31.0

  • New/improved detections:
    • CrowBrowser (LG SmartTV),
    • Robots: Scrapy, HTTPie
    • OpenHarmony
    • ArkWeb (HuaweiOS browser engine)
  • UDFs
    • New UDF for Elastic Search 9
    • All Elastic Search UDFs(Plugins) must be built by the user for their specific version.

Version v7.30.0

  • New/improved detections:
    • Updated the list of Amazon devices (2023, 2024 models)
    • Fix phones with real browser name at the end (like AAB does)
    • Presearch browser, Citrix WorxWeb, Klarna, Budbee, MAGAPPX, Yandex, Albert Heijn App, Ghostery, Dalvik, Nu.nl (iOS)
    • ZTE Nubia
    • Pico 3 and Pico 4 VR Headset
    • Very old Samsung Browser is a webview
    • Whitelabel “Safe” Browser apps (iOS): Ziggo, KPN, VandenBorre, F-Secure
    • Handle “Windows 11.0” (the ‘.0’ is very rare)
    • CPU tag arm_64
    • Handle URLs better with Robots/Hackers/Spammers
    • UltraBlock useragent randomizer
    • Improve DuckDuckGo
    • Mapping ClientHint value for AgentName (i.e. ClientHint “YaBrowser” –> “Yandex Browser”)
    • Handle edgecases:
      • ‘OpenBSD != Linux amd64’
      • ‘Linux x86_64:108.0’
    • Robots (Generic, Fediverse and AI Related):
      • AmazonBot, Bravebot, PetalBot
      • FediIndex, vmcrawl, Nonsensebot, Caveman-hunter, …
      • OpenAI/ChatGPT, Claudebot (Anthropic), PerplexityBot
    • Codeberg.org is a code hosting site (not a brand for a bot)
    • Updated the ISO 639-3 language code table

Version v7.29.0

  • Build
    • Require JDK 23 installed for Trino support.
    • Leverage new toolchains plugin: no longer needs toolchains.xml.
  • New/improved detections:
    • Do tag lookups for Webviews (Yandex showed wrong)
    • SamsungBrowser with a newer “reduced” version on a Phone doing DEX.
    • Snorlax useragent with BASE64 encoded part
    • Devices from OX Tab, Xiaomi
    • Partially handle broken: Safari “Mobile” on Mac OS X
    • Gitlab CI Runner
    • HUAWEI Quick App Center (+ false positive of it being a Hacker)
    • TV Bro
  • Analyzer:
    • Renamed Sec-CH-UA-Form-Factor to Sec-CH-UA-Form-Factors (no rules yet)

License

I’m publishing this under the Apache 2.0 license because I believe it is the best way to make these kinds of projects available to the world.

But do not underestimate how much work went into this. I have spent over a decade tuning this project to what you have now.

All I want to see in return is a little bit of gratitude from the people who use this. If you are a home user/hobbyist/small business then a simple star on the project is enough for me. Seeing that people use and like the things I create is what I’m doing this for. What also really helps are bug reports, headers from real/new devices/browsers that I have net yet seen before and discussions on things you think can be done better.

Despite there not being any obligation (because of the Apache 2.0 license); If you are a big corporation where my code really adds value to the products you make/sell then I would really appreciate it if you could do a small sponsor thing. Buy me lunch (€10), Buy me a game (€100) or what ever you think is the right way to say thank you for the work I have done.

If this project has business value for you then don’t hesitate to support me with a small donation. If this project has business value for you then don’t hesitate to support me with a small donation.

Yet Another UserAgent Analyzer
Copyright (C) 2013-2025 Niels Basjes

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.