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


D_R's picture

I forgot to tell: I'm using a XA2 too with last Hossa

MartiMasa's picture

I have/had exactly the same problem so I decided to completely remove Amazfish from my XA2 and then reinstall it. Reinstalling fails now due to missing ”alienaudioservice-0.3-1.2.60.jolla.armv7hl.rpm” in SFOS So please do not remove Amazfish before this is fixed! UPDATE: I was now able to reinstall the app on XA2 after refreshing cache & restarting phone. However, the „No data to transfer” error persists but notifications, HRM and step-counts work just fine.

Mariusmssj's picture

Is anyone else having issues with getting the weather working? I tried setting the location multiple time but it doesn't seem to work.

seiichiro0185's picture

I seem to have the same Problem. Just got an Amazfit Bip, and Setting the Weather Location just resets as soon as I leave the Settings page. Also no Weather is send to the watch.

Everything else works nicely so far (after the first day of use), so thanks a lot for this great App @piggz !

Mariusmssj's picture

It is odd as it does find the city and you can select it, but once you leave the menu it just gets cleared

seiichiro0185's picture

Interesting discovery I made today: Restarting the daemon does lead to weather being send to the watch. Also the city seems to be saved in ~/.config/harbour-amazfish/harbour-amazfish/config.json The settings page is still empty though.

Mariusmssj's picture

Ahh I see, by restarting the daemon you mean just stop the service and start it again from the app?

piggz's picture

I should maybe point out that installing a new version currently doesnt restart the service, so, you should do it manually after an update for the update to take effect!

seiichiro0185's picture

@Mariusmssj: Yes, i simply stopped and started the service from the settings page, after that Weather started working on the watch.
@piggz: In my case there was no update involved. Its a new install of 0.9.2, since I just got the Bip last friday.

Mariusmssj's picture

Did you have to pair the phone again? For me after stoping and starting the service it would not connect back to the phone and I had to go through the paring process again.

seiichiro0185's picture

It didn't connect by itself, but using the "Connect to Watch" (don't know exact wording here in English, my Phone is in German) entry in the Pulley Menu was enough, I didn't have to do the pairing again. Maybe it would have reconnected by itself after some time, didn't try that.

Termitebug's picture

Can't install Amazfish to latest Hossa. Jolla is missing from Sony-nile repository alienaudioservice package required by Amazfish .rpm

D_R's picture

I'll get always no data to transfer popup and no data in the charts.... I get only the actual value for steps. On the side with the 3 charts I get no data to transfer popup always...

zepher's picture

I am having a similar issue as D_R, the first time I connected it did update data but since that time additional days are shown mostly as blank (no data) and for one day the plots just look strange, heart rate is shown as a broad line. There are no reported errors on data transfer and phone <--> watch comms seem fine in the debug menu. I am on firmware

piggz's picture

The graphs work, its just not auto-downloading the data, you have to keep manually downloading until there is no data left

zepher's picture

Ah, I see. can get data now. it seems to only get heart rate for a couple of days in the last few weeks, perhaps I have set up something wrong with the heart rate recording interval. thanks for all your work on this app!

D_R's picture

I downgraded to firmware Same behaviour : pairing and connecting is okay but the values are not shown in the charts. It seems that nothing is written or read from to the database...

BonoNL's picture

For the right apk:

This is the last APK with these three packages:

  1. Mili_chaohu.fw
  2. Mili_chaohu.res (the Bip will tell you when needed)
  3. Mili_dth.gps (this rarely changes, check the table below, if you should update)


I just donated, keep up the good work Adam!

MartiMasa's picture

Hi, I think I have the same issue as D_R. The watch connects, notifications, battery status, pulse as well as step-counts are working fine. However, no data and no curves are shown in the app. When trying to receive the data from connected watch „No data to transfer” is displayed. My firmware is but I'll try to update. How to fix the data transfer?

D_R's picture

Hallo Piggz,

thank you for that great app!!!
The connection problem is gone with the last update of Amazfish. But since the last Sailfish update I have no curves in the charts. How can I debug it or solve that problem?
My firmware is on Amzfit Bip
and the kdb lib was installed by zypper...

Mariusmssj's picture

Hello piggz, just wanted to say you are doing a great work to provide us this app :) I plan to get an Amazfit Bip but I wanted to ask if it supports Calendar Alerts?

Thank you :)

zepher's picture

Thanks so much 0.9.1 works for me too. I just had to remove the pairing and repair so that it would authenticate.

zepher's picture

Same here, I had set the location details before trying to connect.

piggz's picture

Please try 0.9.1

zepher's picture

I had the same journalctl output as jojonintendo. It's the first time I've paired.

piggz's picture

Its a little odd ... i just wiped config/unpaired my watch, and it doesnt crash! .. I'll keep digging though!

piggz's picture

Oh, i think I found it! I only wiped my device config, not the full config.  The next stage of the loading is the weather, so I guess it crashes as no location is set.  An easy fix!

jojonintendo's picture

Nice! I'll try the new version as it comes out and report back.

Edit: what I mean is that I've already tried to set the location before pairing, and also configuring everything else like the name, height, etc. But it still won't connect.

piggz's picture

Please try 0.9.1

jojonintendo's picture

Working perfectly fine now, thank you very much for your fast fix!