Strava Stats

A local dashboard for visualising your Strava activity data. Connect your Strava account and explore stats, trends, and charts across all your sports.

Requirements

• Python 3.10+
• A Strava account

Setup

1. Create a Strava API application

1. Go to strava.com/settings/api (log in if prompted)
2. Fill in the form:
   • Application Name: anything you like, e.g. My Stats
   • Category: choose any relevant category
   • Club: leave blank
   • Website: http://localhost (required but not used)
   • Authorization Callback Domain: localhost
3. Click Save and you will be taken to your app's settings page
4. Note down your Client ID and Client Secret — you will need these in the next step

2. Start the server

Clone or download this repository, then in a terminal run:

macOS / Linux:

./start

Windows:

start.bat

The first time you run it, the script will:

• Ask for your Strava Client ID and Client Secret, and save them to a .env file
• Generate a random SESSION_SECRET_KEY automatically
• Create a Python virtual environment
• Install all dependencies
• Start the server at http://localhost:8000

On subsequent runs it skips straight to starting the server.

3. Connect your Strava account

Open http://localhost:8000 in your browser and click Connect with Strava. You will be redirected to Strava to authorise the app, then brought back to the dashboard.

Notes

• Your credentials are stored locally in .env and never leave your machine
• The .env file is excluded from git, so it will not be accidentally committed
• If you need to update your credentials, delete .env and run the start script again