Quizify

Multiplayer Useless Knowledge Quiz Game for Home Assistant

Turn any gathering into a trivia battle. Players scan, questions fly, everyone competes. No app needed.

Website • Get Started • How to Play • Question Packs • See It In Action

---

What Is Quizify?

Quizify is an open-source trivia quiz game for Home Assistant — a multiplayer party game that turns any phone in the room into a buzzer and any TV into a game-show screen.

A question appears. Everyone races to answer. Points fly. Streaks build. Champions emerge.

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

The lobby. Players scan, drop in, scoreboard ready.

---

Why Parties Are Better With Quizify

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

Runs Fully Local — No cloud. No subscription. No data leaves your network. Free and open-source. Your trivia, your network, your business.

Solo or Squad — Play alone for a couch session, or up to 20+ players for a full party. The host can self-join and play along, or just stay at the wheel.

Everyone Competes — Points, speed bonuses, streaks, five different power-ups, and a dramatic finale with podium and end-of-game awards. Real competition, real laughs.

Works on Any Screen — Dashboard mode for the TV. Players use their phones. Admin runs the show. No extra hardware needed.

Nineteen Themes, Three Languages — 7,310 questions across 53 themed packs (Geography, Pop Culture, Film & TV, Art & Literature, Animals & Nature, Sport, Music, Science, History, Food & Drink, Technology, World Cup, Estimation, Picture Round, Christmas, New Year's Eve, Halloween, Sankt Martin, Thanksgiving) in German, English and Spanish. Mix them, filter them, swap mid-session.

---

Setup In Home Assistant

Step 1: Install

Via HACS (Recommended) — Quizify is in the HACS default list. Open HACS, search for "Quizify", install it and restart Home Assistant. Or use the shortcut:

Manual

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

Step 2: Configure

Or manually:

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

That's it. Quizify is now installed.

If you enjoy Quizify, a star on GitHub helps other Home Assistant users find it.

---

Opening Quizify (Admin)

After installation, access Quizify to start a game:

Option 1: HA Sidebar (Recommended)

Quizify automatically adds itself to your Home Assistant sidebar.

1. Open Home Assistant
2. Look for Quizify in the left sidebar
3. Click to open the launcher
4. Hit "Quizify öffnen" / "Open Quizify" — navigates to /quizify/admin. The HA sidebar/header still wraps it; install Quizify as a PWA (next paragraph) if you want a truly chromeless fullscreen launcher.

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

Option 2: Direct URL

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

Option 3: HA Companion App

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

Quizify also installs as a Progressive Web App — once you've opened /quizify/admin from the launcher, tap the install prompt on the admin screen (browsers that support PWAs) and Quizify gets its own home-screen icon, fullscreen, no browser chrome.

Hosting Requires a Home Assistant Login

The admin side of Quizify is protected by your Home Assistant login. The first time you open /quizify/admin on a device, you're sent to the normal HA login screen; after that the device stays signed in and opening Quizify is instant.

The first connection from a fresh HA instance also bootstraps a persistent admin token — only the device that bootstrapped it can fire start_game, reset_game, end_game, or kick_player. If a stranger finds the URL on your home network, they can connect as a player but cannot start, reset, or control the game.

Lost your admin tab? Call the quizify.reset_admin_session service from Developer Tools → Services. The next admin connection re-bootstraps a fresh token.

Players are unaffected — joining at /quizify/player stays password-free, so guests still scan the QR code and play with zero friction.

What a guest sees after scanning the QR code. Type a name, tap Join.

---

The Experience

For Players

Scan the QR. Type your name. Buzz in.

The Rush A question appears. The clock is ticking. Three answers. You think you know it... but is it really that one?

The Strategy Answer fast for a speed bonus. Hit a streak for multiplier points. Got a Joker? Knock out one wrong answer and turn 33% into 50%.

The Reveal The correct answer drops in a sage-green callout. The room reacts. Someone nailed it on a 5-streak. Someone burned their Joker on a question they would have gotten anyway. Everyone's laughing.

A fun fact appears for context ("Giraffen schlafen im Schnitt nur 1,9 Stunden am Tag…"). The leaderboard reshuffles with delta arrows. Next round is one tap away.

For Hosts

Pick the pack. Pick the difficulty. Hit start.

Pick a pack, then a mode Choose your pack right on the first screen (featured card + chips), then a preset — Quick Round (5 rounds · Easy · 20s), Classic (10 rounds · Medium · 30s), Marathon (20 rounds · Hard · 45s) — or unfold the Custom panel to dial in language, difficulty, round count, and per-question timer.

Solo or Squad Solo play is supported since v1.1.9 — host self-joins, lobby unlocks with one player. Or wait for up to 20 friends. The lobby shows the QR code, the join URL, and a live roster as people drop in.

Full Control Reset the game at any time (header ⟲ button), end the game cleanly (finale + podium), kick a player out (× next to their name). The admin tab also redirects to the player view on game start, so you play along while staying in control.

TV Dashboard Cast /quizify/dashboard to the TV for a shared spectator screen — large question, three answer tiles that flip green (correct) / red (wrong) at reveal, fun-fact card, top-5 leaderboard with streak markers, and the full podium at the finale. Players watch the TV, tap on their phones. A live answer-distribution bar chart at reveal is on the roadmap — see #151.

---

Game Features

Every round ends with the verdict, the fact, and the standings.

Scoring That Creates Drama

Base formula (correct answers only):

Points = (Base + Speed Bonus) × Difficulty × Streak × (×2 if Double Points power-up)

Component	Value
Base points	10
Speed bonus	up to +5 (linear, decays over time limit)
Difficulty multiplier	Easy ×1.0 / Medium ×1.5 / Hard ×2.0
Streak multiplier	none for the first 2 correct answers in a row; from 3 in a row ×1.3, 4 in a row ×1.4, 5 or more ×1.5 (cap)
Wrong / timeout	0 pts, streak resets

Example: Medium difficulty, instant answer, 3× streak in a row: (10 + 5) × 1.5 × 1.3 = **29 pts** (the same answer on a 1× or 2× streak scores 22 pts)

Time Limits

Two paths, two sets of defaults:

Preset timers (what you get clicking Quick / Classic / Marathon):

Preset	Timer
⚡ Quick Round	20 s
🧠 Classic	30 s
🏆 Marathon	45 s

Difficulty-derived defaults (when you change just the difficulty chip without a preset):

Difficulty	Timer
Easy	20 s
Medium	15 s
Hard	10 s

Both are overridable from the Custom Settings panel — pick any timer in 5–300 s.

Streak Milestones

Three points where a streak yells at the room with a toast notification:

• 🔥 3 in a row — first toast pops, +30 % streak multiplier kicks in
• 🔥🔥 5 in a row — second toast, multiplier caps at +50 %
• 🔥🔥🔥 7 in a row — On fire! — third toast for bragging rights

Miss one and the streak resets. The pressure is real.

Power-Ups

One random player receives a random power-up at the start of each round. Use it during the question phase — power-ups are consumed immediately and the public broadcast tells everyone who used what.

Power-Up	Effect
🃏 Joker	Removes one wrong answer (33 % → 50 % chance of guessing right)
✌️ Double Points	This round's points count double
🥶 Freeze	Locks an opponent out of answering for 5 seconds — their clock keeps running, so they lose answer time (a real penalty, not a pause)
⏱️ Time Boost	Adds +5 seconds to your own timer
🥷 Steal	Takes 50% of a target player's current round points

Freeze and Steal require selecting a target player — only offered when 2+ players are in the game.

On the final round, players can stake a wager (0–100 % of their points): a correct answer wins it, a wrong answer loses it. The wager only resolves if you actually answer — timing out keeps your current points (no win, no loss). This is intended behaviour and is shown in the wager UI so it isn't a hidden trap.

Live Emoji Reactions (and a tiny scoring twist)

A reaction row sits below every reveal screen. Tap 🔥 😂 😱 👏 🤔 and your emoji floats across every other player's screen.

There's a small scoring mechanic baked in: a reaction sent during the reveal grants +1 point to every player who answered that round correctly — "audience appreciation". Each reactor can only grant the bonus once per round, and each correct answerer caps at +3 incoming bonus per round so a 6-player table can't pile free points on the leader every reveal. Reactions sent outside the reveal phase (lobby, mid-question) are pure visual.

Late-Joiners Get a Fair Shake

If a friend shows up mid-game, they can join from the QR code on the spot. New players inherit the average score of the current room so they're not stuck at zero for the next 5 rounds — they compete fairly from their first question.

Reconnect Without Losing Your Spot

If a phone loses WiFi, locks, or accidentally closes the browser, the player session is held by a session token. Reopening the URL within the grace period reconnects them to the same slot — score, streak, and power-up intact.

---

The Finale

Glory. Bragging rights. Maybe a rematch.

The last round ends. The podium animates in: 1st in the centre, 2nd on the left, 3rd on the right. The champion's name reads in coral display type. Below the podium, a "Your Result" card shows your rank, total score, and three personal stats: best streak, rounds played, power-ups used.

End-of-game awards drop next: 🥇 Best Round, ⚡ Fastest Finger, 🚀 Comeback King, 🔥 Hot Streak, 🎯 Most Accurate, 🧊 Buzzkill, 🧠 Knowledge Expert. Each goes to exactly one player, gated on plausibility (e.g. Comeback King needs ≥4 rounds played). Awards skip themselves on solo games where there's nothing to compare against. Best Round is the single highest-scoring round anyone played (#150); the podium's own "Top Score" is the highest total, and the two carried the same name until #860.

A leaderboard with all players follows so latecomers and bottom-of-the-pack still see their rank.

Then "Start New Game" (same settings, same players) or Reset Game (fresh lobby, everyone re-joins). The next round of demands is one tap away.

---

Automations

Quizify fires quizify_* events on the Home Assistant event bus at every game milestone, so your own automations can follow the game. They are off by default: switch on The House Plays Along under Settings → Devices & Services → Quizify → Configure (or the master switch in the admin setup, "Does the house play along?").

Three ready-made blueprints, one click each:

• Flash lights on the answer reveal (green if most of the room was right, red if not):
• Announce the winner on a speaker via text-to-speech:
• Start a game from a button, remote or any trigger (quizify.start_game):

Event	Fires when
quizify_game_started	A game starts (game_id, player_count, round_count)
quizify_question_shown	A question goes on screen (round, total_rounds, question_type)
quizify_time_running_out	The round timer drops to 5 seconds, once per round (seconds_remaining)
quizify_answer_revealed	The answer is revealed (round, correct_option_index, correct_option_text, correct_count, total_players)
quizify_streak_milestone	A player hits a streak milestone (player_name, streak, bonus)
quizify_finale_started	The finale begins
quizify_winner_decided	The winner is decided (winner_name, score)
quizify_game_ended	The game is over (leaderboard: list of name, score)
quizify_hot_seat_started	The Hot Seat detour opens (player_name, entrant_name, bid_pct, stake, bidder_count)
quizify_wager_open	The betting window opens (round, total_rounds, seconds)
quizify_lightning_started	The Lightning Round starts (question_count, seconds_per_question, player_count)

---

Question Packs

Quizify ships with 7,310 questions across 53 themed packs in 19 themes, in German, English and Spanish.

Theme	🇩🇪 Deutsch	🇬🇧 English	🇪🇸 Español
🌍 Geographie / Geography / Geografía	159	159	159
🦋 Tiere & Natur / Animals & Nature / Naturaleza	158	160	160
🎬 Popkultur / Pop Culture / Cultura Pop	159	160	160
⚽ Sport / Deportes	158	160	159
🎵 Musik / Music / Música	158	158	160
🔬 Wissenschaft / Science / Ciencia	159	159	159
📜 Geschichte / History / Historia	159	160	160
🍔 Essen & Trinken / Food & Drink / Comida	160	159	160
💡 Technik / Technology / Tecnología	158	160	159
🎬 Film & Serien / Film & TV / Cine y series	159	160	159
🎨 Kunst & Literatur / Art & Literature / Arte y literatura	160	160	160
🏆 Weltmeisterschaft / World Cup / Copa Mundial	157	159	160
🎯 Schätzfragen / Estimation / Estimación	40	40	40
🖼️ Bilderrätsel / Picture Round / Ronda de Imágenes	40	40	40
🎄 Weihnachten / Christmas / Navidad	160	160	160
🎆 Silvester / New Year's Eve / Nochevieja	130	130	140
🎃 Halloween	101	101	101
🏮 Sankt Martin	54

Spanish arrived in 1.3.0, reached every written theme in 1.9.0 and was completed in 1.10.0 — every row in the table above ships in all three languages, World Cup, Estimation, Picture Round and the two holiday packs included. The Estimation packs hold slider questions rather than multiple choice — see How to Play; every themed pack now carries five slider questions of its own (#566) on top of its written ones.

Some rows only show up when they are due. The Halloween packs carry a season window for all of October, the Sankt Martin pack (German only) one from 4 to 11 November, the English Thanksgiving pack one from 19 to 28 November, the Christmas packs one from 1 to 26 December and the New Year's Eve packs one from 27 December to 6 January; inside its window a seasonal pack is pinned as the featured pack on the setup screen and its card in the picker gets a badge. Outside it, the pack is still selectable like any other — it simply stops asking for attention. The World Cup packs use the same mechanism for June and July.

Pack selection lives on the first screen: a featured pack card (e.g. World Cup) up top, with every other pack as a tappable chip right beneath it — tap to select or deselect, mix several, then hit Start Game. Game settings (difficulty, rounds, timer) stay one tap away under Adjust settings. Mixed mode drops you a random question from every selected pack, so you can stir Geography + Pop + Sport together for chaos mode.

Missing a topic? Ask for a pack from inside the app. The last tile in the pack picker opens a short request form (theme, language, a note); it lands in this repo as an issue labelled pack-request, and the finished pack comes back as a pull request that ships to everyone. This works out of the box through the Quizify worker. If you run your own worker (cf-workers/), set it as Community pack submission URL in the integration options.

All packs follow an "Unnützes Wissen" editorial line — surprising, counter-intuitive, weird-but-true trivia. Less "capital of France", more "the average cloud weighs about 500 tons".

Custom Question Packs

Your own packs go in your Home Assistant config directory, at <config>/quizify/packs/ — the same <config> that holds configuration.yaml (/config/quizify/packs/ on Home Assistant OS). Quizify creates the folder on startup. Drop a JSON file in there and call the quizify.reload_packs action (Developer Tools → Actions → "Quizify: Reload question packs"), then reload the admin page — the pack appears in the picker. No restart needed; a restart works too.

Why not custom_components/quizify/questions/? HACS replaces that whole directory on every update, so a pack kept in there is deleted the next time Quizify updates. If you already have packs in custom_components/quizify/questions/community/, Quizify moves them to <config>/quizify/packs/ on the next start so they survive from now on.

{
  "name": "Movies",
  "language": "en",
  "theme": "popculture",
  "version": "1.0",
  "questions": [
    {
      "id": "mov_001",
      "question": "Which actor has appeared in the most Marvel Cinematic Universe films?",
      "answers": [
        {"text": "Samuel L. Jackson", "correct": true},
        {"text": "Robert Downey Jr.", "correct": false},
        {"text": "Chris Evans", "correct": false}
      ],
      "difficulty": "medium",
      "fun_fact": "Samuel L. Jackson appeared as Nick Fury in over 11 MCU films. He signed an unprecedented nine-film contract with Marvel — the longest acting contract in Hollywood history.",
      "category": "Movies"
    }
  ]
}

Rules:

• Exactly 3 answers per question
• Exactly 1 correct answer
• Per-question fields the loader reads: id (required), question (required), answers (required), difficulty (default medium), fun_fact (optional), category (optional, falls back to pack name), image_url (optional — an https:// URL, or a path under /quizify/static/ for an image shipped with the pack; anything else is ignored)
• Pack-level fields: name, language (de / en / es — only those are wired into the language chip; other ISO codes load but won't be selectable from the UI), theme (one of geography, nature, popculture, sport, music, science, history, food, tech, worldcup, trivia — drives the theme-tab filter and pack-card icon), version
• File goes in <config>/quizify/packs/ — picked up on the next quizify.reload_packs call, or the next restart

---

Multi-Language Support

Quizify speaks your guests' language.

• 🇩🇪 Deutsch — Vollständige Unterstützung
• 🇬🇧 English — Full support
• 🇪🇸 Español — Compatibilidad completa

The UI follows the game language (since v1.1.24) — pick German in the pack-picker and the entire admin / player / dashboard surface switches to German labels, tooltips, error messages, fun-fact labels, and end-game awards. Switch to English or Spanish and the whole thing flips.

636 i18n keys, full parity between all three locales, validated in CI.

---

Analytics

Quizify includes a built-in analytics dashboard at /quizify/analytics:

• Total games played
• Average players per game
• Top players by cumulative score
• Category breakdown with average scores
• Games-over-time chart (7d / 30d / 90d / all)
• Recent game history with podium and round count
• Flagged questions (players can flag a wrong/confusing question from the reveal screen)

Data is stored locally in config/quizify/analytics.json with a 90-day retention window.

---

Network Setup

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

Protocol	Port	Purpose
HTTP/HTTPS	8123 (default)	Game UI, API, static assets
WebSocket	8123 (same port)	Real-time game communication

If players 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 /api/quizify/ws (standard HA proxy configs already handle this)
• If using HTTPS with a self-signed cert, guests may need to accept it once

⚠️ Fritzbox users: The Fritzbox guest WiFi fully isolates clients from your home network — this cannot be overridden with firewall rules. Players must join the main WiFi, or use a separate VLAN-capable router to create a guest network with selective LAN access.

---

Technical Details

Requirements

• Home Assistant 2024.12+
• HACS (recommended) or manual installation
• A device with a browser for the admin / TV view; phones for players

How It Works

• Native Home Assistant integration — no extra services
• WebSocket-based real-time sync for admin, players, and TV dashboard
• Local processing — no cloud required
• Session token reconnect for mid-game drops
• Up to 20 concurrent players (tested; WiFi is the practical limit)
• PWA install on the admin page for a native-feeling launcher

Architecture

Home Assistant
    └── Quizify Integration
            ├── Game State Manager    (game/state.py)
            ├── WebSocket Handler     (server/websocket.py)
            ├── Question Bank         (game/questions.py)
            ├── Power-Up Manager      (game/powerups.py)
            ├── Player Registry       (game/player_registry.py)
            ├── Highlights Engine     (game/highlights.py)
            ├── Analytics Service     (analytics.py)
            └── Web UI
                    ├── /quizify/admin       (host)
                    ├── /quizify/player      (mobile)
                    ├── /quizify/dashboard   (TV)
                    └── /quizify/analytics   (stats)

---

Built With AI Assistance

Quizify is built with substantial help from AI coding tools (Claude Code). That's not a confession — it's a feature. Here's what that looks like in practice:

• Test coverage: 145 Python tests across 10 test files, exercising the game state machine, WebSocket protocol, scoring math, power-up effects, admin-redirect grace window, and the asset-fingerprint cache-buster — every regression gets a test before the fix lands.
• Architecture is documented in code: see game/state.py reset_to_lobby() vs. the new clear_all_players() (added in v1.1.15) — the comment block walks through why reset_to_lobby intentionally keeps players (for the finale's "Play again — same settings" path) while the explicit reset button needs to drop everyone, and references the specific user-visible bug ("phantom 'sdfsd 2' / 'Fjfj 2' players surviving a reset") that drove the change.
• Eighty-plus releases with traceable root causes, not just "fixed". i18n hygiene, pack-picker scalability, iOS Safari quirks, and cache-buster propagation all got dedicated sweeps in v1.1.x.
• MIT-licensed, fully local, no telemetry.

The AI is the typist. The decisions, the architecture, the bug triage, and the "ship it" call are all human. If something looks off in the code, open an issue — that's how the documented bug-fix sweeps started in the first place.

---

FAQ

---

What's New

The complete history is in CHANGELOG.md; longer prose notes for each release are on the GitHub releases page.

v1.24.0 — Holiday Packs, and a Sturdier Core 🎄

• Christmas grows to 160 questions per language, New Year's Eve gains a 2026-in-review block, and Thanksgiving (English) and Sankt Martin (German) are new, each featured only in its own season (#1101, #1102, #1111, #1113)
• A player who drops out mid-game keeps their score and seat, Hot Seat reads out the right question at the reveal, and text-to-speech never skips a question or a reveal (#1098, #1097, #1096, #1095)

v1.23.0 — A Pack for Film Night 🎬

• Film & TV packs in German, English and Spanish, about 160 questions each, and the picture packs grew from 17 to 40; 56 misplaced or repeated questions are gone (#1050, #1047, #1054, #1073)
• Streaks pay from the third correct answer with a toast at every milestone, the points under each answer add up, and tied players share the podium and the win (#1062, #1066, #1075, #1078, #1085)

v1.22.0 — The Lightning Round under Watch ⚡

• The host page and the television no longer stay frozen in the Lightning Round: after five seconds without a frame they reconnect by themselves and rejoin the round where it stands (#1035)
• With debug logging on, every Lightning frame records which screens it reached, so a returning freeze names its own cause in the Home Assistant log (#1044)

v1.21.0 — One Copy of the Truth 🪞

• Things written twice had grown apart: five name-escaping helpers with three meanings, two connection indicators, two reveal builders. Each now exists once, so a name with quotes renders the same on the television, the host page and the phones (#980, #982)
• The host keeps End Game in reach in every phase including Lightning, a lost final wager shows as a minus, and the estimation packs hold 40 questions per language (#1017, #1030, #1031, #1028)

v1.20.0 — Scores, Freeze and the Answer Marks Tell the Truth 🧮

• The estimate round stopped lying to its winner: a phone that guessed closest read "Time's up · 0 Points", a tie named only one team, and the number line drew ends nobody could have guessed (#951, #966, #967)
• Freeze finds a target in team mode, every question starts without the last round's "answered" marks, the World Cup packs hold 160 questions each, and the end screen counts people — and says "1 round" (#952, #953, #969, #975, #976)

v1.19.0 — Halloween, and Nothing Gets Lost Mid-Game 🎃

• Three Halloween packs, 303 questions in German, English and Spanish, pinned on the setup screen all October (#948)
• A team keeps its row when its last phone sleeps, estimate questions show who has answered, the Hot Seat starts on a clean grid and the final clock no longer jumps (#936, #939, #940, #941); game_active stays on through the wager and the Hot Seat, and the options save with pickers left empty (#938, #937)

v1.18.0 — One Score, and the Room Joins the Loud Parts 👥

• Team mode keeps one score, not two. The podium showed the team while analytics, the leader sensors and the winner event read the person underneath — two events could name different winners for the same finale (#923). Playing the candidate on a television found the last two leaks: the head-to-head strip and a member's all-time line.
• Six holiday packs, 603 questions in all three languages, 1 December to 6 January (#663) — and the lights and speakers finally join the auction, the betting window and Lightning (#708)

v1.17.0 — What the Reload Was Throwing Away 🔄

• Reload during a Hot Seat, a bet, a team answer or the final screen and the game used to forget where you were; six fixes rebuild each of those from the snapshot the server was already sending
• Every surface got its own stylesheet and script, so a rule written for a 390 px phone can no longer reach the television

v1.16.0 — Everybody on the Final Board 🔒

• The door was open: a page in any browser on the network could reach the game's socket and claim the host's seat. And four shipped pictures were not ours to ship — the licence check that missed them no longer greps for a phrase.
• The television shows this game (language, fun fact, difficulty and leaderboard all followed the last one), a host who closed the tab can come back, and team mode gets its own auction and final wager

v1.15.0 — The House Closes Its Doors, and Brings Its Own Type 🚪

• A guest could claim the free admin slot and drive the host's lights, speakers and scenes with no Home Assistant credential — two minutes after the host closed their tab
• The end screen stopped clipping its awards on a television (a phone stylesheet's max-width: 160px was reaching the big screen), and an English game no longer framed its questions in German on the phones

v1.13.0 — What the Television Was Never Showing You 📺

• Three screens that never fitted a 720p television — the question view, Lightning and the end screen all ran past the bottom, taking the last answers, the percentages and the leaderboard with them
• The Hot Seat inherited five things Lightning had all along: snapshot, teardown, settings restore, the team case and a TV view

v1.12.0 — The Room Keeps Score Between You Two 🥊

• The lobby names the two people who have played together most often and shows their record, and the end screen shows it again with the game everyone just watched counted in. Nothing appears until a pair has played twice.

v1.11.0 — The Chair Is Auctioned, and the Bet Comes First 🪑

• Once per game the Hot Seat is auctioned, and a bid is a share of your own points rather than a number of them — bid in points and whoever is ahead wins every auction
• The rest of the room stakes points on the outcome, and the wager window now opens before the question is shown

v1.10.0 — Spanish Is Finished, and the Room Tells You What's Happening 🇪🇸

• 4,740 questions across 36 packs, twelve per language — imagenes-es, estimacion-es and copa-mundial-es closed the last three gaps
• Season and evening standings, power-up messages in words rather than symbols, and the join address as text you can type

v1.9.0 — Your Own Record, and a Finished Spanish Shelf 🏅

• One quiet line under the lobby hero: a returning player's own all-time standing, "N wins from M games", visible to them and nobody else (#371)
• A way to ask for a pack that is missing, instead of building one yourself (#579)

v1.8.0 — Play as a Team, and Every Pack Learns Two New Tricks 👥

• Two people on one sofa become one participant. Players form teams themselves in the lobby; the host assigns nobody, and the answer stays changeable until the buzzer (#365).
• Every themed pack now carries five picture questions and five estimation questions of its own

v1.7.0 — Host From the Dashboard, and a Round of Pictures 🎛️

• custom:quizify-host-card puts start / advance / end on a Lovelace view, so hosting no longer means leaving the dashboard (#278)
• Server-side presets (#433) and the first picture pack — plus four defects that eight release candidates and a green test suite had not found, and playing it did

v1.6.1 — The Room Stops Giving It Away 📺

• The TV stopped parking the correct answer on tile A. The big screen drew its grid in question-file order while the phones used the round's shuffle — on 16 of the 26 shipped packs that meant tile A, every question, every game (#521). Scoring was never affected; it simply leaked to everyone watching.
• The setup screen, three times over — entity pickers no longer come up empty over a remote connection (#524, #527), the admin token survives closing the tab so a host can't be locked out for good (#530), and setup asks for one speaker instead of two (#525)
• "With kids" no longer ambushes you — the preset switches the auto Lightning Round off (#513)
• Shareable result cards on the end screen — rank, packs, hit rate, points, one glyph per round (#369)
• Two new Spanish packs — Deportes (#515) and Cultura Pop (#517), 150 questions each

v1.6.0 — The House Plays Along 🏠

• Whole-home game-show mode — lights react to the game and room sound effects punctuate it, all off by default and only as far as you take it
• HA services for voice and automations, a freshness engine that stops repeating the same questions, colour-independent reveal for accessibility, and per-player language

v1.5.0 — Now It's Fluent in Spanish, and a Whole Lot Sturdier 🇪🇸

• Four Spanish packs, 600 questions, and a fully translated UI
• A security and accessibility sweep across the host and player surfaces

v1.4.1 — Android Companion Launcher Fix 📱

• "Open Quizify" works inside the Android Home Assistant Companion app, whose WebView silently swallowed the old target="_blank" link (#348)

v1.4.0 — The Host Finds Its Voice, and Close Enough Counts 🗣️

• Spoken narration — a Home Assistant speaker reads the questions, names the options, announces the answer and welcomes players as they join (#281). Silent until you switch it on.
• Estimation questions — a slider instead of four buttons, closest guess takes the points, and a number-line reveal showing everyone's guess (#275)

v1.3.0 — Lightning Strikes, and Now It Speaks Spanish ⚡

• Lightning Round — a fast bonus mode nobody sees coming
• Spanish, picture questions, lobby music, auto-difficulty, community pack submission, and a reworked finale

v1.2.7 — Concurrency + Security Hardening 🔒

• Backend-only release: concurrency fixes (#167) and a security pass (#168), with 17 new tests

v1.2.6 — World Cup Night 🏆

• Two new World Cup packs (🇬🇧 World Cup · 🇩🇪 Weltmeisterschaft, ~200 questions) — surprising, weird-but-true facts about football's biggest stage, generated and reviewed for accuracy. The library is now ~2,890 questions across 20 packs.
• Pack selection moved to the first screen — a featured pack card plus every pack as a tappable chip, so you pick what to play in one tap without opening "Adjust settings". Game settings (difficulty, rounds, timer) stay there.
• Every host screen follows your Home Assistant language — the launcher, dashboard, and analytics no longer flash English and flip to the browser language.
• Self-healing asset cache — the cache-buster is now a content fingerprint, so updates land on the next page load without manual cache clearing. The in-page "New version available" banner was removed (no surprise reloads on a TV mid-game).

v1.1.41 — End-screen Typography Lock 🎯

• End-screen rank / score / stats actually shrink now. v1.1.40 reduced four classes by 20 % but a later "anchor bump" block silently overrode all four. Pulled the override; live-tested via CDP browser-harness against the running HA. The end-screen rank/score/stat block now stops eating the viewport above the leaderboard for real this time.

v1.1.40 — Typography Pass Across Player Screens 📐

• "Richtige Antwort: X" callout +20 % for the load-bearing element on the reveal view; surrounding context (your-answer strip, fun-fact body, section heads) +10 %
• Game view question text –20 % so 3-line questions stop dominating the viewport
• End-screen personal-result block –20 % so the rank card stops eating the screen above the leaderboard
• Podium spans 90 vw, not 90 % of the parent — fixed phone squeeze caused by parent horizontal padding

v1.1.39 — Theme Filter + Card Overflow Fix 🔧

• Theme-tab filter actually filters pack cards (CSS specificity collision pulled, hidden-by-theme rule now wins)
• Cards no longer overflow viewport on phones (minmax(0, 1fr) grid columns + overflow-wrap: anywhere)
• Version badge actually shows the running version (was hardcoded to v1.1.18 since first added)

v1.1.37 — Six New Themes 📚

• Sport, Music, Science, History, Food & Drink, Technology — each in 🇩🇪 + 🇬🇧, bringing the library from 3 themes to 9 and ~256 questions to ~838 questions across 18 packs
• All new packs follow the "Unnützes Wissen" editorial line — surprising, counter-intuitive, weird-but-true facts
• Pack-picker grew six new theme tabs (⚽ / 🎵 / 🔬 / 📜 / 🍔 / 💡) and twelve new pack cards

v1.1.31 — Pack-Picker Phase 2 🎨

• Featured Spotlight card (coral→sun gradient, "Sofort spielen" CTA) at the top of the pack-picker
• Theme tabs row filters which packs are visible
• Pack cards (2-col grid on mobile, 3-col on tablet) replace the old chip pills — emoji icon, display-type name, monospace question count, coral-border + ✓ active state

v1.1.29 — PWA Install Button 📲

• Admin page now offers "Install Quizify" via the browser's PWA install prompt. Native-feeling icon on home screen, fullscreen launcher, no browser chrome.

v1.1.24 — UI Follows Game Language 🌍

• The entire admin + player + dashboard + analytics surface now flips locale when the game language changes mid-session. No more half-translated screens.

v1.1.18 — Reveal-Page Polish ✨

• Per-round reveal text +30 % (most-stared-at page mid-game)
• More gap above Rangliste for visual separation
• Correct-answer line is now a sage-pill callout — was muted 12 px gray text, now a soft sage-tinted pill with the answer in display 800-weight green so it reads at a glance

v1.1.17 — Drop Green Tick on Correct Reveal 🎯

• The big "+N PUNKTE" already reads as the positive verdict; the green ✓ was competing for attention. Wrong answers keep the ✗ so negatives stay unmistakable.

v1.1.16 — Remove Dead Admin-Reveal-View 🧹

• Stripped 192 LOC of unused admin-side reveal markup + handlers. Production flow always redirects the host to /quizify/player on game start, so the duplicate admin reveal never actually rendered.

v1.1.15 — Reset Finally Resets 🔄

• reset_to_lobby() used to only zero scores — every connected WebSocket stayed in the registry. That's why phantom players ("sdfsd 2") reappeared across games. Now Reset closes every player WS, drops the entire registry, and wipes session tokens. Truly fresh lobby.

v1.1.13 — Bigger Result + Podium Typography 🏆

• Finale / podium / end-of-game text bumped another 20 %. Headlines, champion name, podium plank numbers, per-place scores, and personal stats all get explicit larger sizes so the celebration moment actually celebrates.

v1.1.12 — Integer Timer + 20 % Bigger Text ⏱️

• Player-side timer no longer shows decimals (server sends 19.5, German locale rendered it as 19,5). Now Math.ceil() for display, raw kept for the bar.
• Root body font-size bumped 16 px → 19.2 px so every rem-sized piece of typography scales up 20 %.

v1.1.10 — Admin Header Reset Button ⟲

• Small ⟲ icon in the admin header, hidden on setup, visible everywhere else. Click → confirm modal → wipes current game + players → back to setup. Useful for the stale-lobby scenario.

v1.1.9 — Solo Play + i18n Sweep 🎮

• Solo play. MIN_PLAYERS 2 → 1. Comparative end-of-game awards still gate on MIN_PLAYERS_FOR_AWARDS = 2.
• i18n sweep. Every hardcoded German leak in the English UI (and a handful of hardcoded English strings that never reached German users) properly routed through t(). 24 new keys, full EN/DE parity, cache-bust on translation JSON.

v1.0.0 — Initial Release 🎉

• WebSocket-based multiplayer trivia game
• 150 German questions across 3 categories
• Timer-based scoring with speed bonuses, streaks, and difficulty multipliers
• 5 power-ups: Joker, Double Points, Freeze, Time Boost, Steal
• Reconnect support with session tokens
• Admin dashboard with QR code, player list, and game controls
• Dashboard / TV mode at /quizify/dashboard
• Analytics tracking at /quizify/analytics

View full changelog →

---

Troubleshooting

Phantom players in the lobby?

• Hit the Reset Game button (⟲ icon, top-right of the admin header). Closes every player WS, drops the registry, wipes session tokens. Fresh empty lobby.

Cannot start the game (button stays hidden)?

• Quizify needs at least one player in the lobby to start. Click "Als Spieler beitreten" / "Join as Player" to self-join — the Start button unhides immediately.
• If you see "still need X more" stuck on the screen, do a hard refresh (Ctrl/Cmd + Shift + R) — your browser may be cached on an older release.

Admin tab can't fire start_game ("Admin only" error)?

• Your device hasn't bootstrapped the admin token. Run the quizify.reset_admin_session service from Developer Tools → Services. The next admin connection re-bootstraps a fresh token.

Players can't connect?

• Verify Home Assistant is accessible on the network the players are on.
• Try IP address instead of hostname.
• Guests on a separate WiFi/VLAN? See Network Setup — just open TCP 8123.
• Fritzbox guest WiFi isolates clients from the home network — players must join the main WiFi (see warning in Network Setup).

QR code won't scan?

• Improve display lighting.
• Verify the QR URL is reachable from the player's network.
• Some legacy phone scanners need the URL hostname, not the IP — try opening /quizify/admin from the host on a hostname-based URL if your network resolves it.

Browser stuck on old version after HACS update?

• Quizify cache-busts every static asset via a content fingerprint (?v=<version>-<hash>), so a normal page load already pulls the fresh version after an update — no manual cache clearing.
• The integration's Python only reloads on a full Home Assistant restart, so after a HACS update do Settings → System → Restart (not just "reload integration"). A long-open tab can be reloaded once if it still looks stale.

---

Contributing

Contributions welcome! Bug fixes, new question packs, translations, additional themes — all appreciated.

Quick start: Fork → Branch → PR. See open issues for ideas and the good first issues label for easy starting points.

Pack contributions are especially welcome. Drop a JSON file in custom_components/quizify/questions/, follow the schema in Custom Question Packs, and open a PR. The repo has a pack-review pipeline (10-rule anti-pattern list, parallel agent review) that runs on every pack before merge.

---

License

MIT License. See LICENSE for details.

A release ships more than Quizify's own code, and every bundled thing keeps its own licence. THIRD_PARTY.md is the index of what those are and where each licence text lives.

Bundled JavaScript. The join QR code is drawn by qrcodejs, vendored at commit 04f46c6a in custom_components/quizify/www/js/vendor/qrcode.min.js so that no page reaches a CDN. It is MIT, and the upstream copyright and permission notice travel with it in qrcodejs-LICENSE.txt.

Bundled fonts. Quizify ships DM Sans and JetBrains Mono in custom_components/quizify/www/fonts/, both under the SIL Open Font License 1.1, with the licence texts alongside them. They are served from your own Home Assistant — no page contacts Google Fonts or Fontshare, which is what makes "no data leaves your network" true for guests as well as for you. See www/fonts/README.md.

Bundled pack images. MIT covers the code. It does not cover the pictures in custom_components/quizify/www/img/packs/ — each one keeps the licence it came with, and its provenance is recorded row by row in that folder's credits.md, including the licence template on the source file record. The policy, and the test that enforces it, are in www/img/packs/LICENSING.md.

One thing there is worth knowing before you redistribute a fork. The PD-USGov and NASA rows are public domain by 17 U.S.C. §105, which is a statement about United States law and has no effect elsewhere; the project accepts that deliberately and says so. Every other row rests on an expiry or a release that covers the whole world — the eleven that did not were replaced or removed in 1.17.0 (#817), and the quarantine is empty.

---

Ready to Play?

The next trivia battle is one QR scan away.

Install Quizify Now

---

The open-source trivia quiz for Home Assistant. Built for fun.

⭐ Star on GitHub · Report Bug · Request Feature · Discussions

Made with ❤️ for the Home Assistant community