Your rating: None Average: 4.7 (53 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, 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 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 resource sent.  Just wait for the app to connect again, then send the resource. 

The following types of file exist:

firmware, resource, a-gps data, fonts

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 theire 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


  • 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


alex000090's picture

Dear piggz, is there weather settings in newest version of program? I don't see it in Settings menu as in previous version.

piggz's picture

There is new code which hides some settings if theyre not applicable to a particular device.   However, all devices have weater enabled at the moment, and GTS and Bip users have confirmed the option is there.  If the device isnt paired/set up then it may not show.

alex000090's picture

OK. Thank you!
All have worked after rebooting the phone.

AlphaX2's picture

What device you are using?

ninepine's picture

Fantastic! 1.2.0 fixes the calendar data on GTS for me thanks.

cartron's picture

yep, works great on my GTS :)

rdomschk's picture

Thanks for your updates and using your freetime :) I have a GTS and I tested the new calendar datas with a choose a watchface with a text face for reminders. But I cant see any entrys. It is the right way? 

A secound problem since the update 1.1.3 is by me, that the step count and the sleeptime for comming days are not 0. It shows for every future day the actuell day counts. I have a Sony xperia 10. Maybe it the reason. 

cartron's picture

re "A secound problem since the update 1.1.3 is by me, that the step count and the sleeptime for comming days are not 0. It shows for every future day the actuell day counts. I have a Sony xperia 10. Maybe it the reason. ", I always had this behaviour, so not sure this was introduced in 1.1.3.

AlphaX2's picture

Version 1.2.0-1 should fix calandar data, so it did for me.

AlphaX2's picture

Hi piggz, great news, the latest 1.2.0 update fixes calander bug. It's sending calandar data to watch now and thats really cool. I'm working on some GUI beautifying, hope you're interested. :-)

AlphaX2's picture

Hi, thank you for the great update with all the these small detail fixes. I'm very sorry, but the new feature of sending calander data, is not working on my GTS. The logs (journal) shows no errors. Any idea, what to try? Thank you very much.

piggz's picture

Please supply the logs from journalctl | grep amazfish.... Calendar looks 2 weeks ahead and sends the first 10 events it finds.  You will have to reboot for it to work becuase of the permission system.

AlphaX2's picture

There are the logs, forced update with Button from debug settings page.

piggz's picture

Thats not a full log, get the logs from this boot with journalctl -b | grep amazfish

AlphaX2's picture

Ups, sorry.

And there is an error, while creating the database.

Thank you.

piggz's picture

Can you show the content of /usr/lib/systemd/user/harbour-amazfish.service

Have you rebooted?

piggz's picture

Oh, i know the issue...

piggz's picture

Please try 1.2.0.  Service will need restarted/or a reboot.

Stezkoy's picture

Hi, this application supports clock GTR?

piggz's picture

not yet, can you gie the exact name of the GTS from the bluetooth settings page?

Stezkoy's picture

don't have a gts

piggz's picture

i mean gtr!

Stezkoy's picture

Amazfit GTR


alex000090's picture

Dear piggz, could you add sleep time interval when the phone don't send any notification to a clock?

piggz's picture

Yes, there is already an open issue for this

rdomschk's picture

Thank You very mutch for this genial app. I got a Amazfit GTS on my Birthday an could coupple it with this way. My question is if is possible to add an option to increase the font sizes in messages on the watch. In the androidapp it is adapted on the system fonts of android. 

Now I have found a moded newest Firmware mod (with Font 12) for the GTS from here:

But how can I send this to the watch? It are 3 files (fw, ft and res) Maybe I can only send the ft 0 font file. Could you sharing your knowledege with me please?

AlphaX2's picture

Do you mean this auth-key thing? Getting the key might be anoying, but not to hard. I have some problems with disconnecting and reconnecting, but the phone is just on the table and very near. These reconnects or the connection itself seems to drain the battery (on phone and GTS) a lot.

ahjolinna's picture

I just tried to connect GTS with my Xperia 10 and I noticed that when it tired to find/scan for the device your app didn't notice that bluetooth wasnt ON (yet) and just said after a while that couldn't fine the device. Maybe add a check if bluetooth has/hasn't been enabled


PS. I really hope the connecting process for GTS will someday become way easier than what it's now

jpn9s's picture

Shall it be possible to have an following some day: When watch is connected via bt to Sailfish phones, a silent mode is activated automatically?

AlphaX2's picture

Hi, I am really happy with my new Amazfit GTS that works well for now. Hope you keep up the great work, would be cool to see a watchface install option added. The two default faces of the GTS are okay, but not great. Thank you a lot.