#fit #garmin #data #json-file #messages #output #read

bin+lib rusty-but-fit

Read Garmin's .FIT files and output them as JSON

3 releases (breaking)

0.5.0 Jul 2, 2024
0.4.0 Jun 21, 2024
0.3.0 Jun 21, 2024

#672 in Parser implementations

Download history 162/week @ 2024-06-15 66/week @ 2024-06-22 161/week @ 2024-06-29 33/week @ 2024-07-06 31/week @ 2024-07-27 32/week @ 2024-09-14 21/week @ 2024-09-21 40/week @ 2024-09-28

93 downloads per month

MIT license

215KB
7K SLoC

Garmin .FIT parser

crates.io

A project to get a little bit more familiar with rust-lang.

The tool itself parses .FIT files and converts it to JSON-formatted messages.

At the moment heavy work in progress... but you can already try it out.

Install

cargo install rusty-but-fit

Commands

Parsing for Garmin's FIT file format

Usage: rusty-but-fit [OPTIONS] --file <FILE> <COMMAND>

Commands:
  summary   Create summary of all messages and their count
  messages  Return messages defined by the -m parameter
  raw       Outputs all messages, incl. unknown messages and invalid fields
  help      Print this message or the help of the given subcommand(s)

Options:
  -f, --file <FILE>     FIT file to parse
  -d                    Debug output (cannot be piped to jq)
  -u, --unknown-fields  Output unknown fields
  -i, --invalid-values  Output invalid values
  -h, --help            Print help
  -V, --version         Print version

Examples

summary command

Output message types in the file and their count:
rusty-but-fit -f activity2.fit summary
{
  "Lap": 1,
  "Session": 1,
  "Time in zone": 2,
  "GPS Metadata": 1826,
  "Totals": 1,
  "Record": 382,
  "Unknown": 2004,
  "Sport": 1,
  "Training file": 2,
  "Activity": 1,
  "Zones target": 1,
  "Device settings": 1,
  "Connected devices (undocumented)": 1,
  "Event": 7,
  "User profile": 1,
  "Device info": 20,
  "File Id": 1,
  "File creator": 1
}

messages command

messages arguments
Return messages defined by the -m parameter

Usage: rusty-but-fit --file <FILE> messages [OPTIONS]

Options:
  -m, --message_type <MESSAGE_TYPE>  Message types as enumerated from 'summary' command. Can be repeated for multiple messages.
  -h, --help                         Print help
Get messages of a certain type
rusty-but-fit -f activity2.fit messages -m "Activity"
{
  "local_timestamp": 1078141854,
  "num_sessions": 1,
  "type": "Manual",
  "event": "Activity",
  "timestamp": 1078138254,
  "event_type": "Stop",
  "total_timer_time": 1717468
}
Read positional data from Record type

This might need some conversion from semicircle to degrees.

rusty-but-fit -f activity2.fit messages -m 'Record' | jq --argjson conversion "$((2**31))" '.[].message | {lon: (."position_long" * 180/$conversion), lat: (."position_lat" * 180/$conversion)}'
...
{
  "lon": 10.557905668392777,
  "lat": 52.23186925984919
}
{
  "lon": 10.557780275121331,
  "lat": 52.231866996735334
}
{
  "lon": 10.557699054479599,
  "lat": 52.23186397925019
}
{
  "lon": 10.55741960182786,
  "lat": 52.231861716136336
}
...

Dependencies

~2–3MB
~58K SLoC