Direkt zum Hauptinhalt

Stream-Credits Troubleshooting

Browser-Source zeigt nichts oder einen Fehler

  • Prüfe die URL genau: Sie muss entweder /overlay/stream-credits/<id>/<token> (64 Hex-Zeichen) oder /overlay/stream-credits?id=...&token=... sein. Ein falscher oder abgelaufener Token zeigt einen roten Fehlertext "invalid_or_expired" statt des Abspanns.
  • Token abgelaufen? Standard-Gültigkeit ist 30 Tage — in der Vorlage auf "Token rotieren" klicken und die OBS-Source-URL neu einfügen.
  • Cache: in OBS auf die Source rechtsklicken → Quelle aktualisieren (oder "Quelle aktualisieren, wenn Szene aktiv wird" aktivieren, siehe Setup-Seite).

Es erscheinen nur Demo-Namen (LeadModOne, ModAlpha, VIP_1, Viewer_1 …)

Das ist kein Bug, sondern der eingebaute Fallback, wenn die Overlay-Seite deinen Kanal nicht zuordnen kann — z. B. weil noch kein bot_instances-Eintrag mit channel_id existiert oder channel_id in der URL falsch geschrieben ist. Prüfe:

  • Ist der Bot mindestens einmal in deinem Channel gestartet worden (Twitch-Connect aktiv)?
  • Falls du &channel_id= manuell an die URL angehängt hast: exakt deinen Twitch-Login verwenden, keine Tippfehler.

Liste ist leer, obwohl der Stream echt lief

  • Es gibt keine Mindest-Nachrichtenzahl — eine einzige Chat-Nachricht reicht rein technisch. Wenn trotzdem niemand auftaucht, hat wahrscheinlich niemand im Chat geschrieben, oder alle Schreiber wurden als Bots gefiltert (siehe unten).
  • Die Aggregation sucht standardmäßig die letzte bekannte Stream-Session (twitch_stream_id=latest). Falls du zwischen Aufnahme und Rendern mehrere Kurz-Streams hattest, zieht sie evtl. die falsche Session — dann &twitch_stream_id=<ID> explizit in der URL setzen.
  • Der Streamer selbst wird beim Rendern immer ausgeschlossen (Broadcaster-Flag) — das ist Absicht, kein Bug.

Echte Zuschauer fehlen — vermutlich fälschlich als Bot gefiltert

Chatlix filtert bekannte Bot-Namen (Nightbot, StreamElements, Fossabot, etc.) UND alles, dessen Login auf bot, _bot, botto oder bottv endet (ab 5 Zeichen Login-Länge). Das trifft in seltenen Fällen echte Menschen mit "bot" im Namen. Es gibt aktuell keine Self-Service-Whitelist dafür im Dashboard — wenn dir das passiert, ist das ein bekannter Trade-off (Recall vor Precision), kein Konfigurationsfehler bei dir.

"Falsche" Sortierung innerhalb einer Sektion

⚠️ Es gibt keine einstellbare Sortierung für Namen. Server-seitig wird innerhalb jeder Sektion immer nach Nachrichtenanzahl absteigend sortiert (aktivster Chatter zuerst), bei Gleichstand nach letzter Aktivität. "Alphabetisch" oder "Reihenfolge des Auftauchens" existieren nicht als Optionen — falls dir das jemand als Feature verkauft hat, ist das veraltet oder falsch.

Lead-Mod / Mod / VIP fehlt im Abspann

  • Rollen werden ausschließlich aus den IRC-Chat-Badges der jeweiligen Nachricht gelesen (kein separater API-Abruf einer Mod-/VIP-Liste). Das heißt konkret: Der User muss in der Stream-Session mindestens einmal im Chat geschrieben haben — reiner VIP-/Mod-Status ohne eine einzige Nachricht reicht nicht, um im Abspann zu erscheinen.
  • Twitch braucht 1–2 Minuten, bis ein frisch vergebener Mod-/VIP-Status in den Chat-Badges auftaucht — bei Live-Beförderungen kurz vor Stream-Ende kann das knapp werden.

Subscriber erscheinen nicht als eigene Sektion

Das ist kein Fehler: Der Subscriber-Status wird zwar pro Chatter mitgespeichert, aber es gibt keine eigene "Subs"-Sektion im Abspann (nur Lead-Mods/Mods/VIPs/Zuschauer). Ein Sub ohne Mod-/VIP-Rolle landet ganz normal unter "Zuschauer". Wenn du Subs sichtbar hervorheben willst, bleibt aktuell nur der Umweg über den Sektionstitel selbst umzubenennen — es gibt keine automatische Sub-Sektion.

"Ich brauche wohl einen speziellen Twitch-Scope" — nein

Anders als früher hier behauptet: Es ist kein channel:read:subscriptions-Scope oder Mod-Scope für Stream-Credits nötig. Die normale Chat-Verbindung des Bots reicht, weil Rollen aus den Chat-Badges jeder Nachricht kommen, nicht aus einem separaten API-Call. Wenn VIPs/Mods trotzdem fehlen, ist die Ursache fast immer "hat nicht gechattet" oder "Bot war nicht verbunden", nicht ein Scope-Problem.

Lange Liste — Abspann läuft (gefühlt) endlos

  • Erhöhe das Scroll-Tempo (Standard 80 px/s, Range 10–400).
  • Setze ein Limit pro Sektion (z. B. Zuschauer auf 200 statt unbegrenzt — Zuschauer-Limit ist per Default bereits auf 500 in der Aggregation gedeckelt, "Lead-Mods/Mods/VIPs" sind dagegen technisch unlimitiert).
  • Sektionen, die du nicht brauchst, in der Vorlage abwählen.
  • "Loop" ausschalten, falls aktiv — sonst läuft der Abspann bewusst endlos weiter, bis du die Szene wechselst.

Overlay-URL ist öffentlich geworden — was jetzt?

Die URL enthält einen 64-stelligen Hex-Token pro Vorlage. In der Vorlage-Detailseite gibt es den Button "Token rotieren" — danach ist die alte URL sofort ungültig (Server prüft mit hash_equals, kein Cache-Fenster). Denk daran, die neue URL danach in OBS nachzutragen, sonst zeigt deine Source den Fehlerzustand.

Menüpunkt "Stream-Credits" fehlt komplett in meiner Sidebar

Stream-Credits ist als Power-User-Feature eingestuft und erscheint standardmäßig nicht im normalen Dashboard-Menü. Nutze die Direkt-URL https://chatlix.app/dashboard/stream-credits, die Cmd-K-Palette, oder stelle dein Menü im Dashboard auf "Eigenes Menü"/Power-Ansicht um.

Siehe auch