Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/isaac-chung/strava-kudos

A Python tool to automatically give Strava Kudos to recent activities on your feed.
https://github.com/isaac-chung/strava-kudos

kudos python python3 strava strava-data

Last synced: 2 months ago
JSON representation

A Python tool to automatically give Strava Kudos to recent activities on your feed.

Awesome Lists containing this project

README

        

# Strava Kudos Giver πŸ‘πŸ‘πŸ‘

[![Python 3.9](https://img.shields.io/badge/python-3.9-blue.svg)](https://www.python.org/downloads/release/python-370/) ![Github Actions](https://github.com/isaac-chung/strava-kudos/actions/workflows/give_kudos.yml/badge.svg)

A Python tool to automatically give [Strava](https://www.strava.com) Kudos to recent activities on your feed. There are a few repos that uses JavaScript like [strava-kudos-lambda](https://github.com/mjad-org/strava-kudos-lambda) and [strava-kudos](https://github.com/rnvo/strava-kudos).

The repo is set up so that the script runs on a set schedule via Github Actions. Github suggests in their [docs](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#schedule) 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](https://docs.github.com/en/billing/managing-billing-for-github-actions/about-billing-for-github-actions#included-storage-and-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](https://github.com/microsoft/playwright-python) 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!

[![ForTheBadge built-with-love](http://ForTheBadge.com/images/badges/built-with-love.svg)](https://GitHub.com/Naereen/)