Blank OBS Overlay
First check the dock. If the dock is empty, fix the source/platform. If the dock works, open the exact overlay URL in a normal browser, confirm the same session, then refresh the OBS browser source.
Wrong Session
The source, dock, overlay, bot, and Event Flow pages must use the same session ID. Treat session IDs like room names: different spelling means different rooms.
dock.html?session=YOUR_SESSION
OBS Cannot Hear TTS
Plain system TTS often speaks through the computer but not through OBS Browser Source. Use a provider/browser TTS mode such as Kokoro, Piper, Kitten, eSpeak, OpenAI-compatible, or a cloud provider, or route system audio separately.
Kokoro Does Not Speak Portuguese or Spanish
Built-in Kokoro voices are English voices. For Portuguese, use Piper with pipervoice=pt_BR-faber-medium, or eSpeak with espeakvoice=pt-br. For Spanish, use Piper with pipervoice=es_ES-davefx-medium, or eSpeak with espeakvoice=es.
dock.html?session=YOUR_SESSION&speech=pt-BR&ttsprovider=piper&pipervoice=pt_BR-faber-medium
dock.html?session=YOUR_SESSION&speech=es-ES&ttsprovider=piper&pipervoice=es_ES-davefx-medium
Chrome Works But The Desktop App Does Not
The desktop app uses Electron sessions, not your normal Chrome profile. Sign in inside the app source window or use the Chrome extension path when the platform blocks embedded/app browser contexts.
TikTok Fails Or Changes Modes
Record the app mode, signing provider, status text, app version, and whether chat is visible in Standard mode. Test one TikTok mode at a time.
YouTube Chat Is Missing
Confirm the stream is live, live chat is visible, and you are using the right YouTube path: live chat, static comments, Standard capture, or WebSocket/API mode.
Bot Replies Do Not Send
Reading chat is not the same as posting chat. Check platform send-back support, account login, account role, source mode, provider response, and rate limits.
Event Flow Does Nothing
Confirm the source event reaches the dock. For audio, media, and OBS actions, keep actions.html?session=YOUR_SESSION open with the same session.