🏃‍♂️ Jogging Dashboard

Interactive Python Dash app to visualize, analyze, and explore your jogging or running sessions recorded as GPX/FIT files.

SVG-Export:

Features

Select file choose a data file to analyse your run
export SVG creates an (SVG) image of your "Course" and the "Info Banner" stats (STRAVA-inspired)
Info Banner with total distance, duration, and average pace
Interactive Map View with route trace and start/stop markers
Elevation Profile with relative height and gradient fill
Speed Over Time plot with smoothing and average line
Heart Rate Over Time plot with smoothing and average line (if .fit file)
Deviation from Mean Speed to see pacing consistency
Pace Bar Chart showing per-kilometer pace breakdown

Project Structure

jogging_dashboard_browser_app.py    # Main Dash application (Web-Version)
jogging_dashboard_gui_app.py        # Main Dash application (loading Web-Version in a Gui)
gpx_files/                          # Folder for storing GPX files
fit_files/                          # Folder for storing FIT files
requirements.txt                    # Required Python packages
README.md                           # Project description file

Getting Started

1. Clone the repository

git clone https://github.com/yourusername/jogging-dashboard.git
cd jogging-dashboard

2. Install dependencies

It is recommend using a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

Content of the requirements.txt file:

[Dash & Web Components]

dash
dash-bootstrap-components
plotly
pandas
numpy
scipy
gpxpy
fitparse

[GUI Version (PyQt6)]

PyQt6
PyQt6-WebEngine

[Additional Dependencies (usually automatically installed)]

requests

3. Run the app

python jogging_dashboard_browser_app.py

Then open your browser and go to:
http://127.0.0.1:8051

Or as Gui-Version

python jogging_dashboard_gui_app.py

Uploading Your GPX File

Export your activity (e.g., from Strava, Garmin, etc.) as a .gpx or .fit file
Place the file into the gpx_files/ or fit_files/ directory
Select it via the dropdown in the dashboard

Tech Stack

Dash (by Plotly) for building the UI and graphs
Pandas for data wrangling
Plotly Graph Objects & Express for advanced visuals
Scipy for smoothing the data lines
GPXPy for parsing .gpx files
Numpy for vectorized math and smoothing
FitParse for parsing .fit files

Example GPX File

You can test the dashboard by either placing any valid .gpx file in the gpx_files/ or any valid .fit file in the fit_files/ directory. Make sure it contains track points with elevation and time data.

To Do / Ideas

Plotting heart rate data - if FIT file choosen.
Export as PDF report
Multi-run comparison

License

This project is open source under the MIT License.

Feedback / Contributions

Feel free to open issues or pull requests!
If you enjoy this project, a ⭐️ star is always appreciated.

3.4 KiB Raw Blame History Unescape Escape