huafetcher/README.md

huafetcher

Kivy GUI for huami-token. Works on desktop and as Android apk. Downloads key and aGPS data, unzips it into /storage/emulated/0

huami-token: all credits to the original author

Developer

Install

Install Buildozer and Kivy

pip install buildozer pip install kivy

or

pip install -r requirements.txt

Run

python main.py

Make Android apk

buildozer -v android debug deploy run

User

Obtaining apk

Either build apk as per above or get it from the releases

Signing into account

This process is pretty unintuitive, so make sure to read this first! Only tested for Xiaomi login method.

1. Install the apk, run it and manually give it permission for storage (only needed if you plan to fetch aGPS).

2. Choose Xiaomi as login method (selected by default). Press Get token button.

3. This will open up your browser. Here you need to sing into your Xiaomi account.

4. Once you press Sign in, your browser will warn you. This is because of invalid Xiaomi certificates (Pretty bad on their side...). So you need to get pass this warning. Screenshots show Fennec (Firefox).

5. This gets you to a blank page, url starts with hm.xiaomi.com/watch.do. You must copy this URL.

6. Go back to Huafetcher and paste the URL into the URL result field by using the Paste button.

7. Now you can get a key or aGPS.

Key

8. For key, press Fetch key. The key will appear in the Found key field, get it by pressing the Copy button.

This key must be entered into Gadgetbridge during pairing process with devices that require it

aGPS

8. For aGPS, press Fetch aGPS button. Files will be downloaded and the two important files will be unzipped into /storage/emulated/0. You can send them into your device with the Gadgetbridge FW/App Installer