IF YOU WANT TO EDIT THE WIKI, do so on codeberg.org . The wiki on github.com is a read-only mirror, as is the git repo itself. Issues and PRs will move to codeberg summer 2019, if you want your issue/PR comments migrated properly, please create a codeberg acount before we will migrate.

Obtaining Gadgetbridge

There are multiple ways to get Gadgetbridge:

• Official release channel is done via F-Droid, see listing for Gadgetbridge and we encourage you to install the app through there. This will ensure timely updates and signed packages which are verifiably built from the published source code.

• If you do not have F-Droid installed/cannot install it, you can download official, signed Gadgetbridge apks from the Gadgetbridge listing page and side-load them into your device. You then have to take care of updating yourself.

• You can build Gadgetbridge from source code.

• There is an unofficial, unsupported version at Google Play and we discourage anyone from using it. It is not endorsed by the core team. This app migth not be the latest version and we cannot guarantee that the source code is unmodified. Please see issue #480 for some background, discussion and explanation of why the developers of Gadgetbridge will to not publish into the Play Store.

Pairing/Connecting new device

• It is typically NOT necesarry to install the MiFit app at all. Unfortunatelly, this has been changing over time. New devices and older devices with updated firmware require server based pairing. This means, that you absolutely must use MiFit app to make the initial pairing, retrieve the pairing key and then use this key to pair with Gadgetbridge. Currently, some devices (Mi Band 4, Amazfit Bip Lite, Amazfit GTR and Amazfit GTS) are known to be the first device with this enabled from the beggining. Read page Server based pairing for further details.
• If you have the MiFit app, make sure it is not running. Kill or uninstall it.
• Unpair the band/watch from the phone’s bluetooth.
• Ensure GPS/location services are enabled on your device (this is related to Android permission system, since Android 6).
• Make sure to give Location service permissions to Gadgetbridge.
• Run Gadgedbridge and add new device to Gadgetbridge by pressing the Plus button.
• After the device has been discovered, follow the instructions.
• For further information check out the wiki for details about general configuration, some specifics about your particular device or, FAQ or developer info.