Almost there: the site is not configured yet
This page is for the person who installed Cat Hype Train. The following settings are missing on the server:
Add them to the project's environment variables, redeploy, then reload this page. The README explains each one.
A hype train full of cats, for your stream
When a hype train starts on your channel, a wooden toy train rolls onto your stream. Every viewer who contributes gets a cat with their name on it, and new wagons couple on as more people join.
Setup takes about two minutes: connect your Twitch account, pick a size and position, then paste one link into OBS.
You will be asked to approve on twitch.tv. You never type your password here.
- Read-only access. The overlay can see hype train events, bits cheers and new subscriptions on your channel. It cannot chat, change anything, or see your email.
- Nothing to install. It runs as a normal browser source in OBS, Streamlabs Desktop and similar software.
- You stay in control. You can disconnect at any time from this page, which deletes everything stored about you.
Your Twitch connection needs to be renewed. This happens if you changed your Twitch password or removed Cat Hype Train from your Twitch connections. Your settings and your OBS link are kept.
Make it yours
A long train shrinks by itself so that every wagon stays on screen.
Lift the train to clear a webcam, a chat box or a bottom banner. At 0 it runs along the bottom edge.
Without the track, the wheels roll directly on the height you chose, for example along the top of a banner.
Up to 13 wagons fit on screen. Contributors beyond that still count, but do not get a cat.
A wooden sign with the level, the progress bar and the countdown. Drag it in the preview to put it anywhere, and pull a corner to resize it. Hide it if you already show Twitch's own hype train bar.
Add it to OBS
- In OBS, go to the Sources panel, click + and choose Browser. Name it Cat Hype Train and click OK.
-
Paste your personal overlay link into the URL field:
- Set Width to 1920 and Height to 1080. If your OBS canvas has another size, use that size instead: the train adapts.
- Leave Shutdown source when not visible and Refresh browser when scene becomes active unchecked, so the overlay stays connected when you switch scenes.
- Click OK. In the Sources list, drag Cat Hype Train to the top so it sits above your game and camera. To use it in other scenes, add it there with + β Browser β Add Existing.
Keep this link private. Treat it like a password and do not show it on stream. If it ever leaks, make a new one: the old link stops working immediately.
Check that it works
The train only appears during a hype train, so most of the time the overlay shows nothing at all. Send a test train to see it in OBS right now: six pretend viewers hop aboard, the train levels up once, then leaves after about 25 seconds.
The test only plays in your OBS, with made-up names. It is skipped if a real hype train is running.
Help
The test train does not show up in OBS
- Wait up to 20 seconds: the overlay checks for new instructions a few times a minute.
- Check that the source is visible (eye icon on) and at the top of the Sources list in the scene you are looking at.
- Open the source's properties and check that the whole link was pasted, including the part after
#key=, and that the size is your canvas size. - In the properties, click Refresh cache of current page, then send another test.
- Check that the computer running OBS is online.
When will the real train appear?
Automatically, a second or two after a hype train starts on your channel. It stays for the whole train, celebrates each level, and leaves when the train ends. You do not need to keep this page open, and you do not need to do anything before each stream.
I changed a setting. Do I need to update OBS?
No. Settings are saved as you change them and your OBS picks them up within about 20 seconds, even in the middle of a stream. The link in OBS never changes unless you make a new one.
Some contributors did not get a cat
The train holds 13 wagons, so 26 cats with two per wagon or 13 with one. After that, contributors are still counted on the level sign but have no cat. Viewers who cheer anonymously share a single cat called Anonymous.
Your Twitch connection is missing the bits or subscriptions permission, so only the top contributors reported by Twitch get a cat. Connect again and approve all three permissions to seat everyone.
Can I move or resize it directly in OBS?
Yes, it is a normal source: you can drag, scale and crop it. The size and height settings on this page are usually easier, because the overlay keeps the train inside the screen for you.
A warning about the Twitch connection appeared on the overlay
The overlay renews its Twitch access by itself, so this should be rare. It happens if you change your Twitch password, or remove Cat Hype Train under Twitch Settings β Connections. Come back to this page and click Connect with Twitch: your settings and your OBS link are kept, and the overlay reconnects by itself within a minute. The warning shows for 20 seconds and does not keep coming back during your stream.
Does it work with Streamlabs Desktop or other software?
Yes, with anything that has a browser source: Streamlabs Desktop, Meld Studio, XSplit and others. The steps are the same: add a browser source, paste the link, set the size to your canvas.
What is stored about me?
- Your Twitch user ID and username.
- The access Twitch granted, stored encrypted. It is read-only: hype train events, bits cheers and subscriptions.
- Your settings from this page.
Viewer names are only shown on the overlay while a train is running; they are never stored. Disconnect below withdraws the Twitch access and deletes all of the above.
Stop using Cat Hype Train
Withdraws the Twitch access, deletes your settings and disables your overlay link.