Fitness Stats Bot for Discord (Powered by Strava)

This is still a work in progress.

This Discord Bot provides fitness stats for you using Strava and sends embedded Discord messages with stats and graphs.

The repository contains the code for a Python-based Discord bot. The bot is currently self-hosted with Docker and makes use of the following packages:

• interactions.py - A library for creating interactive message menus in Discord
• stravalib - A Python package for accessing Strava data from the Strava V3 web service

Invite link for bot (Note: the bot is almost never running at the moment except for testing)

Server link if you would like to chat with me about the bot or find other Strava users on Discord.

🚲 Features

• Connect your Strava account to Fitness Stats Bot to see statistics and graphs about your Strava activities using slash commands
• Bot displays graphs and stats using embeds

Installation

If you would like to host this bot on your own machine, you can follow these steps:

1. Clone the repo
2. cd to repo root
3. (Optional) Create a virtual environment
4. Run pip install -r requirements.txt to install packages needed (step only needed if not using Docker)
5. Create a configuration file:
   • The easiest way is to make a file called .env in the repository root, with the following format:

   DISCORD_TOKEN = ...
   DISCORD_CLIENT_SECRET = ...
   STRAVA_CLIENT_SECRET = ...
   STRAVA_CLIENT_ID = ...
   

   • You can get the Discord token by creating your own bot. Follow this guide to find out how to make your bot and get your Discord token.
   • You can get the Strava Client ID and Client Secret by creating your own Strava application. Follow section B in this guide to find out how to make your Strava app.

Bot Demo

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

TODO

• Find a way to easily handle the authorization code that the user gets after going through Strava OAuth (create a website that displays code or saves it to the database)
• Add leaderboard for users within server
• Create a command that lets users display their latest activity