Your rating: None Average: 4.7 (60 votes)


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


Version 0.9.0 requires sailfish version or above due to changes in the base sailfish image

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.

MiBand 2/3/Cor

These devices are untested and use the Bip backend.  Should be safe to try and FW download should not be allowed.

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.


  • Pairingfrom
  • 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


  • 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


mvdm's picture

if you need help for french or dutch translation  just ask ;-)

cvp's picture

Did someone test it with the Stratos 2 or Pace Watch? :)

dalas_revo's picture

In SFOS's BT setting, sorry

dalas_revo's picture

I recovered by deleting the watch in SFOS's, re-pairing it, sending resources, fw and finally the font

marxistavegana's picture

0.8.1 works with COR and does not crash

dalas_revo's picture

No, I think your instruction is clear enough, people just have to follow it ;)
Maybe you could add a hint not to mix Latin and non-latin files, but in general I think it should be clear...

Reflashing did only work after deleting the watch in the BT section of SFOS settings, but finally flashing non-Latin font did the trick! Thank you very much!

dalas_revo's picture

Very nice app! Thank you!
Finally a usable smartwatch on sailfish :) Unfortunately I managed to bring my device into a more or less unusable state ( not bricked). First I flashed latest fw ( doesn't recognize the one with ending "latin" as fw) and res (latin), which worked very well. Afterwards I flashed latin fonts. Now the Bip always displays "Connect APP to update" and I can't get it out of this state. Reflashing firmware and ressources doesn't help.
I's there anything I can do to get it working again?
I am using it on an XA2, amazfish 0.8.1, as 0.8 always crashed at startup

piggz's picture
piggz's picture

Oh, sorry you got in such a state.  Could you try flashing the 3 non latin files, firmware, Res and font.


Failing that, can you use an android device to use mifit to do the flash?  I probably need better instructions on what to flash and which order!

Caluna's picture

Hi piggz,

I am also trapped in the "Connect to update" loop. Tried tore-flash different firmwares (from 0.1 to 1.1.5)  without much success. Additionally, Mi-Fit app on Android does not help as pairing fails. Do you have any other ideas?



piggz's picture

you need to srnd thr matching firmware and res, and.possibly font file. hopefully amazfish can still connect and send the files? all i can suggest is what is in the gadget bridge wiki, good luck

Caluna's picture

Hi Piggz,

I think, the device is bricke and stuck in a state that cannot be recovered: The files are sent in the correct order (as suggested in the wiki), but at the end of the transfer of the respective files I always end up with the message "connect to app to update" and connection to the phone is lost. I have to re-pair using Amazfish and can connect again. The connection request on the device pops up and I can agree and connection can be established. But still: the device does not "boot".  

Mi Fit on Android sends connection request, but when I agree, it says that the connection request cannot be sent.


piggz's picture

doesnt sound dire if you can still connect and send files. persist, try older, or try gadgetbridge

Caluna's picture

Tried a lot without any success: Gadgetbridge says, that there is a problem with transfer of metadata. "Google" provides not a real answer to this...

piggz's picture

you are trying all the non latin files,.3 of?

Caluna's picture

Yes: tried just the non-latin files, also in different order (fw first, res first gps first). FW Versions:,,,

All ends up with the same result

Caluna's picture

Finally, the problem has been solved "automatically": Somehow the firmware got stuck (I think). I had to wait till the device shut off due to low battery, load it and restart. Afterwards I had to install firmware again using official Mi-fit app on an Android deviced. Now, everything works again like a charm...

cartron's picture

One thing i just noticed: alarms are not synchronized to the watch. Actually i have one alarm which got pushed (happening on Mon, Tue, Thu, Fri) but whenever i try to add / enable other alarms, the watch shows me the other alarms as '0:00 tomorrow / disabled'
And modifying the alarm which got pushed does not work either

dalas_revo's picture

I cannot push any alarms, too. The output which is relevant here (I guess) is

[W] unknown:112 - file:///usr/share/harbour-amazfish/qml/pages/Settings-alarms.qml:112: TypeError: Property 'applyDeviceSettings' of object DeviceInterface(0xffb392f8) is not a function

piggz's picture

Ah, great, thanks for the console output, a remainder of the major restructure.

cartron's picture

Will you fix it in thr next release? :)

meemorph's picture

On startup
[D] unknown:0 - BluezAdapter::BluezAdapter
[D] unknown:0 - Registered notifications listener for device
[D] unknown:0 - BluezAdapter::setAdapterPath: "/org/bluez/hci0"
[D] unknown:0 - DRIVERS: ("org.kde.kdb.sqlite")
[D] unknown:0 - KDbConnection object created.
[D] unknown:0 - KDbConnection::connect() OK.
[D] unknown:0 - ("mi_band_activity", "sports_data")
[D] unknown:0 - VoiceCallsChanged
[D] unknown:0 - ActiveVoiceCallChanged
[D] unknown:0 - BluezAdapter::BluezAdapter
[D] unknown:0 - Using Wayland-EGL
library "" not found
Segmentation fault (core dumped)

meemorph's picture

0.8.0 gives segmentation fault on geminipda with Had to go back to 0.7.5-1.

piggz's picture

Are you doing anything specific to cause the crash or does it happen on startup?

marxistavegana's picture

It is giving me a segfault on sfos3.

piggz's picture

Are you doing anything specific to cause the crash or does it happen on startup?

Its working for me, but I didnt do a clean run, ie, with no pairing.  I will check that.  there were a lot of changes in 0.8.0 so i potentially missed something.


Can you post logs from running in a console to github?

cartron's picture

Hi, on which device? I upgraded my Xperia X yesterday to 0.8.0-1, and it works perfectly. Haven't tried yet running to see whether GPX files are OK now, but the rest works fine

cartron's picture

One cool feature I am missing from Rockpool/Pebble: the ability to select which applications can send notifications to the watch.

e.g. having Spotify sending me a notification on my wrist every time the song changes, is a bit annoying! ;)

cartron's picture

Hi @piggz, thanks for Amazfish, it works like a charm for connection with my Amazfit Bip - which I bought just because you created this software for SailfishOS :)

I was about to tell you that I had issues with the GPX from the first run I did with the Amazfit today - completely wrong, 25KM instead of the 11K I did - the overall trace is fine, but the GPX starting point is like 10 KM away from my real starting point.

I saw that you released version 0.8.0-1 today, I will update and will try it with my next run to see.

Thanks again!

piggz's picture

Thanks, let me know if it works.  Ive heard from someone else that it does.