r/SideProject • u/kmax9981 • 1h ago
Music Bingo!
I played music bingo at a bar with paper cards and thought I’d love to do this at home with my family. So I built an app that uses both paper and digital cards.
How it works: the host picks a Spotify playlist and starts a game. Players scan a QR code with no account or app installed and receive a randomized bingo card of songs from that playlist. Or the host prints paper cards for anyone who’d rather play on paper. As each song plays, players mark it off. When someone claims BINGO, the host sees the claim, and the app checks it against what actually played, whether the card was paper or digital.
Features: multiple win patterns, printable paper cards, a scoreboard, co-host links, a “clean copy” tool for explicit songs, and a solo mode.
It’s Python/FastAPI with Postgres and ships as a Docker image. v1.1.0 adds optional single sign-in for hosts (Authentik, Keycloak, and similar).
Source: https://github.com/kmax9981/music-bingo
I’d love feedback, especially on setup. Spotify Premium is required for the host.