Garmin FIT SDK (Python)

Garmin International, Inc. · also known as garmin-fit-sdk; FIT Python SDK; Flexible and Interoperable Data Transfer SDK

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

Websitedeveloper.garmin.com
VendorGarmin International, Inc.
LicenceSource 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.)
CategoryUtilities and libraries
FunctionsParsing, Decoding
TargetsWearables
Runs onPython 3 (pip install garmin-fit-sdk)
PricingFree to use under the Garmin FIT licence [github.com]
UsersResearch
Last activity2026-11-03 · Release 21.221.0 (commit 'Garmin FIT SDK 21.221.0'); PyPI 21.221.0 uploaded the same day [github.com]
GitHub activitygarmin/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]

Related tools

Guides that discuss this tool

Sources

  1. Garmin developer site: FIT SDK overview (developer.garmin.com)
  2. GitHub: garmin/fit-python-sdk (README) (github.com)
  3. fit-python-sdk LICENSE.txt (Garmin FIT Protocol License Agreement) (github.com)
  4. GitHub: fit-python-sdk releases (21.221.0, 2026-11-03) (github.com)
  5. PyPI JSON: garmin-fit-sdk release list (21.221.0, 2026-11-03) (pypi.org)

Reviewed . Spotted an error? See the corrections policy.