Ovládání kvízu

Celý kvíz řídíš jedním velkým tlačítkem. Nic se nespustí samo.

Sady
Kvíz neběží
Tímto zlatým tlačítkem řídíš celý kvíz ručně. Klikni na Spustit kvíz — divákům se v OBS ukáže úvod.
Celkové pořadí v OBS:
Obrazovka do OBS
Otevřít overlay →
Přidej v OBS jako zdroj „Prohlížeč“ — tohle uvidí diváci.
Odkaz pro diváky
Kdo nechce psát do chatu, hlasuje klikáním na mobilu. Zapíná se v průvodci nastavením. Odkaz se mění při každém spuštění StreamQuizu i po novém připojení, posílej divákům ten, který je tady. Když se změní za běhu, bot nový odkaz napíše do chatu.
Testovací ovládání
Otevřít test →
Kvíz na zkoušku, odpovědi diváků naklikáš sám. Pozor, hraje se naostro: ukázané otázky odejdou do Archivu, výsledky i s vymyšlenými diváky se zapíšou do Historie a do Žebříčku (ze Žebříčku už je nesmažeš) a připojený StreamQuiz píše do chatu. Zvláštní sada na zkoušku ochrání tvoje otázky, Žebříček ne (je společný pro všechny sady). Před zkouškou StreamQuiz v průvodci odpoj.

Otázky

Seznam otázek aktivní sady. Odehrané se samy odloží do Archivu, ať se příště neopakují.

← Vyber otázku vlevo, nebo klikni + Nová

Sady otázek

Každá sada = vlastní seznam otázek. Připrav si víc témat a přepínej mezi nimi třeba i během streamu.

Načítám…

Otázky od lidí

Nech si otázky psát od diváků. Pošleš jim jeden soubor, oni ho otevřou, vyplní otázky a pošlou ti je zpátky — nic nikam neposílají po internetu.

1
Pošli lidem tenhle soubor
Stáhne se ti StreamQuiz-otazky.html. Hoď ho na Discord nebo pošli mailem. Otevřou ho dvojklikem, nic neinstalují.
Stáhnout soubor pro diváky
2
Až ti pošlou soubor, načti ho sem
Vybereš, jestli z toho udělat novou sadu, nebo otázky přidat k těm, co už máš. Obrázky a zvuky se načtou s nimi.

Vzhled obrazovky

Jak kvíz vypadá divákům v OBS. Změna se projeví do pár vteřin i bez refreshe.

Barevný styl

Klikni na náhled — vybraný styl se rovnou pošle do overlaye.
Chceš si overlay prohlédnout bez spuštění kvízu? Otevři ukázku otázky nebo ukázku výsledků. Do OBS patří pořád adresa bez ?demo.

Velikost na obrazovce

Zvětšení kvízu?
Overlay se sám přizpůsobí rozlišení browser sourcu. Tímhle můžeš doladit. 100 % = výchozí.
100 %

Zvuky

Všechny zvuky jsou v aplikaci — nic se nestahuje. přehraje zvuk jen tady u tebe · zaškrtnutí = zvuk se v kvízu použije · nahradí vlastním. Overlay si změny načte při startu dalšího kvízu.

Žebříček diváků

Dlouhodobé výsledky napříč všemi kvízy. Klikni na řádek pro detail. Vidíš jen ty — divákům se nikde neukazuje.

Načítám…

Historie kvízů

Každý odehraný kvíz i s výsledky. Výsledky si můžeš stáhnout jako textový soubor.

Načítám…

Nastavení

Jak se počítají body a jak kvíz probíhá.

Bodování

Za co jsou body?
Jak se divákům počítají body za odpověď.
Trestné body za špatnou odpověď?
Kolik bodů se odečte za špatnou odpověď. 0 = špatné odpovědi nic nestojí. Skóre v kvízu může jít i do minusu.

Průběh kvízu

Tempo čtení?
Kolik znaků za sekundu stihneš přečíst nahlas. Podle toho čeká otázka i každá odpověď, než naskočí další. Změna platí od další otázky.
10 zn/s
Nejkratší čas na otázku
I krátká otázka zůstane na obrazovce aspoň tak dlouho sama, než naskočí první odpověď.
4 s
Nejkratší čas na přečtení odpovědi
Další odpověď naskočí, až přečteš předchozí — krátká (ANO / NE) ale až po téhle době, ať neproblikne. Odpočet začne 1 s po přečtení poslední.
1,5 s
Ukázková otázka

Počítám časovou osu…

Kolik času mají diváci na odpověď
Odpočet, který vidí na obrazovce. Změna platí od další otázky — otázka, která už je na obrazovce, doběhne s dosavadním časem.
15 s
Zpoždění tvého streamu?
Změř si ho: pusť si vlastní stream na mobilu a porovnej, za jak dlouho se objeví to, co máš právě v OBS. Typicky 3–10 s. Nastavíš-li víc, než je skutečnost, diváci budou mít jen o něco delší čas — nic se nerozbije.
vypnuto
Kolik otázek v jednom kvízu
0 nebo prázdné = hrají se všechny dostupné (kvíz můžeš kdykoliv ukončit tlačítkem Ukončit kvíz). Když je dostupných míň, hraje se maximum. Odehrané otázky jdou do Archivu a příště se nehrají.
vše
Zamíchat pořadí otázek
Vypnuto = hrají se přesně v pořadí seznamu (šipky nahoru a dolů u otázek). Zapnuto = losují se náhodně.
Ukázat, kdo odpověděl špatně
Po odhalení odpovědi se v overlayi objeví seznam diváků se špatnou odpovědí.

Připojení Twitche

Průvodce nastavením
Připojení účtu, kanál, whisper a web hlasování pro diváky.
Otevřít průvodce →

Nápověda

Kompletní příručka — všechno na jednom místě, funguje i bez internetu. Klikni na sekci.

První spuštění
  • Rozbal ZIP kamkoliv a spusť StreamQuiz.exe — sám se otevře prohlížeč s průvodcem (/setup). Později ho najdeš vlevo dole v menu jako Průvodce nastavením.
  • Krok 1: Připoj Twitch — přihlašuješ se svým účtem na twitch.tv/activate (kód se předvyplní). Nic se neinstaluje, žádné API klíče.
  • Krok 2: Zkontroluj kanál a zapni co chceš (chat je vždy zapnutý, hlasování na webu je zapnuté od začátku a můžeš ho vypnout, volitelně whisper), pak klikni na Připojit ke kanálu. Kvíz se tím ještě nespouští.
  • Krok 3: Dostaneš odkazy — overlay do OBS, ovládání kvízu a se zapnutým web hlasováním i odkaz pro diváky. Když se něco nepovedlo (web hlasování se nepodařilo spustit, nastavení se neuložilo), varování i s radou uvidíš právě tady.
  • Kategorie na Twitchi: k vysílání si nastav kategorii StreamQuiz (psanou dohromady), ať tě diváci kvízu najdou. Pozor, Stream Quiz s mezerou je jiná hra. Dokud Twitch naši kategorii v nabídce nemá, přidej aspoň tag StreamQuiz.
  • Přihlášení vypršelo: když Twitch přihlášení StreamQuizu odmítne, průvodce ukáže nahoře červenou pilulku Přihlášení vypršelo a vrátí tě na krok 1. V kroku 1 se přihlas znovu (nebo, když průvodce hlásí, že je účet znovu ověřený, jen klikni na Pokračovat) a v kroku 2 dej Připojit ke kanálu.
  • Odkaz odhlásit v kroku 1 jen odpojí Twitch účet — hlasování v chatu, whisperem i na webu přestane. Běžící kvíz nezastaví, ten ukončíš v Ovládání.
  • Na začátek je v sadě Moje otázky 5 ukázkových otázek (i s obrázkem, zvukem a videem), takže si kvíz můžeš hned vyzkoušet. Pak je smaž nebo si založ vlastní sadu.
Windows může při prvním spuštění ukázat „Systém Windows ochránil váš počítač“ (aplikace nemá podpis) → klikni Další informace → Přesto spustit. Když vyskočí firewall, dej Povolit. Obojí jen jednou.
OBS — overlay na stream
  • V OBS přidej Prohlížeč (Browser source) s adresou z kroku 3 průvodce (tlačítko Kopírovat) — obvykle http://localhost:8080/. Stejnou stránku otevře odkaz Obrazovka do OBS vlevo dole v menu.
  • Doporučená velikost = tvoje rozlišení scény (např. 1920×1080). Overlay se sám přizpůsobí menšímu rozlišení; doladit můžeš posuvníkem Zvětšení kvízu v sekci Vzhled (karta Velikost na obrazovce).
  • Pozadí je průhledné — kvíz se vykreslí přes tvou scénu/kameru.
  • Vzhled: vyber si jeden z 15 skinů — barevné (Klasik, Neon, Midnight, Crimson, Emerald, Royal), animované (Pulse, Inferno), zlaté (Zlato, Zlato metal) i tématické (Vista Aero, Cyberpunk, Retro Game, Windows 95, Windows XP). Projeví se do pár vteřin bez refreshe v OBS.
  • Vlastní barvy: klikem na dlaždici Vlastní barvy si namícháš vlastní styl (základ a akcent, zbytek se dopočítá; náhled je živý overlay) a dáš Uložit styl. Do overlaye ho pustíš klikem na jeho náhled. Další klik na už vybraný vlastní styl ho otevře k úpravě nebo ke smazání; smazáním vybraného stylu se overlay přepne na Klasik. Vlastních stylů může být až 20.
  • Jak overlay vypadá, zjistíš i bez spuštění kvízu: v sekci Vzhled dole otevři ukázku otázky nebo ukázku výsledků (i se všemi dlaždicemi statistik). Do OBS patří adresa bez ?demo.
Po každé aktualizaci StreamQuizu dej v OBS na browser sourcu „Obnovit cache aktuální stránky“. Když overlay ukáže vlevo nahoře červený rámeček „NESOULAD VERZÍ“, je to přesně tohle.
Ovládání kvízu
  • Celý kvíz řídíš jedním velkým zlatým tlačítkem v sekci Ovládání: Spustit kvíz (úvod) → Zobrazit otázku → Odhalit odpověď → Další otázka → … → Ukázat výsledky. U otázky s médiem „před otázkou“ se nejdřív ukáže jen médium a tlačítko se změní na Spustit otázku. Když u otázky hraje zvuk nebo video, tlačítko nabídne Otevřít odpovídání hned — médium se utne a diváci hned odpovídají (jinak se odpovídání otevře samo, až médium dohraje). Řádek s žárovkou pod tlačítkem vždy říká, co udělá další klik.
  • Pod tlačítkem je rámeček Otázka X / Y s textem a možnostmi tak, jak je vidí diváci, takže nemusíš koukat do OBS. Správnou odpověď v něm uvidíš až po odhalení. Během kvízu karta ukazuje i to, kolik diváků odpovědělo, kolik zbývá sekund a kolik hráčů se zapojilo.
  • Přeskočit otázku — zahodí aktuální otázku bez bodů. Ukončit kvíz — ukončí kvíz a ukáže výsledky.
  • Vypnout StreamQuiz (vlevo dole v menu, na úzké obrazovce v horní liště ikon) — až dohraješ. Odpojí chat, whisper i hlasování na webu a aplikaci ukončí; obraz v OBS zůstane, jak byl. Když kvíz ještě běží, nabídne ho nejdřív ukončit (s výsledky a zápisem do historie). Se zpožděním streamu počká, než odejde poslední zpráva do chatu. Nastavení zůstane — po dalším spuštění se StreamQuiz připojí sám.
  • Anulovat otázku — když měla otázka chybu v zadání (překlep, dvojznačnost). Body za ni se všem vrátí (i trestné), do statistik se nezapočítá, vrátí se mezi aktivní otázky a diváci se to dozví v chatu. Jde to i po odhalení. Když je špatně jen označená správná odpověď, použij opravu (poslední bod).
  • Opakovat médium — znovu ukáže obrázek / přehraje zvuk otázky (např. když divák přišel pozdě). Dalším klikem (Skrýt médium) ho schováš.
  • Export výsledků — po skončení kvízu stáhne pořadí jako .txt (objeví se, když kvíz neběží).
  • Statistiky na konci: vpravo vedle tabulky vítězů se samy ukážou dlaždice (až 10). Dlaždice, pro kterou kvíz nedal data, se nezobrazí.
    • Nejrychlejší prsty — kdo byl nejčastěji první se správnou odpovědí.
    • Nejvyšší úspěšnost — nejvyšší podíl správných odpovědí.
    • Smolař večera — nejnižší podíl správných; jen když je opravdu horší než vítěz úspěšnosti.
    • Nejdelší série — nejvíc správných odpovědí za sebou, aspoň 3. Špatná i vynechaná otázka sérii přeruší.
    • Nejrychlejší průměr — průměrný čas správných odpovědí (zpoždění streamu se odečítá); potřeba aspoň 3 správné.
    • Nejvíc matoucí otázka — otázka s nejmenším podílem správných, i s nejčastější chybnou odpovědí.
    • Největší past — otázka, kde nejvíc z odpovídajících (aspoň 2) zvolilo stejnou chybnou odpověď. Když je to tatáž otázka jako nejvíc matoucí, dlaždice se neukáže.
    • Bez chyby — kdo odpověděl na všechno a všechno správně (nejvýš 3 jména, pak „a další N“). Když nikdo, ukáže se Vydrželi do konce — kolik hráčů odpovědělo na všechny otázky. Obojí jen u kvízu se 3 a více otázkami.
    • Dav měl pravdu — v kolika otázkách přebil správný hlas nejčastější chybu. Počítají se jen otázky, kde odpověděli aspoň 4 lidé; při remíze se otázka bere jako prohraná.
    • Celkem — počet hráčů, kolik procent odpovědí bylo správně a počet otázek.
  • Úspěšnost, smolař a průměr se počítají jen hráčům, kteří odpověděli aspoň na 2/3 odhalených otázek — nejméně na 3, ale nikdy na víc, než kolik otázek bylo (12 otázek → 8 odpovědí, 30 → 20). Jinak by vyhrál kdokoliv s jedinou trefou. Hranici overlay vypíše pod dlaždicemi. Přeskočené a anulované otázky se nepočítají, oprava správné odpovědi statistiky přepočítá. Do Historie ani do exportu se statistiky neukládají.
  • Dlaždice stojí vpravo ve dvou sloupcích, tabulka vítězů vlevo; vejde se do ní 24 jmen bez ohledu na počet dlaždic. Ostatní hráči jsou sečtení v řádku „a dalších N“. Výsledková scéna zabírá celou obrazovku — pokud máš v OBS pod overlayem kameru, po dobu výsledků ji zakryje.
  • Celkové pořadí v OBS: po výsledcích zůstane na obrazovce tabulka vítězů se statistikami. Pořadí všech hráčů se ukáže až na tvůj pokyn — řádkem Celkové pořadí v OBS pod velkým tlačítkem: Ukázat, šipky nahoru a dolů (po 20 hráčích), Na začátek a Schovat. Schovat vrátí výsledky se statistikami (a když pořadí otevřeš během otázky, vrátí otázku). Rolovat musíš odsud, OBS myš do overlaye nepustí.
  • Tlačítka mají ~2,5s pojistku proti dvojkliku — omylem zmáčknuté druhé kliknutí kvíz neposune. Při nájezdu otázky je tlačítko chvíli zamčené.
  • Špatně označená správná odpověď: po odhalení klikni v rámečku s aktuální otázkou na možnost, která opravdu platí. Okno ukáže, kdo body dostane a kdo o ně přijde; po potvrzení se body přepočítají, overlay přesune zelenou a do chatu jde krátká zpráva. Stejně to jde v editoru otázky — i u starší, už odehrané otázky. Přeskočenou nebo anulovanou otázku opravit nejde (nemá co přepočítat). Před odhalením rámeček správnou odpověď neukazuje — kvíz si tak můžeš zahrát i sám, když ti otázky připravil někdo jiný.
Testovací ovládání
  • Kvíz na zkoušku bez chatu: odkaz Testovací ovládání vlevo dole v menu nebo karta v Ovládání (adresa http://localhost:8080/control). Tlačítka 1. Start, 2. Další otázka, 3. Odhalit, Skip a Konec.
  • Odpovědi diváků si naklikáš sám: za zadaný nick tlačítky A–D, nebo 8 náhodných diváků. Odpovídání se po Další otázce otevře samo, až otázka dojede na obrazovku.
  • Médium nastavené „před otázkou“ se tady nepřehraje, to umí jen Ovládání.
Hraje se naostro: ukázané otázky odejdou do Archivu, výsledky i s vymyšlenými diváky se zapíšou do Historie a do Žebříčku (ze Žebříčku je nesmažeš, smazání v Historii ho nezmění) a připojený StreamQuiz píše do chatu. Zvláštní sada na zkoušku ochrání tvoje otázky, Žebříček ne (je společný pro všechny sady). Před zkouškou dej v průvodci Odpojit StreamQuiz.
Otázky, média a pořadí
  • + Nová v sekci Otázky; v editoru vyplň otázku, možnosti a zaškrtni správnou. Otázku můžeš dočasně vypnout (nehraje se, nesmaže se).
  • Otázka ANO/NE (jen 2 možnosti): vyplň jen A a B, C a D nech prázdné. V overlayi se ukážou dvě velké možnosti, do chatu se posílá „odpovídej A/B“ a hlas C/D se nepřijme (žádné trestné body za neexistující možnost). D bez C nejde uložit.
  • Ukládá se samo: hotová otázka se uloží chvilku po poslední změně — stav vidíš nahoře v editoru. Rozepsanou (neúplnou) otázku si aplikace drží jako koncept i po zavření okna: najdeš ji pod + Nová (odznak) a nabídne se ti k dokončení. Klik na žlutý stav skočí na to, co chybí.
  • Délka: otázka nejvýš 150 znaků, odpověď nejvýš 60 — delší text by na streamu rozbil vzhled. Počítadlo ukazuje, kolik zbývá. Starší delší otázky se hrají dál, jen mají v seznamu štítek dlouhá.
  • Zajímavost / vysvětlení (nepovinné): divákům se neukáže. Po odhalení ji uvidíš v rámečku s otázkou v Ovládání (a také v overlayi otevřeném s ?admin=1) a můžeš ji přečíst nahlas. Do OBS patří adresa bez ?admin=1.
  • Čas na přečtení: první odpověď naskočí až po chvíli podle délky otázky a tempa čtení z Nastavení (výchozí 10 znaků za sekundu, otázka aspoň 4 s, nejvýš 20 s), abys ji stihl přečíst nahlas. Další odpovědi naskakují stejně — podle své délky (aspoň 1,5 s, nejvýš 7 s na jednu). Odpočet začne 1 s po přečtení poslední. Zpoždění streamu se k tomu přičítá zvlášť (viz Bodování a čas).
  • Médium (foto / video / zvuk): hned po nahrání vyskočí okno Kdy se má médium přehrát — před otázkou (samostatná ukázka, pak teprve otázka), u otázky (obrázek zůstane vidět při odpovídání), nebo obojí. Bez volby otázka nejde uložit; volbu kdykoli změníš tlačítkem Změnit. Zvuk a video se přehrají celé, délka není omezená: u otázky se odpovídání otevře, až médium dohraje (délku admin změří sám a ukáže ji pod volbou).
  • Úprava během kvízu: změny otázek, které v kvízu ještě nepřišly, se propíšou rovnou do běžícího kvízu; smazaná nebo vypnutá ještě nepřišlá otázka z kvízu vypadne. Otázka, která už je na obrazovce, se nepřepíše (diváci vidí původní znění) — výjimkou je oprava správné odpovědi.
  • Pořadí: otázky se hrají přesně v pořadí seznamu — přesouvej je šipkami nahoru / dolů. Číslo vlevo = pořadí přehrání.
  • Chceš losovat? Zapni v Nastavení volbu Zamíchat pořadí otázek.
  • Kolik otázek se hraje: normálně všechny aktivní (klidně 50 — kvíz můžeš kdykoliv ukončit tlačítkem Ukončit kvíz a nedohrané otázky zůstanou na příště). Chceš pevný počet (třeba 30)? Nastav v Nastavení volbu Kolik otázek v jednom kvízu — když je dostupných míň, hraje se prostě maximum.
  • Archiv: každá otázka, která se ukázala na streamu, se automaticky přesune do záložky Archiv a příště se už nehraje (diváci ji už viděli). V Archivu ji můžeš kdykoliv Vrátit do hry, nebo Vrátit vše (třeba pro nové publikum).
Sady otázek
  • Každá sada je vlastní seznam otázek — třeba „Filmový kvíz“, „Hudba 90. let“. Přepínáš je v sekci Sady tlačítkem Přepnout (během běžícího kvízu to nejde).
  • U každé sady jsou vpravo ikony: přejmenovat, zduplikovat, stáhnout jako ZIP včetně médií (třeba pro kamaráda) a smazat. Aktivní sadu smazat nejde.
  • Načíst otázky ze souboru naimportuje ZIP i JSON.
  • Přesun otázek mezi sadami: v sekci Otázky klikni na Vybrat víc otázek, zaškrtej je a dej Přesunout do jiné sady. Tak sloučíš várky od víc diváků do jedné.
Otázky od lidí
  • Nech si otázky psát od diváků, aniž bys jim dával přístup do kvízu. V sekci Otázky od lidí klikni na Stáhnout soubor pro diváky — stáhne se StreamQuiz-otazky.html. Ten pošli na Discord nebo mailem.
  • Divák ho otevře dvojklikem (nic neinstaluje, nic se nikam neodesílá), vyplní otázky, může přiložit obrázek, zvuk nebo video, a klikne na Vytvořit soubor pro streamera. Dostane jeden .zip, který ti pošle zpátky.
  • Ten zip načteš tlačítkem Načíst otázky od diváka. Vybereš, jestli z toho udělat novou sadu, nebo otázky přidat k těm, co už máš. Média se načtou s nimi.
  • U každé takové otázky pak v seznamu uvidíš štítek s nickem a tématem, ať víš, od koho je. Otázky můžeš normálně upravovat i mazat.
  • Rozepsaná otázka se divákovi ukládá sama (i s přílohou). Když klikne na Vytvořit soubor a má ve formuláři otázku, kterou ještě nepřidal do seznamu, appka se zeptá, jestli ji přidat.
Jak diváci odpovídají
  • Chat: divák napíše jen A / B / C / D (u otázky se dvěma nebo třemi možnostmi platí jen nabízená písmena). Počítá se první odpověď, měnit ji nejde.
  • Whisper (když je zapnutý): /w tvůj_účet A — odpověď nevidí ostatní.
  • Web: diváci hlasují na odkazu pro diváky (přihlásí se přes Twitch, 1 hlas na otázku). Hlasování na webu je zapnuté od začátku (vypneš ho v kroku 2 průvodce). Aktuální odkaz ukazuje karta Odkaz pro diváky v Ovládání (obnovuje se sama) i krok 3 průvodce — a bot ho sám píše do chatu při startu kvízu a pak každou pátou otázku, a znovu když se po novém připojení změní (vypneš v průvodci přepínačem Odkaz na web hlasování do chatu).
  • Odkaz se mění při každém spuštění StreamQuizu, po novém připojení v průvodci i po obnovení místnosti na serveru — divákům posílej vždy ten aktuální. Po novém připojení a po obnovení místnosti ho bot sám napíše do chatu, po spuštění StreamQuizu ne. Starý odkaz se ještě nějakou dobu otevře, ale otázky na něj už nechodí — stránka jen čeká. Když místnost na serveru úplně zanikne, stránka divákovi napíše, že skončila, a poradí mu požádat tě o nový.
  • Na webu divák po odhalení vidí, jestli se trefil a co bylo správně, a po konci kvízu kartu Kvíz skončil se svým místem, body a vítězem. Stránka může zůstat otevřená — další kvíz na ní naskočí sám, dokud StreamQuiz nevypneš ani se znovu nepřipojíš (pak platí nový odkaz).
  • Vše se počítá dohromady — jeden divák = jeden hlas, ať odpoví kdekoliv.
Bodování a čas
  • Podle rychlosti — čím dřív správně, tím víc bodů (přesné hodnoty ukazuje popisek v Nastavení).
  • Jen správně — každá správná odpověď stejný počet bodů, rychlost nehraje roli.
  • Trestné body za špatnou odpověď — ve výchozím stavu zapnuté, −25 bodů. Diváci tak nemůžou jen tipovat naslepo. Skóre může jít i do minusu. Nechceš to? Nastav v Nastavení na 0.
  • Tempo čtení, Nejkratší čas na otázku a Nejkratší čas na přečtení odpovědi — jak dlouho otázka i každá odpověď zůstane sama, než naskočí další (podle délky textu; výchozí 10 znaků za sekundu, otázka aspoň 4 s, odpověď aspoň 1,5 s a nejvýš 7 s). Odpočet začne 1 s po přečtení poslední odpovědi. Pod slidery vidíš, za kolik sekund po kliknutí na Další otázku naskočí otázka, každá odpověď a kdy se začne odpovídat. Změna platí od další otázky.
  • Kolik času mají diváci na odpověď — délka odpočtu; změna platí od další otázky.
  • Zpoždění tvého streamu — o kolik sekund později vidí diváci tvůj obraz (typicky 3–10 s, změříš to na mobilu). Kvíz o tolik prodlouží odpovídání a otázku pošle do chatu a na web později; odpočet na obrazovce zůstane stejný. Do průměrného času ve statistikách se zpoždění nepočítá. Výchozí jsou 2 s (na Twitchi je zpoždění vždy, i v režimu nízké latence 2–4 s), 0 = vypnuto.
  • „Můj hlas se nepočítal“ — pod rámečkem s otázkou v Ovládání se po zavření hlasování ukáže řádek Nezapočítáno: kolik hlasů přišlo pozdě (a o kolik sekund), kolik před otevřením odpovědí, kolik bylo opakovaných (počítá se vždy první odpověď) a kolik použilo písmeno, které otázka nenabízí. Pozdní hlasy skoro vždy znamenají nenastavené Zpoždění streamu. A ještě jedna past mimo kvíz: Twitch nepošle stejnou zprávu dvakrát do 30 sekund — kdo odpoví „A“ a hned na další otázku zase „A“, druhou zprávu Twitch tiše zahodí. Kvíz proto bere i „A.“, „A!“ nebo „a)“ a na startu to divákům připomene.
  • Ukázat, kdo odpověděl špatně — po odhalení ukáže v overlayi i seznam diváků se špatnou odpovědí (u jména i kolik bodů ztratil).
  • Žebříček — dlouhodobé výsledky napříč všemi kvízy: body, přesnost, výhry, účast. Vidíš je jen ty tady v aplikaci, divákům se nikde neukazují. V aplikaci se smazat nedá a smazání kvízu v Historii ho nezmění.
Zvuky
  • Sekce Zvuky: přehraje zvuk lokálně (jen tobě), zaškrtávátko zapíná/vypíná zvuk v kvízu, slider = hlasitost, nahraje vlastní mp3/ogg/wav, vrátí původní.
  • Overlay si změny načte při startu dalšího kvízu.
  • Zvuky se nepřekrývají: nový zvuk utne předchozí (krátce dozní), hudba hlasování počká, až dohraje zvuk konce času, a pod zvukem nebo videem otázky mlčí pípání odpočtu. Spolu hrají jen šuch se znělkou otázky a tichý podkres pod odpočtem.
Historie a export
  • Sekce Historie ukazuje posledních 300 kvízů — u každého datum, sadu, počet otázek a hráčů, délku a první tři. Starší se nemažou, jen se přesunou do souboru StreamQuiz-data/data/quiz_history_archive.json (vedle StreamQuiz.exe; když tam nejde zapisovat, v %LOCALAPPDATA%\StreamQuiz).
  • Zobrazit pořadí ukáže celé výsledky. Stáhnout .txt = výsledková listina (můžeš vložit do chatu/Discordu). Prázdné kvízy (nikdo nehrál) se neukládají.
  • Statistiky z konce kvízu se do Historie neukládají. Smazání záznamu Žebříček nezmění.
Aktualizace na novou verzi
  • Všechna tvoje data (nastavení, přihlášení k Twitchi, otázky, sady, historie, žebříček, vlastní zvuky a média) jsou ve složce StreamQuiz-data vedle StreamQuiz.exe. Nová verze je musí najít na stejném místě.
  • 1. StreamQuiz vypni (Vypnout StreamQuiz vlevo dole v menu) — běžící program by nešel přepsat.
  • 2. Nový ZIP rozbal do stejné složky jako minule a nech soubory přepsat. Složky StreamQuiz-data se rozbalení nedotkne.
  • Rozbalil jsi ZIP jinam (Průzkumník nabízí novou složku pojmenovanou podle ZIPu)? StreamQuiz pak začne „od nuly“ a při startu ti napíše, kde našel starší data (do okna konzole i do průvodce, kde upozornění zůstane, dokud ho nezavřeš). Stačí vypnout, přesunout složku StreamQuiz-data ze staré složky vedle nového StreamQuiz.exe a spustit znovu.
  • 3. V OBS dej na browser sourcu „Obnovit cache aktuální stránky“.
  • Záloha před aktualizací: Zálohovat data (ZIP) · bez médií. V ZIPu je nastavení, otázky, sady, historie, žebříček, vlastní vzhledy a zvuky (a média, pokud je nevynecháš). Přihlášení k Twitchi se nezálohuje — po obnově se jen znovu přihlásíš v průvodci. Obnova: StreamQuiz vypni a ZIP rozbal do složky StreamQuiz-data (soubory nech přepsat).
  • Novou verzi ti StreamQuiz ohlásí sám: jednou po spuštění (a pak jednou za 6 hodin) se zeptá mikvr.stream, jaká verze je venku, a v Ovládání nahoře ukáže odkaz ke stažení. Posílá jen svou verzi, nic jiného. Nechceš to? Do quiz_config.json dej "update_check": false.
Nahlásit problém
  • Když se něco chová divně, stáhni diagnostiku (ZIP) a pošli mi ji na Twitchi (mik_VR) spolu s tím, co jsi dělal a co se stalo.
  • Co v ZIPu je: verze StreamQuizu, verze Windows, tvoje nastavení bez tajných hodnot, stav připojení a kvízu, přehled sad a soubor streamquiz.log (co aplikace psala do konzole). Není tam přihlášení k Twitchi ani otázky samotné.
  • Nejdřív ale zkus dvě věci, které řeší většinu potíží: v OBS „Obnovit cache aktuální stránky“ a v průvodci Odpojit → Připojit ke kanálu.
Řešení problémů
  • Overlay ukazuje vlevo nahoře červený rámeček „NESOULAD VERZÍ“ → v OBS „Obnovit cache aktuální stránky“ na browser sourcu.
  • Spustil jsi StreamQuiz podruhé → když už jeden běží, nové okno otevře v prohlížeči jeho Ovládání a samo se zavře. Okno napíše, že adresu nejde otevřít → port (výchozí 8080, server_port v quiz_config.json) drží jiný program, nebo ho má rezervovaný Windows. Zavři ten program a StreamQuiz spusť znovu, případně změň server_port a pak uprav i adresu overlaye v OBS.
  • Bot nepíše do chatu / odpovědi se nepočítají → Ovládání tě na to upozorní červeným rámečkem nad velkým tlačítkem, když Twitch přihlášení odmítl i když StreamQuiz k Twitchi vůbec není připojený. Otevři Průvodce nastavením (vlevo dole v menu, nebo Nastavení → Připojení Twitche → Otevřít průvodce). Svítí-li nahoře Přihlášení vypršelo nebo krok 1 žádá přihlášení (po aktualizaci z verze starší než 2026-10-06a jednou ano), přihlas se v kroku 1 znovu a v kroku 2 dej Připojit ke kanálu. Ukazuje-li krok 1 Přihlášen jako …, klikni na Pokračovat a v kroku 2 na Připojit ke kanálu. Otevře-li se průvodce rovnou v kroku 3, dej Odpojit StreamQuiz a znovu Připojit ke kanálu; svítí-li tam varování, řiď se jím.
  • Ovládání hlásí, že výsledky nebo nastavení nejde uložit → soubor s daty nejspíš drží jiný program (antivir, OneDrive). StreamQuiz chvíli počká a zkusí to znovu; když to pořád nejde, nic nepřepíše (otázky, sady, historii, celkový žebříček, hlasitosti, zvuky ani vlastní styly). Výsledky kvízu a body do žebříčku uloží zvlášť (quiz_history.neulozene-*.json a leaderboard.neulozene-*.json) a v hlášce napíše, kam přesně; do Historie ani žebříčku se samy nedoplní. Varování ukáže i Vypnout StreamQuiz, když při tom ukončí kvíz nebo kvíz skončil těsně předtím. Změnu zkus udělat za chvíli znovu. Když Ovládání hlásí, že soubor s nastavením byl při startu zamčený, vypni StreamQuiz a spusť ho znovu — nastavení do té doby neukládá, aby tvoje nepřepsal. Když se při startu nepodařilo načíst seznam sad, obnov stránku; na tvoji aktivní sadu StreamQuiz přepne sám, jakmile seznam půjde načíst. (Poškozený soubor po ruční úpravě je jiný případ, tam rámeček poradí, co s ním.) Když se to opakuje, přesuň složku se StreamQuizem mimo OneDrive, nebo jí dej výjimku v antiviru.
  • Web hlasování nejede → podívej se do kroku 3 průvodce, jestli tam není varování; bot ti navíc napíše do chatu, když je služba nedostupná. Zkus v kroku 3 Odpojit StreamQuiz, v kroku 2 nech zapnuté Hlasování na webu a dej Připojit ke kanálu. Vznikne nový odkaz — bot ho napíše do chatu.
  • Divákům web píše, že místnost skončila, nebo jen čeká a otázky nechodí → mají starý odkaz. Pošli jim aktuální z karty Odkaz pro diváky v Ovládání.
  • Zvuk v prohlížeči nehraje hned → prohlížeč blokuje zvuk do prvního kliknutí do stránky. V OBS tohle neplatí.
  • Mám OBS na jiném počítači a overlay je černý → StreamQuiz záměrně poslouchá jen na svém počítači (127.0.0.1), aby ti nikdo na síti neviděl správné odpovědi dopředu. Když OBS běží jinde, StreamQuiz zavři (jinak by soubor při uložení nastavení přepsal), ve složce StreamQuiz-data vedle StreamQuiz.exe (když tam nejde zapisovat — třeba v Program Files nebo na OneDrivu — najdeš ji v %LOCALAPPDATA%\StreamQuiz) otevři v Poznámkovém bloku quiz_config.json a přepiš "bind_host": "127.0.0.1" na "0.0.0.0". Nic dalšího tam měnit ani vyplňovat nemusíš. Pak StreamQuiz spusť a v OBS použij http://<IP-tvého-PC>:8080/. Pozor: ovládání kvízu nemá heslo — v tomhle režimu se k němu dostane kdokoliv na stejné síti. Adresu zadávej jako IP nebo jméno bez tečky (např. http://quizpc:8080/); jiné jméno s tečkou StreamQuiz odmítne (ochrana před podvrženou doménou) — povolíš ho v quiz_config.json řádkem "allowed_hosts": ["jmeno.domena"].
  • Technický log: StreamQuiz-data/streamquiz.log (vedle StreamQuiz.exe; když tam nejde zapisovat, v %LOCALAPPDATA%\StreamQuiz) — pošli ho, když něco hlásíš.

Načíst otázky