diff --git a/README.md b/README.md index f95412a..5663b4c 100644 --- a/README.md +++ b/README.md @@ -4,11 +4,12 @@ Kivy GUI for huami-token. Works on desktop and as Android apk. Downloads key and [huami-token](https://github.com/argrento/huami-token): all credits to the original author -screenshot -screenshot +screenshot +screenshot +## Developer -## Install +### Install Install [Buildozer](https://github.com/kivy/buildozer/) and [Kivy](https://github.com/kivy/kivy) @@ -19,11 +20,70 @@ or pip install -r requirements.txt -## Run +### Run python main.py -## Make Android apk +### Make Android apk buildozer -v android debug deploy run +## User + +### Obtaining apk + +Either build apk as per above or get it from the [releases](https://codeberg.org/vanous/huafetcher/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). + +screenshot +screenshot + +2) Choose Xiaomi as login method (selected by default). Press `Get token` button. + +screenshot + +3) This will open up your browser. Here you need to sing into your Xiaomi account. + +screenshot + +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). + +screenshot +screenshot + +5) This gets you to a blank page, url starts with `hm.xiaomi.com/watch.do`. You must copy this URL. + +screenshot + +6) Go back to Huafetcher and paste the URL into the URL result field by using the Paste button. + +screenshot + +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. + +screenshot + +This key must be entered into Gadgetbridge during pairing process with devices that require it + +screenshot +screenshot +screenshot + +### 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 + +screenshot +screenshot +screenshot +screenshot + diff --git a/screenshots/01.jpg b/screenshots/01.jpg new file mode 100644 index 0000000..156c0bd Binary files /dev/null and b/screenshots/01.jpg differ diff --git a/screenshots/01a.jpg b/screenshots/01a.jpg new file mode 100644 index 0000000..ed5c147 Binary files /dev/null and b/screenshots/01a.jpg differ diff --git a/screenshots/01b.jpg b/screenshots/01b.jpg new file mode 100644 index 0000000..f23f89d Binary files /dev/null and b/screenshots/01b.jpg differ diff --git a/screenshots/02.jpg b/screenshots/02.jpg new file mode 100644 index 0000000..e4b5b06 Binary files /dev/null and b/screenshots/02.jpg differ diff --git a/screenshots/03.jpg b/screenshots/03.jpg new file mode 100644 index 0000000..5f9f568 Binary files /dev/null and b/screenshots/03.jpg differ diff --git a/screenshots/04.jpg b/screenshots/04.jpg new file mode 100644 index 0000000..095783d Binary files /dev/null and b/screenshots/04.jpg differ diff --git a/screenshots/05.jpg b/screenshots/05.jpg new file mode 100644 index 0000000..450dabf Binary files /dev/null and b/screenshots/05.jpg differ diff --git a/screenshots/06.jpg b/screenshots/06.jpg new file mode 100644 index 0000000..6c69d62 Binary files /dev/null and b/screenshots/06.jpg differ diff --git a/screenshots/07.jpg b/screenshots/07.jpg new file mode 100644 index 0000000..be2580c Binary files /dev/null and b/screenshots/07.jpg differ diff --git a/screenshots/08.jpg b/screenshots/08.jpg new file mode 100644 index 0000000..96ac322 Binary files /dev/null and b/screenshots/08.jpg differ diff --git a/screenshots/09.jpg b/screenshots/09.jpg new file mode 100644 index 0000000..d9f3684 Binary files /dev/null and b/screenshots/09.jpg differ diff --git a/screenshots/10.jpg b/screenshots/10.jpg new file mode 100644 index 0000000..0178f6e Binary files /dev/null and b/screenshots/10.jpg differ diff --git a/screenshots/11.jpg b/screenshots/11.jpg new file mode 100644 index 0000000..aee96cf Binary files /dev/null and b/screenshots/11.jpg differ diff --git a/screenshots/12.jpeg b/screenshots/12.jpeg new file mode 100644 index 0000000..6cda166 Binary files /dev/null and b/screenshots/12.jpeg differ diff --git a/screenshots/13.jpeg b/screenshots/13.jpeg new file mode 100644 index 0000000..cf4a80b Binary files /dev/null and b/screenshots/13.jpeg differ diff --git a/screenshots/14.jpeg b/screenshots/14.jpeg new file mode 100644 index 0000000..08c358b Binary files /dev/null and b/screenshots/14.jpeg differ diff --git a/screenshot1.jpg b/screenshots/screenshot1.jpg similarity index 100% rename from screenshot1.jpg rename to screenshots/screenshot1.jpg diff --git a/screenshot2.jpg b/screenshots/screenshot2.jpg similarity index 100% rename from screenshot2.jpg rename to screenshots/screenshot2.jpg