Edison/music-cards
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Rename script to music_cards_generator.py and update references

Browse Source 
- Renamed generate_hitster_cards.py to music_cards_generator.py
- Updated all documentation references to use the new filename
- Removed remaining Hitster references from the filename
- Script name now matches the Music Cards branding

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Heiko Joerg Schick
2025-08-10 21:20:32 +02:00
parent d839dbe293
commit ff42d5fddc
3 changed files with 7 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+4 -4
View File
@@ -2,7 +2,7 @@
## Project overview ## Project overview
- Goal: Generate printable DIN A4 sheets with music cards from a Spotify playlist. Front shows a QR code plus the title and artist(s); back shows the release year and small text. - Goal: Generate printable DIN A4 sheets with music cards from a Spotify playlist. Front shows a QR code plus the title and artist(s); back shows the release year and small text.
- Current core: generate_hitster_cards.py uses Spotify’s Web API, generates QR codes and PDF pages with 3 × 3 cards per A4 (each 63 × 88 millimetres). - Current core: music_cards_generator.py uses Spotify's Web API, generates QR codes and PDF pages with 3 × 3 cards per A4 (each 63 × 88 millimetres).
- Outputs: - Outputs:
- Separate files mode: fronts.pdf and backs.pdf. - Separate files mode: fronts.pdf and backs.pdf.
- Interleaved mode: cards.pdf with alternating pages (odd fronts, even backs) via --one-pdf. - Interleaved mode: cards.pdf with alternating pages (odd fronts, even backs) via --one-pdf.
@@ -23,7 +23,7 @@
- Treat user-provided playlist URLs as sensitive until published by the user. - Treat user-provided playlist URLs as sensitive until published by the user.
## Repository structure (expected) ## Repository structure (expected)
- generate_hitster_cards.py — main script with CLI. - music_cards_generator.py — main script with CLI.
- CLAUDE.md — this file. - CLAUDE.md — this file.
- Optionally: - Optionally:
- README.md — quick start and printing notes. - README.md — quick start and printing notes.
@@ -34,9 +34,9 @@
- Dependencies: - Dependencies:
- pip install spotipy reportlab qrcode[pil] - pip install spotipy reportlab qrcode[pil]
- Run (separate files): - Run (separate files):
- python generate_hitster_cards.py --playlist "<playlist_url>" --client-id <CLIENT_ID> --client-secret <CLIENT_SECRET> --out ./cards_out --max-cards 54 - python music_cards_generator.py --playlist "<playlist_url>" --client-id <CLIENT_ID> --client-secret <CLIENT_SECRET> --out ./cards_out --max-cards 54
- Run (single interleaved file): - Run (single interleaved file):
- python generate_hitster_cards.py --playlist "<playlist_url>" --client-id <CLIENT_ID> --client-secret <CLIENT_SECRET> --out ./cards_out --max-cards 54 --one-pdf - python music_cards_generator.py --playlist "<playlist_url>" --client-id <CLIENT_ID> --client-secret <CLIENT_SECRET> --out ./cards_out --max-cards 54 --one-pdf
- Printing: - Printing:
- ‘Actual size’ (no scaling), high-contrast, 300 dpi or better. - ‘Actual size’ (no scaling), high-contrast, 300 dpi or better.
- Duplex: odd pages are fronts, even pages are the backs of the same set of 9 cards. - Duplex: odd pages are fronts, even pages are the backs of the same set of 9 cards.
README.md
+2 -2
View File
@@ -33,7 +33,7 @@ pip install spotipy reportlab qrcode[pil] pillow
### Basic Usage (Separate PDFs) ### Basic Usage (Separate PDFs)
```bash ```bash
python generate_hitster_cards.py \ python music_cards_generator.py \
--playlist "https://open.spotify.com/playlist/YOUR_PLAYLIST_ID" \ --playlist "https://open.spotify.com/playlist/YOUR_PLAYLIST_ID" \
--client-id YOUR_CLIENT_ID \ --client-id YOUR_CLIENT_ID \
--client-secret YOUR_CLIENT_SECRET \ --client-secret YOUR_CLIENT_SECRET \
@@ -43,7 +43,7 @@ python generate_hitster_cards.py \
### Single Interleaved PDF (for Duplex Printing) ### Single Interleaved PDF (for Duplex Printing)
```bash ```bash
python generate_hitster_cards.py \ python music_cards_generator.py \
--playlist "https://open.spotify.com/playlist/YOUR_PLAYLIST_ID" \ --playlist "https://open.spotify.com/playlist/YOUR_PLAYLIST_ID" \
--client-id YOUR_CLIENT_ID \ --client-id YOUR_CLIENT_ID \
--client-secret YOUR_CLIENT_SECRET \ --client-secret YOUR_CLIENT_SECRET \
generate_hitster_cards.py → music_cards_generator.py
+1 -1
View File
@@ -11,7 +11,7 @@ home printing and cutting. Cards can be generated as separate front/back PDFs
or as a single interleaved PDF for duplex printing. or as a single interleaved PDF for duplex printing.
Usage: Usage:
python generate_hitster_cards.py --playlist <URL> --client-id <ID> --client-secret <SECRET> python music_cards_generator.py --playlist <URL> --client-id <ID> --client-secret <SECRET>
Requires Spotify Web API credentials for accessing playlist data. Requires Spotify Web API credentials for accessing playlist data.
""" """