<p align="center"> <img src="assets/RoundedIcon.png" width="150" height="150" alt="Posterfy Logo"> </p> <div align="center"> <h1>TrackStar ✨</h1>

An open-source game inspired by Hitster, where players guess the release year of songs to build a chronological timeline. 🎶

</div>

Preview ⭐️

| Front cards | Back cards | Gameplay | |------------|------------|----------| | <img src="assets/screenshots/dataset/qr_codes.png" width="250"> | <img src="assets/screenshots/dataset/song_cards.png" width="250"> | <img src="assets/screenshots/gameplay.png" width="250"> |

Key Features 🚀

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.py backend 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.

Creating Custom Datasets

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.

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

Installation 💻

Prerequisites

Xcode (latest version recommended)
Swift (6.0 or higher)
A macOS environment for development

Steps

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.

Contributing 🤝

This project is open to contributions.

License 📝

This project is licensed under the Mozilla Public License 2.0 - see the LICENSE file for details.

TrackStar

Install / Use

README