izzy/stream-chat

OBS Chat Overlay for StreamerBot

stream-chat

Chat Overlay for OBS based on streamer.bot's websocket, using pronouns from pronouns.alejo.io.

Installation

Local

To use the Chat overlay locally just download the newest release from the releases page and unpack it somewhere OBS can reach it.

After unpacking you can open generator.html in a browser to open the configurator.

Online

While this is the easier method, using the online method comes with some drawbacks. First and foremost that Github has a soft limit on Bandwidth and Availability. There is no guarantee that this will always work.

Also keep in mind that Github has their own data collection policies.

To get started with using this method go to https://chat.bean.tools/generator.html

Configuration

Supported settings are in options.md. It's easier to use the generator page, but in case you want to build the URL by hand or programatically, these might be helpful

Troubleshooting

Generally the best way to troubleshoot is to open the browser console (F12) and check for any errors. Error messages in the console might differ depending on your browser. Given OBS is based on CEF(Chromium Embedded Framework) it's likely that Chrome's console is the most accurate.

If you're not sure what to do, feel free to open an issue and we'll try to help. You can also join the discord(see below) and we can help you in text or voice chat.

Settings set in the generator aren't working in OBS

Possible reasons:

• You have not removed the Local File checkbox in the OBS Source

Solution

• Uncheck Local File and paste the generated URL again

Can't connect to WebSocket

Possible errors in the console:

• Firefox can’t establish a connection to the server at ws://127.0.0.1:8080/
• Websocket connection to 'ws://127.0.0.1:8080/' failed: [...]

Possible reasons:

• Streamer.Bot is not running
• Streamer.Bot is listening on a different port
• Streamer.Bot is listening on a port that is not exclusively available

Troubleshooting:

• Make sure Streamer.Bot is running
• If you're using a custom port, make sure it's the same as the one in the overlay's URL
• If you're using a custom port, make sure it's not in use by another application(try a different port)
• To make sure the port is exclusively available, close Streamer.Bot and run Get-Process -Id (Get-NetTCPConnection -LocalPort 8080).OwningProcess in PowerShell. If the output is empty, the port is available, otherwise it's in use by another process and you should probably try a different port.

WebSocket connected but doesn't show messages

Possible errors in the console:

• No direct errors
• Log will say connected, but not say SUBSCRIBE: ok

Possible reasons:

• Wrong kind of Streamer.Bot websocket server started

Troubleshooting:

• Make sure that in Streamer.Bot you started the internal Websocket server(under "Websocket Server"), not a custom one(under "Websocket Servers" - mind the plural)

I've read this README but I still have questions/problems, where can I get help?

If you have a Github account, opening an issue is the best way to give feedback. Otherwise feel free to join my Discord and ask your questions in the appropriate support channels.

Contributors / Thanks

Thanks to @andi242 for his fork on https://github.com/andi242/twitch-chat