Garmin devices¶

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

Experimental

Support for some of these devices is recent, and still experimental. This page is also still a work in progress and not complete.

List of Garmin watches supported by Gadgetbridge:

List of watches

Other Garmin devices supported by Gadgetbridge:

List of gadgets

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.

List of features supported by Gadgetbridge

Set time
Device info (firmware, model)
Device state (battery, sleep, wearing)
Calendar sync
Notifications
- Notification pictures
- App icons
Calls
Canned messages for calls and notifications
Contacts
Music
- Music Info
- Volume
- Music buttons
Send GPS during workouts
AGPS upload
Activity sync
Realtime Settings
Weather
File upload
- Courses
- Workouts
- PRG apps
AGPS updates (see below)

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¶

Open issues

Do not forget to check any other open issues in the project repository.

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
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".

Official app

Do not enable if you plan on using the official app or connect the device to the internet. After enabling this setting, your device credentials will be invalid, and you may need to factory reset the device to authenticate again.

Import Historical Data from Garmin Connect¶

1. Export Your Garmin Data¶

To start, you need to export all your Garmin data from Garmin Connect.

Navigate to the Garmin Account Data Management page.
Sign in to your Garmin account.
- If you are already signed in, skip this step
Select Export Your Data.
Click on Request Data Export.
- Your request will be submitted, and you will receive an email with a download link. The link usually arrives within 48 hours, but it can take up to 30 days to be sent.
- Note: For individual activity data to upload to a new account or third-party site, you can find it by navigating to DI_CONNECT > DI-Connect-Uploaded-Files and opening the .zip files inside.

Alternative: Manual Steps from Garmin Support¶

If you prefer not to visit the link, here are the steps directly from Garmin Support:
1. Go to Garmin Support.
2. Follow the steps listed under "Export All Garmin Data Using Account Management Center" to export your data.

2. Download Your Exported Data¶

Once you receive the export email from Garmin: - Click the Download button in the email. - Save the exported file to your preferred folder.

3. Unzip the Data Export¶

Extract the contents of the exported .zip file.

4. Extract Files from the `.zip`¶

Inside the unzipped folder, navigate to DI_CONNECT > DI-Connect-Uploaded-Files.
Extract any additional .zip files contained within this folder.

Files from multiple devices

The export will include files from all devices connected to the Garmin account. If there is overlapping data across multiple devices, Gadgetbridge might display wrong data (eg. duplicated steps).

You can use the following python script to take all fit files in a directory and split them across one directory per device. The directories will include the device's serial number as a suffix.

Click here to download the script.

Usage, if you have uv installed:

uv run garmin-split-fit-by-device.py <path>

Or, if you do not have uv, install python-fitparse and run:

python3 garmin-split-fit-by-device.py <path>

5. Connect Your Android Phone¶

You have two options for transferring the data to your Android phone: MTP (Media Transfer Protocol) or ADB (Android Debug Bridge).

Option A: Using MTP (Recommended for smaller file counts)¶

Plug your Android phone into your computer using a USB cable.
Enable File Transfer on your Android phone.
- This option will allow you to drag and drop files.

Option B: Using ADB (Recommended for larger file counts)¶

Enable USB Debugging in Developer Options.
How to enable Developer Options
Once USB Debugging is enabled, connect your phone to the computer.

6. Transfer the Data to Your Android Device¶

Depending on which method you are using, follow one of the options below.

Option A: Using MTP¶

Navigate to the extracted .zip folder and drag the files into the following folder on your Android device:

Path on Android:

/Android/data/nodomain.freeyourgadget.gadgetbridge/files/MAC:ADDRESS:HERE:XX:XX:XX/

Option B: Using ADB¶

Open the terminal on your computer and run the following commands:
Check if your device is recognized:
```
adb devices
```
- Ensure your device is listed.

Push the files to your Android device:

find ~/PATH/TO/DI_CONNECT/DI-Connect-Uploaded-Files/UploadedFiles_0-_Part1/ -type f -print0 | xargs -0 -I {} adb push {} /storage/emulated/0/Android/data/nodomain.freeyourgadget.gadgetbridge/files/MAC:ADDRESS:HERE:XX:XX:XX/

7. Re-process all files¶

Once the files are successfully transferred, open the Gadgetbridge app on your Android phone.

Tap the ⚙️ icon in the device card.
Tap on Developer settings.
Tap on Reprocess activity files.

Once the Scan Files notification completes, your historical Garmin Connect data should now appear in Gadgetbridge.

Additional Notes:¶

If you're having issues with ADB or the MTP transfer method, make sure USB Debugging is enabled and that your device is correctly connected.
If the data doesn't appear immediately in Gadgetbridge, try restarting the app or your phone.