Amazfish

Rating: 
4.69697
Your rating: None Average: 4.7 (66 votes)

Donations: https://paypal.me/piggz

Companion application for the Huami Amazfit Bip, Cor, MiBand2/3 and GTS

***BUILT FOR 3.4 PLEASE READ OLDER USERS***

Amazfish needs to be built on OBS against a defined set of libraries.  Becuase there is a delay between a Sailfish release and that release being available on OBS, there will be a delay to supporting the latest versions.

For releases of the current version built against other Sailfish releases, use the repositories at :

https://build.merproject.org/project/show/home:piggz:harbour-amazfish and
https://build.merproject.org/project/show/home:piggz:kf5

***PLEASE READ for 1.7.0 Update***

The new sport display feature requires the MapBox component.  The easiest way to get this is by installing PureMaps from rinigus repository.

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 https://github.com/Freeyourgadget/Gadgetbridge/wiki/Amazfit-Bip-Firmware...

App has been tested using an amazfit bip and GTS, downloading the latest (0.1.1.45) 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.

https://github.com/Freeyourgadget/Gadgetbridge/wiki/Huami-Server-Pairing

AGPS Download/Transfer

The official amazfit app can download and transfer the AGPS files to the watch automatically.  The amazfit web site limits download of the files to those with accounts.  A python script has been developped that can download the AGPS files, these can then be transferred to your phone, and downloaded to the watch using the normal "Download File" option.

  • Obtain the script from https://github.com/argrento/huami-token
  • Download the AGPS files using the -g paramter, this will download 2 .zip file.  The only one required is cep_alm_pak.zip
  • Extract the zip and transfer the 2 .bin files to the phone
  • Send the files gps_alm.bin and cep_pak.bin to the watch.

YMMV Devices

  • MiBand 2/3/4
  • Cor
  • GTR
  • Bip-S

These devices are untested and use the existing Bip/GTS backends.  They should be safe but your mileage may vary, and some features may not work.

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.

Implemented

  • Pairing
  • Notifications
  • Calls
  • Some settings
  • Retrieving activities
  • Heartrate Chart
  • Alarms
  • Watchface download
  • Firmware upload
  • Activity Sync

Todo

  • 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.

Tip:
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.

Source: https://github.com/piggz/harbour-amazfish

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.
Screenshots: 
Application versions: 
AttachmentSizeDate
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
File harbour-amazfish-1.6.7-1.armv7hl.rpm3.18 MB22/09/2020 - 00:25
File harbour-amazfish-1.6.8-1.armv7hl.rpm3.18 MB22/09/2020 - 11:29
File harbour-amazfish-1.7.01.7.0.20201010190441.8409c73-1.5.1.jolla_.armv7hl.rpm3.25 MB10/10/2020 - 22:34
File harbour-amazfish-1.7.11.7.1.20201013113553.5d4533a-1.6.1.jolla_.armv7hl.rpm3.25 MB13/10/2020 - 15:03
File harbour-amazfish-1.8.1-1.10.1.jolla_.armv7hl.rpm3.35 MB17/12/2020 - 01:24
File harbour-amazfish-1.8.2-1.11.1.jolla_.armv7hl.rpm3.35 MB18/12/2020 - 23:28
File harbour-amazfish-1.8.5-1.12.1.jolla_.armv7hl.rpm3.38 MB07/01/2021 - 20:31
File harbour-amazfish-1.8.7-1.13.1.jolla_.armv7hl.rpm3.41 MB20/01/2021 - 00:00
File harbour-amazfish-1.9.0-1.14.1.jolla_.armv7hl.rpm3.45 MB21/01/2021 - 12:44
Changelog: 

1.9.0

  • Added strava upload support
  • Allow activities to be deleted from database
  • Fix dbus interface
  • Fix navigation in kirigami

1.8.7

  • Code refactor to make adding more huami devices easier
  • Fixed setting display items / order for Bip
  • Fixed horrible display items screen
  • Fixed alarms page
  • Fixed call notification

1.8.6 (not release for sailfish)

  • Build fixes for other platforms

1.8.5

  • Support for flashing the PInetime Infinitime firmware
  • Support for setting and re-arranging GTS menu items
  • Activities are now saved as TCX, aswell as GPX.  This allows indoor activities to be saved.
  • XML is no longer stored in the database, instead the filename/path is saved.

1.8.2

  • Fix file selection in download page
  • Translation updates
  • Some contributed build fixes

1.8.1 - Includes 1.8.0 which was skipped

  • Reqrite the entire application to use rinigus QML components, enabling cross platform
  • Expermental navigation instructions from Pure Maps
    • On GTS instructions come through the music app
    • On other, instructions are by notifications (may be spammy!)
    • Fix GTS GPS data with duplicate sime stamps
    • Lots of code cleanups

1.7.1

  • Implement AGPS download for Bip/Lite/GTS (See description)
  • Translation updates

1.7.0

  • Added parsing for sport summary data and record data in database
  • Added new sport info page with all activity data and map of route
  • Fixed buttonPressed dbus-signal (contribution from jgibbon)
  • Added untested basic bip-s support

1.6.8

  • Fix application notifications not shown in UI

1.6.7

  • Add support for the activity data format in later GTS firmware
  • Pinetime-JF renamed InfiniTime
  • Add music control for InfiniTime
  • Fix sending goal to watch

1.6.6.

  • Fix uI crash when daemon not running
  • Minor backend fixes

1.6.5

  • 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

1.6.1

  • Fixed repeating alarms

1.6.0

  • 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

1.5.6

  • Fix daemon crash when pairing

1.5.5

  • Fixed sending weather to GTS
  • Refactored weather code
  • Initial support for Pinetime-JF

1.5.1

  • Be more stringent about allowing firmwares to be downloaded
  • Fix timestamps in GPX files

1.5.0

  • 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

 

1.4.5

  • Added heartrate analysis page
  • Moved raw graphs to menu

1.4.0

  • 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!)

1.3.1

  • Darker paercentage circle
  • Fixed service Stop button
  • Load steps on startup for quicker display
  • Translation updates

1.3.0

  • UI improvements thanks to @AlphaX2
  • Note added to sleep page

1.2.0

  • Hopefully fix reading calendar
  • Translation update
  • Start using the supported-features system to hide some UI components when not applicable

1.1.3

  • 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

1.1.2

  • Fix initial pairing with Bip, Miband 3 and maybe others

1.1.1

  • Add support for Bip Lite
  • Allow connection of MiBand3 and Cor (untested, uses the Bip backend)
  • Translation updates

1.1.0

  • Fix alarms being overwritten
  • Initial (beta) support for Amazfit GTS
  • New pairing page and improved pairing

1.0.0

  • 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

0.9.2
Stop notification when call answered
Fix sending weather on interval
Add more languages for watch (only works if supported by FW)

0.9.1
Fixed crash for new users
Weather UI fixes
Whitelisted some more firmware
Translation updates
Bugfixes for daemon/ui split

0.9.0
***ONLY FOR SAILFISHOS >= 3.0.3***
Daemon/UI split
Reworked some pages to streamline them

0.8.9
Add buffer for 10 notifications when watch disconnected

0.8.8
Added deep sleep value to page
Save GPX files in data location not cache location
May install on SFOS 3.0.3 when available

0.8.7
New UI layout
Sleep statistics

0.8.5
Added step summary chart showing steps over previous 20 days from the selected day
Added auto-sync of activity data which occurs each hour

0.8.2
Fixed applying settings from the UI

0.8.1
Hopefully fixed crash introduced in 0.8.0

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

 

0.7.5
Implemented sending weather
Fixed app displaying correct status when watch disconnects
Use correct icon for depecher
Fix layout of HR button

 

0.7.3
Updated translations
Fixed user profile settings page not opening

Comments

carmenfdezb's picture

I can confirm that this bug is fixed in v1.6.1 and alarms work perfect now =). Thank you so much, @piggz!!

Malakay's picture

Hi, on Saturday was at last some time to fiddle with watch. 
I paired my Bip succesfully, but still disconnects randomly. So I decided after an advice on TJC to reflash Bip firmware to 0.1.1.4.5 which is tested (before there was latest 1.6.4.8. version), according description here. I used Amazfish version 1.5.1.1. Disconnecting was much better, not too often as before. Then I updated on latest amazfish version and it seems to be okay now. Sometimes it disconnects (but I don´t know why, my phone is all the time in my pocket and watch on my hand), but almost everytime it reconnects in 2 minutes back. But another problem appeared - every notification on watch is displayed twice. Is there any solution? 

piggz's picture

duplicate notifications is a known issue, ill get to it.

Malakay's picture

So, I tested multiple firmwares and Amazfish versions, still problem with dropping connection. But in another FW there was no problem with multiple notifications. So I don´t know what to do next. I am thinking about getting rid of those watches, it cost me much time and still it is not working properly :'( 
 

urbi's picture

Dear piggz,

Is it possible that the application will support the Amazfit GTR watch?

piggz's picture

Already does in my devel version :D

urbi's picture

It's nice to hear that.

armorica's picture

Any idea on when this will become available? I'm looking for a new (SFOS supported) watch and the GTR looks to be a good option then.

piggz's picture

if you ping @adampigg on telegram, i can send you a version with gtr support, otherwise, just wait a few days :)

chris7chris's picture

Thanks for you app ! Bip is working well.

Georgiy's picture

Hello,Piggz help.no connect bip org.freedesktop.dbus.error.noreply.

Dear Piggz,install version 1.5.1-1, then everything worked, if you update to version 1.5.5-1 stops working,as well as the icons in the app disappear.While I'm on version 1.5.1-1.Fix it.Thanks.

chris7chris's picture

Well, I have resetted now, but I still can't connect htc Androidphone with Gadgetbridge to GTS.
BT turns itself off after a short time and thats it.
Sometimes BT stays on, but no Connection to Watch.

chris7chris's picture

I try to get my GTS working. With Amazfit mod i got the auth key, but Gadgetbridge (from borrowed Android Phone) does not connect to the watch. I tried a lot but no chance (SF OS latest version, XA2). The Bip of my son connected more or less easily to Amazfish. Any advices? Thanks in advance.

piggz's picture

you need to not reset the watch after obtaining the key...also, in GB you prefix the code with 0x, but not in amazfish.

D_R's picture

So I fixed the problem by uninstalling. Then I installed amazfish 1.4.0 paired the device andchecked the graphs. All was ok. Then I upgraded to actual
Amazfish ...

D_R's picture

Okay I've got it. But now I don't have any diagrams again...

eber42's picture

Alarm handling has stopped working in some recent release. Alarm does not show on watch if I do not select some days of week, and if I do it is created as a one shot alarm. Line "int repeatMask = config->alarmRepeatMask(n) ? 128 : 0;"  in MiBandService::setAlarms seem suspicious because it would prevent creating repeating alarms. And at least on bip firmware 1.1.5.16 a 0 value for repeatMask makes the alarm disappear.

carmenfdezb's picture

I have the same issue too. I've set an alarm from Monday to Friday and today it doesn't sound :(
Please, fix this bug, it's important.

D_R's picture

I had to reflash my XA2 yesterday :-(

now I can't install qt-qtconnectivity-qtbluetooth. How can I get this package installed?

zypper search results is package not found ????

eber42's picture

Package name may be qt5-qtconnectivity-qtbluetooth, and zypper can find it in jolla repository

Veraendert's picture

Hi, i did a search but found nothing. Is this supposed to work with Jolla1 & Amazfit Bip ? It should have BT4.0, so technically, it should support BLE, no? Thanks!

nobodyinperson's picture

No, the Jolla 1 unfortunately has no Bluetooth Low Energy (BLE), so no luck there...

Veraendert's picture

Thanks anyway. That way i at least don't have to try any longer.

eber42's picture

It seems file upload, including watchfaces & firmwares, is broken with my Amazfit Bit (hardware rev: V0.11.2.4) since Amazfish version 1.0.0: last working version was 0.9.2. I tried with various watch firmware versions (0.1.1.45, 1.1.5.02, 1.1.5.16). Also you should remove line 46 ("m_type = Invalid;") in bipfirmwareinfo.cpp to enable firmware upload.

Thanks for your great app.

piggz's picture

I have already fixed with unreleased 1.5.0 .... if you contact me on telegram you can test

eber42's picture

Thanks, it works great now. But it seems the pairing dialog is broken unless I manually install qt5-qtconnectivity-qtbluetooth. Maybe you could add it as a required dependency ?

vige's picture

There's still something funny going on with pairing. Today I did a factory reset to my by bip. After that, the first attempt at pairing didn't quite work: amazfish clearly thought that the device had been paired, but the bip just displayed the pairing image. Second attempt worked as expected.

piggz's picture

Did you delete it from the sailfisBT settings page first?  Amazfish may have been reported the old device from bluez.

vige's picture

Sorry, I can't remember anymore :/ I'd say it's quite likely that I had not deleted the old device before the first attempt.

jpn9s's picture

One strange thing in Amazfish 1.4.5: At the moment I have as active two alarms just on Thursday. However these alarms are alarming me every day at set time values. It seems that 'Save settings' - buttoms are stuck somehow inside Alarm-sheet. Is this a bug or what? Otherwise everything works as it should. I have Amazfit Cor & Xperia XA2 SFOS 3.3.0.14.

Addition: I have rebooted twice until now.

Addition: Still continuing after 1.5.0.

Pages