{"id":44962,"library":"fitparse","title":"FIT File Parser","description":"Python library to parse ANT/Garmin .FIT files. Current version 1.2.0 provides a high-level interface to read FIT files, including data messages, definitions, and developer fields. Release cadence is low, with no recent updates.","status":"active","version":"1.2.0","language":"python","source_language":"en","source_url":"https://github.com/dtcooper/python-fitparse","tags":["fit","garmin","ant","parser"],"install":[{"cmd":"pip install fitparse","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"","wrong":"","symbol":"FitFile","correct":"from fitparse import FitFile"},{"note":"","wrong":"","symbol":"Record","correct":"from fitparse import Record"},{"note":"","wrong":"","symbol":"FitParseError","correct":"from fitparse import FitParseError"}],"quickstart":{"code":"from fitparse import FitFile\n\nfitfile = FitFile('activity.fit')\nfor record in fitfile.get_messages('record'):\n    for data in record:\n        print(f\"{data.name}: {data.value}\")","lang":"python","description":"Open a FIT file, iterate over 'record' messages, and print field names and values."},"warnings":[{"fix":"Use another library if write support is needed.","message":"The library does not support writing or creating .FIT files. It is read-only.","severity":"gotcha","affected_versions":"all"},{"fix":"Ensure Python 3.6 or newer is used.","message":"Python 2 support was dropped in version 1.0.0. Use Python 3.6+.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Convert: degrees = semicircles * (180.0 / 2**31)","message":"FIT files often use semicircles for latitude/longitude. The library returns raw values; you must convert manually.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"search_vec":"'1.2.0':13 'ant':41 'ant/garmin':8 'cadenc':32 'current':11 'data':25 'definit':27 'develop':29 'field':30 'file':2,10,23 'fit':1,9,22,39 'garmin':40 'high':17 'high-level':16 'includ':24 'interfac':19 'level':18 'librari':5 'low':34 'messag':26 'pars':7 'parser':3,42 'provid':14 'python':4 'read':21 'recent':37 'releas':31 'updat':38 'version':12","created_at":"2026-06-07T12:52:41.992437+00:00","updated_at":"2026-06-07T12:52:41.992437+00:00","problems":[{"fix":"Check if field.value is not None before using.","cause":"Accessing .value on a field that is None (e.g., missing data).","error":"AttributeError: 'NoneType' object has no attribute 'value'"},{"fix":"Upgrade fitparse to the latest version or use a different parser.","cause":"The FIT file uses a protocol version not yet supported by fitparse.","error":"fitparse.exceptions.FitParseError: Unsupported FIT file version"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://www.github.com/dtcooper/python-fitparse","github":"https://www.github.com/dtcooper/python-fitparse","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["analytics"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}