Erstes Setup in 5 Minuten

Dieses Kapitel bringt dich vom frischen Account zur ersten sichtbaren Overlay-Quelle in OBS mit einem funktionierenden Test-Alert. Der schnellste Weg dahin ist der eingebaute Setup-Wizard im Dashboard unter /dashboard/wizard („OBS & Connect Setup" in der Sidebar, Bereich „Stream vorbereiten" → „Setup"). Er fuehrt dich in fuenf Schritten durch genau das, was hier beschrieben ist, inklusive Fortschrittsanzeige und automatischer Diagnose bei Problemen.

Was du brauchst

• Chatlix-Account (siehe „Account anlegen" — Registrierung ist aktuell invite-only)
• OBS Studio installiert, mit aktiviertem WebSocket-Server falls du spaeter Connect nutzt
• Twitch-Account, mit dem du streamst und der Mod-Rechte vergeben kann

Schritt 1: Twitch-Account verbinden

Im Wizard klickst du auf „Mit Twitch verbinden". Das laeuft ueber /oauth/twitch/login im Modus „link" (du bist ja schon eingeloggt, brauchst also keinen Invite-Code mehr). Nach dem Redirect zurueck steht der Status auf „verbunden". Falls du dich schon direkt per Twitch-OAuth registriert hast, ist dieser Schritt automatisch erledigt.

Chatlix bekommt dabei einen ganzen Satz Scopes fuer Chat, Moderation, Redemptions, Hype Train, Ads und Polls (Details in „Wichtige Konzepte"). Das ist mehr als reiner Lesezugriff — der Bot kann aktiv chatten und moderieren.

Schritt 2: Bot starten und zum Mod machen — Pflicht

Das ist der Schritt, der am haeufigsten uebersprungen wird und danach fuer Verwirrung sorgt: Der Chatlix-Bot muss in deinem Twitch-Chat Moderator sein, sonst funktionieren Timeouts, geloeschte Nachrichten, manche Commands und Redemption-Reaktionen nicht zuverlaessig. Der Wizard zeigt dir dafuer einen Button, der den noetigen Twitch-Chatbefehl bzw. Link liefert, um den Bot zum Mod zu befoerdern. Erledige das, bevor du weitermachst — der Wizard laesst dich sonst zwar technisch weiterklicken, aber Moderation bleibt kaputt.

Schritt 3: Erstes Overlay anlegen

Im Wizard installierst du per Klick ein Starter-Preset (Route /v1/onboarding/install-starter-pack), das dir sofort ein fertiges Overlay mit sinnvollen Grundeinstellungen anlegt. Alternativ gehst du in den Bereich „Pro Editor" bzw. „Meine Overlays" (Sidebar unter „Stream vorbereiten" → „Overlays & Auftritt") und legst manuell ein neues Overlay an.

Jedes Overlay bekommt eine eindeutige Render-URL der Form https://chatlix.app/overlay/view.php?id=...&token=.... Diesen Token brauchst du im naechsten Schritt.

Schritt 4: Browser-Source in OBS

1. In OBS bei deiner Szene auf das Plus unter „Quellen" klicken.
2. „Browser" waehlen, Namen vergeben.
3. Die Overlay-URL aus dem Wizard kopieren (eigener Kopier-Button) und einsetzen.
4. Breite/Hoehe auf deine Canvas-Aufloesung setzen — der Wizard bietet dafuer direkt Kopier-Buttons fuer 1920 und 1080 an.
5. OK, danach im Wizard auf „Habe ich erledigt" klicken.

Wichtig: Den Token in der URL nicht oeffentlich teilen (nicht im Stream zeigen, nicht in Chat-Commands verlinken). Wer ihn hat, kann dein Overlay rendern.

Schritt 5: Letzter Check — Test-Alert

Der Wizard prueft: laeuft OBS, ist die Browser-Source aktiv? Dann klickst du auf „Test-Alert senden" und schaust auf deinen Stream-Screen — dort sollte ein Follow-Alert erscheinen. Kommt nichts an, startet der Wizard automatisch eine Diagnose (Route /v1/onboarding/diagnose?overlay_id=...) und zeigt dir konkrete Fehlerursachen an, statt dich raten zu lassen. Du kannst die Diagnose auch manuell ueber den Button „Probleme diagnostizieren" anstossen.

Live gehen

1. In OBS Stream starten.
2. Im Dashboard Live-Status pruefen (Live Control Room, Sidebar „Live steuern").
3. Optional: einen kurzen Test-Stream mit privatem/unlisted Status fahren, um Reaktionen unter echter Last zu sehen, bevor Zuschauer zusehen.

Alternative: der gamifizierte Einstieg

Neben dem praktischen Wizard gibt es unter /dashboard/onboarding einen zweiten, spielerischeren Einstiegsflow mit sieben Schritten (Intro, Game-Watcher-Download, Twitch verbinden, Heartbeat-Demo mit erkanntem Minecraft, Demo-Event abspielen, Magic-Moments-Overlay-Test mit vorgefertigten Cinematics wie „Boss Cinematic" oder „Diamond Hype", Abschluss). Der ist eher fuer den ersten Eindruck gedacht und ersetzt den Wizard nicht vollstaendig — fuer den echten Live-Betrieb brauchst du trotzdem ein reales Overlay mit Browser-Source, wie oben beschrieben.

Was du als Naechstes machen kannst

• Chatlix Connect installieren, wenn du Szenen/Quellen aus Automations heraus umschalten oder Smart Lights/Stream-Deck nutzen willst (siehe Book „Chatlix Connect")
• Mehrere Overlays fuer verschiedene Szenen anlegen
• Automation-Vorlagen unter „Stream vorbereiten" → „Automation" durchgehen und eigene Reaktionen bauen
• StoryQuest fuer interaktive Formate ausprobieren

Schnelle Sanity-Checks