GET YOUR FIRST MONTH FREE WITH PROMO CODE “BETA” 50 SIGNUPS AVAILABLE

Setting up Your Overlays

Everything on this page is a one-time job. Once it is done you never touch it again.

Setting up OBS with Whatnot Checking it works When something looks wrong Overlay sizes Stream Deck

The short version. Download one file from your dashboard, import it into OBS, and every overlay appears in the right place at the right size. You do not have to type any addresses or measurements in by hand.

Setting up OBS with Whatnot

OBS is the free program that puts your camera and your overlays together and sends the result to Whatnot, eBay Live or Fanatics Live. If you already stream, you may already have it. If you do not, download it from obsproject.com first and come back here. If you can't figure out how to get OBS connected to Whatnot, watch this video.

Watch this video walkthrough, or follow the step by step guide below. This covers getting your file out of the control panel, then opening OBS and reaching the Import window.
  1. Download your overlay file

    On your dashboard, press Download my OBS file. It saves a file called United Breakers Preset.json, usually into your Downloads folder. This file has your own private addresses inside it, so do not post it anywhere or send it to anyone.

    The Download my OBS file button on the United Breakers dashboard

    Your dashboard. The button is in the setup box at the top.

  2. Open OBS and find the Scene Collection menu

    Look along the very top edge of the OBS window, above everything else, for the word Scene Collection. It is a menu, next to File and Edit. It is not inside the app. It is on the bar at the top.

    The OBS menu bar with Scene Collection highlighted

    The OBS menu bar. Scene Collection is the sixth item along.

  3. Choose Import

    In that menu, click Import. A window opens asking for a file.

    The Scene Collection menu open with the Import option highlighted
  4. Pick the file you just downloaded

    Press the three dots, go to your Downloads folder, and choose United Breakers Preset.json. Then press Import.

    The OBS import window with United Breakers Preset.json selected
  5. Switch to the new scene collection

    Open Scene Collection again and click United Breakers in the list. Your overlays appear, already sized and placed on a 1080 × 1920 vertical canvas, the shape Whatnot and the others stream at.

    The Scene Collection menu with United Breakers listed and selected

    That is the setup finished. Everything below is for checking it and for when something looks off.

Checking it works

Open your control panel for a league. At the top you will see how many of your overlays OBS has picked up.

If you want to watch it actually happen, press Test my overlays in the panel. It plays one reveal so you can see it fire in OBS. Nothing is marked sold and it is safe to press while you are live.

When something looks wrong

The overlay is a blank or black box in OBS. Right-click the source in OBS, choose Properties, and press Refresh. If it is still blank, check the address in that source matches the one on the pane in your control panel. Press the link button on the pane to copy it.

I reset my links and now nothing shows. Resetting deliberately breaks every address you had. Download the OBS file again and import it again, or copy each new address from the control panel into the source that already exists.

There is no sound. The highlight clips are deliberately silent so your own commentary sits on top. The music is separate: check the Music volume slider in the Animation Playback pane, and check the browser source in OBS does not have Control audio via OBS turned off.

Everything vanished mid-break. In Classic, open the menu in your control panel and look for Show all overlays. In Next Gen, look at the On stream box on the Live tab: a red, crossed-out eye means that overlay is hidden, and Show all brings them back. If it says that rather than “Hide all overlays”, they are switched off. A red strip across the panel says so too, with a button to bring them back.

It says another break is still open. Only one league can be live at a time. The message names the league and offers to end it for you. Your board for each league is saved separately, so nothing is lost either way.

Overlay sizes

You only need these if you are adding sources by hand instead of importing the file. The other overlays size themselves to whatever you give them; these are the numbers they are designed around.

OverlayWidth × height
Team Board1080 × 480
Text Ticker1920 × 160
Popups700 × 700
Team Randomizer640 × 820

Next Gen Stats (beta)

Next Gen Stats comes with the Pro and Complete plans. You pick the exact boxes you are opening, and your overlays then show facts about those boxes on their own: odds, guarantees, the chase players and real recent sales. You never type in what you pulled. It is in beta, so if a number looks wrong or something breaks, tell us on Discord.

It has its own OBS file. Next Gen overlays have their own addresses, separate from Classic, so the Classic file will not show them. You can keep both collections in OBS and switch between them.

  1. Download your Next Gen OBS file

    The first time you open Next Gen it asks you to download it. Any time after that, open Setup in the Next Gen control panel and press Download OBS file. It saves United Breakers Next Gen.json, usually into your Downloads folder. It has your own private addresses inside it, so do not post it or send it to anyone.

  2. Open OBS and find the Scene Collection menu

    It is on the bar along the very top of the OBS window, next to File and Edit.

    The OBS menu bar with Scene Collection highlighted
  3. Choose Import

    In that menu, click Import. A window opens asking for a file.

    The Scene Collection menu open with the Import option highlighted
  4. Pick the Next Gen file

    Press the three dots, go to your Downloads folder, and choose United Breakers Next Gen.json. Then press Import.

    The OBS import window, choosing a downloaded United Breakers file
  5. Switch to the Next Gen scene collection

    Open Scene Collection again and click United Breakers Next Gen. Every Next Gen overlay appears, already sized and placed. Go back to United Breakers in the same menu whenever you run a Classic break.

    The Scene Collection menu with the United Breakers collections listed

What the new overlays do.

Where things are. The Live tab is everything you use while streaming, and its On stream box is where you hide and show each overlay. Setup holds your boxes, which overlays you use, the board look and the rest of the settings. The Fact sheet is notes about your boxes, for you to read. It never goes on stream.

Sizes, only if you add sources by hand:

Next Gen overlayWidth × height
Team Board1080 × 480
Stats Feed1080 × 140
Sell Sheet460 × 600
Text Ticker1920 × 160
Popups700 × 700
Team Randomizer640 × 820

Stream Deck

Only relevant if you own an Elgato Stream Deck. It is a small box of physical buttons; if you do not have one, ignore this entirely. Everything works without it.

In your control panel, open the menu and choose Stream Deck. Turn on Show endpoints on controls and each button in the panel shows its own address. In the Stream Deck app, add a Website action, paste the address, and choose GET request in background. One button per team, plus buttons for spin and each popup. Replay and hiding overlays are listed under More buttons in the same Stream Deck window.

The first press on a team marks it sold and plays the reveal. A second press takes the sale back. If a button shows an alert, nothing happened: usually no break is live, or that button belongs to the other version of the panel.

Keep these addresses private. Anyone who has one can drive your overlay.

Still stuck? Ask us on Discord, tell us what you see on screen and we will get you running.