Beatify: Musikquiz in Home Assistant mit Spotify einrichten

Beatify macht aus Home Assistant eine Musik-Gameshow. Ein Song läuft über deine Lautsprecher, die Gäste scannen einen QR-Code und raten am Handy das Erscheinungsjahr oder tippen Titel und Interpret. Wer Hitster kennt, erkennt die Idee sofort wieder. Die Integration hat mir jemand per E-Mail empfohlen. Ich habe sie mir mit Music Assistant und Spotify eingerichtet.

Die Gäste brauchen dafür weder eine App noch ein Konto. Beatify ist kostenlos und Open Source (MIT) und wird vom GitHub-Nutzer mholzi entwickelt. Stand dieser Anleitung ist Beatify 4.8.4 mit Home Assistant 2026.10.

Was Beatify von Hitster unterscheidet

Eine Zeitleiste zum Einsortieren gibt es bei Beatify nicht. Du schätzt das Jahr per Schieberegler oder tippst Titel und Interpret.

Wenn du genau die Hitster-Mechanik willst, bringt Music Assistant übrigens ein eigenes Musikquiz als Plugin mit. Dort gibt es den Modus „Music Timeline“, in dem du Songs auf einer Zeitleiste einsortierst. Das Plugin ist allerdings als experimentell markiert, Spieltypen und Einstellungen können sich mit jedem Release ändern.

Beatify bringt dafür 70 fertige Playlists mit, darunter viele deutsche, dazu Partylicht und Sprachansagen. Es läuft auch ohne Music Assistant direkt auf Sonos oder Alexa. Ich nutze es hier mit Music Assistant und Spotify.

So hängt das Setup zusammen

Der Stream kommt von deinem Spotify-Konto und geht in Music Assistant. Dafür brauchst du ein Premium-Konto, sonst klappt es nicht. Statt Spotify geht auch zum Beispiel Apple Music. Music Assistant leitet die Audiospur dann an den Lautsprecher weiter, den du ausgewählt hast.

Beatify stellt den QR-Code bereit. Alle, die mitspielen wollen, scannen ihn mit dem Handy, melden sich nirgendwo an und sind direkt im Quiz. Dazu brauchst du noch eine Anzeige für das Quiz, zum Beispiel deinen Fernseher im Wohnzimmer. Ein Laptop oder ein iPad würde wahrscheinlich auch gehen.

Es gibt vermutlich noch den einen oder anderen Weg, das Ganze aufzubauen. Bei mir hängt es genau so zusammen.

Was du brauchst

• Home Assistant 2025.1 oder neuer, ältere Versionen unterstützt Beatify nicht.
• HACS, Beatify steht im Standard-Store. Falls du HACS noch nicht installiert hast, hilft dir meine Anleitung zur HACS-Installation.
• Music Assistant, eingerichtet und mit Spotify verbunden. Beatify spielt die Songs über Music Assistant ab.
• Spotify Premium. Spotify Free funktioniert nicht, weil der kostenlose Tarif keinen gezielten Einzeltitel auf Abruf abspielt. Das gilt für jeden Streamingdienst, Beatify braucht immer ein bezahltes Abo.
• Einen Lautsprecher, den Music Assistant steuert, zum Beispiel Sonos, Chromecast oder HomePod. Chromecast und HomePod funktionieren nur über Music Assistant.
• Gäste im selben WLAN wie Home Assistant. Ein abgeschottetes Gastnetz reicht nicht, mehr dazu im Troubleshooting weiter unten.
• Optional einen Fernseher mit Browser als große Spielfläche, Lampen für das Partylicht und einen TTS-Dienst für Sprachansagen.

Schritt 1: Beatify über HACS installieren

• Öffne HACS in der Seitenleiste.
• Suche nach Beatify und öffne den Eintrag.
• Klick auf Herunterladen und bestätige.
• Starte Home Assistant neu: Einstellungen, dann System, dort den Neustart öffnen und Home Assistant neu starten wählen.

Schritt 2: Integration hinzufügen

• Geh auf Einstellungen, dann Geräte & Dienste und klick auf Integration hinzufügen.
• Suche nach Beatify.
• Der Dialog „Beatify einrichten“ hat keine Eingabefelder. Er zeigt nur, welche Mediaplayer Beatify gefunden hat (die Zeile darunter ist englisch: „Found … media player(s)“). Findet er keinen, kannst du trotzdem weitermachen, abspielen geht dann aber erst mit einem Lautsprecher.
• Bestätige mit OK.

Beatify lässt sich übrigens nur einmal hinzufügen, das ergibt auch Sinn. Danach legt es ein Gerät mit diesen Entitäten an:

Mit diesen Sensoren kannst du Automationen bauen. Ein Beispiel dafür kommt in Schritt 7.

Schritt 3: Beatify öffnen

• Klick in der Seitenleiste auf Beatify.
• Beatify öffnen startet das Spiel im Vollbild in einem neuen Tab.
• Direkt geht es auch über http://<deine-HA-Adresse>:8123/beatify/admin.

Beim ersten Öffnen auf einem Gerät fragt Beatify nach deinem Home-Assistant-Login. Hosten darf jedes HA-Benutzerkonto, nicht nur Admins. Fehlt Beatify in der Seitenleiste, hilft ein weiterer Neustart.

Schritt 4: Den Einrichtungsassistenten durchlaufen

Beim ersten Start steht dort „Noch nicht eingerichtet“. Einrichtung starten führt dich durch fünf Schritte:

• Lautsprecher („Wo soll die Musik spielen?“): Es erscheinen nur unterstützte Lautsprecher. Ein Sonos, den auch Music Assistant kennt, steht dort nur einmal als Music-Assistant-Lautsprecher. Beatify blendet den doppelten Eintrag selbst aus. Bei mir war die Auswahl ziemlich lang, ich habe die Küche genommen.
• Musikdienst („Wer streamt?“): Wähle Spotify.
• Playlist („Deine erste Playlist.“): Wähle eine oder mehrere der mitgelieferten Playlists. Insgesamt sind es 70 mit 8.724 Songs, darunter Deutschpop Klassiker, NDW, Schlager Classics, Deutschrap Klassiker, Ballermann Party Hits, Wiesn Party Hits, Disney Hits Deutschland und Best of Giraffenaffen für Kinder.
• Spielmodus („Wie möchtest du spielen?“): Hier stellst du Schwierigkeit (Leicht, Normal, Schwer), Zeit pro Runde, Song läuft, Anzahl Runden und die Ansagesprache ein. Unter Spielmodus wählst du zwischen Jahres-Modus und Titel & Interpret, unter Spielstil zwischen Klassisch, Dramatisch, Chaos und Eigene Auswahl.
• Atmosphäre („Level dein Spiel auf.“), optional: Unter Party-Licht wählst du die Lampen, die Intensität (Dezent, Mittel, Party) und den Modus. Unter Sprachansagen wählst du einen TTS-Dienst und die Ausführlichkeit (Minimal, Standard, Voll). Testansage senden prüft, ob die Stimme aus dem Lautsprecher kommt. Dieser Schritt erscheint nur, wenn Home Assistant passende Lampen oder TTS-Dienste hat.

Bei den Playlists gibt es neben den mitgelieferten auch Community-Playlists. Eigene kannst du dir zusammenklicken. Das finde ich den interessantesten Punkt der ganzen Integration. Bei den Kartenspielen bist du auf die Titel angewiesen, die sich der Hersteller irgendwann überlegt hat. Hier kannst du ein vermisstes Genre selbst bauen. Die Playlists des Originalspiels gibt es auch bei Spotify, du kannst sie dir speichern, bearbeiten und neue Songs hineinwerfen. In meiner Testrunde habe ich die One Hit Wonder genommen.

Beim Spielstil verhält sich Klassisch wie das originale Kartenspiel. Dramatisch steigert sich, wobei die letzte Runde entscheidet. Bei Chaos dürfen sich die Spieler gegenseitig ärgern. Wenn du einen Stil anklickst, schalten sich weitere Optionen dazu, die du alle frei konfigurieren kannst. Dazu gehören ein Filmquizbonus und ein Intromodus, der bei ungefähr 20 % der Runden nur die ersten 20 Sekunden eines Liedes spielt. Auch kannst du den Schwierigkeitsgrad während einer Runde steigern oder das Finale stechen einschalten. Ich habe es zum Ausprobieren auf Klassisch und Normal gelassen.

Beim Partylicht synchronisiert Beatify farbige Lampen zum Beat. Bei den Sprachansagen habe ich Piper als TTS-Entität gewählt und eine Testansage gesendet. Sie kam allerdings in der Küche raus, also dort, wo ich den Lautsprecher gewählt hatte.

Wer später etwas ändern will, kommt über Zurück auf dem Startbildschirm wieder in die Einstellungen.

Schritt 5: Gäste einladen und spielen

Nach dem Assistenten landest du auf „Bereit zum Hosten“ mit großem QR-Code. Dort siehst du auch noch mal Lautsprecher, Musikdienst, Playlist, Modus und Atmosphäre sowie eine Vorschau, was die Gäste sehen.

• Die Gäste scannen den QR-Code mit der Handykamera, tippen ihren Namen ein und tippen auf Beitreten. Die Spielerseite liegt unter /beatify/play und braucht keinen Login.
• Willst du selbst mitspielen, tippst du auf Als Spieler beitreten.
• Drucken gibt den QR-Code als Ausdruck für den Tisch aus.
• Sind alle in der Lobby, startet Spiel starten die erste Runde.

Ich habe das mit zwei Spielern ausprobiert: einmal im Browser als Daniel, einmal mit der Handykamera über den QR-Code. Der zweite Spieler erschien sofort in der Lobby. Nach dem Start läuft der Song. Jeder gibt seinen Tipp ab. Bei mir war es die Auswahl, wer den Song singt. Nach der Runde zeigt Beatify einen Fun Fact zum Song und einen Zwischenstand. Dazu kannst du Emojis hin und her schicken. Mit den Reglern unten gehen Lauter, Leiser, Stopp und Weiter. Spiel beenden zeigt den Endstand mit ein bisschen Konfetti.

Wer später dazukommt, scannt einfach den Code und steigt mit dem Durchschnittspunktestand ein. Am Ende startet Revanche eine neue Runde mit denselben Spielern, ohne neuen Scan.

So wird im Jahres-Modus gepunktet

Wer früh antwortet, bekommt bis zum doppelten Wert. Serien richtiger Tipps bringen Bonuspunkte ab drei in Folge. Mit „Dreifach oder nichts“ wettet ein Spieler auf das exakte Jahr. Im Modus Titel & Interpret gibt es 10 Punkte für den Titel und 5 für den Interpreten, kleine Tippfehler zählen teilweise.

Schritt 6: Das TV-Dashboard auf den Fernseher bringen (optional)

Auf „Bereit zum Hosten“ öffnet TV-Dashboard öffnen die große Ansicht mit QR-Code, Lobby, Auflösung und Rangliste. Die Adresse ist http://<deine-HA-Adresse>:8123/beatify/static/dashboard.html. Am einfachsten öffnest du sie direkt im Browser des Fernsehers oder Streaming-Sticks. Das Dashboard zeigt nur das Bild, die Musik kommt weiter aus dem Lautsprecher, den du im Assistenten gewählt hast.

Willst du das Dashboard in Home Assistant einbetten, bearbeitest du ein Dashboard und klickst auf Karte hinzufügen. Dort wählst du die Karte Webseite, dann Code-Editor anzeigen und fügst diesen Inhalt ein:

type: iframe
url: /beatify/static/dashboard.html
aspect_ratio: 56.25%

Schritt 7: Licht dimmen, sobald das Spiel startet (optional)

binary_sensor.beatify_beatify_game_active springt auf on, sobald die erste Runde läuft. Ist das Spiel vorbei, steht er wieder auf off. In der Lobby steht er auf off. Damit lässt sich das Licht im Raum steuern.

So legst du die Automationen an: Geh auf Einstellungen, dann Automationen & Szenen und Automation erstellen, dann Neue Automation erstellen. Öffne oben rechts das Drei-Punkte-Menü, wähle In YAML bearbeiten, füge den Block ein und klick auf Speichern. Ersetze light.wohnzimmer durch deine eigene Lampe oder Lichtgruppe.

Licht dimmen beim Spielstart

1alias: Beatify Spielstart Licht dimmen
2description: Dimmt das Wohnzimmer, sobald eine Beatify-Runde läuft.
3triggers:
4  - trigger: state
5    entity_id: binary_sensor.beatify_beatify_game_active
6    from: "off"
7    to: "on"
8conditions: []
9actions:
10  - action: light.turn_on
11    target:
12      entity_id: light.wohnzimmer
13    data:
14      brightness_pct: 30
15mode: single

Geprüft mit Home Assistant 2026.10.2

Licht wieder hochfahren, wenn das Spiel endet

1alias: Beatify Spielende Licht hoch
2description: Macht das Wohnzimmer wieder hell, sobald das Beatify-Spiel vorbei ist.
3triggers:
4  - trigger: state
5    entity_id: binary_sensor.beatify_beatify_game_active
6    from: "on"
7    to: "off"
8conditions: []
9actions:
10  - action: light.turn_on
11    target:
12      entity_id: light.wohnzimmer
13    data:
14      brightness_pct: 100
15mode: single

Geprüft mit Home Assistant 2026.10.2

Nimm dafür Lampen, die du im Assistenten nicht als Partylicht gewählt hast. Sonst steuern Beatify und die Automation dieselbe Lampe gleichzeitig.

Sicherheit

• Lass den Companion-Auth-Bypass ausgeschaltet. Unter Einstellungen, Geräte & Dienste, Beatify und Konfigurieren gibt es genau eine Option: „Auth-Bypass für die HA-Android-Companion-App aktivieren“. Sie ist ab Werk aus und soll es bleiben. Hinter Home Assistant Cloud (Nabu Casa) oder einem Reverse-Proxy sieht jede Anfrage lokal aus. Ein Fremder aus dem Internet könnte ohne Login Spiele hosten.
• Die Gästeseite braucht keinen Login. /beatify/play ist für alle offen, die deine HA-Adresse erreichen, zeigt aber nur Spieldaten. Alles, was Lautsprecher oder Lampen steuert, verlangt einen Home-Assistant-Login.
• Der Knopf „Falsches Jahr?“ schickt Daten nach außen. Tippt ein Spieler nach der Auflösung darauf, gehen Interpret, Titel, Jahr, Playlist und der Spielername an einen Server des Entwicklers (beatify-api.mholzi.workers.dev). Der macht daraus ein Ticket auf GitHub. Ohne diesen Knopf läuft das Spiel lokal.

Tipps und Troubleshooting

• Gäste im Fritzbox-Gastnetz kommen nicht ins Spiel. Das Gastnetz der Fritzbox trennt die Geräte vollständig vom Heimnetz, das lässt sich laut Beatify-README auch per Firewall-Regel nicht aufheben. Die Gäste müssen ins normale WLAN. Mit einem eigenen Gast-VLAN reicht eine Regel auf die HA-Adresse, TCP-Port 8123.
• Wenn die Musik nicht startet und das Spiel pausiert, ist meist Spotify in Music Assistant abgemeldet, oder es ist ein Free-Konto. Verbinde Spotify in Music Assistant neu und klick danach in Beatify auf Fortsetzen.
• Fehlt der Lautsprecher im Assistenten, liegt es meist an Chromecast, Nest oder HomePod. Die tauchen nur auf, wenn Music Assistant sie steuert. Füge sie erst dort hinzu und öffne dann Beatify neu.
• Den Knopf „Beatify zurücksetzen“ nutzt du nur im Notfall. Er beendet das laufende Spiel und löscht die gespeicherte Einrichtung für alle Geräte im Haushalt. Für einen anderen Lautsprecher oder andere Playlists reicht Zurück.
• Gibt es zu viele Antworten mit „nah dran“, stell die Schwierigkeit auf Schwer. Dann gibt es nur noch für ±2 Jahre Punkte.

Kennst du Hitster schon? Was hältst du von der Umsetzung in Home Assistant? Mich würde interessieren, welche Playlists bei dir laufen würden.