Garmin devices¶

The following list includes all implemented features for Garmin devices. The actual supported features can vary for each device.

List of Garmin watches supported by Gadgetbridge:

Other Garmin devices supported by Gadgetbridge:

Implemented features¶

These features are supported by Gadgetbridge and apply to all Garmin models included in this page. Note that actual available features per device depends on the device capabilities.

Activity Sync¶

The following fit file types are fetched from the device and saved in the phone's internal storage:

• Activity (workouts)
• Monitor (daily activity)
  • Steps
  • Distance
  • Calories
  • Heart rate
  • SpO2
  • Stress
  • Body energy
  • Intensity minutes
  • Respiratory rate
  • Metabolic rate
  • Resting heart rate
• Metrics (not parsed)
• Changelog (not parsed)
• HRV values and summary
• Skin temperature (not parsed)
• Sleep
  • times and sleep stages, including naps
  • score
  • only on devices that provide them - see known issues below

Pairing¶

Some devices like the Forerunner 165 need to be put in "pairing mode" for Gadgetbridge to be able to find them.

• In the device, find a "Pair phone" option
• Your device might now show a QR code - you can ignore it and simply pair on Gadgetbridge

Some devices might have issues pairing if not connected at least once to the official app - see issue #3963. So far, this has been reported to happen in the following devices:

• Instinct 2S
• Fenix 5 Plus
• Fenix 5X Plus
• Forerunner 245 Music

On these devices, you might see that pairing fails. However, if you go back and fill out the user information on the watch, it should allow you to continue, and Gadgetbridge will then work.

Known issues¶

• Activity sync sometimes gets stuck (eg. Fenix 7S)
• Sleep stages are only supported on devices that are able to display them without a phone connection - issue #4048
  • Sleep tracking only works on watches that support sleep "glances" or "widgets". On other (usually older) devices, Gadgetbridge might display sleep almost all day, since the watches are not able to compute sleep without a connection to the official app.
• Some newer devices do not sync all activity data
  • Please enable "New sync protocol" and "Multi-link Reliable" in the "developer settings" for your device. If you face this issue, please provide feedback as an issue or reach out on Matrix, so that we know the new protocol works.
  • More information in issue #5021
• Some workouts do not get synced
  • If some workouts do not show up in Gadgetbridge, try to enable "new sync protocol" in device settings → developer settings
  • If they are still missing, connect the watch to a computer and check whether they are under Activity/PendingHD. This is a known issue even in the official app. Please disable System → Advanced → Data Recording → Position Enhancement.

Missing features¶

• User information
• Settings on older devices
• Alarms (supported on some devices)
• Hydration reminder
• App management

There are more missing features that are not listed here.

Weather¶

Weather updates require authentication - see the Authentication section.

AGPS updates¶

Devices fetch AGPS updates periodically, by sending HTTP requests directly. Gadgetbridge intercepts these requests and sends a file from the local phone storage. These can be configured from the "Location" page in the device preferences.

AGPS updates require authentication on some devices - see the Authentication section.

Authentication¶

Some functionalities such as weather and AGPS updates require the device to be authenticated with valid credentials. These must be refreshed every 90 days for these functions to continue working.

Gadgetbridge supports sending fake credentials, so that the device stays in an authenticated state - you can enable this in the "Authentication" settings page, by selecting "Send fake OAuth responses".

Import Historical Data from Garmin Connect¶

See Import from Garmin Connect.