Emulating User Agent

Generate realistic and diverse user agents for desktop, mobile, and web automation testing.

Features

• 🖥️ Desktop User Agents — Windows, macOS with Chrome, Firefox, Safari, Edge
• 📱 Android User Agents — 100+ realistic Android devices (Samsung, Google Pixel, OnePlus, Xiaomi, etc.)
• 🎯 Locale Support — 30+ languages and regions
• 🔄 Random Generation — Generate diverse agents for testing and web scraping
• 📊 Device Details — Include viewport, DPI, model, Android version, and more

Installation

pip install emulating-user-agent

Quick Start

from Emulating.AndroidUserAgent import get_random_agent, get_android_user_agent
from Emulating.DeskTopUserAgent import USER_AGENTS

# Get a random agent (desktop or mobile, English locale)
device_name, agent_data = get_random_agent(isEn=True)
print(agent_data['ua'])  # User-Agent string
print(agent_data['viewport'])  # Viewport dimensions

# Get a specific Android device
agent = get_android_user_agent(isEN=True, device_name="Samsung Galaxy S25 Ultra")
print(agent['ua'])
print(agent['model'])
print(agent['android'])

Usage Examples

Get Random Android Device

from Emulating.AndroidUserAgent import get_random_android_device, list_android_devices

# List all available devices
devices = list_android_devices()

# Get random device
name, agent = get_random_android_device(isEn=True)
print(f"Device: {name}")
print(f"User-Agent: {agent['ua']}")
print(f"Viewport: {agent['viewport']}")

Access Desktop Agents

from Emulating.DeskTopUserAgent import USER_AGENTS

for device_name, agent_data in USER_AGENTS.items():
    print(f"{device_name}: {agent_data['ua']}")

API Reference

get_random_agent(isEn: bool) -> tuple

Returns a random agent (desktop or mobile).

• isEn: If True, use English locale; otherwise random locale

get_android_user_agent(isEN: bool, device_name: str | None = None) -> dict

Returns an Android user agent with full device details.

• isEN: English locale flag
• device_name: Optional specific device (see list_android_devices())

get_random_android_device(isEn: bool) -> tuple[str, dict]

Returns device name and Android agent.

list_android_devices() -> list[str]

Lists all available Android device names.

Supported Android Devices

• Samsung: Galaxy S25, S24, S23, S20, Note 20, Z Fold 5, Z Flip 7, Galaxy A series
• Google Pixel: 11, 10, 9 Pro, 8 Pro, 7 Pro, 7, 6a
• OnePlus: 13, 12, 11, 10 Pro, Nord 4
• Xiaomi: 15, 14, 13, 12, Redmi Note series
• OPPO/realme: Find X8, X6, GT series
• Sony Xperia, Motorola, Asus ROG, Huawei, and more

License

MIT License - See LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Raz Andr