Welcome to the UserAgentWonderland Repository! This repository contains extensive lists of user-agents categorized by device type, making it easier for developers and researchers to identify and utilize user-agent strings from a variety of platforms.
In the digital landscape, User-agent strings are essential for identifying the client software making a request to a server. They provide critical information about the browser, operating system, device type, and more. Understanding the structure of user-agent strings can aid in various applications, such as analytics, debugging, or serving customized content.
A typical user-agent string consists of multiple components, each containing specific information, often formatted in the following structure:
Mozilla/5.0 (Platform; Encryption; OS; Browser; Version)
| Parameter | Description | Example |
|---|---|---|
| Browser Engine | Indicates the engine used to render the web content. Most strings start with Mozilla/5.0. |
Mozilla/5.0 |
| Platform | Specifies the operating system and CPU architecture. This includes details about the device type. | (Windows NT 10.0; Win64; x64) |
| Encryption | Indicates if the client supports secure connections (like TLS). This is sometimes included in the final string. | (KHTML, like Gecko) |
| OS | Further details about the operating system. This may include the version number and additional OS-specific details. | (Ubuntu; Linux 20.04) |
| Browser | Names the web browser being used, which may include information about its version as well. | Chrome/94.0.4606.61 |
| Version | The specific version number of the browser, allowing for detailed analytics. | Version/14.0 |
Below is a visual example of how the components fit together in a typical user-agent string:
User-Agent:
├── Browser Engine: Mozilla/5.0
├── Platform: Windows NT 10.0
├── Encryption: KHTML
├── OS: Ubuntu 20.04
├── Browser: Chrome
└── Version: 94.0.4606.61
- Mobile Devices:
- Often include indicators like
MobileorTablet.
- Often include indicators like
- Search Robots:
- Bots like Googlebot or Bingbot typically have unique identifiers.
- Custom Headers:
- Some applications or devices might pass custom user-agent strings for identification.
This repository aims to provide a comprehensive collection of user-agents sorted into several categories including:
Mozilla/5.0 (iPhone; CPU iPhone OS 14_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.0 Mobile/15E148 Safari/604.1
Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:91.0) Gecko/20100101 Firefox/91.0
Mozilla/5.0 (compatible; Ubuntu; Linux; x86_64; rv:20.04) Gecko/20100101 Ubuntu/20.04
Mozilla/5.0 (Windows NT 10.0; Win64; x64; Trident/7.0; AS; rv:11.0) like Gecko
Mozilla/5.0 (Linux; Android 10; SM-T870) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/94.0.4606.61 Safari/537.36
Mozilla/5.0 (Linux; U; Android 9; SmartTV) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/77.0.3865.92 Safari/537.36
And much more! 🎉
- User-agent lists by category
- Easy access and integration for developers
- In two common file formats: .txt and .json
- Clear formatting for quick scanning
current lists
- mobile devices:
- phones: ✅ 100
- tablets: ✅ 100
- ...
- IoT:
- general list: ✅ 100
- smart fridges: ❌
- webcams: ❌
- smart watches: ❌
- smart light bulbs: ❌
- ...
- **Personal Computers a.k.a. PCs **: ✅ 100
- ...
- Servers: ❌
- ...
- ...
Note: The lists do not contain unique user agents and also have some few duplicates. In addition, the different file formats do not contain the same user agents.
To get started with the UserAgent Repository, you can clone this repository to your local machine:
git clone https://github.com/D4T4HUN73R/UserAgentWonderland.gitOnce cloned, you can browse through the directories corresponding to different device types and view the user agents in plain text format.
- For TheNumberOneThing: Just enjoy it!
- Testing: Test how your web applications behave with different devices by simulating user-agent strings.
- Analytics: Analyze traffic based on user-agents to understand your audience better.
- Integration of user-agent parsing libraries
- Automated updates for the user-agent lists
- User-contributed lists and submissions
- Enhanced categorization based on additional metrics (OS version, browser versions, etc.)
- A big thank you to all contributors who help in keeping the lists updated!
- Special thanks to the open-source community for providing valuable resources to compile these user-agents.
The published scripts, software, and associated URLs or links are intended for educational purposes only. We disclaim any responsibility for the content displayed on external platforms or websites mentioned. Users are prohibited from engaging in any criminal, malicious activities or actions that may cause harm to others or engage in activities with wrongful intent using the provided materials. By accessing and utilizing these materials, you agree to abide by this disclaimer and use the content solely for educational purposes.