{"id":17202041,"url":"https://github.com/colcarroll/strava_calendar","last_synced_at":"2025-04-07T11:10:18.919Z","repository":{"id":148526344,"uuid":"164723275","full_name":"ColCarroll/strava_calendar","owner":"ColCarroll","description":"Visualizations from Strava data in matplotlib","archived":false,"fork":false,"pushed_at":"2024-12-10T03:16:04.000Z","size":766,"stargazers_count":95,"open_issues_count":2,"forks_count":7,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-31T10:05:56.766Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ColCarroll.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-08T20:00:43.000Z","updated_at":"2025-03-27T00:57:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"9103b49f-e75d-4c2f-986f-88ee87e38baf","html_url":"https://github.com/ColCarroll/strava_calendar","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ColCarroll%2Fstrava_calendar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ColCarroll%2Fstrava_calendar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ColCarroll%2Fstrava_calendar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ColCarroll%2Fstrava_calendar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ColCarroll","download_url":"https://codeload.github.com/ColCarroll/strava_calendar/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247640465,"owners_count":20971557,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-15T02:13:23.749Z","updated_at":"2025-04-07T11:10:18.893Z","avatar_url":"https://github.com/ColCarroll.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Strava Calendar\n\nA project to make beautiful visualizations from Strava data. Heavily inspired by the [wonderful R library by Markus Volz](https://github.com/marcusvolz/strava).\n\n## Install\n\n```python\npip install git+git://github.com/colcarroll/strava_calendar.git\n```\n\n## Use\n\nFirst 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).***\n\n```python\nfrom strava_calendar import plot_calendar\n\nplot_calendar(zip_path=zip_path, year=2018)\n```\n\n![default plot](https://github.com/colcarroll/strava_calendar/blob/main/samples/sample_1.png \"Default plot\")\n\n\nYou can control how many columns there are, the spacing between months and columns, and the label in the top left:\n\n```python\nplot_calendar(zip_path=zip_path, year=2017, n_cols=6, month_gap=1.5, col_gap=1, label='')\n```\n\n![custom plot](https://github.com/colcarroll/strava_calendar/blob/main/samples/sample_2.png \"Custom Plot\")\n\nYou can also plot a single column of weeks, which is pleasant.\n\n```python\nplot_calendar(zip_path=zip_path, year=2017, n_cols=1)\n```\n\n![strip plot](https://github.com/colcarroll/strava_calendar/blob/main/samples/sample_3.png \"Strip Plot\")\n\nIf you want to write more custom code, you can give that a shot, too:\n\n```python\nimport datetime\n\nimport matplotlib.pyplot as plt\n\nfrom strava_calendar import Plotter, get_data\n\ndata = get_data(zip_path, 'running', datetime.datetime(2018, 1, 1), datetime.datetime(2019, 1, 1))\n\nplotter = Plotter(data)\n\nfig, ax = plt.subplots(figsize=(9, 6))\n\nfig, ax, offset = plotter.plot_month(year=2018, month=6, fig=fig, ax=ax)\nax.text(0, offset + 4.2, 'Weeee!', fontdict={'fontsize': 32, 'fontweight': 'heavy'}, alpha=0.5)\n```\n\n![month plot](https://github.com/colcarroll/strava_calendar/blob/main/samples/sample_4.png \"Month Plot\")\n\n## See also! \n\nDownloading your data is a bit of a pain. You migh as well try out [this awesome project](https://github.com/Lisa-Ho/year-in-sports) while you're visualizing your year!\n\n## Bulk export from Strava\n\nThe process for downloading data is also [described on the Strava website](https://support.strava.com/hc/en-us/articles/216918437-Exporting-your-Data-and-Bulk-Export#Bulk):\n\n1. After logging into Strava, select \"[Settings](https://www.strava.com/settings/profile)\" from the main drop-down menu at top right of the screen.\n2. Select \"[My Account](https://www.strava.com/account)\" from the navigation menu to the left of the screen.\n3. Under the \"[Download or Delete Your Account](https://www.strava.com/athlete/delete_your_account)\" heading, click the \"Get Started\" button.\n4. Under the \"Download Request\", heading, click the \"Request Your Archive\" button. ***Be careful not to delete your account here!***\n5. The archive takes a while to be sent. Download the zipped file to a location whose path you know.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolcarroll%2Fstrava_calendar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcolcarroll%2Fstrava_calendar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolcarroll%2Fstrava_calendar/lists"}