--- id: fitparse version: "1.2.0" license: MIT License Copyright (c) 2011-2020, David Cooper Copyright (c) 2017-2020, Carey Metcalfe Permission is hereby granted, free of charge, to any person… (full text in the JSON record) license_treatment: permissive maintenance: dormant --- # fitparse — Python library to parse ANT/Garmin .FIT files License: permissive · Maintenance: dormant · Downloads: 130.0K/mo ## What it is and what it does fitparse is a Python library for reading ANT/Garmin .FIT files, a binary format used by fitness devices and sports watches to store activity data. It parses the binary structure and exposes records (such as GPS points, heart rate samples, or device metadata) as Python objects with named fields and optional units. The library includes a command-line tool (fitdump) to convert .FIT files to readable or JSON output. The package has no runtime dependencies and works standalone. However, it is in dormant maintenance: the original author has limited availability and explicitly recommends fitdecode as an alternative. The last release was in 2020, though the repository shows recent commits. High install friction stems from source-only distribution (no wheels). Use this package if you need to parse .FIT files and prefer a minimal-dependency solution, but be aware that bug fixes and new ANT SDK support may be slow or unavailable. Use it for: - Extract GPS coordinates and timestamps from Garmin activity files for analysis or mapping. - Convert .FIT files to JSON or human-readable format via the fitdump command-line tool. - Parse device metadata (manufacturer, serial number, firmware) from .FIT files. - Batch process fitness activity files to aggregate metrics across multiple workouts. - Build a custom data pipeline that reads .FIT files and feeds structured records into a database or analytics tool. ## Worth the install? AI-flagged interpretation of the facts above — verify before relying. Parses ANT/Garmin .FIT binary files, extracting structured data like timestamps, coordinates, and device metrics from fitness device recordings. Yes, if you need to parse .FIT files and can tolerate dormant maintenance. The library is stable for basic use and has no dependencies. However, be aware that the maintainer recommends fitdecode as an alternative and is not actively developing this package. Install friction is high due to source-only distribution. Check whether fitdecode better suits your needs before committing. ## Install pip install fitparse uv add fitparse poetry add fitparse ## Installing fitparse Before you install: High install friction due to source-only distribution. Maintenance is dormant—the maintainer explicitly states limited availability and recommends fitdecode as an alternative. Last release was 2020-09-07, over five years ago. Repository remains active (last commit 2025-01-28) but no new releases are planned. License in practice: MIT License permits commercial and private use with minimal restrictions. You may use, modify, and distribute the code freely provided you retain the copyright and license notice. Quickstart: import fitparse fitfile = fitparse.FitFile("my_activity.fit") for record in fitfile.get_messages("record"): for data in record: print(f"{data.name}: {data.value}") Requires a valid .FIT file; no network or external service dependencies. Verify before relying: - Whether the package works reliably with modern Python versions (requires_python is unspecified in metadata). - Whether fitdecode is a drop-in replacement or requires code changes. - Current state of open issues and pull requests on the repository. ## Package facts - License: MIT License Copyright (c) 2011-2020, David Cooper Copyright (c) 2017-2020, Carey Metcalfe Permission is hereby granted, free of charge, to any person… (full text in the JSON record) (permissive) - Python support: unspecified - Install friction: high - Maintenance: dormant - Downloads: 130.0K/month (top 15,000 on PyPI) - Known vulnerabilities: none known ## Tags parse FIT files, ANT Garmin fitness data, FIT file parser, extract activity data, binary fitness format, Garmin device data, FIT protocol parser, fitness-data, binary-format, dormant-maintenance [View on SkillFed](https://skillfed.io/packages/fitparse) · [View on PyPI](https://pypi.org/project/fitparse/)