Rename script to music_cards_generator.py and update references
- 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:
@@ -2,7 +2,7 @@
|
||||
|
||||
## 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.
|
||||
- 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:
|
||||
- Separate files mode: fronts.pdf and backs.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.
|
||||
|
||||
## Repository structure (expected)
|
||||
- generate_hitster_cards.py — main script with CLI.
|
||||
- music_cards_generator.py — main script with CLI.
|
||||
- CLAUDE.md — this file.
|
||||
- Optionally:
|
||||
- README.md — quick start and printing notes.
|
||||
@@ -34,9 +34,9 @@
|
||||
- Dependencies:
|
||||
- pip install spotipy reportlab qrcode[pil]
|
||||
- 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):
|
||||
- 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:
|
||||
- ‘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.
|
||||
|
||||
@@ -33,7 +33,7 @@ pip install spotipy reportlab qrcode[pil] pillow
|
||||
|
||||
### Basic Usage (Separate PDFs)
|
||||
```bash
|
||||
python generate_hitster_cards.py \
|
||||
python music_cards_generator.py \
|
||||
--playlist "https://open.spotify.com/playlist/YOUR_PLAYLIST_ID" \
|
||||
--client-id YOUR_CLIENT_ID \
|
||||
--client-secret YOUR_CLIENT_SECRET \
|
||||
@@ -43,7 +43,7 @@ python generate_hitster_cards.py \
|
||||
|
||||
### Single Interleaved PDF (for Duplex Printing)
|
||||
```bash
|
||||
python generate_hitster_cards.py \
|
||||
python music_cards_generator.py \
|
||||
--playlist "https://open.spotify.com/playlist/YOUR_PLAYLIST_ID" \
|
||||
--client-id YOUR_CLIENT_ID \
|
||||
--client-secret YOUR_CLIENT_SECRET \
|
||||
|
||||
@@ -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.
|
||||
|
||||
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.
|
||||
"""
|
||||
Reference in New Issue
Block a user