Hitster Card Generator (fancy edition)

This is a simple python script to generate you fancy hitster cards from any spotify playlist! The generated spotify codes can be easily scanned from your phone.

Heavily inspired & adopted from this project: https://github.com/fjlein/hitster - please check them out!

Will generate a pre-aligned PDF for you to simply double side print. The back side is already flipped so you can just press "print".

---

Installation

We are using uv to manage python packages and versions.

Steps

1. Install uv however you prefer
2. Clone this repo -> git clone https://github.com/Kigstn/hitster-card-generator
3. Install packages -> uv sync
4. Copy the .env.example -> .env & fill out the values
5. To get your spotify auth information & create a spotify app (needed for API access), please consult this guide
6. Run script -> uv run src/hitster_card_generator/main.py
7. Your outputs will be in the output folder

---

Customisation

Tbh, customisation wasn't a big focus when making this project. So you may need to dig into the script to change stuff you want.

What you can do somewhat easily:

• Change background: Just replace the background.png with a file of your choosing. Make sure it is 800x800px
• Change the title: Overwrite the env var CARD_TITLE

---

Note: No AI was used in the making of this :)