Donations: https://paypal.me/piggz
Companion application for Huami Devices (such as Amazfit Bip, Cor, MiBand2/3 and GTS and GTS), Pinetime Infinitime and Bangle.js.
This application requires several supporting packages. Until Aug 2021, these were available on openrepos for the latest SailfishOS release. Updating these libs is a big pain, so they have now moved to SailfishOS::Chum. If you dont know what that is, read this https://build.merproject.org/project/show/sailfishos:chum:testing
To install Amazfish, first install the "chum" repository from the link above and "pkcon refresh" then install Amazfish.
I apologise about thie extra step, but it makes updates much easier. Pacakges in chum are automatically built for each SailfishOS release and instantly available. In the future, Amazfish may also be distributed this way, but for now, it can still be installed from here, for the current SailfishOS release.
If you already have Amazfish installed, and need to update, you will also need chum, but you may have to drop to a command line and "zypper dup" and accept and changes to the package vendor.
There are 3 tiers of supported devices:
These are devices I have, have tested and will try not to break any functioanlity for an include:
* Amazfit Bip
* Amazfit GTS
* Pinetime Infinitme
* Bangle.js
These are devices which are properly implemented in the application, but I do not have and are tested by the commuity, and include:
* Amazfit BipS
* Amazfit Bip Lite
I do not promise not to break funcaionality in these, but will fix where I can
These are devices which use a protocol that is close to another suppored device, and so is treated like that device. Your mileage may vary with these devices.
* MiBand 2/3/4
* AMzfit Cor
* Amazfit GTR
Amazfish needs to be built on OBS against a defined set of libraries. Becuase there is a delay between a Sailfish release and that release being available on OBS, there will be a delay to supporting the latest versions.
For releases of the current version built against other Sailfish releases, use the repositories at :
https://build.merproject.org/project/show/home:piggz:harbour-amazfish and
https://build.merproject.org/project/show/home:piggz:kf5
The new sport display feature requires the MapBox component. The easiest way to get this is by installing PureMaps from rinigus repository.
Powered by KEXI
As of version 0.5.1, actiivity data is retrieved into an sqlite database. Becuase I think it is important to allow individuals to be in control of their own data, and that they should have the ability to analyse it themsleves, I have chosen to store data in a KEXI compatible database. This will allow you to copy the database from the phone, and open it up inside KEXI on Linux/Windows/Mac and perform queries and reports on it. This added ability means i link to a couple of KDE libraries, which should be installed automatically.
Firmware Download - READ FIRST - I am not liable if you brick your watch ;)
Read this for info about which files to flash https://github.com/Freeyourgadget/Gadgetbridge/wiki/Amazfit-Bip-Firmware...
App has been tested using an amazfit bip and GTS, downloading the latest (0.1.1.45) official firmware.
The firmware is split into multiple files on these devices. With the official MiFit app, all are downloaded at once, and everything works fine. With this app, you have to send each file individually. The firmwares are available by extracting the MiFit apk, and looking in the assets/ folder for files named Mili_chaohu.*. When you select a file, its type and version will be determined, and you will be prevented from sending invalid files.
The firmware (.fw) requires a matching fotn (.ft) and resource (.res). Send the firmware first, the app will send a reboot command at the end of the transfer, and the watch will boot up into a mode where it needs the matching font and resource sent. Just wait for the app to connect again, then send the font and resource.
The following types of file exist:
firmware, resource, a-gps data, fonts
So, to re-iterate, the firmware flashing order is:
The newer devices (GTS, BipS etc) requires a server-side pairing key which requires inital pairing with an android device. To get the key, follow the instructions here and enter into Amzafish when prompted, WITHOUT 0x at the beginning.
See https://codeberg.org/Freeyourgadget/Gadgetbridge/wiki/Amazfit-GTS
AGPS Download/Transfer
The official amazfit app can download and transfer the AGPS files to the watch automatically. The amazfit web site limits download of the files to those with accounts. A python script has been developped that can download the AGPS files, these can then be transferred to your phone, and downloaded to the watch using the normal "Download File" option.
Pairing Issues
Pairing works for myself, sometimes I have to try twice. If pairing doesnt work at all, then try:
Check if after all this, pairing works from the sailfish BT settings page. It should pair and connect just fine from there. f that doesnt work, my app wont either.
Not all features currently implemented
***May not work on all devices***
Uses Bluetooth Low Energy to communicate with the watch, this is known to be problematic on some devices. it is known to work on the Xiaomi Mido. Probably also works on the FP2. Official devices unknown.
Implemented
Todo
Tip:
On your device, create a symlink in /home/nemo to /home/nemo/.local/share/harbour-amazfish
This way, you can easilty copy the database off the phone using MTP.
Bip and GTS notify when the watch button is pressed. This is captured by amazfish which allows running actions on theses presses. An action can be ran on 2,3 or 4 presses. To confiure the actions, goto Settings > Application > Button Actions.
A custom script can be used, the script must be called harbour-amazfish-script.sh and be in the home folder. Example which sends a OTP code to the watch as a message:
#!/bin/sh if [ "$1" == "4" ]; then CODE=`python3 -c 'import pyotp;totp = pyotp.TOTP("XXXX Authenticator code here XXXX");print(totp.now())'` dbus-send --session --print-reply --dest=uk.co.piggz.amazfish /application uk.co.piggz.amazfish.sendAlert string:'' string:'Google OTP' string:$CODE boolean:true fi;
Source: https://github.com/piggz/harbour-amazfish
Credits to:
2.0.3
2.0.2 - Now for 4.1
2.0.0 (incl unreleased 1.9.9)
1.9.8
1.9.7
1.9.6
1.9.5 (includes unreleased changes for otehr distros)
1.9.0
1.8.7
1.8.6 (not release for sailfish)
1.8.5
1.8.2
1.8.1 - Includes 1.8.0 which was skipped
1.7.1
1.7.0
1.6.8
1.6.7
1.6.6.
1.6.5
1.6.1
1.6.0
1.5.6
1.5.5
1.5.1
1.5.0
1.4.5
1.4.0
1.3.1
1.3.0
1.2.0
1.1.3
1.1.2
1.1.1
1.1.0
1.0.0
0.9.2
Stop notification when call answered
Fix sending weather on interval
Add more languages for watch (only works if supported by FW)
0.9.1
Fixed crash for new users
Weather UI fixes
Whitelisted some more firmware
Translation updates
Bugfixes for daemon/ui split
0.9.0
***ONLY FOR SAILFISHOS >= 3.0.3***
Daemon/UI split
Reworked some pages to streamline them
0.8.9
Add buffer for 10 notifications when watch disconnected
0.8.8
Added deep sleep value to page
Save GPX files in data location not cache location
May install on SFOS 3.0.3 when available
0.8.7
New UI layout
Sleep statistics
0.8.5
Added step summary chart showing steps over previous 20 days from the selected day
Added auto-sync of activity data which occurs each hour
0.8.2
Fixed applying settings from the UI
0.8.1
Hopefully fixed crash introduced in 0.8.0
0.8.0
Major code restructure to better allow support for other devices (devs needed!)
Whitelist new Bip frmwares
Hopefully fixed GPS issue with new firmwares
0.7.5
Implemented sending weather
Fixed app displaying correct status when watch disconnects
Use correct icon for depecher
Fix layout of HR button
0.7.3
Updated translations
Fixed user profile settings page not opening
Comments
Malakay
Fri, 2020/07/10 - 18:21
Permalink
where can I find amazfish logs?
piggz
Fri, 2020/07/10 - 18:45
Permalink
In the journal ... devel-su, journalctl | grep amaz
Malakay
Sat, 2020/07/11 - 22:29
Permalink
Thanks, I´ve got still connection problems, still dropping, so I want to try to debug. But I have it connected via ssh and got command ready and today it is working flawlessly few hours. Now I disconnected ssh, so I´ll see.
mklick
Thu, 2020/07/09 - 11:50
Permalink
After restarting the watch and re-coupling it works also for me now. Thanx, fast and a great work.
armorica
Thu, 2020/07/09 - 08:35
Permalink
After updating to 1.6.5 the connection issue with the GTR is gone. Great job!
ahjolinna
Thu, 2020/07/09 - 03:56
Permalink
for me rebooting solved the connection/auth issue (with GTS, on Xperia 10)
btw. is it possible to get the "Find Mobile" feature, as I kinda misplace my phone way too often
mklick
Wed, 2020/07/08 - 15:11
Permalink
PS: Rebooting SF does not help, manual BT coupling works.
mklick
Wed, 2020/07/08 - 14:37
Permalink
Thanx for the new version. Unfortunately it does not work for GTS and 0.0.9.12. The error message at the watch is still the same. Connecting to the clock does not work, unpairing and repairing results in a no-reply dbus error. Please let me know if you need more data, e.g., another Android BT dump. I am still using the "old" key since the BT address did not change.
erdzas
Wed, 2020/07/08 - 14:52
Permalink
Hi, the update solve the conexion issue with the new FW for GTS. Thank
erdzas
Tue, 2020/07/07 - 21:26
Permalink
Hi, according to Gadgetbridge ticket, the huami-auth-experiments fixes the connection issue for the GTS with FW 0.0.9.12. I don't know if using the gadgetbridge code can help to fix the same issue in amazfish.
armorica
Thu, 2020/07/02 - 17:07
Permalink
Great to see the GTR being supported now. Based on the mentioned support I ordered one yesterday and received it today. Did the Android steps, used the python script (small issue regarding a module missing; fixed that installing pip3 and the rich module).
Had some "issues" pairing, but after pressing the "start" button this worked. Bit confusing to see the watch listed (having entered the auth key) but being unable to pair. It may be a good idea to write out the procedure in more detail.
As I can see the number of steps for today, it's clear the two are talking :-)
Great job!
mklick
Thu, 2020/07/02 - 02:05
Permalink
Thanx for this great app, very useful. It was working the last weeks with my GTS. I was so happy.. This was true until the latest firmware 0.0.9.12 installed by the Amazfit app today. Connecting does not work, there appears also an error message at the watch that the app should be updated. It seems that the protocoll was changed. I would aporiciate solving this issue very much.
piggz
Wed, 2020/07/01 - 09:45
Permalink
Issue is knwon by GB devs, perhaps you could provide logs from android for comms whn conneting with new protocol? https://codeberg.org/Freeyourgadget/Gadgetbridge/issues/1907
mklick
Thu, 2020/07/02 - 02:24
Permalink
Thanx for the quick reply. The description following your link fits to my case. Got the log via BTsnoop when Amazfit was connecting to the GTS, 33kB. How do you want to get it?
piggz
Thu, 2020/07/02 - 10:14
Permalink
New github issue pls
fried_tomato
Tue, 2020/06/30 - 13:03
Permalink
Hi there, first of all, thanks a lot for the app. It's really useful.
I used it for 2 months with a miband2, and now I'm using it with a BIP without any difficulties.
The only issue that I have is setting up the notifications. I was wondering if anyone could give me a hand, please. I'd like to choose which apps send notifications to the smartwatch (e.g. Telegram yes, Whatsapp no, phone calls yes, email no, etc...) but I can't find the option to do so. Any advice, please?
Caluna
Mon, 2020/06/29 - 12:13
Permalink
Hi Piggz,
thank you for the long awaited GTR support. Coupling works great and steps etc are transferred to the phone. Notifications do not work so far - watch shows notofication that the app has to be updated. Is this the current status?
carmenfdezb
Sun, 2020/06/28 - 17:10
Permalink
Hi @piggz! Settings of alarm doesn't work fine :/ I set an alarm from monday to friday and it only is set for 'Tomorrow'
carmenfdezb
Tue, 2020/06/30 - 22:44
Permalink
I can confirm that this bug is fixed in v1.6.1 and alarms work perfect now =). Thank you so much, @piggz!!
Malakay
Sun, 2020/06/28 - 15:35
Permalink
Hi, on Saturday was at last some time to fiddle with watch.
I paired my Bip succesfully, but still disconnects randomly. So I decided after an advice on TJC to reflash Bip firmware to 0.1.1.4.5 which is tested (before there was latest 1.6.4.8. version), according description here. I used Amazfish version 1.5.1.1. Disconnecting was much better, not too often as before. Then I updated on latest amazfish version and it seems to be okay now. Sometimes it disconnects (but I don´t know why, my phone is all the time in my pocket and watch on my hand), but almost everytime it reconnects in 2 minutes back. But another problem appeared - every notification on watch is displayed twice. Is there any solution?
piggz
Sun, 2020/06/28 - 15:40
Permalink
duplicate notifications is a known issue, ill get to it.
Malakay
Tue, 2020/07/07 - 22:48
Permalink
So, I tested multiple firmwares and Amazfish versions, still problem with dropping connection. But in another FW there was no problem with multiple notifications. So I don´t know what to do next. I am thinking about getting rid of those watches, it cost me much time and still it is not working properly :'(
urbi
Wed, 2020/06/24 - 17:03
Permalink
Dear piggz,
Is it possible that the application will support the Amazfit GTR watch?
piggz
Wed, 2020/06/24 - 17:16
Permalink
Already does in my devel version :D
urbi
Sat, 2020/06/27 - 22:14
Permalink
It's nice to hear that.
armorica
Thu, 2020/06/25 - 13:41
Permalink
Any idea on when this will become available? I'm looking for a new (SFOS supported) watch and the GTR looks to be a good option then.
piggz
Thu, 2020/06/25 - 14:11
Permalink
if you ping @adampigg on telegram, i can send you a version with gtr support, otherwise, just wait a few days :)
chris7chris
Sat, 2020/06/20 - 17:40
Permalink
Thanks for you app ! Bip is working well.
Georgiy
Tue, 2020/06/02 - 20:33
Permalink
Hello,Piggz help.no connect bip org.freedesktop.dbus.error.noreply.
Dear Piggz,install version 1.5.1-1, then everything worked, if you update to version 1.5.5-1 stops working,as well as the icons in the app disappear.While I'm on version 1.5.1-1.Fix it.Thanks.
chris7chris
Tue, 2020/05/12 - 20:07
Permalink
Well, I have resetted now, but I still can't connect htc Androidphone with Gadgetbridge to GTS.
BT turns itself off after a short time and thats it.
Sometimes BT stays on, but no Connection to Watch.
Pages