1
0
mirror of https://codeberg.org/Freeyourgadget/Gadgetbridge synced 2024-11-14 05:59:26 +01:00
Gadgetbridge/README.md
2020-07-31 23:24:36 +02:00

6.3 KiB

Gadgetbridge is now hosted on codeberg.org

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 Code Quality: Java Total Alerts Translate

Download

Get it on F-Droid

List of changes

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

  • Amazfit Bip Wiki
  • Amazfit Bip Lite (WARNING: NEEDS MI FIT WITH ACCOUNT ONCE) Wiki
  • Amazfit Bip S (WARNING: NEEDS MI FIT WITH ACCOUNT ONCE)
  • Amazfit Cor Wiki
  • Amazfit Cor 2 Wiki
  • Amazfit GTR (WARNING: NEEDS MI FIT WITH ACCOUNT ONCE) Wiki
  • Amazfit GTS (WARNING: NEEDS MI FIT WITH ACCOUNT ONCE) Wiki
  • Amazfit T-Rex (WARNING: NEEDS MI FIT WITH ACCOUNT ONCE)
  • BFH-16
  • Casio GB-6900B
  • Fossil Hybrid HR (WARNING: NEEDS FOSSIL APP WITH ACCOUNT ONCE AND COMPLICATED PROCEDURE) Wiki
  • Fossil Q Hybrid
  • HPlus Devices (e.g. ZeBand) Wiki
  • iTag
  • ID115
  • JYou Y5
  • Lenovo Watch 9
  • Lenovo Watch X (Plus) Wiki
  • Liveview
  • Makibes HR3
  • Mi Band, Mi Band 1A, Mi Band 1S Wiki
  • Mi Band 2 Wiki
  • Mi Band 3 Wiki
  • Mi Band 4 (WARNING: NEEDS MI FIT WITH ACCOUNT AND ROOT ONCE) Wiki
  • Mi Band 5 (WARNING: NEEDS MI FIT WITH ACCOUNT AND ROOT ONCE) Wiki
  • Mi Scale 2 (Currently only displays a toast after stepping on the scale)
  • NO.1 F1
  • Pebble, Pebble Steel, Pebble Time, Pebble Time Steel, Pebble Time Round Wiki
  • Pebble 2 Wiki
  • Teclast H10, H30
  • TLW64
  • XWatch (Affordable Chinese Casio-like smartwatches)
  • Vibratissimo (Experimental)
  • ZeTime Wiki

Features

Please see FEATURES.md

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)
  • "ksiwczynski", "mkusnierz", "mamutcho" (Lenovo Watch X Plus)
  • Andreas Böhler (Casio GB-6900B)
  • 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)

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/

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 - The most active channel
  • IRC: #gadgetbridge on Freenode

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 and possibly provide the logfile

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