python-fitparse
Open sourceUnmaintained
The README carries a notice that the maintainer has limited to no time and is seeking a maintainer. Latest commit on master 2025-01-28 (a datetime-module update), about 21 months before this review; no GitHub releases are listed and PyPI's latest release is 1.2.0 (2020-09-07). GitHub lists open, unmerged pull requests created in 2026-09 (for example #163 to #165). Not tested.
python-fitparse is a Python library and command-line script (fitdump) for parsing ANT/Garmin .FIT files, the binary activity-file format used by Garmin and other fitness devices. It reads messages such as records, device information and events and can dump them in readable or JSON form. The README describes no forensic workflow, and a README notice says the maintainer has limited to no time for the package and suggests the fitdecode library as an alternative.
Facts
| Website | github.com |
|---|---|
| Vendor | David Cooper (dtcooper), Carey Metcalfe and contributors |
| Licence | Open source (MIT (MIT License text in the repository LICENSE file, copyright 2011-2025 David Cooper and 2017-2025 Carey Metcalfe)) |
| Category | Artefact parsers |
| Functions | Parsing, Decoding |
| Targets | Wearables |
| Runs on | Python (pip install fitparse) |
| Pricing | Free |
| Users | Open-source DFIR community, Research |
| Last activity | 2025-01-28 · Latest commit on master (merge of pull request #147, datetime module update); latest PyPI release 1.2.0 on 2020-09-07 [github.com] |
| GitHub activity | dtcooper/python-fitparse · 828 stars · last push 2025-01-28 · checked 2026-11-10 |
Capabilities
- The README describes the project as a Python library to parse ANT/Garmin .FIT files, installed with pip install fitparse, and shows reading a file with fitparse.FitFile and iterating messages of a given type (such as record, device_info, file_creator or event). [github.com]
- A fitdump command-line script dumps a .FIT file (or stdin) in a readable or JSON format, can filter by message name or number, and has an --ignore-crc option for devices that write invalid CRCs. [github.com]
- The README states that the FIT profile is its own Python module and that the profile generation script supports ANT FIT SDK versions from 1.00 up to 5.10; it also lists component fields and compressed timestamp headers as supported. [github.com]
- The profile.py file shipped on master is stamped as exported from FIT SDK version 20.8 on 2019-03-05, which is newer than the SDK 5.10 ceiling named in the README's change-log section. [github.com]
Limitations
- A notice at the top of the README states that the maintainer has limited to no time to work on the package, is looking for a maintainer for issues and releases, and suggests the fitdecode library (by polyvertex) as an alternative. [github.com]
- PyPI lists 1.2.0 (uploaded 2020-09-07) as the latest release of fitparse; the previous releases were 1.1.0 (2019-02-27), 1.0.1 (2017-10-13) and 1.0.0 (2014-10-24). [pypi.org]
- The README says the public API is still unstable and partially complete, and marks the command-line converters and the field-type normalisation as work in progress. [github.com]
- The README describes no forensic use, hashing, validation reporting or acquisition from a device; it parses FIT files that have already been obtained. [github.com]
Links
Related tools
- Garmin FIT SDK (Python) · Utilities and libraries
- GarminDB · Artefact parsers
- Gadgetbridge · Utilities and libraries
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
- GitHub: dtcooper/python-fitparse (README, LICENSE) (github.com)
- GitHub: python-fitparse master commit history (github.com)
- PyPI JSON: fitparse release list (1.2.0, 2020-09-07) (pypi.org)
- GitHub: python-fitparse pull requests (github.com)
- python-fitparse profile.py (generated profile header) (github.com)
Reviewed . Spotted an error? See the corrections policy.