Your rating: None Average: 4.7 (40 votes)


Companion application for the Huami Amazfit Bip and Cor


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

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

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


cvp's picture

Thanks for the update. Watchface upload works fine! I get the message that the app responding, just keep waiting. Donation is out :)

German translation for 0.6.5 is ready, pullrequest is started.

eanderalx's picture

Nice App, what about a daemon so that the app does not have to be open?

Two Problems I've found while using with an Band 2 and an Xperia.
The call Notification sometimes doesn't work, restarting amazfish help.
The second problem is a bit more complicated, but at the moment I do not understand under which circumstances it occurs. I suspect it is related to the notifcations you access.
Normaly I get one notification per conatct (contact name and last message) in the eventsview for messages from whatsapp or sailorgram. When they are marked as read in the web client the notification in the eventview disappear.

While running your app the eventsview show one notification per message from a contact (contact name first message, same contact name second message) and after they are marked as read by the web client on my PC the notification don't disappear from eventview until I delete them. After restarting your app everything was fine again and worked as expected.


cvp's picture

What about translations? Can we help you? I can help to translate to german :)

piggz's picture

Yes, do it on github, somone else is already doing sweding tranlations

cvp's picture

.... done ;)

Okerampa's picture

Thanks ! And we can set the alams now, great :)

Okerampa's picture

I think I got an issue since last version : I cannot go to status/weather/etc. by swiping left or righe. Swipe up and down work... If I connect to Mi Fit on androit, I can again swipe. But each time I reconnect using Amazfish swipe left and right won't work :(

Also, does Amazfish update weather ? I think not, but to be sure ^^

(Xperia X and version 0.6.0)

piggz's picture

settings - device - display items - save

and no, not yet

gomerus's picture

I had the same problem and was wondering what happened. All items where marked, but i didn't try the save button. Maybe it would be good to save when going back instead of having an extra save button?

mousse04's picture

On band2, time selection ia inverted. When selecting 12h, display ia 24h and vice versa ;)!!! But great, very goos app

mousse04's picture

Works with my band 2. In the forecast of supporting officially thr band 2, any chance to be able to set up alarms ? Thanks

cvp's picture

Amazfish Version: 0.5.5 || Amazfit FW Version V0.1.1.36 || SFOS

* The Heartrate Chart dont work on an Xperia X. Ot display only "No data" ... Or i use it wrong ?


piggz's picture

Click the button on the first page to download your data ... keep clicking until it says there is no more data.

You need to turn on all-day-hrm in settings to have it monitor your heartrate all the time.

cvp's picture

Thanks this works for me :) thank you for your work :)

rgrgrg's picture

Thanks for this app!

Couple of questions:

1) any plans for the Stratos?

2) does it integrate at all with something like Laufhelden?


Thanks again!

piggz's picture

1) no, not unless someone donated a device, however I will accept PRs for new devices

2) yes. initially i want to get live HR data to laufhelden

rgrgrg's picture

I'd be willing to chip in a few dollars for that purpose, maybe there are others that are also interested?

bundyo's picture

Thanks, works now!

bundyo's picture

Hmm, seems to depend on some cmake version, at least in 2.2.

piggz's picture

give it a go now ... hopefully fixed it

Okerampa's picture

I don't know if it was corrected since the 5.1.1 version, but with 4.7.1 I could pair only if I had updated my watch before using Mi Fit on an android device. Then it worked flawlessly :) One missing feature in this version : the call number or contact name is not shown, instean only "incoming call' ^^ But thumbs up otherwise !

cvp's picture

Oh nice! My Amazfit Bip arrived today. And the version 0.5.1 has been released :)
I use a Sony Xperia X and the pairing and connecting works! Data is synchronized.

One UI bug: The refresh button for the heart rate monitor shifts to the right as soon as a numbuber is displaed.

I would be glad if more features will appear :)


Amazfit FW VErsion V0.1.1.36 - SFOS

gomerus's picture

With the current version I can connect again too. The connection itself seems much more stable now. The range seems a bit low. More than a meter away and I often get reconnects.

Thaodan's picture

Look on github there's already a bug for this. it's called supported firmware.

gomerus's picture

Hey thanks for the updates. Unfortunately the last two releases it's impossible to pair. Have the same problem as Caluna. But i like your fast progress. Keep it up!
Forgot to say. I'm still on fp2

piggz's picture

please try 0.4.7

gomerus's picture

Unfortunately still the same problem. What information do you need from me to help you debug?

Caluna's picture

Hi Piggz,

Version 0.4.1-1 seems not to connect to the device (SFOS X latest). Version 0.3 works perfectly..

Best C.

piggz's picture

have you re-paired? no problems here, but it was a major change requiring a repair.  there are some issues with multiple notifications, and my dev version is much better.  with a few more features added i will make a release soon.





Caluna's picture

Yes, tried to re-pair. During re-pairing I get a truncated text saying 

Connecting to watch.../org/bluez/hci0/dev_(Mac Adress of my device)



But connection cannot be established - also forgetting and re-pairing of the device in Sailfish BT settings does not help. Maybe next version solves the issue for me...

Edit: 0.4.5-1 does not solve the problem