An open-source game inspired by Hitster, where players guess the release year of songs to build a chronological timeline. 🎶
| Front cards | Back cards | Gameplay |
|---|---|---|
![]() |
![]() |
![]() |
- Gameplay: Guess the release year of songs and create a chronological timeline.
- Open-Source: Contribute to the project and help expand its features.
- Custom Datasets: Create your own song datasets using the provided
generate.pybackend script. - Apple Music Integration: Play the songs using Apple Music.
- Hitster cards support: Choose between your own printed cards or use the original Hitster card set.
TrackStar allows you to use custom song datasets. A Python script, generate.py in the backend directory, is provided to help you generate these datasets.
cd backend
pip install -r requirements.txt
# optional: turn a raw source into a songs.json with a parser script (see parsers/)
python parsers/hitster_csv.py -o songs.json
# build datasets/<name>/ with info.json, songs.json, README.md and a printable cards.pdf
python generate.py build songs.json --name my-songs --display-name "My Songs"songs.json is a list of {"id", "title", "artist", "year"?, "album"?} objects. cards.pdf prints duplex (flip on long edge): QR fronts, song backs colored per 5-year period. See backend/README.md for how it works.
If you've created a custom dataset that you think would be valuable for other players, consider contributing it to the official repository:
- Create a pull request with:
- A clear description of your dataset (genre, time period, theme etc.)
- Any special notes about the dataset
- Xcode (latest version recommended)
- Swift (6.0 or higher)
- A macOS environment for development
-
Clone the repository:
git clone https://github.com/BennoCrafter/TrackStar.git cd TrackStar -
Open the project in Xcode:
open TrackStar.xcodeproj
-
Build and run the project on your desired device.
This project is open to contributions.
This project is licensed under the Mozilla Public License 2.0 - see the LICENSE file for details.


