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


  • 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


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.

piggz's picture

you could help by opening an issue on github, and if possible, gather the bluetooth snoop log from an android device as it sends a watchface to the device, this way, i have something to reverse engineer.  Gadgetbridge does not yet support sending watchfaces to the GTS, so I dont have a reference implementation to work from

subeditor's picture

Any chance to pair with Huawei/Honor devices?

piggz's picture

ive no plans to, though i will always accept PRs if someone implements a new device.

erdzas's picture

Hi piggz,

I use Amasfish on XA2 plus with the last os version, since few day.

I have noticed a large battery drain (my consumption has doubled), This is not the case with previous version of the app and miband 2.

And my watch loose 20% of battery per day.

jpn9s's picture

Since Feb 7th, thus the fifth day, Cor with XA2 SFOS + Amazfish ver 1.1.1 has been working very flawlessy. Great! Thank you.

velemas's picture

Pairing with Amazfit Cor 2 (Amazfit Band 2) does not work in 1.1.1.

Caluna's picture

Hi did anyone test, if GTS support also ads suppor fot GTR?

ninepine's picture

Amazfit GTS

Hi @piggz Many thanks for the App and the work on the recent beta for GTS. Here are some comments / feedback. Not sure I have done everything right but hope these notes are helpful.

I’m running Amazfish 1.1.1-1 on Sony Xperia XA2 running Sailfish Nuuksio connecting to Amazfit GTS with Firmware v0.0.8.37 (Have not attempted to flash any firmware files described as for Amazfit Bip). Watch firmware updated using Amazfit for Android on an Android phone to latest firmware (

Pairing. Have paired natively in Sailfish Settings – It is showing as Connected. No need to get key for pairing etc. In settings Debug info though the Connection State is :authfailed

App shows Battery level and Heartrate correctly and Bluetooth refreshes every few minutes to update. On Steps screen the current step count is captured and shown but sometime this is augmented temporarily by a factor of 10. There is a list of dates below the step count but this is not bound to the step count. Moving between dates shows the step count for the current date rather than changing for each day. There is no Data / graphs shown in any of the graph boxes but this is the first day connected. Sleep shows no data and is zero. Analysis screen shows no data.

Not sure is I should have flashed to BIP firmware or if the database is OK. No option to Download Data (greyed pulldown option).

Some clarification on whether to flash the Bip firmware for the GTS would be appreciated please.

Hope this is helpful. Best wishes,


piggz's picture

1. DO NOT flash a bip FW to a GTS

2. You definitiely need the pairing code and to pair through the app as described, its not enough to just "pair" it in jolla-settings, without that, the watch wont authenticate to the app.

ninepine's picture

@piggz Thanks for clarifying. Will pair through the app. 

jpn9s's picture

Or multiplies with 10 (10x)the steps as mentioned earlier allready.

Funny, my Cor attached to Amafish counted steps earlier without any problem. After that yesterday-crisis due to the jump to Vers 1.1.0 / 1.1.1 my Amafish step counting went crazy. I have SFOS in my XA2, too.

carmenfdezb's picture

This version fix bugs for amazfit bip? In v1.1 I can't send any file to my watch and it doesn't shows right values in steps.

carmenfdezb's picture

Ok, I've installed v1.1.1 and it only has bug about steps

jpn9s's picture

I read of Sailfish API Documentation. Unfortunately I do not have any skill for any adding. I'm sorry.

jpn9s's picture

Works now for Cor, too. Thank you very much. Va bene adesso.

jpn9s's picture

Mi scusi
. ☺ Bluetooth shows Amazfit Cor... But I do not understand what dialog? Cor is not shown in pairing options.

jpn9s's picture

Thus 1.1.0. Cor does not pair with app. App only shows 'Start service'. Nothing else.

piggz's picture

Can you give the name of the Cor as it appears in the sailfish settings dialog?

jpn9s's picture

Dear Piggz,

Good afternoon. My XA2 loaded 1.1.1 Amazfish. Noted that Amazfit Cor does not work anymore. Is it skipped out, isn't it? Thank you for your reply on this.

carmenfdezb's picture

Hi @piggz!
Since I've updated to v1.1 I have some issues:
1) Wrong value in steps: when I access to steps page, it always shows the value multiplied tenfold. For example, if steps value is 1000 in my amazfit bip, amazfish displays 10000. It only shows the right value when I synchronize data.
2) I can't install firmware, it always shows invalid file. However, I can install firmware with v0.9.2 (it fails in v1.0 too)

erdzas's picture

Hi @piggz.
 I found some small bugs with my GTS and the 1.1.0-1:

First of all, I get two notifications on the watch for one on the phone.

Second, I have a button to mark the notification as read, but in the majority I don’t have it.

Thirdly the time format displayed on the watch is in 12Hrs while in the settings I selected 24Hrs (bug also present on my miband2)

Sanpo's picture

So, everytime I reboot my xperia 10+, I have to pair my Bip again..

carmenfdezb's picture

Hi @piggz!

I'm trying to analize the database but I don't understand some values (for example, a lot of values in 'heartbeat' are '255' in my database). I'll be very grateful if you explain here or in github the meaning of fields in database.

Thanks in advance!

MihailSafonov's picture

С Mi Band 4 будет работать?

erdzas's picture

Hi @piggz.

First, nice app, it work well for cor and miband 2.

Is theire any workaround to pair with GTS, for now?

Or must we wait the next realase?

Now when I try to pair, the app stay at "connecting to watch" stage

piggz's picture

Wait fo rnext release :)

jpn9s's picture

Good morning. I have Amazfit Cor plus Amazfish together XA2 SFOS Everything works perfect, but the calendar alarms in the phone are not shown in my Amazfit Cor. Calls and messages are shown. Also putting on Android support is shown in my Cor. What do I have to do that also calendar alarms are  shown, or  are they not allowed yet? Thank you for your Amazfish and for your help.