Skip to content

Troubleshooting

Kristopher Barrantes edited this page Oct 30, 2026 · 4 revisions

Troubleshooting

Reporting a problem

Settings > Support builds a report with your Cuebot version, system details and recent log. Tokens, passwords, stream keys, API keys, client secrets and webhook URLs are always removed, and account names too unless you choose to keep them. You see exactly what will be sent before anything leaves your computer. From there you can open a GitHub issue with the report filled in, or copy or save it.

If Cuebot crashed, it offers Report it... the next time it starts.

Never paste tokens, passwords or stream keys into an issue by hand.

Common problems

Windows says "Windows protected your PC". Cuebot is not code-signed yet. Click More info, then Run anyway.

Google says "Google hasn't verified this app". Google is still reviewing Cuebot's YouTube access. Click Advanced, then Go to Cuebot.

A platform says "sign in again". The platform ended the sign-in (for example after a password change, or when you removed Cuebot's access on the platform). Open the platform's page and sign in again.

OBS does not connect. Check that Tools > WebSocket Server Settings > Enable WebSocket server is on in OBS and that the port and password in Cuebot match. If OBS runs on another computer, use that computer's address and allow the port in its firewall.

Nothing happens when an event arrives. Check that the action and the trigger are both switched on, and that the platform is connected (the top bar shows a chip per connection). Chat > History shows every run; the Log tab on the Dashboard shows warnings, such as a Twitch permission you did not grant.

Text-to-speech is silent on Linux. Install espeak-ng, and one of pw-play (PipeWire), paplay or aplay.

The window does not appear on Linux. Start Cuebot from a terminal to see the log, or try --backend=x11. See Linux.

I lost the window. Start Cuebot again: the running copy comes to the front. --reset-window puts it back on the main screen.

Where the logs are

In the data folder's logs folder (see Backups and Your Data). The Dashboard's Log tab shows the current log.

Clone this wiki locally