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


piggz's picture

Fixed in 0.4.6 (i hope!)

Caluna's picture

Great! Seems to work. Thank you!!!

piggz's picture

yay, it works for someone not me! what is your phone?

RageZilla's picture

Hi Piggz,

I have the same issue than Caluna on my Xperia X. I can't pair my amazfit Bip with 0.4.6.

piggz's picture

please try 0.4.7

RageZilla's picture

It works now!!


piggz's picture

I believe I know why the watch disconnects after 15 minutes .... hopefully I can fix it, but its a problem that happens on sailfish, not on a linux desktop :/ :(

Caluna's picture

Thank you for the update (0.2-1): Development seems to go quite fast. After update I get each 2-3 minutes a message that the app successfully connected (Sailfish X). Any way to turn this off?

piggz's picture

Not yet ... next version will have a setting for it. For me, it seems to be every 15 minutes it reconnects. Ideally, id like to stop it reconnecting at all, except when genuinely out of range.

Caluna's picture

Hi Piggz,

re-connection message is back again in 0.4.7-1. Any way to turn this off in this version. I was not able to find anything in the settings!?

piggz's picture

At least now the reconnection message only happens when genuinely gone out of range, but i'll had a setting for it in the next version.

gomerus's picture

Hey Thanks for the app. Can amazfish be used to initially connect to the watch? I am trying to connect with my fairphone on version The app seems connected, but i cant use the watch, since its still waiting for pairing? (i accepted the connection on the watch)
is anybody here with a fairphone and trying the same?

piggz's picture

No, not yet. Pair and setup using mifit, then you will get the firmware update. Turn off BT on the android device, then pair with amazfish.

gomerus's picture

Okay, then i have to get someone with an android phone ;)

Caluna's picture

Piggz, that's great. I have to test it with Sailfish X - hope that it works :)

piggz's picture

Yes, would be interesting to know how that works, though I think another dev said it didn't! :( Great to find someone else with both sailfish and a bio!

Caluna's picture

Haha, you refer to my nickname: that's true; it's a leftover from my time as student. Although, botany was not my favorite :)

piggz's picture

Sorry that was meant to say bip, but got auto corrected!

Caluna's picture

No problem: Combination of Sailfish and Bip is a even more narrow niche :) Nevertheless: I was able to test Sailfish X with the Bip I gave to my wife: connection needs some time, but after a while, the connection was established and messages arrived. I did not test, if content of the messagex can also be seen, as I received two of them (so got the messages about two new WA messages)... Great work!!!

jdrescher's picture

Really cool piggz! I don't own one but can we integrate this into Laufhelden? Shame that OPX does not support BLE :-(

piggz's picture

Are you sure it doesn't?  As it's a ported device, perhaps it can be fixed?


On my to-do list is to add support to Laufheldwn to read from the HRM service.  There is scope for major additions, I think I need a database for storing all the sleep/step/heart/GPS data.

jdrescher's picture

Yes it can be fixed, except I don't know how...

Maybe you can do the communication between apps and the watch app via DBUS like in Rockpool. You would have interfaces to populate the current heart rate, battery level of the watch and other things. And it would be nice if apps could display data on the watch via a DBUS interface.

piggz's picture

That's not a bad idea, I always planned on making s dbus service anyway, and splitting my app into front and back end so the GUI doesn't need to be up for notifications.


This watch is quite limited and can't really display info from an app, other than some notifications.  There are no apps, is mainly a tracker + hrm + notifications.