What's in the pack
You should have two files in the folder you downloaded. Each one is a standalone HTML file - open it in any browser to preview it, or add it as a Browser Source in OBS.
Standalone chat hype meter. Connects directly to Twitch - no Streamer.bot needed. Set your channel via ?channel= in the OBS URL. No file editing required.
Top 5 chatters leaderboard with animated rank-change transitions. Connects directly to Twitch - no Streamer.bot needed. Set your channel via ?channel= in the OBS URL. No file editing required.
Hype Meter setup
No file editing required. Your channel name is set directly in the OBS browser source URL using a ?channel= parameter.
Click + in your Sources panel → Browser. Give it a name and click OK.
In the URL field, type the full path to the file and append ?channel=yourchannel:
file:///C:/path/to/hype-meter-public.html?channel=yourchannel
Replace yourchannel with your Twitch channel name (lowercase). Replace the path with wherever you saved the file.
Set width to 280 and height to 130. Click OK - done. No file editing needed.
Tip: Adjusting sensitivity. If your chat is very active, the bar may pin at 100% constantly. You can adjust the MAX_MPM value by opening the file in a text editor and changing that one line. 20–30 works well for most mid-size streamers.
Top Chatters setup
No file editing required. Same approach as the hype meter - your channel name goes in the OBS browser source URL.
Click + in your Sources panel → Browser. Give it a name and click OK.
In the URL field, type the full path to the file and append ?channel=yourchannel:
file:///C:/path/to/top-chatters-public.html?channel=yourchannel
Replace yourchannel with your Twitch channel name (lowercase). Replace the path with wherever you saved the file.
Set width to 430 and height to 330. Click OK.
Tick this option in the Browser Source properties. This resets the leaderboard to zero at the start of each stream instead of carrying over data from last time.
OBS browser source sizes
| File | Width | Height | Needs Streamer.bot? |
|---|---|---|---|
| hype-meter.html | 280 px | 130 px | No - connects directly to Twitch |
| top-chatters-public.html | 430 px | 330 px | No - connects directly to Twitch |
Both files work with a transparent background in OBS. Make sure your Browser Source does not have a background colour set, or tick "Custom CSS" and leave it empty. The overlays are designed to be layered on top of other sources.
Troubleshooting
The hype meter stays at SILENT
Check that your channel name is spelled correctly in the file (it must be lowercase). The status dot in the top-left of the widget turns grey when disconnected - if it's grey, the channel name is likely wrong or Twitch's servers are unreachable from OBS's browser.
The top chatters list stays empty
Check that your channel name is spelled correctly in the file (it must be lowercase). If the channel name is correct, try right-clicking the Browser Source in OBS → Properties → OK to force a refresh. Also make sure the stream is actually live - Twitch's anonymous IRC access only receives messages while the channel is broadcasting.
The overlay has a white or black background in OBS
In OBS Browser Source properties, scroll down to Custom CSS and make sure it contains at minimum: body { background-color: rgba(0,0,0,0); } - or just leave the field completely empty.