🎵 Spektrum

An interactive multiplayer music quiz where players compete to identify songs through colors and characters.

spektrum_demo.mp4

(sound on ↑)

How to Play

Spektrum is meant to be played with all participants in the same room. One person acts as the host and is responsible for music playback. The host creates a lobby and shares the join code with the group. When players have joined, the host starts the game.

Players will hear a piece of music and must identify the correct color or character associated with each song. Quick answers score more points.

Current Questions

The quiz at https://quiz.kottz.se features a mix of Anglosphere and Swedish music. If you'd prefer to use your own question set, you can host your own instance following the instructions below.

Host Your Own

Backend Setup

git clone https://github.com/kottz/spektrum
cd server
cp config.example.toml config.toml  # Edit as needed
cargo run --release

If you want to deploy your own instance there is a provided Dockerfile that pairs well with fly.io. Create a Backblaze B2 bucket, look at the server/env.example for the environment variables you have to set in fly.io. Make a env.prod and apply the keys with cat env.prod | fly secrets import.

Frontend Setup

cd frontend
npm run dev --host    # Development
npm run build         # Production

Creating Custom Questions

There is also a separate admin panel you can use as a convenient way to add and remove questions and sets.

cd admin_panel
npm run dev --host    # Development
npm run build         # Production

Questions are stored in server/data as a JSON file. The game supports two types of questions:

Color questions require:

• Media (Song with a YouTube-link)
• One or more colors from: Red, Green, Blue, Yellow, Purple, Gold, Silver, Pink, Black, White, Brown, Orange, Gray

Character questions require:

• Media (Song with a YouTube-link)
• Six different character options per question
• 300x300 AVIF image for each character