diff --git a/CLAUDE.md b/CLAUDE.md index efca636..b09f4eb 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,12 +1,12 @@ # Guide for this repository ## Project overview -- Goal: Generate printable DIN A4 sheets with ‘Hitster-style’ 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). - Outputs: - Separate files mode: fronts.pdf and backs.pdf. - Interleaved mode: cards.pdf with alternating pages (odd fronts, even backs) via --one-pdf. -- Scope: Personal, non-commercial use; not affiliated with Hitster or Spotify. +- Scope: Personal, non-commercial use; not affiliated with Spotify. ## Key requirements and constraints - Paper and layout: @@ -61,7 +61,7 @@ - Avoid copying full API payloads to logs; redact where necessary. ## Known limitations and non-goals -- The Hitster iPhone app will not scan these QR codes; they are standard QR codes to open.spotify.com, not Hitster’s proprietary format. +- These are standard QR codes that link to open.spotify.com for universal compatibility with any QR code scanner. - Album.release_date year may differ from an original single’s first release in some catalogues. - Client credentials flow cannot read private playlists; that requires user login (authorisation code flow). @@ -110,4 +110,4 @@ ## Licence and attribution - Use for personal, non-commercial purposes only. -- Not affiliated with or endorsed by Hitster or Spotify. +- Not affiliated with or endorsed by Spotify. diff --git a/generate_hitster_cards.py b/generate_hitster_cards.py index 5bd6ae1..ea633ad 100644 --- a/generate_hitster_cards.py +++ b/generate_hitster_cards.py @@ -276,7 +276,7 @@ def generate_pdf_interleaved(cards: List[TrackCard], out_dir: str, show_year_on_ print(f"Generated interleaved PDF: {os.path.abspath(out_path)}") def main(): - parser = argparse.ArgumentParser(description="Generate DIN A4 Hitster-style cards from a Spotify playlist.") + parser = argparse.ArgumentParser(description="Generate DIN A4 music cards from a Spotify playlist.") parser.add_argument("--playlist", required=True, help="Spotify playlist URL (public).") parser.add_argument("--client-id", required=True, help="Spotify CLIENT_ID.") parser.add_argument("--client-secret", required=True, help="Spotify CLIENT_SECRET.")