Beatify

Multiplayer Music Trivia Quiz Game for Home Assistant

Turn any gathering into an unforgettable music trivia experience. Guests scan, songs play, everyone competes. It's that simple.

Get Started • Supported Speakers • See It In Action

---

Beatify is an open-source music quiz game for Home Assistant — a multiplayer music trivia party game that turns your smart speakers into a game show.

A song plays through your Sonos, Alexa, or Music Assistant speakers. Everyone races to guess the release year. Points fly. Streaks build. Champions emerge.

No apps to download. No accounts to create. Just scan a QR code and play.

Zero Friction Entry — Guests scan a QR code. That's it. No apps. No accounts. No WiFi password drama. 10 seconds from scan to playing.

Uses Your Existing Smart Speakers — Works with Music Assistant, Sonos, and Alexa speakers you already have. See Supported Speakers for details.

Your Music, Your Vibe — Spotify, Apple Music, YouTube Music, or Tidal playlists. Curated song packs included. Create your own.

Runs Locally — No cloud. No subscription. No data leaves your network. Fast, private, reliable.

Everyone Competes — Points, streaks, power-ups, and a dramatic finale with podium and stats. Real competition, real laughs.

🖥️ Admin Dashboard — Set up your game in seconds

🎵 Playlist Selection — Filter by decade, style, and region

🎮 Game Setup — Pick your speaker and playlist, hit start

📱 Lobby — Guests scan the QR code to join

👋 Player Join — Enter a name and you're in

📱 Mobile View — Fully responsive on any device

Via HACS (Recommended) — Install this HACS integration in seconds:

HACS → ⋮ Menu → Custom Repositories
→ URL: https://github.com/mholzi/beatify
→ Category: Integration
→ Install "Beatify"
→ Restart Home Assistant

Manual

cd /config/custom_components
git clone https://github.com/mholzi/beatify.git beatify
# Restart Home Assistant

Settings → Devices & Services → Add Integration → "Beatify"

That's it. Beatify is now installed.

After installation, access Beatify to start a game:

Beatify automatically adds itself to your Home Assistant sidebar.

1. Open Home Assistant
2. Look for Beatify in the left sidebar
3. Click to open the launcher
4. Hit "Open Beatify" — the game opens in a fullscreen new tab (no HA chrome)

Tip: If you don't see Beatify in the sidebar, restart Home Assistant.

http://YOUR-HA-IP:8123/beatify/admin

1. Open the HA Companion app
2. Tap the menu (☰) or swipe from left
3. Select Beatify from the sidebar

1. Select a speaker — Only supported speakers appear
2. Choose your music service — Spotify or Apple Music (depends on speaker)
3. Pick playlists — Select one or more
4. Adjust settings — Language, timer, difficulty
5. Start Game — Share the QR code with guests

Print it. Display it. Share it.

For Players

Slide to guess. Tap to submit. Pray you're right.

The Rush A song starts playing. The clock is ticking. You know this song... but was it '85 or '87?

The Strategy Answer fast for bonus points. Hit a streak for multipliers. Feeling confident? Bet double-or-nothing.

The Reveal The year drops. The room erupts. Someone nailed it. Someone was way off. Everyone's laughing.

Gold confetti bursts for exact guesses. Chart positions and fun facts appear. You just learned that song spent 22 weeks at #1.

For Hosts

Select speakers. Pick playlists. Start the party.

Full Control Skip tracks. Adjust volume. Pause the game. End early if needed. All from your phone.

Customize the Challenge Set round timers (15s/30s/45s) and difficulty levels (Easy/Normal/Hard) to match your group.

Print the QR Physical QR code printout for the coffee table. Guests join themselves.

Play Along Join as a player with admin controls. Compete and manage simultaneously.

The moment of truth. Every single round.

Choose your difficulty—each changes how points are awarded:

Submit instantly: 2x multiplier Submit at deadline: 1x multiplier Linear scale in between. Hesitation costs points.

• 3 in a row: +20 bonus points
• 5 in a row: +50 bonus points
• 10 in a row: +100 bonus points
• 15 in a row: +150 bonus points
• 20 in a row: +250 bonus points
• 25 in a row: +400 bonus points

Miss one? Streak resets. The pressure is real.

Feeling confident? Toggle the bet before submitting. Score points: Double them. Score zero: Lose it all.

Know your artists? Enable this mode in game setup. Guess the artist after the song: +5 bonus points. Alternate names accepted—"Prince" or "The Artist" both count.

Glory. Bragging rights. Maybe a rematch.

Fireworks explode for the winner. Full podium with medals. Personal stats. Best streaks. Bets won.

See how your game compared to all-time averages. Set a new record? Rainbow confetti and a "NEW RECORD!" badge.

Everything you need to demand a rematch.

Playlists are displayed on the main Beatify admin screen:

1. Open Beatify (see above)
2. Scroll to the Playlists section
3. Check the boxes next to playlists you want to use in your game
4. Selected playlists show their song count

Beatify comes with 2,363 songs across 21 curated playlists:

• 🎸 60s Classics — 45 tracks from the golden age of rock & roll
• 🎹 80s Hits — 208 classic hits from the decade of synths and MTV
• 🎵 90s Hits — 32 essential tracks from the decade
• 🎵 2000s Pop Anthems — 151 essential pop hits from the 2000s
• 🇪🇸 100% en Español — 127 Latin & Spanish classics
• 🎬 100 Greatest Movie Themes — 162 iconic film soundtracks
• ☀️ 100 Summer Anthems — 112 feel-good tracks from 1957-2020
• 🇬🇧 British Invasion & Britpop — 100 tracks from The Beatles to Blur
• 🎭 Cologne Carnival — 291 German carnival favorites
• 🕺 Disco & Funk Classics — 76 essential disco and funk tracks from the 70s and 80s
• 💥 Eurodance 90s — 100 party songs from the eurodance era
• 🏆 Eurovision Winners (1956-2025) — 72 winning songs
• 💃 Fiesta Latina 90s — 50 Latin party anthems from Shakira, Ricky Martin, Maná
• 🎯 Greatest Hits of All Time — 180 chart-toppers across four decades
• 🎵 Motown & Soul Classics — 100 iconic soul tracks from Diana Ross, Marvin Gaye, The Temptations
• 🎤 One-Hit Wonders — 98 flash-in-the-pan classics
• 💔 Power Ballads — 99 epic rock ballads from the 80s and 90s
• 🎸 Pure Pop Punk — 100 essential pop-punk tracks from the 2000s
• 🇩🇪 Schlager Classics — 60 German schlager classics
• 🇳🇱 Top 100 Dutch Classics — 100 Nederlandstalig tracks
• ⛵ Yacht Rock — 100 smooth West Coast classics from the 70s and 80s

Custom playlists are stored in: config/beatify/playlists/

See Creating Playlists for the JSON format.

Beatify uses simple JSON playlists stored in config/beatify/playlists/.

{
  "name": "80s Classics",
  "songs": [
    {
      "year": 1983,
      "uri": "spotify:track:4cOdK2wGLETKBW3PvgPWqT",
      "fun_fact": "Spent 8 weeks at #1"
    },
    {
      "year": 1985,
      "uri": "spotify:track:2374M0fQpWi3dLnB54qaLX",
      "fun_fact": "Written in just 10 minutes"
    }
  ]
}

Playlist Tips:

• Mix decades for variety
• Include recognizable songs (obscure = frustrating)
• Add fun facts for the reveal screen
• 10-20 songs per playlist works great

Sample playlists are included to get you started immediately.

Beatify speaks your guests' language.

• English — Full support
• Deutsch — Vollständige Unterstützung
• Español — Soporte completo
• Français — Support complet

Select during game setup. All players see the chosen language. Fun facts and awards are also translated!

Beatify works with specific Home Assistant integrations that support music playback:

Cast devices (Chromecast, Nest Audio, Nest Hub, Google TV) and HomePod don't support direct music playback from Home Assistant. They require a streaming source.

The solution: Install Music Assistant and add your Cast/HomePod devices there. Music Assistant acts as the streaming source and works perfectly with Beatify.

In Beatify's admin screen:

• ✅ Supported players show with a platform badge (Music Assistant, Sonos, Alexa)
• ❌ Unsupported players (Cast, etc.) are hidden with a hint to use Music Assistant

Beatify runs entirely within Home Assistant's HTTP server — no extra ports or services needed.

If guests are on a separate WiFi/VLAN, add a single firewall rule:

Guest VLAN → HA IP : TCP 8123

That's it. No mDNS, no broadcast, no additional ports.

Tips:

• The QR code uses the HA URL as seen by the admin's browser — make sure that URL is reachable from the guest network
• If using a reverse proxy (nginx/Caddy), ensure WebSocket upgrades are allowed for /beatify/ws (standard HA proxy configs already handle this)
• If using HTTPS with a self-signed cert, guests may need to accept it once

• Home Assistant 2024.1+
• Supported media player (see Supported Speakers above)
• HACS (recommended) or manual installation

• Native Home Assistant integration
• WebSocket-based real-time sync
• Local processing—no cloud required
• Session persistence for reconnection
• Up to 20+ concurrent players

Home Assistant
    └── Beatify Integration
            ├── Game State Manager
            ├── WebSocket Handler
            ├── Media Player Service
            └── Web UI (Admin + Player)

See ARCHITECTURE.md for the full system overview and WEBSOCKET.md for the WebSocket API protocol.

• Intro Mode — Random rounds play only 10 seconds of the song, then silence. Fullscreen ⚡ splash overlay, guaranteed every 4 rounds
• Quick Rematch — Hit Rematch on the scoreboard to restart with the same settings and players
• Fullscreen Launcher — Sidebar opens a launcher that pops the game into a clean new tab (no HA chrome)
• Comeback King superlative — Awarded to the player who improves the most during a game
• Film Buff superlative — Awarded for the most movie quiz bonus points
• Faster round transitions — Preflight caching + timeout-bounded playback cuts dead time between rounds
• Apple Music & Tidal fix — URIs correctly converted for Music Assistant playback
• HA 2026.2 compatible — Eliminated blocking I/O warnings
• 3 new/expanded playlists — 100% en Español (127 songs), 80s Hits expanded (208 songs), Top 100 Dutch Classics (100 songs)
• All playlist names standardized to English — Consistent naming across all 21 playlists
• 21 playlists, 2,363 songs, 4 music platforms, 4 languages

• Tidal support — Fourth streaming provider (Spotify, Apple Music, YouTube Music, Tidal)
• Movie Quiz Bonus — Guess the movie a soundtrack is from for tiered bonus points (5/3/1)
• French language — Fourth UI language (EN, DE, ES, FR)
• Film Buff superlative — New end-game award for movie quiz performance
• 2 new playlists — British Invasion & Britpop (100 songs), Summer Party Anthems (112 songs)
• All playlists enriched with Tidal URIs

• 3 new playlists — Motown & Soul Classics (100 songs), Disco & Funk Classics (76 songs), Fiesta Latina 90s (50 songs)
• Data quality pass — Added artist/title to Movies & Schlager (222 tracks), normalized Karneval chart data
• Streaming URI enrichment — 82 new Apple Music and YouTube Music URIs across Movies and Power Ballads
• Enrichment tooling — New enrich_playlists.py script for automated cross-platform URI lookup

• Tag-based filtering — Filter playlists by decade, genre, region, and mood in the Admin UI
• Pure Pop Punk playlist — 100 essential pop-punk tracks from the 2000s
• Yacht Rock playlist — 100 smooth West Coast classics
• Expanded 80er Hits — Grew from 100 to 125 tracks
• New 90er Hits — 32 essential tracks from the decade

• YouTube Music support — Use YouTube Music as your music provider alongside Spotify and Apple Music
• Custom playlist requests — Users can request Spotify playlists directly from the Beatify interface
• 80er Hits playlist — 100 classic hits from Michael Jackson, Prince, Madonna, A-ha, and more

• Multi-platform speaker support — Automatic detection for Music Assistant, Sonos, and Alexa
• Dynamic music service selector — Shows only compatible services for your selected speaker
• Cast device guidance — Helpful hints for Chromecast/Nest users to install Music Assistant

• Live emoji reactions — Send 🔥 😂 😮 👏 💀 reactions during reveals that float across all screens
• Artist Challenge mode — Guess the artist for +5 bonus points, with alternate name support
• Early reveal — Round ends instantly when all players have guessed
• Complete UI redesign — Collapsible admin sections, unified lobbies, compact reveal view
• One-Hit Wonders playlist — 98 songs celebrating flash-in-the-pan hits
• Kölner Karneval playlist — 291 songs of Cologne carnival tradition

• Admin analytics dashboard — Track games played, popular playlists, player stats, and error rates
• Mobile performance boost — 53% smaller bundles, lazy loading, adaptive animations
• Music Assistant support — Native playback service for reliable MA integration
• Styled confirmation dialogs — No more ugly browser popups
• Game settings display — See rounds and difficulty in the player lobby

• Spanish language support — Full UI and playlist content in Spanish
• German playlist content — Fun facts and awards translated for all 370 songs
• TV Dashboard improvements — Easier to find, shows round stats and fun facts
• Invite late joiners — QR popup during gameplay for latecomers
• Admin lobby makeover — Dark theme, player list, real-time updates
• Alexa fix — Spotify playback now works on Alexa devices

• Steal power-up — Build a 3-streak, then copy another player's answer
• End-game superlatives — Awards for Speed Demon, Hot Streak, Risk Taker, Clutch Player, and Close Calls
• Song difficulty rating — 1-4 star ratings based on historical player accuracy
• Reliability improvements — Pre-flight speaker checks, smart retry logic, graceful error handling

• Rich song information — Chart history, certifications, awards, and fun facts on every reveal
• Game statistics — Track performance across games with all-time averages and "NEW RECORD!" moments
• Confetti celebrations — Gold bursts for exact guesses, fireworks for winners, epic shows for perfect games
• Mystery mode — Album covers blur during guessing (no more peeking!)
• New playlist — Eurovision Winners (1956-2025) with 72 winning songs

• Difficulty presets — Easy, Normal, or Hard scoring modes
• Customizable round timer — Quick (15s), Normal (30s), or Relaxed (45s)
• Round analytics — See guess distribution, accuracy stats, and speed champions

View full changelog →

No speakers appearing in Beatify?

• Only Music Assistant, Sonos, and Alexa Media Player speakers are supported
• Cast devices (Chromecast, Nest, Google TV) require Music Assistant
• HomePod requires Music Assistant
• See Supported Speakers for the full compatibility table

Players can't connect?

• Verify Home Assistant is accessible on your network
• Try IP address instead of hostname
• Ensure port 8123 is reachable
• Guests on a separate WiFi/VLAN? See Guest WiFi / Network Setup — just open TCP 8123

Music won't play?

• Check media player is online in Home Assistant
• Verify playlist URIs are valid for your music service
• For Sonos: Only Spotify is supported (not Apple Music)
• For Alexa: Ensure your music service is linked in the Alexa app
• Check Home Assistant logs for errors

QR code won't scan?

• Improve lighting on the display
• Try the "Print QR" feature for a physical copy
• Use a dedicated QR scanner app

Have a question? Check our Discussions Q&A for answers to common questions about installation, music services, gameplay, and troubleshooting.

💡 Got an idea? Share it in Ideas 🐛 Found a bug? Open an Issue 🎵 Want a playlist? Submit a request through the Admin UI

Contributions welcome! Whether it's a new playlist, a bug fix, or a translation — check our CONTRIBUTING.md for the full guide.

Developer docs: Architecture | WebSocket API | Changelog

Quick start: Fork → Branch → PR. See good first issues for easy starting points.

MIT License. See LICENSE for details.