A Python script that automatically updates your GitHub profile README with a random quote from your favorite franchises.
- 🎲 Randomly selects quotes from different franchises (Mass Effect, South Park, SpongeBob)
- 🤖 Automated daily updates via GitHub Actions
- 🎨 Beautiful HTML banner with character icons
- 🌍 Supports multiple languages (English and German quotes)
Run the script locally to update your README:
python quote_updater.pyThe GitHub Action workflow automatically updates the quote every day at midnight UTC.
To manually trigger an update:
- Go to your repository on GitHub
- Click the "Actions" tab
- Select "Update Daily Quote" workflow
- Click "Run workflow"
Edit quote_updater.py to select franchises:
SELECTED_FRANCHISES = ["all"] # All franchises
# OR
SELECTED_FRANCHISES = ["south_park", "spongebob"] # Multiple franchises
# OR
SELECTED_FRANCHISES = ["mass_effect"] # Single franchiseAvailable franchises: mass_effect, south_park, spongebob
- Navigate to
collection/[franchise]/[character]/ - Edit
quotes.txt:- First line:
- Character Name - Following lines: One quote per line (wrapped in quotes)
- First line:
Example:
- Commander Shepard
"I should go."
"We fight or we die. That's the plan."
- Create a repository with your GitHub username
- Copy the following files:
quote_updater.pycollection/folder.github/workflows/update-quote.yml
- Create a README.md with `
To automatically sync updates from this repository to your profile repository:
-
Create a Personal Access Token (PAT):
- Go to: https://github.com/settings/tokens
- Click "Generate new token" → "Generate new token (classic)"
- Name:
Workflow Sync Token - Select scopes:
repoandworkflow - Generate and copy the token
-
Add the token as a secret:
- Go to your profile repository settings:
https://github.com/[username]/[username]/settings/secrets/actions - Click "New repository secret"
- Name:
PAT_TOKEN - Value: paste your token
- Click "Add secret"
- Go to your profile repository settings:
-
Copy the sync workflow:
- Copy
.github/workflows/sync-from-daily-quote.ymlto your profile repository - The workflow will automatically sync
quote_updater.pyandupdate-quote.ymldaily at 01:00 UTC - You can also manually trigger it from the Actions tab
- Copy
This keeps your profile repository automatically updated with the latest script improvements and fixes from this repository, while preserving your own README.md.
Workflow fails with permission error: Go to your repository Settings → Actions → General → Workflow permissions and select "Read and write permissions".