Fork of Gadgetbridge with initial support for Here Active Listening devices
Go to file
Nicolò Balzarotti 377ceccb30 fix broken git repository 2019-12-21 11:56:31 +01:00
.github Add a checkbox about content polices 2017-07-13 22:26:16 +02:00
GBDaoGenerator Added database migration. 2017-09-10 14:45:09 +02:00
app fix broken git repository 2019-12-21 11:56:31 +01:00
config Update gradle to 3.0, gradle android plugin to 2.2-beta2 2016-08-26 22:27:17 +02:00
fastlane/metadata/android bump version update changelogs 2017-10-04 19:44:21 +02:00
gradle/wrapper Huh, travis doesn't like gradle 4.2 yet!? Trying 4.1 2017-09-28 19:17:46 +02:00
.gitignore More work on firmware detection, recognition and validation #234 2016-03-21 23:42:34 +01:00
.travis.yml travis trial and error 2017-03-03 17:40:52 +01:00 bump version update changelogs 2017-10-04 19:44:21 +02:00
CONTRIBUTORS.rst Update contributors list. 2017-04-26 18:15:27 +02:00 Update 2017-09-19 12:40:12 +02:00
Get_it_on_F-Droid.svg.png run optipng on all pngs 2016-09-21 09:25:33 +02:00
LICENSE Initial commit 2015-01-06 00:19:03 +01:00
LICENSE.artwork Add link to in the main drawer. 2017-08-18 21:51:12 +02:00 Update 2017-09-19 12:34:21 +02:00
build.gradle Update gradle build tools to 2.3.3 2017-07-13 23:48:13 +02:00 Allow in-process dex with 2GB heap, as recommended 2016-05-08 21:39:55 +02:00
gradlew First checkin of actual code 2015-01-07 14:00:18 +01:00
gradlew.bat First checkin of actual code 2015-01-07 14:00:18 +01:00
settings.gradle Work towards using greenDAO #206 2016-03-28 23:18:23 +02:00


Gadgetbridge is an Android (4.4+) application which will allow you to use your Pebble, Mi Band, Amazfit Bit and HPlus device (and more) without the vendor's closed source application and without the need to create an account and transmit any of your data to the vendor's servers.






Gadgetbridge on F-Droid

List of changes

Supported Devices


Please see

Getting Started (Pebble)

  1. Pair your Pebble through the Android's Bluetooth Settings or Gadgetbridge. Pebble 2 MUST be paired though Gadgetbridge (tap on the + in Control Center)
  2. Start Gadgetbridge, tap on the device you want to connect to
  3. To test, choose "Debug" from the menu and play around

For more information read this wiki article

How to use (Mi Band 1+2)

  • When starting Gadgetbridge the first time, it will automatically attempt to discover and pair your Mi Band. Alternatively you can invoke discovery manually via the "+" button. It will ask you for some personal info that appears to be needed for proper steps calculation on the band. If you do not provide these, some hardcoded default "dummy" values will be used instead.

    When your Mi Band starts to vibrate and blink during the pairing process, tap it quickly a few times in a row to confirm the pairing with the band.

  1. Configure other notifications as desired
  2. Go back to the "Gadgetbridge" activity
  3. Tap the Mi Band item to connect if you're not connected yet
  4. To test, chose "Debug" from the menu and play around

Known Issues:

  • The initial connection to a Mi Band sometimes takes a little patience. Try to connect a few times, wait, and try connecting again. This only happens until you have "bonded" with the Mi Band, i.e. until it knows your MAC address. This behavior may also only occur with older firmware versions.
  • If you use other apps like Mi Fit, and "bonding" with Gadgetbridge does not work, please try to unpair the band in the other app and try again with Gadgetbridge.
  • While all Mi Band devices are supported, some firmware versions might work better than others. You can consult the projects wiki pages to check if your firmware version is fully supported or if an upgrade/downgrade might be beneficial.

Features (Liveview)

  • set time (automatically upon connection)
  • display notifications and vibrate


Core Team (in order of first code contribution)

  • Andreas Shimokawa
  • Carsten Pfeiffer
  • Daniele Gobbetti

Additional device support

  • João Paulo Barraca (HPlus)
  • Vitaly Svyastyn (NO.1 F1)
  • Sami Alaoui (Teclast H30)


Contributions are welcome, be it feedback, bugreports, documentation, translation, research or code. Feel free to work on any of the open issues; just leave a comment that you're working on one to avoid duplicated work.

Translations can be contributed via

Do you have further questions or feedback?

Feel free to open an issue on our issue tracker, but please:

  • do not use the issue tracker as a forum, do not ask for ETAs and read the issue conversation before posting
  • use the search functionality to ensure that your question wasn't already answered. Don't forget to check the closed issues as well!
  • remember that this is a community project, people are contributing in their free time because they like doing so: don't take the fun away! Be kind and constructive.

Having problems?

  1. Phone crashing during device discovery? Disable Privacy Guard (or similarly named functionality) during discovery.
  2. Open Gadgetbridge's settings and check the option to write log files
  3. Reproduce the problem you encountered
  4. Check the logfile at /sdcard/Android/data/nodomain.freeyourgadget.gadgetbridge/files/gadgetbridge.log
  5. File an issue at and possibly provide the logfile

Alternatively you may use the standard logcat functionality to access the log.