Free as in Freedom: Codeberg.org. Create your repos and join us!
Join Donate
A free and cloudless replacement for your gadget vendors' closed source Android applications. Supports Pebble, Mi Band, Liveview, HPlus and more. https://gadgetbridge.org
Nevar pievienot vairāk kā 25 tēmas Tēmai ir jāsākas ar burtu vai ciparu, tā var saturēt domu zīmes ('-') un var būt līdz 35 simboliem gara.
cpfeiffer 373e38eace Merge remote-tracking branch 'github/pr/1424' 2 dienas atpakaļ
.github Update issue templates 5 mēnešus atpakaļ
.settings Enhancement and Fixes for Bengali Transliteration. (#1263) 4 mēnešus atpakaļ
GBDaoGenerator Fix greendao dependency download 4 dienas atpakaļ
app Merge remote-tracking branch 'github/pr/1424' 2 dienas atpakaļ
config Check length of descriptions for F-Droid (#1083) 9 mēnešus atpakaļ
fastlane/metadata/android bump version, add changelog 5 dienas atpakaļ
gradle/wrapper Update gradle to 4.10.2 4 mēnešus atpakaļ
.gitattributes Add .gitattributes for consistent eol handling 4 mēnešus atpakaļ
.gitignore Enhancement and Fixes for Bengali Transliteration. (#1263) 4 mēnešus atpakaļ
.travis.yml try to satisfy travis 2 nedēļas atpakaļ
CHANGELOG.md bump version, add changelog 5 dienas atpakaļ
CONTRIBUTORS.rst Update license headers (fix duplicates) and contributors list 2 dienas atpakaļ
FEATURES.md update feature matrix 5 mēnešus atpakaļ
LICENSE Fix spacing in LICENSE file 1 gadu atpakaļ
LICENSE.artwork Add link to liberapay.com in the main drawer. 1 gadu atpakaļ
README.md fix codeberg links 4 nedēļas atpakaļ
build.gradle Revert "Revert "update gradle plugin"" 4 dienas atpakaļ
gradle.properties Revert "Revert "update gradle plugin"" 4 dienas atpakaļ
gradlew First checkin of actual code 4 gadus atpakaļ
gradlew.bat First checkin of actual code 4 gadus atpakaļ
settings.gradle Work towards using greenDAO #206 2 gadus atpakaļ

README.md

Gadgetbridge

Gadgetbridge is an Android (4.4+) 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

Donate

Build Total Alerts

Download

Get it on F-Droid

List of changes

Supported Devices

  • Amazfit Bip Wiki
  • Amazfit Cor Wiki
  • Casio GB-6900B (WIP)
  • HPlus Devices (e.g. ZeBand) Wiki
  • ID115 (WIP)
  • Lenovo Watch 9 (WIP)
  • Liveview (WIP)
  • Mi Band, Mi Band 1A, Mi Band 1S Wiki
  • Mi Band 2 Wiki
  • Mi Band 3 Wiki
  • NO.1 F1 (WIP)
  • Pebble, Pebble Steel, Pebble Time, Pebble Time Steel, Pebble Time Round Wiki
  • Pebble 2 Wiki
  • Teclast H10, H30 (WIP)
  • XWatch (Affordable Chinese Casio-like smartwatches)
  • Vibratissimo (experimental)
  • ZeTime (WIP)

Features

Please see FEATURES.md

Getting Started (Pebble)

Please this wiki article

How to use (Mi Band 1+2)

  • Invoke the discovery activity 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.
  • In order to display text notifications on the Mi Band 2, you have to install a font on the band.

Features (Liveview)

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

Authors

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)
  • “ladbsoft” (XWatch)
  • Sebastian Kranz (ZeTime)
  • Vadim Kaushan (ID115)
  • “maxirnilian” (Lenovo Watch 9)
  • Andreas Böhler (Casio GB-6900B)

Contribute

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.

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

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

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