====== 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 [[dashboard:overlays|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 [[dashboard:settings#backup-and-restore|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.