Your rating: None Average: 4.7 (57 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


  • 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


R1v3r's picture

Propably few stupid questions. So I have been thinking to buy one Bip, but few concerns. So does all notification (e.g. whatsapp, messages, call) work in this watch?


And is there APP for the watch, that it can be used as normal swimcounter? :D (so is there any APPs possible to install?)

piggz's picture

Notifications: yes

The bip does not support apps, you are limited to whats in the firmware.  Is it even waterproof for swimming? Ivbe got mine wet, but not sure on the rating.

R1v3r's picture

Hello. Do you have some forum to send questions/request if possible?

Your app seems to be fine, but is there possible to add watch to vibrate when connected and disconnected?

Easily to recognize if phone is out of reach :)

piggz's picture

the link is in the details ;)

btw ... already app sends message to watch on connect .... not sure how disconnect would work

R1v3r's picture

Thanks for fast answer, as always :)

you mean this github address?

And for disconnecting message seems working on android at least :)

R1v3r's picture

Ok. not sure. I saw somewhere, that it would be IP68 that showed like 30 minutes in 1,5 meters. But not sure, if this is for swimming though :D


Edit: Well. Ordered it. Will see, how it goes :)

es1445's picture

Very nice app but I am missing the sleep tracking funktion. Can you add this feature? This would be very nice.

piggz's picture

Yes, its a feature id like to add.....however, you could also work it out for yourself.  As you may or may not know, I store all the data in a .kexi database.  If you copy the database off the computer, and load it up in Kexi on a desktop machine, you may be able to work out how the sleep data is stored.  I basically store all the activity events off the watch, so working out sleep patterns is just a case of querying the correct data.

jojonintendo's picture

Can't get to install it on my Xperia X with latest 2.2.0 Sailfish X. Also, can we expect support for Amazfit equator someday? The hardware seems to be the same as Mi Band, functionality wise it is just like first Mi Band but with even less features (no LED).

piggz's picture

any errors?  what happens if you try and install from the command line?  My understanding is that is _does_ work on the X.  I think the app mostly supports the MiBand 2, but never had anyone test the original MiBand.  Without a device its hard to add support, but I will accept PRs for new devices on github, or device donations :)

jojonintendo's picture

Installing from command line I get approx this (translated): fatal error, nothing provides Thank you very much for your hard work and for answering this fast!

piggz's picture

how are you installing? if using storeman, this should be resolved automatically.  the only way i can see this failing is if you just downloaded the rpm.  look at my other packages and install all the kde ones if you are insatalling outside of a package manager.,

jojonintendo's picture

Silly me, I was just installing the rpm. Now the app works as it should. It seems to try to pair to the equator, but can't really achieve it. If I pair the device from the phone first, then it appears as connected in Amazfish but can't get any data. I could try to provide you with some logs if it could help development. The debug info of Amazfish doesn't really work with equator though.

Again, thank you for your time!

ar560's picture

Hi. Do you activated MiBand in MiFit app? I couldn't connect Amazfit to fresh buyed Band 2. After registration I could connect to Miband.

My setup: Intex Aqua Fish  MiBand 2 HW:V0.1.3.3 SW:V1.0.1.81

Now my problem. No steps count on main page and no heartrate on analysis page. Also alarms seems to not be working.



ar560's picture

Just found function "Lift wrist to view info" doesn't work with Amazfish. Previously I switch on this function in MiFit. And now it doesn't work :(

Where "Refresh button" go? :)

piggz's picture

refresh is now a pulley menu on the stats page

piggz's picture

If you run harbour-amazfish from the command line, it will generate a ton of output which would be useful to debugging the MiBand2.  Have you set a profile on on it?  Settings >  profile > save, see if that helps.

ar560's picture

looks like 12/24h setting inversed for band2. When I select 12h, clock show 0-24 range. 24h selected -> 0-12h range.

ar560's picture

Send links to logs in privat message.

> Settings >  profile > save

Where? In Mifit no such buttons. amazfish too

piggz's picture

I just uploaded a fixed version, opening the user profile page was broken.

Try opening the user profile page, and sending the profile to the band to see if that helps get data back.  If not, send me logs again.

ar560's picture

Yep, settings are saved now. Only steps count on main page absent.

mr_Upolo's picture

Does it work with mi Band 1s? Or it will not connects?

piggz's picture

No, I think at best it works with the MiBand2, Cor, and of course Bip, which is the only officially supported device.

TybaldRabe's picture

Hi, your app is great, but latest version had issues w my MiBand2. Heath rate and steps not displayed on graphs. Ver 0.6.8-1 work better. How can i help? Maybe translation to Czech??

piggz's picture

odd, there shouldnt have been any changes in that regard.   can you get logs after trying to retrieve data and post to github?

mr_Upolo's picture

Is there a thing to unpair the device? I want to connect another device but the app only find old mi Band 2...

piggz's picture

delete the old device from system bluetooth settings, and make sure it is out of range when pairing the new one.

explit's picture

It brings cyrillic (RU) support. (For me very important)

piggz's picture

in that case id better add support for setting that lang in the app!

explit's picture

Thanks piggz! Cool App. Working with the new FW too