Gadgetbridge is hosted on codeberg.org.

Gadgetbridge

Gadgetbridge is an Android application which will allow you to use your Bluetooth gadgets (mostly wearables like smart watches, but many 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 - Mastodon

Download

• Nightly releases
  • Nightly releases are updated more frequently and may be less stable than standard releases, and they are distributed by our F-Droid repository unlike standard releases.
• List of changes

Fork release verification

This repository may contain changes that are not present in the official Gadgetbridge source. Before publishing any release from this repository, compare the release candidate with the corresponding official upstream revision. Every non-upstream code, resource, configuration, and dependency change must be identified, reviewed, and explicitly confirmed as intended for the release. Record the upstream revision used for the comparison and summarize the included non-upstream changes in the release notes or release checklist. Do not publish the release while the comparison is incomplete or any difference remains unexplained.

Supported Devices

Please see the Gadgets page on the website for a complete list of supported devices.

Features

Please see the Features page on the website.

Network access

The main Gadgetbridge build deliberately does not request Android's INTERNET permission. Features that need network access use the optional Internet Helper add-on and require the user to install it and grant Gadgetbridge access. Build variants that explicitly include direct network access, such as the Bangle.js variant, use Android's INTERNET permission instead.

The Mainland China workday alarm feature works from bundled holiday data while it is available. When the feature is configured, or when the user manually requests a refresh, it uses Gadgetbridge's existing network abstraction to retrieve annual data from the open-source NateScarlet/holiday-cn project. If neither direct network access nor a permitted Internet Helper is available, the refresh fails safely and the feature never falls back to treating ordinary weekdays as authoritative holiday data.

Authors

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)

Contribute

See CONTRIBUTING.md for the contribution policy of Gadgetbridge.

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/

Community

If you would like to get in touch with other Gadgetbridge users and developers outside of Codeberg, you can do so via:

• Matrix: #gadgetbridge:matrix.org

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?

0. Phone crashing during device discovery? Disable Privacy Guard (or similarly named functionality) during discovery.
1. Open Gadgetbridge's settings and check the option to write log files
2. Reproduce the problem you encountered
3. Check the logfile at /sdcard/Android/data/nodomain.freeyourgadget.gadgetbridge/files/gadgetbridge.log
4. 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.

Code Licenses

• Gadgetbridge is licensed under the AGPLv3
• Files in app/src/main/java/net/osmand/ and app/src/main/aidl/net/osmand/ are taken from the OsmAnd project, licensed under the GPLv3 by OsmAnd BV
• Files in app/src/main/java/org/bouncycastle are taken from the Bouncy Castle project, licensed under the MIT license by The Legion of the Bouncy Castle Inc.
• Files in app/src/main/java/com/android/nQuant are taken from the nQuant.android project, licensed under the Apache license by Miller Cy Chan
• Files in app/src/main/java/org/concentus are taken from the Concentus project, licensed under the BSD-3 license by various holding parties
• Files in GBDaoGenerator/src/de/greenrobot are taken from the greenDAO project (Gadgetbridge's fork), licensed under the GPLv3 by Markus Junginger, greenrobot
• File app/src/main/java/nodomain/freeyourgadget/gadgetbridge/util/SearchPreferenceHighlighter.java is taken from SearchPreference, licensed under the MIT license by ByteHamster