Table of Contents
Overlay control
Overlay control is the live switchboard for browser-source graphics. Put one StreamHelpers URL in OBS, your encoder, the Director Mini, or the Companion director, then switch individual overlays on and off from this tab.
The exact look and URL parameters for each built-in overlay stay in the overlay reference.
One URL for the encoder
Use the big URL at the top of Overlay control for normal streaming:
- long form:
overlay-composite.php?ovid=irl-all-overlays - short form, when your router supports it:
/ov
That one page carries the overlays that are meant to stack together. The page itself is transparent. It listens to the dashboard for which overlays are on, where they belong and when to hide them.
Keep the one URL in your scene and switch overlays from the dashboard. Do not add ten separate browser sources unless you need a special layout.
Switches and Hide for now
Every overlay has a card with its name, a switch and a Copy URL button. Turn the switch on when viewers should see it. Turn it off when that overlay should be unavailable.
Cards are organized under GPS & location, Weather, Trivia, polls & jokes, Clock & timer, Theme parks, Chat & audience and Your designs. These headings organize the list; your saved named groups remain separate.
Hide for now is different from switching off. It hides the currently visible overlays immediately, without changing which switches are on. Use it when the picture matters more than graphics for a moment. When overlays are hidden, the button changes to Bring back N overlays.
Some cards show a live reading under the name even while the overlay is off, so you can check it before switching on: GPS readout (speed, heading, altitude and satellites), Motion (g-force now and its peak, heading, height change), Audience numbers (viewers, while live and when the count is working), Weather (temperature and humidity), Timer and Stream timer (the time, once it is above zero). A source with nothing to say hides its line. The Companion's overlay buttons show the same readings.
Some cards have quick controls:
- gallery-style overlays can show previous/next/hold/reset controls,
- the timer card follows the Timer tab,
- custom overlay cards act like built-in ones after you create them.
Motion and g-force overlays need StreamHelpers Pro data from the phone or Companion. Without that data, Motion draws nothing. The Map address overlay is also useful only when the Pro live map address is available.
Edit — straight to the builder
Every card has an Edit button. It opens the tab the overlay is designed on, scrolls to that overlay's design section and expands it, so there is nothing to hunt for: the Clock's Edit lands on the Clock tab's Show section, the Poll card's on the Polls tab's Poll card, the GPS ticker's on the GPS tab, the weather cards' on the Weather tab, and so on. The Chat and Featured chat cards open their own builder pages. If the tab that overlay lives on is switched off in Settings → Menu bar, the button is greyed out and says so.
The design section it lands on has the same On / Off switch as the card here, so you can edit an overlay and switch it on without coming back to Overlay control.
GPS and Trivia editors, and the Closest guess and Emoji meter cards, live inside their matching feature sections, like the Weather editors. The Poll card is its own section right after On air on the Polls tab. Edit opens both the editor and any folded enclosing section. Where am I? opens its separate GPS name-overlay editor.
Groups
Groups turns several overlays on or off together. A group is a name and a set of overlays: Park mode might be the wait-times board, the clock and the GPS ticker; Quiet might be everything but the mark.
- New group asks for a name and shows a tick box per overlay. Save keeps it on the router, so every phone sees the same groups. Up to 24.
- Each group row has one switch. Its state says All 3 showing, 1 of 3 showing or All 3 hidden; flipping it switches every overlay in the group in one go, and the cards above update.
- Edit on a group row reopens the picker; the bin deletes the group (the overlays themselves are left alone).
- An overlay that no longer exists — a custom overlay you deleted — quietly drops out of its group.
Groups travel in the router's backup. A helper on a share link cannot use them, the same as the other switches.
StreamHelpers.com mark
The StreamHelpers.com mark is listed like an overlay row because it is drawn by the overlay stack. Leave it on for the free mark. StreamHelpers Pro lets you remove it.
Copying a single overlay URL
Use Copy URL on an overlay card only when an encoder needs that one overlay by itself. For example, you might put a map in its own cropped source or put a timer in a separate scene.
For day-to-day use, prefer the one encoder URL from the top of the page. It keeps the stream easier to control from a phone.
Design an overlay
Press Design an overlay to build your own browser overlay.
The designer gives you a 1920 x 1080 stage. Drag text, clocks, images and data fields into place. You can set fonts, colours, borders, backgrounds and visibility rules. Uploaded media is stored on the router and referenced from the overlay URL, so the encoder can load it without your laptop.
Saved overlays appear back on Overlay control as Custom: … cards. Switch them on and off like any built-in overlay.
Place it on the frame
Most built-in overlay builders have a placement preview. Drag the overlay where it should land in a 1920 x 1080 frame, then save. The live overlay uses that same coordinate system, so a placement that looks right in the builder should land in the same part of the program output.
If an overlay still appears in the wrong place, check the browser source first:
- source width should usually be 1920,
- source height should usually be 1080,
- the source should not be cropped, scaled oddly or nested inside another scaled scene unless you meant it.
OBS and other encoders
In OBS:
- Add Browser Source.
- Paste the one encoder URL.
- Set width to 1920 and height to 1080, or to your program canvas.
- Leave the background transparent.
- Put the source above the camera or program feed.
In hardware encoders or switchers, add a web page, HTML overlay or browser layer, paste the same URL and size it to the full program frame. If the device has transparency or keying controls, use alpha/transparent mode rather than a coloured key.
Director Mini and Companion director
On a Director Mini, add the overlay URL as a web page layer. Size it to the full output and keep it above the video layer. If you use the short /ov address, make sure the Director Mini can reach the router by that address; otherwise use the full URL shown on Overlay control.
The Companion director uses the same overlay stack. If the dashboard warns that no encoder has shown an overlay recently, open the director or encoder scene that contains the overlay URL so the dashboard can see it again.
Reset list
The reset tools clear stream state; they do not delete your saved overlay designs.
Use the Go Live reset buttons when you want to clear:
- Chat messages: the Chat tab, Chat overlay, Featured card and queue, and Chat alerts,
- Trivia points: the leaderboard, while the question bank is kept,
- Poll, Closest guess and Emoji meter: the live card and current votes, guesses or counts,
- AI answer on screen: a What am I looking at? answer left on stream,
- Timer: back to 0:00 and off screen, with its styling kept,
- GPS distance and steps,
- Motion & g-force peaks, when Motion is in use and reporting phones answer.
Use each overlay builder's own reset only when you want to restore that overlay's saved style or placement.
Carrier badges and logos
The Bonded connections overlay shows the network each link is on, e.g. T-Mobile (the SIM's own brand, such as Tello, is not shown: only some SIMs carry it). Carrier names use brand-coloured badges when s_logo is on. Real logos are not shipped (trademarks). Put your own carrier-named image in user-media/carrier-logos/: att.png, tmobile.svg, verizon.png, tello.png (lowercase letters and digits only).
Carrier logo display (logo_display) offers Carrier name only (text), Logo + carrier name (both), or Logo only (name when there is none) (image). Missing or unreadable logos fall back to the carrier name badge, or plain text when colour badges are off. Older URLs/layouts without this key map s_logo=1 to image (the previous default) and s_logo=0 to text. s_logo still controls the name badge's colour styling.
