git404hub

what is intro-quiz fr?

colfin22/intro-quiz — explained in plain English

Analysis updated 2026-05-18

7PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

tl;dr

A self-hosted music guessing game for family game night that plays song intros from your own Navidrome library on a TV or speaker.

vibe map

mindmap
  root((intro-quiz))
    What it does
      Guess the song intro
      Family game night
      Self hosted
    Tech stack
      Python
      FastAPI
      SQLite
      ffmpeg
    Use cases
      TV scoreboard
      Speaker only mode
      Half time trivia
    Audience
      Families
      Self hosters
    Setup
      Navidrome library
      Docker
      Chromecast

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Host a music guessing game for a family party night using your own music library.

VIBE 2

Cast a TV scoreboard with album art while phones act as buzzers for players.

VIBE 3

Run the quiz through a speaker only, with no TV needed, using Home Assistant.

VIBE 4

Build difficulty tiers automatically by blending your play counts with Last.fm popularity.

what's the stack?

PythonFastAPISQLiteffmpegWebSocketDocker

how it stacks up fr

colfin22/intro-quizalx-code/lingbot-video-1.3b-fp8andrevicencio/tmux-flash
Stars777
LanguagePythonPythonPython
Setup difficultymoderateeasy
Complexity3/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires an existing Navidrome music server and a dedicated read-only Subsonic login.

MIT license: use, modify, and share freely, including for commercial purposes, as long as you keep the copyright notice.

in plain english

Intro Quiz is a self-hosted music guessing game built for family game night. It plugs into your own Navidrome music server, the same one you already use to stream your own library, and plays the first five seconds of a song while everyone races to name it on their phone. It runs entirely on your own network, so there are no subscriptions, no ads, and no cloud service involved. The game can show a scoreboard on a cast display or Android TV, with album art and a live progress bar as each clip plays, or it can run in speaker only mode where phones handle the questions and a connected speaker plays the music. Whoever starts a game becomes the game master and controls when rounds begin, and that role passes to someone else each new game. Before a round starts, each player picks three artists they recognize from a randomly shown wall of popular artists in the library, which helps make sure no one is stuck facing only the host's favorite bands. Each round gives four multiple choice answers with a short time limit, and points depend on how quickly you answer correctly. Midway through a game there is a half time break with trivia facts and true or false questions pulled from the library and topped up from an online trivia database when needed. Behind the scenes the app copies your library's track list into its own local database using a read only login to Navidrome, and never changes your files, tags, or playlists. It figures out which songs are easy or hard to recognize by combining your own play counts with how popular a track is on Last.fm, and cuts short audio clips from each track using ffmpeg, skipping quiet intros so a slow fade in does not waste the clip. The whole system is built with Python and FastAPI, using a websocket connection to keep the TV board and each phone in sync, and it stores its data in SQLite. It is released under the MIT license.

prompts (copy fr)

prompt 1
Help me set up intro-quiz with my Navidrome server using Docker.
prompt 2
Show me how to configure a dedicated read-only Subsonic login for intro-quiz.
prompt 3
Write a cron job to run intro-quiz's nightly library sync and clip cutting endpoints.
prompt 4
Explain how to connect intro-quiz to a Chromecast display for the game board.

Frequently asked questions

what is intro-quiz fr?

A self-hosted music guessing game for family game night that plays song intros from your own Navidrome library on a TV or speaker.

What language is intro-quiz written in?

Mainly Python. The stack also includes Python, FastAPI, SQLite.

What license does intro-quiz use?

MIT license: use, modify, and share freely, including for commercial purposes, as long as you keep the copyright notice.

How hard is intro-quiz to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is intro-quiz for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.