OBS Chat Overlay for StreamerBot
  • HTML 79.8%
  • JavaScript 20.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Renovate Bot 599b24559e
All checks were successful
CodeQL / Analyze (push) Has been skipped
CodeQL / CodeQL Scan (Forgejo) (push) Successful in 1m26s
Update https://code.forgejo.org/forgejo/upload-artifact action to v5 (#6)
This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [https://code.forgejo.org/forgejo/upload-artifact](https://code.forgejo.org/forgejo/upload-artifact) | action | major | `v4` → `v5` |

---

### Release Notes

<details>
<summary>forgejo/upload-artifact (https://code.forgejo.org/forgejo/upload-artifact)</summary>

### [`v5`](https://code.forgejo.org/forgejo/upload-artifact/compare/v4.3.1...v5)

[Compare Source](https://code.forgejo.org/forgejo/upload-artifact/compare/v4.3.1...v5)

</details>

---

### Configuration

📅 **Schedule**: (UTC)

- Branch creation
  - At any time (no schedule defined)
- Automerge
  - At any time (no schedule defined)

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this PR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Mend Renovate CLI](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0NC4xNC4xMiIsInVwZGF0ZWRJblZlciI6IjQ0LjQxLjEiLCJ0YXJnZXRCcmFuY2giOiJtYWluIiwibGFiZWxzIjpbIkRlcGVuZGVuY2llcyIsIktpbmQvRGVwZW5kZW5jeSJdfQ==-->

Reviewed-on: #6
2026-08-25 01:50:08 +00:00
.github Update https://code.forgejo.org/forgejo/upload-artifact action to v5 (#6) 2026-08-25 01:50:08 +00:00
assets/readme Update README generator screenshot 2026-07-15 17:03:02 +03:00
chat.html Support Streamer.bot 1.0.7 chat payloads 2026-08-11 23:04:17 +03:00
CNAME Add README generator screenshot 2026-07-15 16:59:47 +03:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2022-07-13 12:39:00 +02:00
generator.html Release stream-chat-rebooted 0.4.0 2026-07-15 00:21:50 +03:00
generator.js Support Streamer.bot 1.0.7 chat payloads 2026-08-11 23:04:17 +03:00
LICENSE Initial commit 2022-03-27 21:13:12 +02:00
options.md Support Streamer.bot 1.0.7 chat payloads 2026-08-11 23:04:17 +03:00
README.md Improve Twitch and YouTube chat support 2026-07-15 17:20:54 +03:00
renovate.json feat: Configure Renovate (#1) 2026-08-17 07:15:31 +00:00
test.html Update test.html 2023-03-30 00:36:12 +02:00

stream-chat-rebooted

Active continuation

This repository is an active continuation of Izzy's original stream-chat project. Full credit for the original overlay and foundation goes to Izzy.

I am actively maintaining this continuation so the project can keep receiving updates, fixes, and support beyond the original repository's planned archive.

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

Stream Chat Overlay URL generator

Supported platforms

stream-chat-rebooted supports chat messages from Streamer.bot for Twitch, YouTube, and Kick. Platform support includes chat messages, emotes, badges, and message removal after user bans or timeouts where Streamer.bot emits those moderation events.

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

You can also use the hosted generator at https://chat.narnacle.com/generator.html.

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 its own data collection policies.

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.

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)

Contributors / Thanks

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