# Xiaomi Mi / Nb BLE - Python Lib + CLI
## Installation
`pip install miauth`
Or clone this repository and run `pip install -e` inside the cloned directory.
### Running tests
`python -m pytest` or `tox` in project main directory.
## Usage examples
After installation, you will have access to the `miauth` command line interface (cli):
1. Register / pair with device via Mi EC protocol (generates 'mi_token' file):
`miauth <device_mac> --register`
1. Login and retrieve serial number and firmware version via Mi EC protocol:
`miauth -s -v <device_mac>`
1. Retrieve serial number and firmware version via M365 protocol:
`miauth --m365 -s -v <device_mac>`
1. Authenticate and retrieve serial number and firmware version via Nb protocol:
`miauth --nb -s -v <device_mac>`
For a full list of the possible commands run `miauth -h`.
Note: Registering / pairing with devices unpairs the device from all other apps!
If you want to use your device with other apps after pairing, either reinstall or remove / re-add the device inside the app.
## License
See LICENSE.md
## Disclaimer
I'm in no way affiliated with Xiaomi or any of their subsidiaries and products. This code has been provided for research purposes only.
Raw data
{
"_id": null,
"home_page": "https://github.com/dnandha/miauth",
"name": "miauth",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "Daljeet Nandha",
"author_email": "dalj337@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/df/5c/fc84f087ef841b01c184ab269c77a45f7799e99203405d9f3658f76b5ee9/miauth-0.9.7.tar.gz",
"platform": null,
"description": "# Xiaomi Mi / Nb BLE - Python Lib + CLI\n\n## Installation\n`pip install miauth`\n\nOr clone this repository and run `pip install -e` inside the cloned directory.\n\n### Running tests\n`python -m pytest` or `tox` in project main directory.\n\n## Usage examples\nAfter installation, you will have access to the `miauth` command line interface (cli):\n\n1. Register / pair with device via Mi EC protocol (generates 'mi_token' file):\n`miauth <device_mac> --register`\n1. Login and retrieve serial number and firmware version via Mi EC protocol:\n`miauth -s -v <device_mac>`\n1. Retrieve serial number and firmware version via M365 protocol:\n`miauth --m365 -s -v <device_mac>`\n1. Authenticate and retrieve serial number and firmware version via Nb protocol:\n`miauth --nb -s -v <device_mac>`\n\nFor a full list of the possible commands run `miauth -h`.\n\nNote: Registering / pairing with devices unpairs the device from all other apps!\nIf you want to use your device with other apps after pairing, either reinstall or remove / re-add the device inside the app.\n\n## License\nSee LICENSE.md\n\n## Disclaimer\nI'm in no way affiliated with Xiaomi or any of their subsidiaries and products. This code has been provided for research purposes only.\n\n\n",
"bugtrack_url": null,
"license": "GNU AGPL v3",
"summary": "Authenticate and interact with Xiaomi devices over BLE",
"version": "0.9.7",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "2a72435883de71a24573580458e55d8d",
"sha256": "dbfe271489e9758f1f6ff6feb178604fa64fb4480157e2873322e7c48a7acbf5"
},
"downloads": -1,
"filename": "miauth-0.9.7.tar.gz",
"has_sig": false,
"md5_digest": "2a72435883de71a24573580458e55d8d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 27000,
"upload_time": "2022-12-18T16:21:01",
"upload_time_iso_8601": "2022-12-18T16:21:01.819767Z",
"url": "https://files.pythonhosted.org/packages/df/5c/fc84f087ef841b01c184ab269c77a45f7799e99203405d9f3658f76b5ee9/miauth-0.9.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-18 16:21:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "dnandha",
"github_project": "miauth",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "miauth"
}