1
0
mirror of https://github.com/tiyn/wiki.git synced 2025-10-13 19:31:21 +02:00
Files
wiki/wiki/android/gadgetbridge.md
2025-10-02 01:36:48 +02:00

3.6 KiB

Gadgetbridge

Gadgetbridge is a free and open source software for Android systems. It is a cloudless replacement for proprietary software for smart devices, but is especially designed for smartwatches and smart bands.

Setup

Gadgetbridge is available on F-Droid in a package called gadgetbridge.

Usage

The following section addresses different uses and the configuration of different devices in Gadgetbridge.

Configuration of Devices

Devices can be added to Gadgetbridge by clicking on the + in the main screen. Afterwards the device can simply be paired.

A special pairing procedure is needed for Amazfit or Xiaomi devices. The following describes the steps that need to be done.

  • Download the Zepp app.
  • Pair the device with the Zepp app.
  • Use huami-token to obtain the auth key by using the command python3 huami_token.py --method amazfit --email my_email --password password --bt_keys with adjusted values.
  • Uninstall the Zepp app and unpair the device from inside the bluetooth settings of the smart phone.
  • Inside the Gadgetbridge app click on the +, find the device and enter the auth key by long pressing on the devices name. Afterwards navigate back to the scanning list.
  • Pair the device by clicking on the device name.

Afterwards the device will be paired and connected.

Add Weather Function

For correct displaying of weather data an additional app is needed. This section is based on the official documentation and recommendation that can be found on Gadgetbridges Codeberg page.

An example for this is the Breezy Weather app which is available on the F-Droid store. Install and configure it to your needs. Then check the Gadgetbridge option insdie the Breezy Weather app. Afterwards the weather function will be working.

In the past an application named Weather Notification was often used. The installation and configuration process was similar but an OpenWeather API key had to be specified in the Weather Notification app. For this an account on OpenWeather was needed. Due to different API versions Weather Notification currently does not work. However it is possible that an update to the application will bring a fix in the future.

Install Watchfaces

Watchfaces can be installed by using Gadgetbridges File Installer option that is available in the menu of connected devices. Watchface files for Xiaomi/Amazfit devices can be downloaded on amazfitwatchfaces.com. The same catalog is also available as an Android app on the Google Play Store.

This section is based on a Reddit post by myhairisawesome.

Download Maps

To download one or more map files to display them for activity GPS data on the mobile phone navigate to the main Settings. Then Select Maps and set the Folder aswell as download the map and move it into the selected folder.