A free and cloudless replacement for your gadget vendors' closed source Android applications. See the list for supported devices. https://gadgetbridge.org
Go to file
José Rebelo 376956bbe9 Xiaomi: Improve activity fetch logging 2023-12-04 09:46:49 +00:00
.gitea Make some clarifications to issue template for Device request 2022-09-15 19:59:37 +02:00
.idea/dictionaries Updated the dictionary to ignore more false positives (#1995) 2020-08-27 22:00:11 +02:00
.settings Enhancement and Fixes for Bengali Transliteration. (#1263) 2018-10-01 23:04:51 +02:00
.woodpecker Update CI to use jdk17 and build tools 33.0.2: 2023-10-08 22:23:05 +02:00
GBDaoGenerator Mi Band 8: Persist bedtime and wakeup times to database 2023-12-01 21:35:29 +00:00
app Xiaomi: Improve activity fetch logging 2023-12-04 09:46:49 +00:00
config remove travis-ci related files 2021-09-25 15:18:05 +02:00
external Fossil/Skagen Hybrids: Update navigationApp to version 1.0 2023-11-02 16:33:21 +01:00
gradle/wrapper Mi Watch Lite test based on miband 8 branch 2023-11-25 21:16:52 +00:00
src bump version, update changelogs 2023-09-16 22:58:50 +02:00
.gitattributes Add .gitattributes for consistent eol handling 2018-09-20 00:05:15 +02:00
.gitignore add app/.cxx/ to .gitignore 2021-09-07 21:52:49 +02:00
.gitmodules Fossil/Skagen Hybrids: Add new navigation app 2023-10-18 13:06:16 +00:00
CHANGELOG.md Update README and changelog 2023-11-29 21:34:57 +00:00
CONTRIBUTORS.rst update license headers 2021-01-10 23:38:13 +01:00
FEATURES.md Fixing the table because I made a mess 2020-08-02 16:44:01 +02:00
LICENSE Fix spacing in LICENSE file 2017-11-01 14:58:43 +01:00
LICENSE.artwork Add flipper device icon 2022-09-07 16:56:28 +02:00
README.md Mi Watch Color Sport: Experimental support 2023-12-02 11:56:23 +00:00
build.gradle bump android gradle plugin 2022-04-07 21:55:04 +02:00
gradle.properties Update CI to use jdk17 and build tools 33.0.2: 2023-10-08 22:23:05 +02:00
gradlew Update gradle wrapper to 7.2 2023-10-04 22:24:41 +01:00
gradlew.bat Update gradle wrapper to 7.2 2023-10-04 22:24:41 +01:00
settings.gradle Work towards using greenDAO #206 2016-03-28 23:18:23 +02:00


Gadgetbridge is now hosted on codeberg.org.

Get it on Codeberg


Gadgetbridge is an Android (5.0+) application which will allow you to use your Pebble, Mi Band, Amazfit Bip 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.

Homepage - Blog - Wiki - Mastodon



Code Licenses

  • Gadgetbridge is licensed under the AGPLv3
  • Files in app/src/main/java/net/osmand/ and app/src/main/aidl/net/osmand/ are licensed under the GPLv3 by OsmAnd BV
  • Files in app/src/main/java/org/bouncycastle are licensed under the MIT license by The Legion of the Bouncy Castle Inc.


Get it on F-Droid

List of changes

Supported Devices

(WARNING: Some of them WIP and some of them without maintainer)

Special Pairing Procedures

Some Huami / Amazfit / Mi / Zepp devices can only be paired with Gadgetbridge using a secret key that has to be obtained once using the proprietary app with an account. Detailed instructions in the wiki: Huami Server Pairing

The Fossil Hybrid HR also requires using the proprietary app, but with a more complicated procedure. Details in the wiki: Hybrid HR.


Please see FEATURES.md


Core Team (in order of first code contribution)

  • Andreas Shimokawa
  • Carsten Pfeiffer
  • Daniele Gobbetti
  • Petr Vaněk

Additional contributors

  • João Paulo Barraca (HPlus)
  • Vitaly Svyastyn (NO.1 F1)
  • Sami Alaoui (Teclast H30)
  • "ladbsoft" (XWatch)
  • Sebastian Kranz (ZeTime)
  • Vadim Kaushan (ID115)
  • "maxirnilian" (Lenovo Watch 9)
  • "ksiwczynski", "mkusnierz", "mamutcho" (Lenovo Watch X Plus)
  • Andreas Böhler (Casio)
  • Jean-François Greffier (Mi Scale 2)
  • Johannes Schmitt (BFH-16)
  • Lukas Schwichtenberg (Makibes HR3)
  • Daniel Dakhno (Fossil Q Hybrid, Fossil Hybrid HR)
  • Gordon Williams (Bangle.js)
  • Pavel Elagin (JYou Y5)
  • Taavi Eomäe (iTag)
  • Erik Bloß (TLW64)
  • Yukai Li (Lefun)
  • José Rebelo (Roidmi, Sony Headphones, Miband 7)
  • Arjan Schrijver (Fossil Hybrid HR watchfaces)


Contributions are welcome, be it feedback, bug reports, 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.

Developer documentation - Support for a new Device - New Device Tutorial

Translations can be contributed via https://hosted.weblate.org/projects/freeyourgadget/gadgetbridge/


If you would like to get in touch with other Gadgetbridge users and developers outside of Codeberg, you can do so 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.
  • Do not ask for help regarding your own projects, unless they are Gadgetbridge related

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 https://codeberg.org/Freeyourgadget/Gadgetbridge/issues/new/choose and possibly provide the logfile

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