fitdecode
FIT file parser and decoder
Decision gist · record as of 2026-08-14
Yes, if you need to parse Garmin FIT files. The package is mature (Beta status since 2018), has no dependencies, installs easily, and covers current Python versions. Maintenance is aging (373 days since last release), but the repository is active and recent updates addressed SDK profile upgrades and edge cases. No known security vulnerabilities. The only caveat is that if you need cutting-edge FIT SDK features, verify that v21.171.0 covers your use case.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >= 3.6; FIT file must be a valid Garmin FIT format file.
- Low friction: pure Python wheel with no runtime dependencies.
- Maintenance status is aging—last release was 373 days ago—but the repository remains active and the package supports current Python versions (3.6 through 3.13).
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects without restriction.
last release 2025-08-06 (373 days) · last repo commit 2025-08-06 · 216 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 103,811 downloads/mo, #12,782 on PyPI
Alternatives
Verify before relying
import fitdecode
with fitdecode.FitReader('file.fit') as fit:
for frame in fit:
if frame.frame_type == fitdecode.FIT_FRAME_DATA:
print(frame.name)- Whether thread-safety guarantees hold across all concurrent access patterns in production use.
- Performance characteristics (speed and memory usage improvements over fitparse) under typical workloads.
- Completeness of FIT SDK profile v21.171.0 coverage for all Garmin device types.
What it is and what it does
fitdecode is a Python library for reading and decoding FIT files—the binary format used by Garmin devices and ANT+ sensors to store fitness and activity data. It provides frame-by-frame parsing via a FitReader context manager, yielding typed objects (headers, definition messages, data messages, CRC footers) that preserve the complete structure of the input file. The library also includes command-line utilities (fitjson and fittxt) to convert FIT files to JSON or text format for inspection and debugging.
Unlike its predecessor fitparse, fitdecode prioritizes thread-safety, speed, and memory efficiency. It retains FIT headers and CRC footers in the output, supports optional CRC validation, and can handle chained (concatenated) FIT files. It also offers binary-level access to records for advanced use cases like file cutting and stitching. The package has no runtime dependencies and installs as a pure Python wheel.
Use it for
- Extract workout metrics (distance, heart rate, cadence) from Garmin device FIT files for analysis or logging.
- Convert FIT files to JSON for integration with web services or data pipelines.
- Debug malformed or non-standard FIT files using human-readable text output.
- Process multiple FIT streams concurrently in a multi-threaded application.
- Validate FIT file integrity and structure before downstream processing.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need to parse Garmin FIT files.
The package is mature (Beta status since 2018), has no dependencies, installs easily, and covers current Python versions. Maintenance is aging (373 days since last release), but the repository is active and recent updates addressed SDK profile upgrades and edge cases. No known security vulnerabilities. The only caveat is that if you need cutting-edge FIT SDK features, verify that v21.171.0 covers your use case.
Install
fitdecode on PyPI
Before you install
Low friction: pure Python wheel with no runtime dependencies. Maintenance status is aging—last release was 373 days ago—but the repository remains active and the package supports current Python versions (3.6 through 3.13).
Requires Python >= 3.6; FIT file must be a valid Garmin FIT format file.
License in practice
MIT license is permissive; you can use, modify, and distribute this package freely in commercial and private projects without restriction.
Quickstart
import fitdecode
with fitdecode.FitReader('file.fit') as fit:
for frame in fit:
if frame.frame_type == fitdecode.FIT_FRAME_DATA:
print(frame.name)Verify before relying
- Whether thread-safety guarantees hold across all concurrent access patterns in production use.
- Performance characteristics (speed and memory usage improvements over fitparse) under typical workloads.
- Completeness of FIT SDK profile v21.171.0 coverage for all Garmin device types.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.6 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Aging 373 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 103,811 / month, #12,782 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: fitdecode-0.11.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “fit file parser”
- fitdecodeParses and decodes FIT files (Garmin's ANT+ fitness data format) into…
- fitparseParses ANT/Garmin .FIT binary files, extracting structured data like…
- fit-toolReads and writes Garmin FIT files for Activity, Workout, and Course…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also fitparse · garmin-fit-sdk · fit-tool · ha-garmin · garminconnect · garth · java-manifest · x690 · ldfparser · hyperframe