Direkt zum Hauptinhalt

Audio reagiert nicht

Wenn eine Reaction oder ein TTS-Output zwar visuell im Overlay erscheint, aber kein Ton raus geht, liegt das fast nie an Chatlix selbst — sondern am Audio-Routing zwischen Browser-Source, OBS-Mixer und Output. Bevor du hier weiter diagnostizierst, klaer zuerst, welchen Abspielweg die Action nutzt — es gibt zwei komplett getrennte Pfade in Chatlix, und die Fehlersuche unterscheidet sich fundamental:

  • Browser-Sound (Standard bei Reactions/TTS/Alerts): Audio wird im Overlay per Web-Audio abgespielt und laeuft ueber die OBS-BrowserSource. Diagnose: Abschnitte 1-6 unten.
  • Lokaler Sound (Sound-Preset, Action-Typ local.sound_play): Audio wird direkt auf dem Streamer-PC von Chatlix Connect abgespielt, komplett ohne OBS-Audio-Pfad. Diagnose: Abschnitt « Spezialfall: lokale Sound-Presets » am Ende.

Im Action-Editor unter /dashboard/actions/<id> steht der Action-Typ oben im Header. Verwechselst du die beiden, testest du am falschen Ende — z.B. OBS-Mixer pruefen, obwohl der Sound gar nicht durch OBS geht.

1. Browser-Source erscheint im Mixer?

In OBS unter Audio-Mixer (unten in der Hauptansicht) muss die BrowserSource als eigener Slider sichtbar sein. Wenn nicht:

  • Rechtsklick auf die BrowserSource → Eigenschaften → ganz unten muss « Audio ueber OBS steuern » aktiviert sein. Ohne diesen Haken spielt der Browser-Tab den Sound zwar intern ab, OBS bekommt davon nichts.
  • Nach dem Aktivieren erscheint die Source im Mixer. Pruefe, dass der Slider nicht auf -∞ dB steht (komplett stumm).
  • Pruefe das Mute-Icon links neben dem Slider — Klick stellt Stumm wieder her.

2. Audio-Monitoring korrekt eingestellt

Im Audio-Mixer rechtsklicken → Erweiterte Audio-Eigenschaften. Fuer die BrowserSource musst du in der Spalte « Audio-Monitoring » einen der folgenden Werte setzen:

  • « Nur Ausgabe » — Stream/Aufnahme bekommt den Ton, du hoerst ihn lokal nicht.
  • « Monitor und Ausgabe » — Stream/Aufnahme bekommt den Ton, du hoerst ihn lokal auch.

Wenn der Wert auf « Monitor aus » steht, hoeren nur die Zuschauer den Ton — du nicht. Wenn der Wert auf « Nur Monitor » steht, hoerst nur du den Ton — die Zuschauer nicht.

Der haeufigste Fehler: « Nur Monitor » ist gesetzt, der Streamer testet im Headset und denkt alles laeuft, aber im Stream-Output kommt nichts an.

3. Monitoring-Device korrekt

Weiterhin in Erweiterte Audio-Eigenschaften: ganz oben ist Monitoring-Geraet. Das muss dein Output-Geraet sein (Headset, Lautsprecher), nicht ein virtuelles Mikrofon. Auf VoiceMeeter-/VB-Cable-Setups ist das ein klassischer Trap — wenn das Monitoring auf eine Virtual-Cable-Input zeigt, hoerst du nichts und der Stream auch nicht.

4. OS-Mute / OS-Mixer

Windows und Linux haben einen App-Mixer (Lautstaerke-Mixer / pavucontrol). Pruefe:

  • Ist obs64.exe / obs dort nicht stummgeschaltet?
  • Ist der Browser-Sub-Prozess (OBSBrowser oder vergleichbar) nicht auf 0%?

Vor allem nach Windows-Updates wird der App-Mixer manchmal neu gewichtet und einzelne Apps landen auf sehr leise.

5. Volumen in der Chatlix-Action

Wenn die ersten vier Stufen sauber sind, liegt's an der Source. Im Dashboard unter /dashboard/sounds/<id> oder im Action-Editor:

  • Volume-Slider nicht auf 0%?
  • Bei TTS: ist die Stimme korrekt konfiguriert und der Test-Knopf liefert hoerbares Audio im Browser?
  • Bei einem Custom-Sound: ist die hochgeladene Datei tatsaechlich Audio-haltig (manche Container haben Video-Track und keinen Audio-Track)?

Der « Test »-Button im Sound-Editor spielt die Datei im Browser ab. Wenn er dort nichts spielt, kommt sie auch nicht in OBS an.

6. Stream-Output testen

Ein lokales Recording mit « Aufnahme starten » (10 Sekunden), Trigger ausloesen, Aufnahme beenden, Datei in einem Player oeffnen. Wenn die Aufnahme den Ton enthaelt, ist das Routing korrekt — Zuschauer hoeren ihn dann auch. Wenn nicht, ist es ein OBS-internes Routing-Problem, kein Chatlix-Problem.

Spezialfall: Reactions ohne Sound

Manche Reactions sind bewusst stumm konfiguriert (rein visuell). Pruefe im Reaction-Editor unter /dashboard/reactions/<id>, ob ein Sound zugeordnet ist. Wenn die Reaktion aus dem Standard-Pack stammt und stumm ist, ist das as designed.

Spezialfall: lokale Sound-Presets (Connect, kein OBS-Pfad)

Manche Sound-Actions sind vom Typ local.sound_play — diese spielen die Datei direkt auf dem Streamer-Rechner ab, ausgeloest von Chatlix Connect, nicht von der Overlay-BrowserSource. Kein Schritt oben (Mixer, Monitoring, BrowserSource) greift hier ueberhaupt. Diagnose:

  • Connect-Status muss online sein — ohne Connect kommt der Intent nie an. Siehe Seite « Connect-Status: offline ».
  • Das Preset muss auf der Maschine lokal registriert sein (im Connect-Installationsordner unter sounds-user/ abgelegt und in sounds-user/index.json eingetragen) — der Cloud-Dienst kennt nur die preset_id, nie den Dateipfad. Fehlt der Eintrag oder die Datei, meldet Connect den Fehlercode preset_not_found bzw. file_missing — sichtbar im Event-Log als Action-Fehler.
  • Nur unterstuetzte Dateiendungen sind erlaubt; eine falsche Endung ergibt bad_extension.
  • Es kann technisch bedingt immer nur ein lokaler Sound gleichzeitig abgespielt werden (single-concurrent-Guard). Wenn kurz hintereinander zwei Trigger kommen, wird der zweite mit busy abgewiesen — kein Bug, sondern Absicht (kein Overlap-Spam).
  • Wenn auf dem System kein unterstuetztes Audio-Backend gefunden wird, meldet Connect executor_unavailable — dann hilft nur ein Systemcheck auf dem Streamer-PC (fehlender Media-Player/Codec), keine Chatlix-Einstellung.

Diese Fehlercodes stehen im Connect-Log (logs/connect.log im Connect-Installationsordner) und im Event-Log des Dashboards. Schick den Fehlercode direkt mit an den Support — er grenzt die Ursache sofort ein, ohne Rueckfragen.

Siehe auch: « Connect-Status: offline », « BrowserSource flackert », « Reward erstellt aber nichts passiert ».