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

Are you doing anything specific to cause the crash or does it happen on startup?

marxistavegana's picture

It is giving me a segfault on sfos3.

piggz's picture

Are you doing anything specific to cause the crash or does it happen on startup?

Its working for me, but I didnt do a clean run, ie, with no pairing.  I will check that.  there were a lot of changes in 0.8.0 so i potentially missed something.


Can you post logs from running in a console to github?

cartron's picture

Hi, on which device? I upgraded my Xperia X yesterday to 0.8.0-1, and it works perfectly. Haven't tried yet running to see whether GPX files are OK now, but the rest works fine

cartron's picture

One cool feature I am missing from Rockpool/Pebble: the ability to select which applications can send notifications to the watch.

e.g. having Spotify sending me a notification on my wrist every time the song changes, is a bit annoying! ;)

cartron's picture

Hi @piggz, thanks for Amazfish, it works like a charm for connection with my Amazfit Bip - which I bought just because you created this software for SailfishOS :)

I was about to tell you that I had issues with the GPX from the first run I did with the Amazfit today - completely wrong, 25KM instead of the 11K I did - the overall trace is fine, but the GPX starting point is like 10 KM away from my real starting point.

I saw that you released version 0.8.0-1 today, I will update and will try it with my next run to see.

Thanks again!

piggz's picture

Thanks, let me know if it works.  Ive heard from someone else that it does.

cartron's picture

will try tomorrow! :)

anyway to try again downloading from the watch? I removed the .gpx file in ~/Laufhelden, but it seems there's a cache somewhere, as Amazfish tells me there's no more run to download

cartron's picture

@piggz i confirm GPX file is no longer corrupted, thanks!

rsw75's picture

No new features that I've seen, and the one unofficial set of release notes I saw just said 'bug fixes'. I've recorded a couple more workouts to play with this evening. Will updatel later

rsw75's picture

Possibly co-incidentally but my two runs after amazfit bip had firmware update to have had the gpx files corrupt in the same style. Run shows going due North, then due East for about the total distance run. The route run is then captured at this mystery location. I can edit the gpx file to get rid of the extra straight lines, but the run remains in the wrong location. Any ideas?

piggz's picture

interesting, i can see how that can happen, not helped by the way the damn bip sends its data. the way the datastream works is to send an initial location/time, and all points after that are sent as offsets from the previous point. so, if the first point is wrong, they all will be.




is it wrong by location and time, or just location?




im running and used the gps this weekend and it was fine. perhaps they changed something.  please test more and raise an issue on github. any other new features?

klampfenfreak's picture

Hi, thank you, piggz! Can't import any .kexi file under Arch distribution. Downloaded all related packages. But something is still missing, error shows no details at all. I will give it a try under Linux Mint next days. btw. works nice under Gemini PDA X27

piggz's picture
codeandcreate's picture

You should mention, that it works nicely with Jolla C...

Thanks a lot for this app!

klampfenfreak's picture

Hi all,

I installed Kexi under Arch Linux. But get Import error, wrong kexi format?

piggz's picture

Can you double check that you can open other kexi databases? Should be able to find one online. Make sure all the kexi drivers are installed.  failing that, you can send me the db to check it?

stevexley's picture

Thanks for the app and the ongoing improvements.  I've noticed lately that my Xperia X keeps putting the app to sleep so I don't get notifications.  Is there a simple way to prevent this?

rsw75's picture

Great app, thank you.
I've only just twigged that workouts recorded on my Bip when downloaded with Amazfish appear in Laufhelden ready for sync to Strava. An instance of the solution to a problem being easier on Sailfish than either Android or iOS.

piggz's picture

yes....i wronte strava support for Laufhelden, and didnt see a need to copy the code into Amazfish.

pjr's picture

Just updated my bip firmware(to with Amazfish and it did work!

The sleep tracking would be nice feature.

Where can I buy some beer for this project?

piggz's picture

Also, thanks for being happy with it.  Sleep willl probably be in next+1, and, I rolled back from fw 1.1.2 because it seemed horribly broken, i couldnt use the on screen button when starting a ride for example.  Previous fw was fine.

piggz's picture

There is the `donate` button in settings ;)

elio88's picture

Hi! In some cases the bluetooth connection between the Cor and Xperia X goes down after few minutes with no possibities of a new connection and the only solution is to pair again the devices

piggz's picture

While i cant debug or suport issues with Cor as I dont have one, the next release, which probably wont have any new features, is a hugew refactoring to better enable more devices to be supported.  You just need a dev to step up and write that support.

R1v3r's picture

Propably few stupid questions. So I have been thinking to buy one Bip, but few concerns. So does all notification (e.g. whatsapp, messages, call) work in this watch?


And is there APP for the watch, that it can be used as normal swimcounter? :D (so is there any APPs possible to install?)

piggz's picture

Notifications: yes

The bip does not support apps, you are limited to whats in the firmware.  Is it even waterproof for swimming? Ivbe got mine wet, but not sure on the rating.

R1v3r's picture

Hello. Do you have some forum to send questions/request if possible?

Your app seems to be fine, but is there possible to add watch to vibrate when connected and disconnected?

Easily to recognize if phone is out of reach :)

piggz's picture

the link is in the details ;)

btw ... already app sends message to watch on connect .... not sure how disconnect would work

R1v3r's picture

Thanks for fast answer, as always :)

you mean this github address?

And for disconnecting message seems working on android at least :)