colfin22/intro-quiz repository overview

⁠Intro Quiz

Self-hosted "guess the intro" music quiz for family game night, built on your own Navidrome⁠ library. A song's first 5 seconds play and everyone races to name it on their phones — fastest correct answer scores most. Runs on a cast display / Android TV (scoreboard + album art on the big screen) or just a cast speaker (phones carry the questions). All local — your music, your network, no subscriptions.

⁠Tags

• latest — the current release
• 1.19, 1.19.0 — pin to a version

Multi-arch: linux/amd64 and linux/arm64.

⁠Quick start

You need a Navidrome server, a free Last.fm API key⁠, and at least one audio output (a cast display / Android TV, or Home Assistant + Music Assistant for a speaker).

services:
  quiz:
    image: colfin22/intro-quiz:latest
    restart: unless-stopped
    ports:
      - "8000:8000"
    env_file: .env
    volumes:
      - ./data:/data
      - ./clips:/clips

docker compose up -d
curl -X POST http://<host>:8000/api/bootstrap   # first-time library sync + clip cutting

Phones open http://<host>:8000; the board lives at /board.

Full setup, environment variables and how it works: 👉 https://github.com/colfin22/intro-quiz⁠