Add Breakcastr to OBS
This guide gets Breakcastr into OBS. The one thing you must add is the overlay browser source. Your studio is separate and does not have to live in OBS at all.
Overview
Breakcastr gives you two links. Each goes into OBS in one place.
| Link | What it is | Where it goes | How you get it |
|---|---|---|---|
| Overlay URL | The graphics your viewers see: the fill board, sold spots, celebration moments. | A Browser Source in your OBS scene. Required | Dashboard homepage, any time. Also on Dashboard → Channel. |
| Studio URL | Your studio: mark spots sold, fire effects, run the show. | Any browser, on any device. Optional | Dashboard homepage, any time. |
The overlay has a transparent background, so only your graphics show over your camera. There is no box or backdrop to hide. Your Overlay URL is unique to you and stable (stays the same between breaks), so you set it in OBS once and you are done.
Before you start
This guide assumes OBS is already installed and running. The following two things must also be completed before continuing.
- A portrait canvas, set in Settings → Video.
- A scene with your camera and microphone configured for it.
Missing either of the above? The Set up OBS page walks you through how the one-time configuration of both.
Please note that selling platform may also have their own unique OBS instructions to ensure your stream runs smoothly. Be sure to review them.
Step 1: Add Breakcastr to your scene
- Pick the scene you stream your breaks from.
- In the Sources box, click + and choose Browser.
- Name it something like
Break Overlay, then click OK. - Fill in the source settings:
- URL: paste your Overlay URL.
- Width and Height: set both to
1080x1920to match your canvas. - Tick Refresh browser when scene becomes active. This lets the board re-sync every time you cut to the scene.
- Click OK.
Want to hear your celebration sounds in your own headphones? Turn on monitoring for this source. See hear what your viewers hear.
Now make sure the overlay sits on top of everything else in your scene. In the Sources list,
right-click Break Overlay and choose Order → Move to Top (or drag it to the top of the list). If
it sits below your camera or any other source, your graphics will be hidden behind them.
That is it. The overlay stays invisible until you start a break, which is exactly right: there is nothing to see yet, and nothing covers your camera.
How you know it worked: the studio watches for your overlay. Once the browser source is loaded, the studio header shows OBS connected. If you try to start a break with no overlay connected, the studio warns you first and hands you the URL to paste, so you cannot silently stream to nobody.
Step 2: Open your studio
Your studio is where you run the show: mark spots sold, fire celebration moments, toggle widgets on and off. Open your Studio URL on whatever device you want to run the break from: an iPad beside your setup, a laptop, your phone, or the computer OBS is already on. Any browser signed into your account is driving the same break.
There is nothing to set up in OBS for this.
Every action updates the on-stream board instantly, because the overlay follows your account and not any one device. You can switch devices mid-break and pick up where you left off.
Step 3: Point OBS at your platform
Breakcastr only puts graphics in your OBS scene. OBS still sends your video to whatever platform you sell on, so you point OBS at that platform once.
Get your platform’s server URL and stream key from its own seller tools, then:
- OBS → Settings → Stream.
- Service: choose your platform if it is listed, otherwise choose Custom.
- Paste the Server/URL and Stream Key, then Apply → OK.
- Click Start Streaming in OBS.
Where each platform keeps those two values, and which platforms qualify at all, is in Supported platforms.
Seeing nothing in OBS? That is expected until two things are true. You need a saved break template with an overlay on it, and you need to have pressed Start break in your studio. Until both are done the browser source is loaded but deliberately transparent, so your camera stays uncovered between breaks. Nothing is broken.
Next
OBS is wired up. One thing left before you can start a break: you need a saved break template, which is your overlay plus the effects you fire, bundled and reusable.
With a template saved, Going live puts you on air. If something is not right, start with Troubleshooting.
Prefer everything in one window? OBS can host the studio itself as a custom browser dock: Docks → Custom Browser Docks…, give it a name, paste your Studio URL, then Apply.