diff --git a/CLAUDE.md b/CLAUDE.md index b09f4eb..5622dcd 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 "" --client-id --client-secret --out ./cards_out --max-cards 54 + - python music_cards_generator.py --playlist "" --client-id --client-secret --out ./cards_out --max-cards 54 - Run (single interleaved file): - - python generate_hitster_cards.py --playlist "" --client-id --client-secret --out ./cards_out --max-cards 54 --one-pdf + - python music_cards_generator.py --playlist "" --client-id --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. diff --git a/README.md b/README.md index 96f2281..a8b3777 100644 --- a/README.md +++ b/README.md @@ -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 \ diff --git a/generate_hitster_cards.py b/music_cards_generator.py similarity index 99% rename from generate_hitster_cards.py rename to music_cards_generator.py index 38b447c..2b1ef63 100644 --- a/generate_hitster_cards.py +++ b/music_cards_generator.py @@ -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 --client-id --client-secret + python music_cards_generator.py --playlist --client-id --client-secret Requires Spotify Web API credentials for accessing playlist data. """