Import from Garmin Connect¶

This page describes how to import all the previously synced data from Garmin Connect to Gadgetbridge.

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.