GarminDB
Open sourceActive
Latest GitHub release v3.9.0 (2026-08-23); PyPI lists 4.0.0 uploaded 2026-09-16 (no matching GitHub release or tag as of 2026-10-30). Latest commits: develop 2026-10-28, master (default branch) 2026-10-15. Not tested. The wiki says the Fitbit CSV import was written for the maintainer's historical data and that no more work is planned in that area.
GarminDB is a set of Python scripts that download a user's own health and activity data from Garmin Connect, or copy it from a locally connected Garmin watch, and import it into SQLite databases with daily, weekly, monthly and yearly summaries. It keeps the downloaded JSON and FIT files so the databases can be rebuilt. It is a personal-data tool: the README describes no forensic purpose, evidence handling or examination of a seized device.
Facts
| Website | github.com |
|---|---|
| Vendor | Tom Goetz (tcgoetz) and contributors |
| Licence | Open source (GPL-2.0 (GPLv2 text in the repository LICENSE file; GitHub reports GPL-2.0)) |
| Category | Artefact parsers |
| Functions | Parsing, Analysis, Cloud extraction |
| Targets | Wearables, Cloud services |
| Runs on | Python 3 (pip install garmindb) |
| Pricing | Free |
| Users | Open-source DFIR community, Research |
| Last activity | 2026-10-28 · Latest commit on the develop branch (not all activity details JSON have a eventTypeDTO); master's latest commit is 2026-10-15; PyPI 4.0.0 uploaded 2026-09-16 [github.com] |
| GitHub activity | tcgoetz/GarminDB · 3,366 stars · last push 2026-11-02 · latest release v3.9.0 (2026-08-23) · checked 2026-11-10 |
Capabilities
- Downloads and imports Garmin daily monitoring files (all-day heart rate, activity, climb/descend, stress, intensity minutes) from the user's Garmin Connect Daily Summary page, extracts sleep, weight and resting heart rate data as JSON, and downloads activity files including lap and record entries. [github.com]
- Stores data in SQLite databases (the backend the README documents), creates summary tables for daily, weekly, monthly and yearly data, and retains the downloaded JSON and FIT files so the database can be regenerated without re-downloading from Garmin Connect. [github.com]
- A pull request (#316) merged into the develop branch on 2026-05-29 adds an optional PostgreSQL backend configured through the JSON configuration file; its description says existing SQLite and MySQL users see no behaviour change. The merge commit is included in release v3.9.0. [github.com]
- Can export activities as TCX files and graph data from the command line or with the supplied Jupyter notebooks; the README suggests SQLite browsers for viewing the databases. [github.com]
- The wiki describes importing data from a locally connected watch instead of downloading from Garmin Connect, using a user-submitted Windows recipe in which the watch is mounted as a drive (MTP) and the --copy option is run. [github.com]
Limitations
- The documented Garmin Connect workflow requires the account holder's Garmin Connect username and password in a local configuration file. [github.com]
- The README states the scripts were developed on macOS and that information or patches for other platforms are welcome. [github.com]
- The README notes that after a code update a DB schema change can raise a version exception that requires rebuilding the databases (garmindb_cli.py --rebuild_db) from the previously downloaded data files. [github.com]
Links
Related tools
- DB Browser for SQLite · Utilities and libraries
- Garmin FIT SDK (Python) · Utilities and libraries
Guides that discuss this tool
- Cloud extraction: tokens, backups and legal process · Three routes to phone data in the cloud: provider legal process, credential or token tools, and account-holder export, with Apple, Google and SWGDE sources.
- Wearable forensics: Apple Watch, Wear OS and fitness trackers · Where smartwatch and fitness-tracker data sits (watch, phone, cloud, exports), what Apple and Google document, dated vendor claims, and the gaps.
Sources
- GitHub: tcgoetz/GarminDB (README, LICENSE) (github.com)
- GarminDB wiki: Usage (github.com)
- GitHub: GarminDB commit history (github.com)
- GitHub: GarminDB releases (github.com)
- GitHub: GarminDB develop-branch commit history (github.com)
- GitHub: GarminDB pull request #316 (PostgreSQL backend) (github.com)
- PyPI JSON: garmindb release list (4.0.0, 2026-09-16) (pypi.org)
Reviewed . Spotted an error? See the corrections policy.