Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Strava Calendar

A project to make beautiful visualizations from Strava data. Heavily inspired by the wonderful R library by Markus Volz.


pip install git+git://


First download your data from Strava (see below for how). The last step gives you a zip_path to the archive with all the data. This is quite slow the first time you run it for a zip file and year (~5mins), but quite fast after that (~5s).

from strava_calendar import plot_calendar

plot_calendar(zip_path=zip_path, year=2018)

default plot

You can control how many columns there are, the spacing between months and columns, and the label in the top left:

plot_calendar(zip_path=zip_path, year=2017, n_cols=6, month_gap=1.5, col_gap=1, label='')

custom plot

You can also plot a single column of weeks, which is pleasant.

plot_calendar(zip_path=zip_path, year=2017, n_cols=1)

strip plot

If you want to write more custom code, you can give that a shot, too:

import datetime

import matplotlib.pyplot as plt

from strava_calendar import Plotter, get_data

data = get_data(zip_path, 'running', datetime.datetime(2018, 1, 1), datetime.datetime(2019, 1, 1))

plotter = Plotter(data)

fig, ax = plt.subplots(figsize=(9, 6))

fig, ax, offset = plotter.plot_month(year=2018, month=6, fig=fig, ax=ax)
ax.text(0, offset + 4.2, 'Weeee!', fontdict={'fontsize': 32, 'fontweight': 'heavy'}, alpha=0.5)

month plot

Bulk export from Strava

The process for downloading data is also described on the Strava website:

  1. After logging into Strava, select "Settings" from the main drop-down menu at top right of the screen.
  2. Select "My Account" from the navigation menu to the left of the screen.
  3. Under the "Download or Delete Your Account" heading, click the "Get Started" button.
  4. Under the "Download Request", heading, click the "Request Your Archive" button. Be careful not to delete your account here!
  5. The archive takes a while to be sent. Download the zipped file to a location whose path you know.


Visualizations from Strava data in matplotlib







No releases published


No packages published