Garmin FIT SDK (Python)
Source availableActive
Latest GitHub release 21.221.0 (2026-11-03); PyPI lists 21.221.0 uploaded 2026-11-03, so the registry and GitHub agree. Not tested. The GitHub licence detector reports NOASSERTION; the licence determination above comes from reading LICENSE.txt.
The Garmin FIT SDK for Python is Garmin's official library for decoding and encoding FIT (Flexible and Interoperable Data Transfer) files, the binary format Garmin states is designed for sport, fitness and health device data. The README documents a Decoder that reads a FIT file, checks integrity and returns decoded messages and errors. It is a developer library, not a forensic tool: the documentation describes no device acquisition, evidence handling or deleted-data recovery, and its licence is not open source.
Facts
| Website | developer.garmin.com |
|---|---|
| Vendor | Garmin International, Inc. |
| Licence | Source available (Garmin FIT Protocol License Agreement (LICENSE.txt; GitHub reports NOASSERTION). Not an OSI licence: a non-exclusive, non-transferable, non-sublicensable licence for the licensee's internal business purposes. Section 2 bars, among other things, redistributing or making the technology available to third parties, benchmarking or competitive analysis, safety-critical use, and distributing it so that it becomes subject to a licence requiring source disclosure; section 3 requires FIT interoperability to be maintained; section 5 grants Garmin a licence to the licensee's modifications and feedback; section 4 treats the licensed technology as Garmin's Confidential Information; section 9 lets either party terminate on 30 days' written notice; section 11(g) lets Garmin amend the agreement, with continued use signifying acceptance.) |
| Category | Utilities and libraries |
| Functions | Parsing, Decoding |
| Targets | Wearables |
| Runs on | Python 3 (pip install garmin-fit-sdk) |
| Pricing | Free to use under the Garmin FIT licence [github.com] |
| Users | Research |
| Last activity | 2026-11-03 · Release 21.221.0 (commit 'Garmin FIT SDK 21.221.0'); PyPI 21.221.0 uploaded the same day [github.com] |
| GitHub activity | garmin/fit-python-sdk · 170 stars · last push 2026-11-03 · latest release 21.221.0 (2026-11-03) · checked 2026-11-10 |
Capabilities
- The Garmin FIT overview page states that the FIT protocol is designed for storing and sharing data that originates from sport, fitness and health devices, with predefined messages for information such as activity data, courses and workouts. [developer.garmin.com]
- The README documents a Decoder object that reads a FIT file stream and returns decoded messages grouped by message type together with a list of errors encountered during decoding. [github.com]
- The README documents an Encoder that builds a FIT file as bytes from message dictionaries, so the library can also write FIT files. [github.com]
- The README documents an is_fit check (the 12- or 14-byte header containing the ASCII string .FIT) and a check_integrity method that verifies the header string, that the file size equals header size plus data size plus CRC size, and that the computed CRC matches the file CRC. [github.com]
- The README documents read options that control representation of decoded data, including applying scale and offset, converting datetimes and types to readable values, expanding sub-fields and components, merging heart rates and enabling or disabling the CRC check, plus an optional message-listener callback. [github.com]
- The README states that the SDK is published to PyPI as garmin-fit-sdk and installed with pip. [github.com]
- The Garmin overview page states that the FIT SDK is available for C, C++, C#, Java, JavaScript, Objective-C, Python and Swift, and describes a separate FitCSVTool command-line tool for converting binary FIT files to readable text files. [developer.garmin.com]
Limitations
- The LICENSE.txt in the repository is Garmin's FIT Protocol License Agreement, not an open-source licence; it grants a limited licence for internal business purposes and its use restrictions include no redistribution to third parties, no benchmarking or competitive analysis, and no use in safety-critical applications. This directory classes it as source-available rather than open-source because of those restrictions. [github.com]
- The README documents decoding of FIT files supplied to the library as a stream; it documents no communication with a watch or other device, no cloud download and no forensic acquisition. [github.com]
- The README describes the Read method as catching exceptions raised during decoding and adding them to an errors list, so callers need to check that list; it describes no recovery of damaged or deleted FIT data. [github.com]
Links
Related tools
- GarminDB · Artefact parsers
Guides that discuss this tool
- 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
- Garmin developer site: FIT SDK overview (developer.garmin.com)
- GitHub: garmin/fit-python-sdk (README) (github.com)
- fit-python-sdk LICENSE.txt (Garmin FIT Protocol License Agreement) (github.com)
- GitHub: fit-python-sdk releases (21.221.0, 2026-11-03) (github.com)
- PyPI JSON: garmin-fit-sdk release list (21.221.0, 2026-11-03) (pypi.org)
Reviewed . Spotted an error? See the corrections policy.