emulating-user-agent 1.0.0__tar.gz

emulating_user_agent-1.0.0/Emulating/AndroidUserAgent.py

@@ -0,0 +1,480 @@
+import random
+
+from .DeskTopUserAgent import USER_AGENTS
+from .UserAgentV6 import get_random_device, generate_barcelona_version
+
+_ANDROID_CHROME_VERSIONS: list[str] = [
+   "145.0.7478.30", "146.0.7680.164"
+]
+
+LOCALES: list[tuple[str, str]] = [
+    ("en_US", "en"), ("en_GB", "en"), ("fr_FR", "fr"), ("de_DE", "de"),
+    ("es_ES", "es"), ("pt_BR", "pt"), ("it_IT", "it"), ("ja_JP", "ja"),
+    ("ko_KR", "ko"), ("zh_CN", "zh"), ("zh_TW", "zh"), ("ar_SA", "ar"),
+    ("ru_RU", "ru"), ("tr_TR", "tr"), ("nl_NL", "nl"), ("pl_PL", "pl"),
+    ("sv_SE", "sv"), ("da_DK", "da"), ("nb_NO", "nb"), ("fi_FI", "fi"),
+    ("id_ID", "id"), ("ms_MY", "ms"), ("th_TH", "th"), ("vi_VN", "vi"),
+    ("hi_IN", "hi"), ("uk_UA", "uk"), ("ro_RO", "ro"), ("cs_CZ", "cs"),
+    ("hu_HU", "hu"), ("el_GR", "el"),
+]
+
+
+def _locale(isEN: bool) -> tuple[str, str]:
+    if isEN:
+        return random.choice([("en_US", "en"),("en_GB", "en")])
+    return random.choice(LOCALES)
+
+_ANDROID_BUILDS: dict[str, list[dict]] = {
+    "android_10": [ # Lancé en 2019
+        {"build": "QP1A.190711.019", "models": ["Pixel 2", "Pixel 3", "Pixel 4"]},
+        {"build": "QKQ1.190825.002", "models": ["Xiaomi Mi 9", "Redmi Note 8 Pro"]},
+        {"build": "G973FXXU3ASJG", "models": ["Galaxy S10", "Galaxy Note 10"]}, # Build Samsung One UI 2.0
+    ],
+    "android_11": [ # Lancé en 2020
+        {"build": "RP1A.200720.009", "models": ["Pixel 3", "Pixel 4", "Pixel 5"]},
+        {"build": "RKQ1.200826.002", "models": ["Xiaomi Mi 10", "POCO F2 Pro"]},
+        {"build": "G980FXXU5CTKG", "models": ["Galaxy S20", "Galaxy Note 20"]}, # Build Samsung One UI 3.0
+        {"build": "RP1A.201005.001", "models": ["OnePlus 8", "OnePlus 8 Pro"]},
+    ],
+    "google": [
+        {"build": "AP2A.240605.024", "models": ["Pixel 6", "Pixel 7", "Pixel 8"]},
+        {"build": "AP3A.240905.015", "models": ["Pixel 9", "Pixel 9 Pro"]},
+        {"build": "AP4A.250305.019", "models": ["Pixel 9a", "Pixel 10 Series"]},
+        {"build": "BP1A.250505.002", "models": ["Pixel 10 Pro", "Pixel Fold 2"]},
+        {"build": "BP2A.250605.012", "models": ["Pixel 10 Series (Beta Android 16)"]},
+        {"build": "CP1A.260305.018", "models": ["Pixel 11 (Early Preview 2026)"]},
+    ],
+    "samsung": [
+        {"build": "UP1A.231005.007.A1", "models": ["Galaxy S23 Ultra", "Z Fold 5"]},
+        {"build": "AP2A.240905.003.A1", "models": ["Galaxy S24 Series", "Galaxy A55"]},
+        {"build": "AP3A.240905.015.A1", "models": ["Galaxy S25 Ultra", "Galaxy Z Flip 7"]},
+        {"build": "BP1A.250505.002.A1", "models": ["Galaxy S26 Series (2026)"]},
+        {"build": "S948BXXU3CXH7", "models": ["Galaxy S24"]},
+    ],
+    "qcom": [  # Snapdragon — OnePlus, Xiaomi, OPPO, Sony, Asus, Nothing…
+        {"build": "SKQ1.211019.001", "models": ["Xiaomi 12", "OnePlus 10 Pro"]},
+        {"build": "UKQ1.230917.001", "models": ["Nothing Phone 2", "OPPO Find X7"]},
+        {"build": "UP1A.231005.007", "models": ["OnePlus 12", "Xiaomi 14"]},
+        {"build": "AP3A.240905.015", "models": ["Xiaomi 15", "OnePlus 13"]},
+        {"build": "BP1A.250505.002", "models": ["Xiaomi 16", "OnePlus 14 (2026)"]},
+    ],
+    "mtk": [  # MediaTek Dimensity — OPPO, Vivo, Motorola, Redmi…
+        {"build": "SP1A.210812.016", "models": ["Redmi Note 11 Pro", "Vivo V23"]},
+        {"build": "TP1A.220624.014", "models": ["Redmi Note 12", "OPPO Reno 10"]},
+        {"build": "UP1A.231005.007", "models": ["Xiaomi 13T Pro", "OPPO Find X6"]},
+        {"build": "AP2A.240605.024", "models": ["Redmi Note 14 Pro+", "Dimensity 9300 models"]},
+        {"build": "BP1A.250505.005", "models": ["Xiaomi 15T", "OPPO Find X8 (2026)"]},
+    ],
+    "exynos": [  # Samsung Exynos — Galaxy A/mid-range
+        {"build": "UP1A.231005.007.A1", "models": ["Galaxy A54", "Galaxy A34"]},
+        {"build": "AP2A.240905.003.A1", "models": ["Galaxy A55", "Galaxy A35"]},
+        {"build": "BP1A.250505.002.A1", "models": ["Galaxy A56 (2026)"]},
+    ],
+}
+
+
+def _barcelona_version() -> str:
+    return generate_barcelona_version()
+
+
+def _timestamp() -> int:
+    return random.choice([922050745, 918016277, 925944384])
+
+def _build_android_ua(model: str, build: str, android_version: str,
+                      api_level: str, dpi: str, resolution: str,
+                      manufacturer: str, codename: str, chipset: str,
+                      locale: tuple | None) -> str:
+
+    lang_region, _ = locale if locale else _locale(True)
+    chrome = random.choice(_ANDROID_CHROME_VERSIONS)
+    bcn = _barcelona_version()
+    ts = _timestamp()
+    return (
+        f"Mozilla/5.0 (Linux; Android {android_version}; {model} Build/{build}; wv) "
+        f"AppleWebKit/537.36 (KHTML, like Gecko) "
+        f"Version/4.0 Chrome/{chrome} Mobile Safari/537.36 "
+        f"Barcelona {bcn} "
+        f"Android ({api_level}/{android_version}; {dpi}dpi; {resolution}; "
+        f"{manufacturer}; {model}; {codename}; {chipset}; {lang_region}; {ts})"
+    )
+
+
+# ──────────────────────────────────────────────────────────────────────────────
+_ANDROID_DEVICE_CONFIGS: dict[str, list[dict]] = {
+
+    # ── Samsung Galaxy S25 series (2025) ─────────────────────────
+    "Samsung Galaxy S25 Ultra": [{"model_pool": [("SM-S938B", "q6q"), ("SM-S938U", "q6q")],
+                                  "build_family": "samsung", "android_pool": [("15", "35"), ("16", "36")],
+                                  "dpi": "500", "resolution": "1440x3120", "viewport": (412, 917),
+                                  "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+    "Samsung Galaxy S25+": [{"model_pool": [("SM-S936B", "e3q"), ("SM-S936U", "e3q")],
+                             "build_family": "samsung", "android_pool": [("15", "35"), ("16", "36")],
+                             "dpi": "516", "resolution": "1440x3024", "viewport": (412, 904),
+                             "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+    "Samsung Galaxy S25": [{"model_pool": [("SM-S931B", "e1q"), ("SM-S931U", "e1q")],
+                            "build_family": "samsung", "android_pool": [("15", "35"), ("16", "36")],
+                            "dpi": "416", "resolution": "1080x2340", "viewport": (360, 800),
+                            "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+
+    # ── Samsung Galaxy S24 series (2024) ─────────────────────────
+    "Samsung Galaxy S24 Ultra": [{"model_pool": [("SM-S928B", "e2q"), ("SM-S928U", "e2q")],
+                                  "build_family": "samsung", "android_pool": [("14", "34"), ("15", "35")],
+                                  "dpi": "500", "resolution": "1440x3088", "viewport": (412, 915),
+                                  "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+    "Samsung Galaxy S24+": [{"model_pool": [("SM-S926B", "p6q"), ("SM-S926U", "p6q")],
+                             "build_family": "samsung", "android_pool": [("14", "34"), ("15", "35")],
+                             "dpi": "516", "resolution": "1440x3120", "viewport": (412, 917),
+                             "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+    "Samsung Galaxy S24": [{"model_pool": [("SM-S921B", "e1q"), ("SM-S921U", "e1q")],
+                            "build_family": "samsung", "android_pool": [("14", "34"), ("15", "35")],
+                            "dpi": "416", "resolution": "1080x2340", "viewport": (360, 800),
+                            "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+
+    # ── Samsung Galaxy S23 series (2023) ─────────────────────────
+    "Samsung Galaxy S23 Ultra": [{"model_pool": [("SM-S918B", "p3q"), ("SM-S918U", "p3q")],
+                                  "build_family": "samsung", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                                  "dpi": "500", "resolution": "1440x3088", "viewport": (412, 915),
+                                  "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+    "Samsung Galaxy S23": [{"model_pool": [("SM-S911B", "dm1q"), ("SM-S911U", "dm1q")],
+                            "build_family": "samsung", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                            "dpi": "425", "resolution": "1080x2340", "viewport": (360, 780),
+                            "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+
+    # ── Samsung Galaxy A series ───────────────────────────────────
+    "Samsung Galaxy A55": [{"model_pool": [("SM-A556B", "a55x")],
+                            "build_family": "samsung", "android_pool": [("14", "34"), ("15", "35")],
+                            "dpi": "390", "resolution": "1080x2340", "viewport": (360, 800),
+                            "manufacturer": "samsung", "chipset": "exynos", "locale": None}],
+    "Samsung Galaxy A35": [{"model_pool": [("SM-A356B", "a35x")],
+                            "build_family": "samsung", "android_pool": [("14", "34"), ("15", "35")],
+                            "dpi": "390", "resolution": "1080x2340", "viewport": (360, 800),
+                            "manufacturer": "samsung", "chipset": "exynos", "locale": None}],
+
+    # ── Google Pixel 9 series (2024) ─────────────────────────────
+    "Google Pixel 9 Pro XL": [{"model_pool": [("Pixel 9 Pro XL", "tokay")],
+                               "build_family": "google", "android_pool": [("15", "35"), ("16", "36")],
+                               "dpi": "486", "resolution": "1344x2992", "viewport": (412, 915),
+                               "manufacturer": "Google", "chipset": "google", "locale": None}],
+    "Google Pixel 9 Pro": [{"model_pool": [("Pixel 9 Pro", "caiman")],
+                            "build_family": "google", "android_pool": [("15", "35"), ("16", "36")],
+                            "dpi": "474", "resolution": "1280x2856", "viewport": (393, 875),
+                            "manufacturer": "Google", "chipset": "google", "locale": None}],
+    "Google Pixel 9": [{"model_pool": [("Pixel 9", "komodo")],
+                        "build_family": "google", "android_pool": [("15", "35"), ("16", "36")],
+                        "dpi": "422", "resolution": "1080x2424", "viewport": (393, 851),
+                        "manufacturer": "Google", "chipset": "google", "locale": None}],
+    "Google Pixel 9 Pro Fold": [{"model_pool": [("Pixel 9 Pro Fold", "comet")],
+                                 "build_family": "google", "android_pool": [("15", "35"), ("16", "36")],
+                                 "dpi": "380", "resolution": "2076x2152", "viewport": (600, 624),
+                                 "manufacturer": "Google", "chipset": "google", "locale": None}],
+
+    # ── Google Pixel 8 series (2023) ─────────────────────────────
+    "Google Pixel 8 Pro": [{"model_pool": [("Pixel 8 Pro", "husky")],
+                            "build_family": "google", "android_pool": [("14", "34"), ("15", "35")],
+                            "dpi": "489", "resolution": "1344x2992", "viewport": (412, 915),
+                            "manufacturer": "Google", "chipset": "google", "locale": None}],
+    "Google Pixel 8": [{"model_pool": [("Pixel 8", "shiba")],
+                        "build_family": "google", "android_pool": [("14", "34"), ("15", "35")],
+                        "dpi": "428", "resolution": "1080x2400", "viewport": (393, 851),
+                        "manufacturer": "Google", "chipset": "google", "locale": None}],
+    "Google Pixel 7a": [{"model_pool": [("Pixel 7a", "lynx")],
+                         "build_family": "google", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                         "dpi": "429", "resolution": "1080x2400", "viewport": (393, 851),
+                         "manufacturer": "Google", "chipset": "google", "locale": None}],
+
+    # ── OnePlus (2024/2025) ───────────────────────────────────────
+    "OnePlus 13": [{"model_pool": [("CPH2687", "op13"), ("PJZ110", "op13")],
+                    "build_family": "qcom", "android_pool": [("15", "35"), ("16", "36")],
+                    "dpi": "450", "resolution": "1440x3168", "viewport": (412, 915),
+                    "manufacturer": "OnePlus", "chipset": "qcom", "locale": None}],
+    "OnePlus 12": [{"model_pool": [("CPH2583", "op12"), ("PJX110", "op12")],
+                    "build_family": "qcom", "android_pool": [("14", "34"), ("15", "35")],
+                    "dpi": "450", "resolution": "1440x3168", "viewport": (412, 915),
+                    "manufacturer": "OnePlus", "chipset": "qcom", "locale": None}],
+    "OnePlus 13R": [{"model_pool": [("CPH2641", "op13r")],
+                     "build_family": "qcom", "android_pool": [("14", "34"), ("15", "35")],
+                     "dpi": "388", "resolution": "1080x2392", "viewport": (393, 851),
+                     "manufacturer": "OnePlus", "chipset": "qcom", "locale": None}],
+    "OnePlus Nord 4": [{"model_pool": [("CPH2657", "opnord4")],
+                        "build_family": "qcom", "android_pool": [("14", "34"), ("15", "35")],
+                        "dpi": "450", "resolution": "1240x2772", "viewport": (412, 900),
+                        "manufacturer": "OnePlus", "chipset": "qcom", "locale": None}],
+
+    # ── Xiaomi (2023/2024/2025) ───────────────────────────────────
+    "Xiaomi 15": [{"model_pool": [("25030PN0DG", "dada"), ("2501129G", "dada")],
+                   "build_family": "qcom", "android_pool": [("15", "35"), ("16", "36")],
+                   "dpi": "522", "resolution": "1440x3200", "viewport": (393, 873),
+                   "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+    "Xiaomi 14 Pro": [{"model_pool": [("23116PN5BC", "shennong")],
+                       "build_family": "qcom", "android_pool": [("14", "34"), ("15", "35")],
+                       "dpi": "522", "resolution": "1440x3200", "viewport": (393, 873),
+                       "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+    "Xiaomi 14": [{"model_pool": [("23127PN0CG", "houji"), ("23116PN5BC", "houji")],
+                   "build_family": "qcom", "android_pool": [("14", "34"), ("15", "35")],
+                   "dpi": "460", "resolution": "1200x2670", "viewport": (393, 873),
+                   "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+    "Redmi Note 14 Pro+": [{"model_pool": [("24116RA68G", "opal")],
+                            "build_family": "qcom", "android_pool": [("14", "34"), ("15", "35")],
+                            "dpi": "446", "resolution": "1220x2712", "viewport": (393, 873),
+                            "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+
+    # ── OPPO / realme (2023/2024) ────────────────────────────────
+    "OPPO Find X8 Pro": [{"model_pool": [("CPH2637", "OP6F29L1"), ("CPH2639", "OP6F29L1")],
+                          "build_family": "mtk", "android_pool": [("15", "35")],
+                          "dpi": "450", "resolution": "1264x2780", "viewport": (412, 900),
+                          "manufacturer": "OPPO", "chipset": "mtk", "locale": None}],
+    "OPPO Find X6 Pro": [{"model_pool": [("PGEM10", "OP4EBF")],
+                          "build_family": "mtk", "android_pool": [("13", "33"), ("14", "34")],
+                          "dpi": "450", "resolution": "1440x3168", "viewport": (412, 915),
+                          "manufacturer": "OPPO", "chipset": "mtk", "locale": None}],
+    "realme GT 7 Pro": [{"model_pool": [("RMX3999", "RE5E35L1")],
+                         "build_family": "qcom", "android_pool": [("15", "35")],
+                         "dpi": "450", "resolution": "1264x2780", "viewport": (412, 900),
+                         "manufacturer": "realme", "chipset": "qcom", "locale": None}],
+    "realme GT 6": [{"model_pool": [("RMX3851", "RE5C38L1")],
+                     "build_family": "qcom", "android_pool": [("14", "34"), ("15", "35")],
+                     "dpi": "510", "resolution": "1440x3168", "viewport": (412, 915),
+                     "manufacturer": "realme", "chipset": "qcom", "locale": None}],
+
+    # ── Samsung Galaxy Z series (2023) ───────────────────────────
+    "Samsung Galaxy Z Fold5": [{"model_pool": [("SM-F946B", "q4q"), ("SM-F946U", "q4q")],
+                                "build_family": "samsung", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                                # Écran intérieur déplié : 2176×1812 @374dpi — viewport CSS plié/déplié
+                                "dpi": "374", "resolution": "2176x1812", "viewport": (768, 1080),
+                                "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+    "Samsung Galaxy Z Flip5": [{"model_pool": [("SM-F731B", "b4q"), ("SM-F731U", "b4q")],
+                                "build_family": "samsung", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                                "dpi": "424", "resolution": "1080x2640", "viewport": (412, 876),
+                                "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+
+    # ── Samsung Galaxy A54 (2023) ────────────────────────────────
+    "Samsung Galaxy A54": [{"model_pool": [("SM-A546B", "a54x")],
+                            "build_family": "exynos", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                            "dpi": "390", "resolution": "1080x2340", "viewport": (360, 780),
+                            "manufacturer": "samsung", "chipset": "exynos", "locale": None}],
+
+    # ── Google Pixel 7 series (2022) ─────────────────────────────
+    "Google Pixel 7 Pro": [{"model_pool": [("Pixel 7 Pro", "cheetah")],
+                            "build_family": "google", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                            "dpi": "512", "resolution": "1440x3120", "viewport": (412, 892),
+                            "manufacturer": "Google", "chipset": "google", "locale": None}],
+    "Google Pixel 7": [{"model_pool": [("Pixel 7", "panther")],
+                        "build_family": "google", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                        "dpi": "429", "resolution": "1080x2400", "viewport": (412, 915),
+                        "manufacturer": "Google", "chipset": "google", "locale": None}],
+    "Google Pixel 6a": [{"model_pool": [("Pixel 6a", "bluejay")],
+                         "build_family": "google", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                         "dpi": "429", "resolution": "1080x2400", "viewport": (412, 892),
+                         "manufacturer": "Google", "chipset": "google", "locale": None}],
+
+    # ── OnePlus 11 / Nord 3 (2023) ───────────────────────────────
+    "OnePlus 11": [{"model_pool": [("CPH2449", "salami"), ("PHB110", "salami")],
+                    "build_family": "qcom", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                    "dpi": "500", "resolution": "1440x3216", "viewport": (412, 915),
+                    "manufacturer": "OnePlus", "chipset": "qcom", "locale": None}],
+    "OnePlus Nord 3": [{"model_pool": [("CPH2491", "opnord3")],
+                        "build_family": "mtk", "android_pool": [("13", "33"), ("14", "34")],
+                        "dpi": "394", "resolution": "1080x2424", "viewport": (393, 851),
+                        "manufacturer": "OnePlus", "chipset": "mtk", "locale": None}],
+
+    # ── Xiaomi 13 / Redmi Note 13 Pro (2022/2023) ────────────────
+    "Xiaomi 13": [{"model_pool": [("2211133C", "fuxi"), ("2210132C", "fuxi")],
+                   "build_family": "qcom", "android_pool": [("13", "33"), ("14", "34")],
+                   "dpi": "422", "resolution": "1080x2400", "viewport": (393, 851),
+                   "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+    "Redmi Note 13 Pro": [{"model_pool": [("23124RN87C", "garnet")],
+                           # 23124RN87C = Redmi Note 13 Pro+ 5G (Snapdragon 7s Gen 2)
+                           "build_family": "qcom", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                           "dpi": "446", "resolution": "1220x2712", "viewport": (393, 873),
+                           "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+
+    # ── Vivo X90 Pro (2022) ──────────────────────────────────────
+    "Vivo X90 Pro": [{"model_pool": [("V2227A", "pd2217")],
+                      "build_family": "mtk", "android_pool": [("13", "33"), ("14", "34")],
+                      "dpi": "450", "resolution": "1260x2800", "viewport": (412, 915),
+                      "manufacturer": "vivo", "chipset": "mtk", "locale": None}],
+
+    # ── Huawei P60 Pro (2023) ────────────────────────────────────
+    "Huawei P60 Pro": [{"model_pool": [("ALN-AL00", "alnp")],
+                        # HarmonyOS 3.1/4.0 — Android 12/13 base, Kirin 9000S
+                        "build_family": "qcom", "android_pool": [("12", "32"), ("13", "33")],
+                        "dpi": "448", "resolution": "1220x2700", "viewport": (393, 873),
+                        "manufacturer": "HUAWEI", "chipset": "qcom", "locale": None}],
+
+    # ── Motorola Edge 40 Pro (2023) ──────────────────────────────
+    "Motorola Edge 40 Pro": [{"model_pool": [("motorola edge 40 pro", "dubai")],
+                              "build_family": "mtk", "android_pool": [("13", "33"), ("14", "34")],
+                              "dpi": "360", "resolution": "1080x2400", "viewport": (393, 851),
+                              "manufacturer": "motorola", "chipset": "mtk", "locale": None}],
+
+    # ── Sony Xperia 1 V (2023) ───────────────────────────────────
+    "Sony Xperia 1 V": [{"model_pool": [("XQ-DQ72", "pdx234")],
+                         # Dalle 4K 21:9 — 3840×1644 @643ppi ; Android reporte généralement ~240dpi logique
+                         "build_family": "qcom", "android_pool": [("13", "33"), ("14", "34")],
+                         "dpi": "643", "resolution": "3840x1644", "viewport": (412, 915),
+                         "manufacturer": "Sony", "chipset": "qcom", "locale": None}],
+
+    # ── Asus ROG Phone 7 (2023) ──────────────────────────────────
+    "Asus ROG Phone 7": [{"model_pool": [("ASUS_AI2205", "AI2205")],
+                          "build_family": "qcom", "android_pool": [("13", "33"), ("14", "34")],
+                          "dpi": "394", "resolution": "1080x2448", "viewport": (393, 851),
+                          "manufacturer": "Asus", "chipset": "qcom", "locale": None}],
+
+    # ── Nothing Phone 2 (2023) ───────────────────────────────────
+    "Nothing Phone 2": [{"model_pool": [("A065", "Pong")],
+                         "build_family": "qcom", "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                         "dpi": "394", "resolution": "1080x2412", "viewport": (393, 851),
+                         "manufacturer": "Nothing", "chipset": "qcom", "locale": None}],
+
+    # ── Tablettes Android ─────────────────────────────────────────
+    "Samsung Galaxy Tab S9 Ultra": [{"model_pool": [("SM-X916B", "gts9u"), ("SM-X916U", "gts9u")],
+                                     "build_family": "samsung",
+                                     "android_pool": [("13", "33"), ("14", "34"), ("15", "35")],
+                                     # 14.6" QHD+ 2960×1848 @240ppi — viewport CSS logique @2x
+                                     "dpi": "240", "resolution": "1848x2960", "viewport": (924, 1480),
+                                     "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+    "Samsung Galaxy Tab S8": [{"model_pool": [("SM-X706B", "gts8p")],
+                               "build_family": "samsung", "android_pool": [("12", "32"), ("13", "33"), ("14", "34")],
+                               # 11" WQXGA 2560×1600 @274ppi
+                               "dpi": "274", "resolution": "1600x2560", "viewport": (800, 1280),
+                               "manufacturer": "samsung", "chipset": "qcom", "locale": None}],
+
+# ── Google Pixel (Anciennes Générations) ─────────────────────────
+    "Google Pixel 5": [{"model_pool": [("Pixel 5", "redfin")],
+                        "build_family": "android_11", "android_pool": [("11", "30"), ("12", "31"), ("13", "33")],
+                        "dpi": "432", "resolution": "1080x2340", "viewport": (393, 851),
+                        "manufacturer": "Google", "chipset": "qcom", "locale": None}],
+    "Google Pixel 4": [{"model_pool": [("Pixel 4", "flame"), ("Pixel 4 XL", "coral")],
+                        "build_family": "android_10", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                        "dpi": "444", "resolution": "1080x2280", "viewport": (393, 830),
+                        "manufacturer": "Google", "chipset": "qcom", "locale": None}],
+    "Google Pixel 3": [{"model_pool": [("Pixel 3", "blueline"), ("Pixel 3 XL", "crosshatch")],
+                        "build_family": "android_10", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                        "dpi": "443", "resolution": "1080x2160", "viewport": (393, 786),
+                        "manufacturer": "Google", "chipset": "qcom", "locale": None}],
+    "Google Pixel 2": [{"model_pool": [("Pixel 2", "walleye"), ("Pixel 2 XL", "taimen")],
+                        "build_family": "android_10", "android_pool": [("10", "29"), ("11", "30")],
+                        "dpi": "416", "resolution": "1080x1920", "viewport": (411, 731),
+                        "manufacturer": "Google", "chipset": "qcom", "locale": None}],
+
+    # ── Samsung Galaxy (Générations S10/S20/Note) ────────────────────
+    "Samsung Galaxy S20": [{"model_pool": [("SM-G980F", "x1s"), ("SM-G981B", "x1q")],
+                            "build_family": "android_11", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                            "dpi": "563", "resolution": "1440x3200", "viewport": (360, 800),
+                            "manufacturer": "samsung", "chipset": "exynos", "locale": None}],
+    "Samsung Galaxy Note 20": [{"model_pool": [("SM-N980F", "c1s"), ("SM-N981B", "c1q")],
+                                "build_family": "android_11", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                                "dpi": "393", "resolution": "1080x2400", "viewport": (360, 800),
+                                "manufacturer": "samsung", "chipset": "exynos", "locale": None}],
+    "Samsung Galaxy S10": [{"model_pool": [("SM-G973F", "beyond1"), ("SM-G973U", "beyond1q")],
+                            "build_family": "android_10", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                            "dpi": "550", "resolution": "1440x3040", "viewport": (360, 760),
+                            "manufacturer": "samsung", "chipset": "exynos", "locale": None}],
+    "Samsung Galaxy Note 10": [{"model_pool": [("SM-N970F", "d1"), ("SM-N970U", "d1q")],
+                                "build_family": "android_10", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                                "dpi": "401", "resolution": "1080x2280", "viewport": (360, 760),
+                                "manufacturer": "samsung", "chipset": "exynos", "locale": None}],
+
+    # ── Xiaomi / POCO / Redmi (Anciennes Générations) ────────────────
+    "Xiaomi Mi 10": [{"model_pool": [("M2001J2G", "umi")],
+                      "build_family": "android_11", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                      "dpi": "386", "resolution": "1080x2340", "viewport": (393, 851),
+                      "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+    "Xiaomi Mi 9": [{"model_pool": [("M1902F1G", "cepheus")],
+                     "build_family": "android_10", "android_pool": [("10", "29"), ("11", "30")],
+                     "dpi": "403", "resolution": "1080x2340", "viewport": (393, 851),
+                     "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+    "POCO F2 Pro": [{"model_pool": [("M2004J11G", "lmi")],
+                     "build_family": "android_11", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                     "dpi": "395", "resolution": "1080x2400", "viewport": (393, 851),
+                     "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+    "Redmi Note 8 Pro": [{"model_pool": [("M1906G7G", "begonia")],
+                          "build_family": "android_10", "android_pool": [("10", "29"), ("11", "30")],
+                          "dpi": "395", "resolution": "1080x2340", "viewport": (393, 851),
+                          "manufacturer": "Xiaomi", "chipset": "mtk", "locale": None}],
+
+    # ── OnePlus (Anciennes Générations) ──────────────────────────────
+    "OnePlus 8 Pro": [{"model_pool": [("IN2023", "instantnoodle")],
+                       "build_family": "android_11", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                       "dpi": "513", "resolution": "1440x3168", "viewport": (412, 906),
+                       "manufacturer": "OnePlus", "chipset": "qcom", "locale": None}],
+    "OnePlus 8": [{"model_pool": [("IN2013", "galilei")],
+                   "build_family": "android_11", "android_pool": [("10", "29"), ("11", "30"), ("12", "31")],
+                   "dpi": "402", "resolution": "1080x2400", "viewport": (412, 915),
+                   "manufacturer": "OnePlus", "chipset": "qcom", "locale": None}],
+
+    # ── Autres Modèles Récents (QCOM / MTK) ──────────────────────────
+    "Xiaomi 16": [{"model_pool": [("25127PN0CG", "xiaomi16")],
+                   "build_family": "qcom", "android_pool": [("15", "35"), ("16", "36")],
+                   "dpi": "460", "resolution": "1200x2670", "viewport": (393, 873),
+                   "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+    "Xiaomi 15T": [{"model_pool": [("250720CG", "dugou")],
+                    "build_family": "mtk", "android_pool": [("15", "35"), ("16", "36")],
+                    "dpi": "446", "resolution": "1220x2712", "viewport": (393, 873),
+                    "manufacturer": "Xiaomi", "chipset": "mtk", "locale": None}],
+    "Xiaomi 12": [{"model_pool": [("2201123G", "cupid")],
+                   "build_family": "qcom", "android_pool": [("12", "32"), ("13", "33")],
+                   "dpi": "419", "resolution": "1080x2400", "viewport": (393, 851),
+                   "manufacturer": "Xiaomi", "chipset": "qcom", "locale": None}],
+    "OnePlus 10 Pro": [{"model_pool": [("NE2213", "ne2213")],
+                        "build_family": "qcom", "android_pool": [("12", "32"), ("13", "33")],
+                        "dpi": "525", "resolution": "1440x3216", "viewport": (412, 915),
+                        "manufacturer": "OnePlus", "chipset": "qcom", "locale": None}],
+    "Redmi Note 11 Pro": [{"model_pool": [("2201116TG", "viva")],
+                           "build_family": "mtk", "android_pool": [("11", "30"), ("12", "32")],
+                           "dpi": "395", "resolution": "1080x2400", "viewport": (393, 851),
+                           "manufacturer": "Xiaomi", "chipset": "mtk", "locale": None}],
+}
+
+
+# ── API Android ───────────────────────────────────────────────────────────────
+
+def get_android_user_agent(isEN: bool, device_name: str | None = None) -> dict:
+
+    if device_name is None:
+        device_name = random.choice(list(_ANDROID_DEVICE_CONFIGS.keys()))
+
+    if device_name not in _ANDROID_DEVICE_CONFIGS:
+        raise ValueError(
+            f"Appareil Android '{device_name}' introuvable.\n"
+            f"Disponibles : {list_android_devices()}"
+        )
+
+    cfg = random.choice(_ANDROID_DEVICE_CONFIGS[device_name])
+    model, codename = random.choice(cfg["model_pool"])
+    build = random.choice(_ANDROID_BUILDS[cfg["build_family"]])["build"]
+    android_version, api_level = random.choice(cfg["android_pool"])
+    locale = cfg["locale"] if cfg["locale"] else _locale(isEN)
+
+    return {
+        "ua": _build_android_ua(model, build, android_version, api_level,
+                                cfg["dpi"], cfg["resolution"],
+                                cfg["manufacturer"], codename,
+                                cfg["chipset"], locale),
+        "viewport": cfg["viewport"],
+        "mobile": True,
+        "locale": locale,
+        "android": android_version,
+        "model": model,
+    }
+
+
+def get_random_android_device(isEn: bool) -> tuple[str, dict]:
+    name = random.choice(list(_ANDROID_DEVICE_CONFIGS.keys()))
+    return name, get_android_user_agent(isEn, name)
+
+
+def list_android_devices() -> list[str]:
+    return list(_ANDROID_DEVICE_CONFIGS.keys())
+
+
+def get_random_agent(isEn: bool) -> tuple:
+    val = random.random()
+    print(val)
+    if val < 0.51:
+        return  get_random_device(isEn=isEn)
+    elif val < 0.9:
+        return get_random_android_device(isEn=isEn)
+    else:
+        return random.choice(list(USER_AGENTS.items()))
+

emulating_user_agent-1.0.0/Emulating/DeskTopUserAgent.py

@@ -0,0 +1,52 @@
+USER_AGENTS = {
+    # ── Windows 11 (Avril 2026) ──────────────────────────────────────
+    "Windows 11 - Chrome": {
+        "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36",
+        "viewport": (1920, 1046),
+        "mobile": False
+    },
+    "Windows 11 - Edge": {
+        "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36 Edg/146.0.0.0",
+        "viewport": (1920, 1046),
+        "mobile": False
+    },
+    "Windows 11 - Firefox": {
+        "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:135.0) Gecko/20100101 Firefox/135.0",
+        "viewport": (1920, 1046),
+        "mobile": False
+    },
+    "Windows 10 - Chrome": {
+        "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36",
+        "viewport": (1536, 864),
+        "mobile": False
+    },
+
+    # ── macOS Sequoia 15.4 / Sonoma 14.7 (Avril 2026) ────────────────
+    "MacBook Pro M4 - Safari": {
+        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.4 Safari/605.1.15",
+        "viewport": (1728, 1116),
+        "mobile": False
+    },
+    "MacBook Pro M3 - Chrome": {
+        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36",
+        "viewport": (1728, 1116),
+        "mobile": False
+    },
+    "MacBook Air M3 - Safari": {
+        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.4 Safari/605.1.15",
+        "viewport": (1440, 893),
+        "mobile": False
+    },
+    "MacBook Air M3 - Chrome": {
+        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/146.0.0.0 Safari/537.36",
+        "viewport": (1440, 893),
+        "mobile": False
+    },
+
+    # ── iMac / Studio (2026) ─────────────────────────────────────────
+    "iMac M4 24 - Safari": {
+        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.4 Safari/605.1.15",
+        "viewport": (2560, 1664),
+        "mobile": False
+    },
+}