README.md

Strava Kudos Giver 👍👍👍

A Python tool to automatically give Strava Kudos to recent activities on your feed. There are a few repos that uses JavaScript like strava-kudos-lambda and strava-kudos.

The repo is set up so that the script runs on a set schedule via Github Actions. Github suggests in their docs to not run cron jobs at the start of every hour to avoid delays so minute30 was chosen here. Feel free to change it to whenever you want. There is also a max_run_duration parameter which is 9 minutes by default so that we don't exceed the monthly Github Action free tier minutes when the action is triggered a few times a day.

🏃 Usage

1. Fork the repo
2. Setup the environment variables in secrets
3. Give kudos automatically!

Alternatively, you can run the script manually with

python3 give_kudos.py

🛠️Setup

Playwright

Playwright is used, so be sure to follow instructions to install it properly.

Environment Variables

Set the environment variables for your email and password as follows:

export STRAVA_EMAIL=YOUR_EMAIL
export STRAVA_PASSWORD=YOUR_PASSWORD

Github Actions

To add secrets for GH actions, navigate to Settings -> Security -> Secrets and Variables -> Actions. Enter your email and password within Repository Secrets.

🔬Testing

Manual testing was done in Python 3.9.10 on Ubuntu 20.04.6.

Contributions

Let me know if you wish to add anything or if there are any issues!