fit-activities-rerun

Load *.fit file data and stream it into Rerun.io for interactive visualization of fitness activities.

Features:

• Map views: OpenStreetMap (default) or Mapbox (access token required)
• Charts: speed, heart rate, altitude, temperature
• Summary info panel
• Free and open source

Table of Contents

• Preview
• Requirements
• CLI
• License

Preview

Dark theme

Light theme

Requirements

With Nix (recommended)

cd into root directory. If you have direnv installed, run direnv allow once to install dependencies. Otherwise run nix develop. This will set up Python, uv, and all system dependencies you need.

Without Nix

• Python 3.13+
• uv

Setup:

uv venv .venv
source .venv/bin/activate
uv sync

CLI

fit-activities-rerun --help

usage: fit-activities-rerun [-h] --fit FIT [--blueprint {none,vertical}] [--map {osm,dark,light,streets,satellite}] [--headless] [--connect] [--serve] [--url URL] [--save SAVE] [--stdout]

Visualize `*.fit` data using Rerun.

options:
  -h, --help            show this help message and exit
  --fit FIT             Path to the .fit file. (required)
  --blueprint {none,vertical}
                        Blueprint to use. (default: vertical)
  --map {osm,dark,light,streets,satellite}
                        Map tile style. To use styles other than 'osm', set the environment variable RERUN_MAPBOX_ACCESS_TOKEN. (default: osm)
  --headless            Don't show GUI
  --connect             Connect to an external viewer
  --serve               Serve a web viewer (WARNING: experimental feature)
  --url URL             Connect to this Rerun URL
  --save SAVE           Save data to a .rrd file at this path
  --stdout              Log data to standard output, to be piped into a Rerun Viewer

Usage

fit-activities-rerun --fit <path-to-fit-file>

Example

fit-activities-rerun --fit ./data/fitdecode/Edge810-Vector-2013-08-16-15-35-10.fit

Customize MapView

To use a map tile style other than the default osm (OpenStreetMap), set a Mapbox access token as the environment variable RERUN_MAPBOX_ACCESS_TOKEN:

• A) In .env:

  RERUN_MAPBOX_ACCESS_TOKEN=your_token

  See .env.example for reference.

• B) Or by exporting it directly:

  export RERUN_MAPBOX_ACCESS_TOKEN=your_token
  fit-activities-rerun --fit activity.fit

• C) Or by setting it in Rerun's Settings -> Map view -> Mapbox access token.

License

MIT