# ChillBox

> *A project by Pausetta.org, Simone Tesini, Francesco De Carlo, Leonardo Segala, Matteo Peretto*

**ChillBox** is a web app that lets you create a shared radio station with a democratic voting system, so everyone gets to enjoy their favorite music together.
Perfect for venues like swimming pools, cafés, or even lively parties.

---

## 🎵 Voting System

Joining a ChillBox room is easy: users can either scan the QR code displayed on the host screen or use GPS to find nearby rooms.
Hosts can set a location range, ensuring only people physically present can add or vote for songs.

---

## 📊 Ranking Algorithm

ChillBox uses a smart ranking algorithm to decide what plays next. The score of each song is based on:

* Votes from users
* How recently similar songs (same genre or artist) have been played (less = better)
* A bit of randomness to keep things interesting
* A strong penalty for songs played too recently

---

## 👐 Hands-Off Experience

ChillBox is designed to be almost entirely hands-free.
Once the host sets up a room and optionally connects a screen or projector 
(to show the current track, QR code, etc.), ChillBox takes care of the rest.

ChillBox comes with built-in automatic moderation to keep the music fair and on-theme.

* Users can’t vote for the same song multiple times.
* A cooldown prevents users from spamming song requests.
* Hosts can define preferred genres and overall mood, so no one can hijack your chill beach vibes with unexpected death metal.

That said, hosts still have access to essential controls, like pause and skip, if needed.
