Your rating: None Average: 4.7 (63 votes)


Companion application for the Huami Amazfit Bip, Cor, MiBand2/3 and GTS


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.

Currently, Amazfish is built agaist the libicu library version 63 in Sailfish 3.3, in Sailfish 3.4 this has been replaced with version 66.

As a workaround, it is possible to force install amazfish and its libraries by using "zypper install --nodeps ..." and manuallycreating symlinks for the icu libraries:

/usr/lib/libicu*.so.66 -> /usr/lib/libicu*.so.63

If you dont know the exact command to use, then just wait untila build is available for 3.4.

***PLEASE READ for 1.7.0 Update***

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

App has been tested using an amazfit bip and GTS, downloading the latest ( 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:

  • .fw
  • .ft
  • .res

Amazfit GTS

Beta support for the Amazfit GTS includes activity data sync and sports sync (GPS). No support for downloading FW or watch face, an no support for sending weather data.  GTS 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.

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.

  • Obtain the script from
  • Download the AGPS files using the -g paramter, this will download 2 .zip file.  The only one required is
  • Extract the zip and transfer the 2 .bin files to the phone
  • Send the files gps_alm.bin and cep_pak.bin to the watch.

YMMV Devices

  • MiBand 2/3/4
  • Cor
  • GTR
  • Bip-S

These devices are untested and use the existing Bip/GTS backends.  They should be safe but your mileage may vary, and some features may not work.

Pairing Issues

Pairing works for myself, sometimes I have to try twice.  If pairing doesnt work at all, then try:

  • keep the app open, and pair again in the BT settings page of sailfish
  • in the sailfish BT settings page, delete all entries and try again
  • turn off/on BT on the phone
  • factory reset the watch

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.


  • Pairing
  • Notifications
  • Calls
  • Some settings
  • Retrieving activities
  • Heartrate Chart
  • Alarms
  • Watchface download
  • Firmware upload
  • Activity Sync


  • More Settings
  • Support other devices (maybe eg MiBand2, as it is similar)

The Cor is also claimed to be working, but as i dont have that device, i cant test it.

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.


Credits to:

  • The rockpool devs, as i borrowed the call handling code handling code from them
  • The gadgetbridge devs, which gave me a lot of hints and inspiration from their device code.
Application versions: 
File harbour-amazfish-0.1-1.armv7hl.rpm112.29 KB17/04/2018 - 23:12
File harbour-amazfish-0.2-1.armv7hl.rpm119.54 KB28/04/2018 - 00:35
File harbour-amazfish-0.3-1.armv7hl.rpm131.01 KB07/05/2018 - 23:54
File harbour-amazfish-0.4-1.armv7hl.rpm137.54 KB18/05/2018 - 23:22
File harbour-amazfish-0.4.1-1.armv7hl.rpm137.63 KB20/05/2018 - 00:15
File harbour-amazfish-0.4.5-1.armv7hl.rpm148.71 KB22/05/2018 - 22:02
File harbour-amazfish-0.4.6-1.armv7hl.rpm149.08 KB22/05/2018 - 22:55
File harbour-amazfish-0.4.7-1.armv7hl.rpm149.42 KB24/05/2018 - 00:35
File harbour-amazfish-0.5.1-1.armv7hl.rpm158.56 KB30/05/2018 - 00:22
File harbour-amazfish-0.5.5-1.armv7hl.rpm164.27 KB02/06/2018 - 22:11
File harbour-amazfish-0.5.8-1.armv7hl.rpm168.1 KB04/06/2018 - 21:07
File harbour-amazfish-0.5.9-1.armv7hl.rpm170.27 KB05/06/2018 - 22:24
File harbour-amazfish-0.6.0-1.armv7hl.rpm171.68 KB06/06/2018 - 00:17
File harbour-amazfish-0.6.5-1.armv7hl.rpm179.96 KB23/06/2018 - 11:28
File harbour-amazfish-0.6.7-1.armv7hl.rpm185.47 KB26/06/2018 - 21:55
File harbour-amazfish-0.6.8-1.armv7hl.rpm186.04 KB28/06/2018 - 21:19
File harbour-amazfish-0.7.0-1.armv7hl.rpm238.07 KB15/07/2018 - 12:13
File harbour-amazfish-0.7.1-1.armv7hl.rpm237.48 KB19/07/2018 - 16:51
File harbour-amazfish-0.7.3-1.armv7hl.rpm239.17 KB23/07/2018 - 23:19
File harbour-amazfish-0.7.5-1.armv7hl.rpm673.84 KB26/08/2018 - 11:02
File harbour-amazfish-0.8.0-1.armv7hl.rpm673.94 KB25/11/2018 - 16:33
File harbour-amazfish-0.8.1-1.armv7hl.rpm674.27 KB29/11/2018 - 00:32
File harbour-amazfish-0.8.2-1.armv7hl.rpm674.21 KB01/12/2018 - 16:29
File harbour-amazfish-0.8.5-1.armv7hl.rpm679.46 KB12/01/2019 - 18:02
File harbour-amazfish-0.8.7-1.armv7hl.rpm681.18 KB23/01/2019 - 01:38
File harbour-amazfish-0.8.8-1.armv7hl.rpm681.32 KB04/04/2019 - 20:58
File harbour-amazfish-0.8.9-1.armv7hl.rpm682.44 KB05/04/2019 - 01:11
File harbour-amazfish-0.9.0-1.armv7hl.rpm703.9 KB18/05/2019 - 00:30
File harbour-amazfish-0.9.1-1.armv7hl.rpm702.06 KB21/05/2019 - 22:37
File harbour-amazfish-0.9.2-1.armv7hl.rpm703.2 KB12/06/2019 - 23:28
File harbour-amazfish-1.0.0-1.armv7hl.rpm703.32 KB05/01/2020 - 17:44
File harbour-amazfish-1.1.0-1.armv7hl.rpm1.8 MB06/02/2020 - 01:11
File harbour-amazfish-1.1.1-1.armv7hl.rpm1.48 MB07/02/2020 - 23:21
File harbour-amazfish-1.1.2-1.armv7hl.rpm1.49 MB16/02/2020 - 12:31
File harbour-amazfish-1.1.3-1.armv7hl.rpm1.6 MB29/02/2020 - 14:09
File harbour-amazfish-1.2.0-1.armv7hl.rpm1.6 MB01/03/2020 - 14:03
File harbour-amazfish-1.3.0-1.armv7hl.rpm1.6 MB04/03/2020 - 12:39
File harbour-amazfish-1.3.1-1.armv7hl.rpm1.6 MB04/03/2020 - 21:22
File harbour-amazfish-1.4.0-1.armv7hl.rpm1.62 MB12/04/2020 - 12:39
File harbour-amazfish-1.4.5-1.armv7hl.rpm1.62 MB13/04/2020 - 15:49
File harbour-amazfish-1.5.0-1.armv7hl.rpm1.61 MB22/04/2020 - 15:23
File harbour-amazfish-1.5.1-1.armv7hl.rpm1.61 MB26/04/2020 - 22:58
File harbour-amazfish-1.5.5-1.armv7hl.rpm2.45 MB15/05/2020 - 11:48
File harbour-amazfish-1.5.6-1.armv7hl.rpm2.45 MB16/06/2020 - 15:48
File harbour-amazfish-1.6.0-1.armv7hl.rpm3.17 MB28/06/2020 - 16:43
File harbour-amazfish-1.6.1-1.armv7hl.rpm3.17 MB30/06/2020 - 22:29
File harbour-amazfish-1.6.5-1.armv7hl.rpm3.18 MB08/07/2020 - 11:17
File harbour-amazfish-1.6.6-1.armv7hl.rpm3.18 MB17/07/2020 - 11:30
File harbour-amazfish-1.6.7-1.armv7hl.rpm3.18 MB22/09/2020 - 00:25
File harbour-amazfish-1.6.8-1.armv7hl.rpm3.18 MB22/09/2020 - 11:29
File harbour-amazfish- MB10/10/2020 - 22:34
File harbour-amazfish- MB13/10/2020 - 15:03


  • Implement AGPS download for Bip/Lite/GTS (See description)
  • Translation updates


  • Added parsing for sport summary data and record data in database
  • Added new sport info page with all activity data and map of route
  • Fixed buttonPressed dbus-signal (contribution from jgibbon)
  • Added untested basic bip-s support


  • Fix application notifications not shown in UI


  • Add support for the activity data format in later GTS firmware
  • Pinetime-JF renamed InfiniTime
  • Add music control for InfiniTime
  • Fix sending goal to watch


  • Fix uI crash when daemon not running
  • Minor backend fixes


  • Fixed GTS/GTR auth with new firmware (please feedback if still issues)
  • Major re-write, mostly non user visible, moving the following to libwatchfish
    • Calendar
    • Notification
    • Calls


  • Fixed repeating alarms


  • Basic GTR support
  • GTS/GTS music app inplemented
  • Moved button based mucis control to daemon
  • Only send connect notification if there are no buffered messages
  • Start using libwatchish where applicable


  • Fix daemon crash when pairing


  • Fixed sending weather to GTS
  • Refactored weather code
  • Initial support for Pinetime-JF


  • Be more stringent about allowing firmwares to be downloaded
  • Fix timestamps in GPX files


  • Fixed file transfers (watchface/fw) to the Bip
  • Watchface transfer to Bip Lite confirmed working
  • Added file transfer support for the GTS
    • Watchface confirmed working on XA2/Mido
    • FW confirmed working on Mido



  • Added heartrate analysis page
  • Moved raw graphs to menu


  • Large contribution from Petr Tsymbarovich
    • Reworked pairing
    • Updated first page
    • Updated config storage
    • Updated device selection
    • Use nemo notifications
  • Add indoor cycling activity type
  • Fix syncing data when in DST(hopefully!)


  • Darker paercentage circle
  • Fixed service Stop button
  • Load steps on startup for quicker display
  • Translation updates


  • UI improvements thanks to @AlphaX2
  • Note added to sleep page


  • Hopefully fix reading calendar
  • Translation update
  • Start using the supported-features system to hide some UI components when not applicable


  • Improve coverpage information and actions
  • Fix labels on graphs
  • Fix auth with bip lite / band
  • Fix bug for time format selection
  • Add support for sending calendar events to supprorted devices
  • Request alarm info from watch on init
  • Fix display of steps showing x10 sometimes


  • Fix initial pairing with Bip, Miband 3 and maybe others


  • Add support for Bip Lite
  • Allow connection of MiBand3 and Cor (untested, uses the Bip backend)
  • Translation updates


  • Fix alarms being overwritten
  • Initial (beta) support for Amazfit GTS
  • New pairing page and improved pairing


  • Added support for flashing newer firmwares
  • Added disconnect notification option
  • Fix buffered notifications when the watch is not connected (they never worked)
  • Added workaround for data not syncing when in DST
  • Added low battery notification

Stop notification when call answered
Fix sending weather on interval
Add more languages for watch (only works if supported by FW)

Fixed crash for new users
Weather UI fixes
Whitelisted some more firmware
Translation updates
Bugfixes for daemon/ui split

***ONLY FOR SAILFISHOS >= 3.0.3***
Daemon/UI split
Reworked some pages to streamline them

Add buffer for 10 notifications when watch disconnected

Added deep sleep value to page
Save GPX files in data location not cache location
May install on SFOS 3.0.3 when available

New UI layout
Sleep statistics

Added step summary chart showing steps over previous 20 days from the selected day
Added auto-sync of activity data which occurs each hour

Fixed applying settings from the UI

Hopefully fixed crash introduced in 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


Implemented sending weather
Fixed app displaying correct status when watch disconnects
Use correct icon for depecher
Fix layout of HR button


Updated translations
Fixed user profile settings page not opening


gerstavros's picture

Will it support Pace?

hensip's picture

Dear piggz,

Is it possible to add support for the Amazfit bip S watch?

Thank's for this amazing work.

vige's picture

Thank you for moving the music player controls to the daemon! It's really great that I no longer have to remember to start the app before going jogging, which is pretty much the only situation where I need that functionality.

axolotl's picture

Thx for the great app. Using it with a Mi Band 4. Everything works fine except phone finder and music controller.
The graphs look a bit strange as it seems that all bars are evenly distributed along the x-axis without respect to missing measurements (e.g. when watch and phone were out of range). For example, I have a heartrate chart starting at 0:16 and ending at 23:50, but the middle of x-axis shows 7:30. I think it would be better to always show the whole 24h range and a stem plot with respect to the exact time along the x-axis. Similarly, the steps chart should be fixed to 7 days, no matter if there were measurements or not. On the other hand, the steps are hardcapped at 20k, where I think they should be capped at the alltime maximum. When doing it with the kexi/sqlite3 data on a PC one can clearly see the many time gaps.
Keep up the good work, will definetly donate a good tasty beer :)

martinbook85's picture

I cannot get my Mi Band 4 to work properly on my Sailfish XA2 Ultra. I found the Auth Key (I think) but it just keeps saying unexpected error when I click on the device in the pair device window. Any suggestions? Thanks!
I thought of tapping the button "start services" and tried pairing again. Now it works fine. So far so good.
What I get so far:
Step count
Heart rate
Set alarm clock
I will soon go by bike to work, we'll see how well it registers that. Sleep tracking is supposed to be updating at noon (why?) so we'll see how well that works.
Bicycle tracking is not available for me. Is there any way to get that? It really is the only exercise I do.

Malakay's picture

Hi, i was testing last days and still drops connection quite often. SFOS Rokua, fw Main problem is that some time it reconnects back in a few minutes, but after few hours it disconnects and doesn t reconnect back even after few hours :( i can provide log.can someone help?

chris7chris's picture

After the last update wheather data is not shown anymore. Only a cloud with a question mark in it. All other stuff is working fine.
Amazfit Bip
Update: Ah, today it's working again with a nice weather forecast.

mklick's picture

Tried the new version now one week. Connection and real-time data (cover) are fine. Weather was also fine after some time. Data in data base are still wrong as shown in the screenshots on github. Please let me know when you need data or logs.

Malakay's picture

where can I find amazfish logs?

piggz's picture

In the journal ... devel-su, journalctl | grep amaz


Malakay's picture

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's picture

After restarting the watch and re-coupling it works also for me now. Thanx, fast and a great work.

armorica's picture

After updating to 1.6.5 the connection issue with the GTR is gone. Great job!

ahjolinna's picture

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's picture

PS: Rebooting SF does not help, manual BT coupling works.

mklick's picture

Thanx for the new version. Unfortunately it does not work for GTS and 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's picture

Hi, the update solve the conexion issue with the new FW for GTS. Thank

erdzas's picture

Hi, according to Gadgetbridge ticket, the huami-auth-experiments fixes the connection issue for the GTS with FW I don't know if using the gadgetbridge code can help to fix the same issue in amazfish.


armorica's picture

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's picture

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 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's picture

Issue is knwon by GB devs, perhaps you could provide logs from android for comms whn conneting with new protocol?

mklick's picture

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's picture

New github issue pls

fried_tomato's picture

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's picture

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's picture

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's picture

I can confirm that this bug is fixed in v1.6.1 and alarms work perfect now =). Thank you so much, @piggz!!

Malakay's picture

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 which is tested (before there was latest version), according description here. I used Amazfish version 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's picture

duplicate notifications is a known issue, ill get to it.

Malakay's picture

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 :'(