READ THIS FIRST

For some reasons, this is one of the first things that pop up when you enter "Garmin Open Source" into Google. However, I hacked this together in a weekend (when Garmin Connect was down...) and then quickly abandoned it (the fate of so many hobby projects). It is not really in any usable state. There are much better alternatives.

Garmin Disconnect - Open source alternative to Garmin Connect

This allows you to download, store and display data from Garmin watches. No internet connection required (except for displaying maps from OSM).

Not affiliated with Garmin at all.

Initially inspired by: https://www.bunniestudios.com/blog/?p=5863

Only tested with a Garmin Forerunner 235 with metric settings.

How it works

1. Synchronization and parsing (download_and_import.py)

The entire filesystem from your device is downloaded and stored into an SQlite database. Updated/changed files are handled as well. All original data files are retained (we just store the FIT files directly in the database as binary BLOBs).

This means we will never lose any data (e.g. if you reset your device, or the device runs out of storage and deletes old activities), and if we later discover we parsed something the wrong way, we can just parse the original files again. It is possible to restore the file system contents of your watch at any point in time from the database (not implemented yet but the data is there).

The files are then parsed using fitdecode. We store a subset of the data from the FIT files "mostly schemaless" as JSON objects in the database.

2. Query and display data (query.py)

We can then query and display the data. Currently, query.py can list activities, and display single activities at a time. Export to a map HTML file which can be viewed in a browser is included.

The plan is to add a JSON web API to query.py, so the data can be pulled from the DB dynamically and displayed in a web UI.

Installation and Usage

REQUIRES PYTHON 3.8

git clone git@github.com:jo-m/garmin-disconnect.git
cd garmin-disconnect
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# download all data
./download_and_import.py [device root, default = /media/$USER/GARMIN]

# show list of available activities
./query.py list

# show an activity, write map to map.html
# use the id from the leftmost column of `./query.py list` output here
./query.py 56

To Do

• Add web API to query.py, so data can be viewed in a web/Javascript frontend
• Add web/javascript frontend
• Test with more watch models
• UI and web API for synchronization