migate 1.1.3

migate is a simplified Xiaomi authentication gateway for Python projects

Xiaomi authentication gateway for Python

---

---

Install

pip install migate

Or add it as a dependency in your project:

# pyproject.toml
dependencies = ["migate"]

# requirements.txt
migate

---

Usage

import migate

# --- passport (default) ---
# If no params are passed, sid defaults to passport.
# pass_token = migate.get_passtoken()
# service = migate.get_service(pass_token)

# --- unlockApi: bootloader unlock ---
# params = {"sid": "unlockApi", "checkSafeAddress": True}

# --- xiaomiio: Mi Home / smart home devices ---
# params = {"sid": "xiaomiio"}

# --- micoapi: Mi AI speaker ---
# params = {"sid": "micoapi"}

# --- i.mi.com: Mi Cloud / Find Device ---
# params = {"sid": "i.mi.com"}

# --- 18n_bbs_global: Mi Community ---
# params = {"sid": "18n_bbs_global"}

pass_token = migate.get_passtoken(params)
service = migate.get_service(pass_token, params)

print(pass_token)
# {
#   "deviceId":  "wb_...",
#   "passToken": "...",
#   "userId":    "..."
# }

print(service)
# {
#   "servicedata": {
#     "nonce":     ...,
#     "ssecurity": "...",
#     "cUserId":   "...",
#     "psecurity": "...",
#     "deviceId":  "wb_..."
#   },
#   "cookies": {
#     # passport       -> {}
#     # unlockApi      -> serviceToken, unlockApi_slh, unlockApi_ph, userId
#     # xiaomiio       -> serviceToken, cUserId, userId
#     # micoapi        -> serviceToken, micoapi_slh, micoapi_ph, userId
#     # i.mi.com       -> serviceToken, i.mi.com_slh, i.mi.com_ph, userId
#     # 18n_bbs_global -> serviceToken, popRunToken, new_bbs_serviceToken, new_login, userId
#   }
# }

---

Region detection

import migate

pass_token = migate.get_passtoken()
region = migate.get_region(pass_token)          # e.g. "EU"
region_config = migate.get_regionConfig(region) # e.g. "Europe"

---

Login

On first run, get_passtoken prompts:

1 - Browser (default)
2 - Terminal
3 - QR code

The session is saved at ~/.{sid}/cookies.json and reused automatically on the next run

---

🤝 Contributing

---