Table of Contents
Overlay reference
The dashboard serves transparent browser-source overlays for GPS, maps, weather, hourly forecast, radar, lightning, clock, timer, theme park wait times, Chat, Featured Messages, and designs made by the operator.
Templates and premade layouts
Every built-in overlay editor has Templates & layouts. Choose Classic dark, Minimal / transparent, Broadcast contrast, Light panel or Compact panel, then Apply template. Where the overlay supports arrangements, choose one too: row/stack, inline chat, timer title position, Featured viewer-name position, or Theme parks ticker, vertical scroller, static rows and one entry at a time. Maps have framing presets, not scrolling text layouts.
Templates edit the regular appearance controls, save normally and update the preview. All settings remain editable. Content, selected data and fields, source credit, timings, running games/countdowns, GPS matching, visibility and placement stay unchanged. Theme parks keeps its setup locks; changing its layout uses the usual speed-unit remapping. Undo template restores the previous appearance. The all-in-one browser source follows saved changes; standalone URL sources need their updated URL.
Visual overlay designer
Open Overlays → Design an overlay. The 16:9 stage uses the same renderer as the live browser source, so its geometry and animation are not an approximation.
Use New from template for a Lower third, Corner badge, Scrolling announcement or GPS stats strip (live speed). Each starts a new, unsaved design with editable layers and a unique starting name. Saved overlays are not replaced; discarding unsaved changes needs confirmation. Customize the layers, then Save when ready.
Custom layers can contain text, live router values, uploaded images, galleries of pictures and short video clips, icons, shapes, animations, scrolling tickers, embedded web pages, and live JSON API data. API feeds discover nested repeating collections and scalar fields from a URL. Displayed fields, before/after labels, value and label styles, sorting, row limits, and list/ticker layout are configured independently. Filters can use fields that are not displayed; filters combine with AND, while checked values inside one filter combine with OR. Third-party API endpoints must allow browser requests through CORS.
Every layer is dragged into place and resized on the stage, galleries included, so a sponsor rotation can sit in the corner at whatever size you want it.
For fine positioning, select a layer and use the arrow keys: each press moves it 0.1% of the frame, Shift + arrow moves 1%, and Alt + arrow makes it wider, narrower, taller or shorter. Esc deselects. Locked layers do not move.
Galleries
A Gallery layer shows a running order of pictures and short clips in one box, one at a time. Use it for a sponsor rotation, a set of “follow me here” cards, or clips to cut to during a break.
Add files with Upload or pick them from ones already on the router. The running order is a separate list above the library: the same file can appear in it more than once, and each entry has arrows to move it and a ✕ to take it out. Removing an item from the running order does not delete the file.
- Change every sets how long a still stays up. A clip always plays for its own length, however long that is.
- Advance is automatically on a timer, or only when I press next if you would rather drive it by hand from the Overlays tab.
- Transition is a cut, cross-fade, slide or zoom, with your own duration.
- Shuffle randomises the automatic order. Pressing next yourself always moves to the next item in the list, so a manual skip stays predictable on air.
- When a clip ends either moves on or loops it.
- Mute clips is on, and should stay on. Browsers refuse to start a video that has sound on its own, so an unmuted clip may simply never play.
Clips must be MP4 or WebM — those are what an encoder's browser can play without help. Pictures can be PNG, JPG, GIF, WebP or SVG.
Uploads are limited to 3 MB a picture and 16 MB a clip, with a total of 96 MB across everything you upload. The bar under the upload button shows what is left. These are not arbitrary: the router's storage is shared with its own firmware, and every file in a gallery is held in the encoder's memory while the overlay is on screen. Keep clips to a few seconds — they are an overlay, not a video player.
If space runs low, the bar turns amber and then red and tells you how much room is actually left rather than how much of the allowance you have spent. Delete files you are no longer using from the library.
A gallery with one item in it simply shows that item — which is also how you put a single looping clip on an overlay.
Once a gallery is on air, the Overlays tab grows a small set of buttons under that overlay's switch: previous, hold, next, reset, and how far through you are. Every encoder showing the overlay follows within about two seconds.
Web page layers
A Web page layer embeds an existing browser source inside a design — an alert box, a chat widget, a goal bar, a countdown, one of this dashboard's own overlays, or a page you wrote yourself. It is given the same address you would paste into OBS, and the page's own HTML, CSS and JavaScript run inside the layer exactly as they would on their own.
- Page zoom is the page's layout width, not a font size. Widgets are usually built for a 1920-wide screen, so a widget dropped into a corner of the frame is told it has more room than the box really has and the result is scaled down to fit. At 50% the page believes it has twice the room. Without this a widget simply renders small and clips.
- Reload is off by default, which is right for anything that updates itself over its own connection. The shortest interval accepted is five seconds.
- Clicks and scrolling are both off by default. An overlay that quietly swallows the mouse is invisible until the one moment it matters.
- Addresses must be complete and start with
http://orhttps://.
Embedded pages are sandboxed: they may run scripts and use their own storage, but they cannot navigate the overlay away, open windows, or raise a dialog. A page that took the whole browser source off air mid-stream would be far worse than one that renders wrong.
Some sites refuse to be embedded anywhere and will show as an empty box — that is the site saying no, not the router. Widget and alert providers almost always allow it.
The toolbar exports or imports a whole custom overlay, including uploaded artwork and every file in a gallery's running order. An API layer can also be exported separately as a reusable preset containing its source, fields, labels, filters, styling, layout, scrolling, and placement. Imported data is validated by the router and remains unsaved until Save is pressed.
Saving a design reaches an encoder that is already streaming. The all-in-one browser source re-checks the router every few seconds and reloads only the overlay that actually changed, so an edit made mid-stream appears on air without reinstalling anything or touching the encoder. A save that changed nothing leaves the layer alone, because reloading a layer restarts whatever it had built up.
Checking an overlay against the shot
Every builder preview sits under a Preview on row: the default scene, dark, light, mid grey, chroma green, a transparency checker, and any colour you care to pick. An overlay is keyed over video, so the only question that matters while styling one is whether it reads on your footage — white text that looks perfect on the dark default disappears over a snowy street.
Live video goes further and puts the Director Mini's program feed behind the overlay, which is the only way to see it over the real shot and line it up with the layers already in frame. The designer's stage has the same option as a Live video tick next to Black background.
It is off unless you turn it on, and worth turning off again when you are done. The Mini serves one preview session at a time, so while it is on it takes the picture from the Director Mini and Chat tabs; those take it back when you go to them, and the preview picks it up again when you return. A preview sitting in a tab you are not looking at hands the session back on its own.
The choice is preview-only and is remembered per account. Nothing here reaches the encoder — the overlay your browser source loads stays transparent.
Numbers that do not wobble
Every overlay uses tabular numbers: each digit is the same width. A clock, wait time, speed or countdown no longer makes its box grow and shrink as the digits change, so a border or background stays still on stream.
Sizing an overlay
Every builder preview is a stage you can drag on. Dragging the box moves the overlay; dragging a corner changes both dimensions and dragging an edge changes only one, so width and height are independent and no overlay is locked to the shape it shipped with.
Overlays fall into two groups, and the difference is only visible once you start resizing:
- Panels that lay themselves out inside the box - the chat overlays, featured messages, the theme parks ticker, the map and radar. These use the space you give them, so a wider box fits more in rather than making everything bigger.
- Panels that size themselves to their own content - the clock, the timer, the GPS readout and the two weather panels. Given a box, the contents scale up uniformly to the largest size that still fits inside it. The proportions never change, so a box that is much wider than it is tall leaves space at the sides rather than stretching the digits.
The anchor buttons under the stage decide which point of the overlay is being placed, and that same point is what the overlay grows away from as it is resized. Reset placement clears the box entirely, which puts a content-sized overlay back to its natural size.
Fine-tuning with the keyboard. Click the preview (or the box) and use the arrow keys: each press moves the overlay 0.1% of the frame, Shift + arrow moves 1%. Alt + arrow resizes instead - width with left/right and height with up/down, or the size in steps for overlays that scale as a whole. Typing in a field is never affected.
Lock size. Some overlays change size with their data - the bonded connections overlay grows and shrinks as modems come and go, and the encoding stats grow when a destination starts. Tick Lock size under the stage to make the box you drew the overlay's size: the box no longer grows or shrinks, and the text and rows inside are scaled to fit it instead. Leave it off to keep the old behaviour, where the content picks its own size inside the box. The setting is part of the overlay URL (lock=1).
Placement is written into the overlay URL, so re-copy the address after moving something. The timer is the exception: its URL is deliberately stable and placement travels in its saved settings, reaching a stream that is already running.
Clock overlay
The Clock tab can put the time, the date, or both on screen. Use it for a simple stream clock, a local date/time stamp, or a fixed timezone when the trip crosses regions.
URL parameters
clock-overlay.php — show (comma list, default time,date), h24 (default off), seconds (default off), tz (IANA zone or local, default local), datefmt (full, medium, numeric, day; default full), size (s, m, l, xl; default l), layout (stack or row, default stack), accent (default #7cc4ff), bg (hex, or none), bo (0–100, default 62), bw (0–24, default 1), radius (0–80, default 14), txt (light or dark, default light), bc (hex, none, or default rgba white border).
GPS readout overlay
The GPS overlay is the compact numbers panel: speed, heading, altitude, coordinates, satellites, accuracy, distance, steps and last update. It polls the router's current GPS data and can hide itself when there is no fix.
URL parameters
gps-overlay.php — fields (comma list, default speed,coords,sats; available speed, heading, altitude, coords, sats, accuracy, distance, steps, updated), speed_unit (mph or kmh, default mph), alt_unit (ft or m, default ft), size (default m), layout (row or stack, default row), accent (default #22e0c0), labels (default on), hidenofix (default off), plus the shared panel style parameters bg, bo (62), bw (1), radius (14), txt (light) and bc.
GPS map overlay
The GPS map overlay follows the current GPS fix on a satellite or street map. It is a live map panel, not a static picture, so the box size you give it decides how much map is visible.
Quick Commands on the dashboard and Companion offer Zoom in / Zoom out for the GPS map, rain radar and lightning. Each changes saved zoom by one level without changing other style or placement settings. The all-in-one source follows saved settings; standalone URLs keep their original zoom.
URL parameters
gps-map-overlay.php — zoom (10–22, default 16), follow (default on), label (default on), base (sat or street, default sat), roads (road/place labels over satellite, default off), bw (0–24, default 2), radius (0–80, default 16), bc (hex, none, or default rgba white border). Zooms 20–22 upscale the map tiles.
Where am I? name overlay
On the GPS tab, this separate overlay names the most suitable nearby ThemeParks.wiki location, park or resort within your configured destination. See GPS setup and matching rules. It needs no AI key or Pro subscription.
It has the same card colours, text size, background opacity, border, corners, entrance/exit animations and draggable position/size controls as the Place card, saved independently. Optional heading/type label, resort context and ThemeParks.wiki credit can be styled. Keep the source credit enabled.
Under GPS detection → Nearby location types, untick Restaurants / dining to avoid naming a restaurant you walk past. Rides / attractions and Shows can also be excluded separately. If no allowed location is close enough, the normal park/resort fallback still works. The source groups rides and other attractions together; finer ride categories are not provided.
Under Text → Wording, choose Resort / park / land / attraction, then tick which levels to include. Available names appear in that order, separated by '' / '', with missing or duplicate levels omitted. The location-type filters still apply. If none of your selected levels is available, the overlay hides and the editor explains why. Closest name + resort context remains the default.
Land names are not guessed. They appear only when the source provides a named land in the matched location's parent hierarchy. Many parks, including the Magic Kingdom data checked, do not provide lands; those names are simply omitted.
URL controls are nameformat=closest|hierarchy, showresort, showpark, showland, showattraction, rides, shows and restaurants. Flags default to on; 0 turns them off. Templates preserve these wording and filter choices.
Layout offers Stacked card, One line, Compact badge and Scrolling ticker, with alignment and ticker speed. One line clips long names with an ellipsis; the ticker loops the full text. Templates & layouts additionally offers Classic card, Minimal one-liner, Broadcast strip, Park badge and Night ticker, alongside Light and Compact panels. Apply a template, then customize it; GPS detection, wording, credit and placement are preserved.
The name-overlay URL accepts layout=card|line|badge|ticker (default card), align=left|center|right (default left), and scrollspeed (20-200 pixels/second, default 60).
Enable Layout → Squeeze to fit to fit the complete one-line name, heading, context and credit into your placement box, without an ellipsis. Everything scales uniformly to fit both width and height, not stretched or squashed. Very long names get smaller; widen the box to make them larger. Card and badge layouts retain their wrapping; the ticker continues scrolling. This option is off by default and templates preserve it. The URL parameter is squeeze=1.
location-name-overlay.php polls the live name. level is auto, park or resort. near defaults to 100 metres (10-500), parknear to 500 metres (100-2000), and resortnear to 3000 metres (500-10000). These are distances from mapped points, not park boundaries. New names must stay stable for 15 seconds; no GPS, unavailable data or out-of-range locations hide it. preview=1 uses sample wording and must not be added to an encoder URL.
The Picture section shows a saved theme park picture beside the name (the place, its park or the resort), left or right, at a chosen height. See Pictures and logos.
Map address overlay
The Map address overlay is the public live-map address for viewers. It is useful when StreamHelpers Pro has created a live map link for the trip.
URL parameters
gps-link-overlay.php — text (map URL or address text), caption (default “Follow me live”), labels (default on), scheme (show the URL scheme, default off), icon (default on), only (show only when a live address exists, default on; preview disables this gate), size (default m), layout (stack or row, default stack), align (left, center, right; default left), accent (default #22e0c0), txt (default light), and the shared panel style parameters bg, bo (62), bw (1), radius (14) and bc.
Motion overlay
The Motion overlay shows phone/Companion motion readings: g-force, peaks, airtime, spin, heading, steps and related ride-style numbers. It needs StreamHelpers Pro motion data; without that data it draws nothing.
URL parameters
motion-overlay.php — fields (comma list, default gforce,gpeak,airtime; available altitude, gforce, gpeak, gmin, vert, vpeak, lat, lpeak, airtime, airlong, spin, spinpeak, heading, steps), alt_unit (ft or m, default ft), layout (default row), accent (default #ff7a59), labels (default on), hideoff (hide when no motion stream is active, default on), plus the shared panel style parameters bg, bo (62), bw (1), radius (14), txt (light) and bc.
Bonded connections overlay
The Bonded connections overlay puts your bond on screen: one line (or tile) per connection, with its carrier as a brand-coloured badge, 4G/5G, bands, signal bars, how much of the stream it is carrying and the data it has used this stream. A totals line adds the bond's rate, data, carriers and handoffs, and an overall health pill sits beside the heading. Nothing identifying is shown: no addresses, WiFi names or interface names, and phones show as Phone 1, Phone 2… unless you choose to use their Companion names. It hides itself while bonding is off.
Turn it on from the Overlays page, from Quick commands, or by voice (show the bonded connections overlay). Build its look in its builder: every field is a checkbox, including the optional Tower ID (off by default) for anyone who wants to look the tower up on a cell map.
Carrier logos are not shipped, because they are the carriers' trademarks. To use one, put an image named after the carrier (att.png, tmobile.svg, verizon.webp, tello.png; lower case, letters and digits only) in user-media/carrier-logos/ and it replaces the badge.
URL parameters
bond-overlay.php — layout (tiles for tiles, otherwise lines), title, names (Companion names, default off), s_carrier, s_rat, s_band, s_signal, s_rate, s_bar, s_data, s_totals, s_health, s_logo (all default on), s_dbm, s_ho, s_tower (default off), hide_idle (default on), always (show while not bonding, default off), plus the shared panel style parameters fs (22), bg, bo (78), bw (2), radius (16), accent, txt and bc.
Encoding stats overlay
The Encoding stats overlay puts what your stream is made of on screen, as Restreamer receives it: the video codec, frame size, frame rate and bitrate by default, and optionally the total bitrate, the audio codec, bitrate, sample rate and channels, the keyframe interval, the pixel format, how long the stream has been up and a bitrate graph. What each platform gets adds a line per destination that is publishing, with the codec, size, frame rate and bitrate it actually receives — handy when one platform gets a re-encoded or downscaled copy. Background audio remover options add the remover's state (on with its preset and how far it turns noise down, paused for music, armed and listening, or a fault), what automatic music detection last decided and its score, and what it costs on the streaming server (CPU, the 60 ms delay it adds, and how long it has been running). Show it as tiles, a stacked list or one compact line. It refreshes every few seconds and hides while no stream is arriving. No addresses, stream keys or server names are ever sent to it.
Build it in the Encoding stats overlay card at the bottom of the Restreamer tab. Turn it on from the Overlays page, from Quick commands, or by voice (show encoding stats, hide stream stats).
If Restreamer's status cannot be read, the overlay hides stale numbers until the feed recovers. This is distinct from a successful status read with no incoming stream.
URL parameters
encoder-overlay.php — s_dir adds the Director app's settings (e.g. “Adaptive up to 6.0 Mbps · HEVC · 1080p30”) and what its encoder is doing now (“886 kbps now · ceiling 6000 · floor 500 · 30 fps measured”), from the director phone's last heartbeat. Other parameters: s_codec, s_res, s_fps, s_vbr, s_audio (default on), s_total, s_ahz, s_gop, s_pix, s_uptime, s_dest, s_dir, s_rm (remover status), s_rmauto (music detection), s_rmcpu (remover CPU, delay and uptime), s_graph, always (default off), layout (tiles, col or line), res (both, px or p), cn (n for AVC/HEVC names), title, plus the shared panel style parameters fs (26), bg, bo (78), bw (2), radius (14), accent, txt and bc.
Timer overlay
The Timer overlay belongs to the Timer tab. Its URL is intentionally stable: the live overlay polls timer-state.php for the running timer and saved styling, so Start, Stop, Clear, placement and restyling reach an encoder that already has the page loaded.
URL parameters
timer-overlay.php — poll (200–5000 ms, default 500), preview (forces a sample visible in the builder). The timer itself, title, colours, border, title placement, picture and saved position come from the Timer tab settings, not from the URL.
Supporters and credits
The Supporters and credits card has a single Edit button for both sources and design. New placements default to the left; an existing saved position is kept.
- Where the names come from: combine up to six named lists, for example YouTube, Patreon and Rumble. Each can be pasted, imported from CSV/JSON/XML/text, or fetched from its own HTTP(S) URL with a private optional auth header. Enable or disable lists independently. Names matching in the same tier appear once. Existing single-list settings and credentials are retained.
- Fresh names before playback: tick Check enabled lists for updates just before playback. The router refreshes before showing the overlay, including Go Live rolls. Fetches share a 22-second budget. Failed sources retain their last good names and report warnings; imports still need a new import to discover signups.
- YouTube members: import your own channel's member export from YouTube Studio when available, or paste the names. YouTube's members.list API requires creator authorization with the channel-memberships scope, not just a public channel name or API key. Direct platform sign-in/token renewal is not built in. For automatic updates use a complete export/feed that combines every API page; a partial paginated response is rejected rather than quietly dropping members.
- Layouts: scroll (credits roll), marquee (side by side, running across), columns and pages (a page at a time).
- Credits and end card: enable an ordered sequence and set each duration (2-300 seconds). Drag supporters, credits and end card into the exact playback order instead of selecting a dropdown. Touch grips, keyboard arrows and Move up / Move down buttons also work. Remove any section to skip it; Add brings it back without losing its saved text or media. The list must contain at least one section while the sequence is enabled. Credits have their own title and multiline text, an optional title graphic and a silent background video. The end card combines a title, text and an optional image or video clip.
- Artwork: upload graphics/videos or provide HTTP(S) media URLs. Uploads reuse the overlay library's limits: 3 MB per picture, 16 MB per clip, 96 MB total and the router free-space reserve. Title graphics apply to supporters and credits. Videos remain silent and loop only for their section; codec/autoplay support depends on the encoder's browser. Test off-air.
- At stream end: Play at the end of the stream runs the sequence through Go Live, with or without an end-roll clip. Go Live's Stream opening & ending card shows the exact saved section order and an Edit shortcut back here. Choose whether the end-roll video plays alongside the sequence or Last, after Supporters and credits. Stop stream waits for the complete ending before stopping publishing. With no video, only the sequence plays. The pre-roll option still accompanies a selected pre-roll clip.
Add its browser source to your scene once. Switching it off and on starts a fresh sequence; a completed sequence clears itself. With the sequence disabled, the original continuously running supporters layout remains available. Design placement, colors, text size and title styling in the editor below the sources; saved placement is never reset by the upgrade.
URL parameters
supporters-overlay.php — mode (scroll, marquee, columns, pages), title, show_title, groups (group by tier), counts, cols, speed, per (names per page), secs (seconds per page), fs, align, shadow, plus the shared look and animation parameters. Lists, credits, media and sequence order come from saved Supporters and credits settings. During a sequence, the supporters section fits one complete pass into its configured duration instead of looping indefinitely.
One encoder URL and dashboard switching
The Overlays page has one switch per built-in and custom overlay, and it has the one address you give your encoder. Add that single full-canvas browser source once, leave it enabled, and use the dashboard switches while you are live. A renderer already loaded in an encoder follows those switches without being re-added.
A custom overlay that contains a gallery also gets previous / hold / next / reset buttons under its switch, one set per gallery.
The short form of the address is:
http://<your router>/ov
That is the same page as the long overlay-composite.php address and either works; the short one exists because the long one is miserable to type on a phone. The Overlays page shows whichever your installation supports.
The builders no longer show their own addresses. Clock, weather, GPS, timer, theme parks, chat and designed overlays each end with a pointer to the Overlays page instead. There is one address for everything, so there is one thing to set up and one thing to re-check. On a Director Mini, the confirmed migration removes only dashboard-managed webpage GFX before creating the shared source. Native titles, clocks, logos, and other device graphics are not touched.
Weather and GPS data refresh themselves.
The one-URL source also keeps up with appearance, placement and builder changes on its own. Adjust a layer in its builder and the encoder picks it up within a few seconds, without re-sending or reloading anything. Only the layer you changed is reloaded, so a tweak to the clock will not interrupt a chat feed or a map. Adding or removing an overlay behaves the same way, and saving a builder without actually changing anything does nothing at all.
Updates reach it too. After a dashboard update, the one-URL source reloads each layer once by itself within a few seconds, so new features (such as theme park pictures on the Timer or the Where am I? overlay) appear on stream without touching the encoder. An overlay pasted into an encoder on its own needs its browser source refreshed after an update.
If you still have individual overlay URLs pasted into an encoder, replace them. A single overlay's URL is its settings — the encoder owns that text, so changing the settings on the dashboard does not change what the encoder holds, and the dashboard switches cannot reach it either. That layer will stay on screen when you press All off or Hide for now, which usually reads as the switches being broken. Swapping to the one address fixes both problems at once.
Putting something on screen asks about its overlay. When you start a poll, a trivia game, a closest-guess game or the emoji meter, tell a joke on screen, reveal a guess result, put an AI answer or a Place card on screen, or start the Timer, the dashboard checks that overlay. If it is switched off, it asks Switch it on now?. If no encoder has shown it for a minute and a half, it tells you it may not be in your scene. Each question is asked at most once every ten minutes. Right after an update, a browser source that was already open can be reported as not shown until the encoder reloads it.
The StreamHelpers.com mark
The one-URL page carries a small StreamHelpers.com mark in its lower-right corner. It is part of the free dashboard and is the last row on the Overlays page, shown as a switch that is already on and greyed out. A router paired with an active StreamHelpers Pro subscription — the same pairing that unlocks Pro Chat and the live map — can switch it off there; a running encoder drops it within a few seconds, the same way it follows every other change. If the subscription lapses, opening the Overlays page puts the mark back. It is drawn by the all-in-one page only, so it is not stacked when several layers are on screen, and it is never mentioned anywhere else in the dashboard.
Weather overlay
The Weather tab builds four separate overlays: current conditions, an hourly strip, radar and lightning. Each has its own URL and its own switch.
Readings
The Data row on the current-conditions builder picks which readings the panel carries: condition, temperature, feels-like, humidity, wind and precipitation. What you tick is remembered and is what the overlay shows.
Date and time inside the panel
Tick Date / time in the same row to add a band along the panel carrying the clock. It is an alternative to placing the separate clock overlay next to the weather panel and keeping the two aligned by hand.
- Position — top, bottom, left or right. The band spans the full width or height of the panel on that side, with a divider between it and the readings.
- Time and Date can each be turned off, so the band can carry either alone.
- 24-hour and Seconds control the clock, exactly as on the clock overlay.
- Date format — short, medium or long.
- Timezone — the router's local time, or a fixed zone.
Turning Date / time off hides these options and removes the band. The standalone clock overlay is unaffected either way; use it when the time belongs somewhere else in the shot.
URL parameters
weather-overlay.php — fields (comma list, default condition,temp,humidity; also accepts feels, wind and precip), unit (f or c, default f), size (s, m, l, xl; default m), layout (row or stack, default row), accent (default #ffd166), labels (default on), dt (date/time band, default off), dtpos (top, bottom, left, right; default bottom), dttime and dtdate (default on), dth24 and dtsec (default off), dtfmt (full, medium, numeric, day; default medium), dttz (default local), plus the shared panel style parameters bg, bo (62), bw (1), radius (14), txt (light) and bc.
Hourly forecast overlay
The Hourly forecast overlay is the strip of coming hours from the Weather tab. It updates itself from the weather feed and is separate from the current-conditions panel.
URL parameters
weather-hourly-overlay.php — unit (f or c, default f), hours (3–12, default 6), rain (precipitation row, default on), accent (default #7cc4ff), plus the shared panel style parameters bg, bo (62), bw (1), radius (14), txt (light) and bc. The overlay polls about every five minutes.
Radar overlay
The Radar overlay is a full map panel with RainViewer radar on top. It can follow the GPS fix or be centered with a URL latitude and longitude.
URL parameters
radar-overlay.php — zoom (6–22, default 9), follow (default on), anim (loop recent radar frames, default on), lat and lon (center override; also turns follow off), base (sat or street, default sat), roads (default off), bw (0–24, default 2), radius (0–80, default 16), bc (hex, none, or default rgba white border).
Lightning overlay
The Lightning overlay plots live Blitzortung strikes over a map or transparent panel and follows the GPS fix by default.
URL parameters
lightning-overlay.php — zoom (6–22, default 8), follow (default on), lat and lon (center override; also turns follow off), base (sat, street or none, default sat), roads (default off), mins (strike age, 1–120 minutes, default 30), bw (0–24, default 2), radius (0–80, default 16), bc (hex, none, or default rgba white border).
Theme parks overlay
Off by default. Turn on Theme parks in Settings → Menu bar to get the tab.
Live wait times, show times and dining availability from ThemeParks.wiki. The tab walks you through it in order: browse the destination directory, pick a park, tick what you want listed (attractions, shows, dining — as many as you like), tick which fields each row carries, then choose how it is presented: a scrolling ticker, a vertical scroller, a static list, or one entry at a time.
The overlay URL is stable. Change park, fields or presentation mid-trip and a browser source already running in your encoder picks it up within a few seconds — you never re-copy or re-add it.
Data is cached on the router and shared by everything that asks for it, so the number of viewers you have makes no difference to how often the API is called. If the API goes quiet the last good data stays on screen rather than the overlay emptying out.
URL parameters
themeparks-overlay.php — poll (15000–300000 ms, default 30000) and preview. Park, fields, layout, styling, credit placement and rows come from the Theme parks tab and are fetched live from themeparks-data.php.
Attribution
This data comes from ThemeParks.wiki, a free community-run service, and their terms ask that you credit them wherever you use it. The overlay carries a small ThemeParks.wiki credit line by default. Please leave it on. There is a switch to remove it for shots where it will not fit, but a verbal mention on stream is the polite substitute. See https://www.themeparks.wiki/about.
With the credit on, Where decides how it sits. Beginning and End put it in with the data — the first or last chip in the ticker, row in the column or list, or slide in the rotation — so it costs no extra height. Top and Bottom give it its own line above or below, easier to read but one line taller. Bottom is the default. The picker is only shown when the credit is on, and your choice is remembered if you switch the credit off and back on.
Because Beginning and End take no room of their own, “it makes the panel too tall” is not a reason to turn the credit off.
Wait times are what the parks themselves publish. They are indicative, occasionally wrong, and nobody involved guarantees them.
Heading to overlay
Tell viewers where you are going next. Pick a ride, show or restaurant in the Heading to section of the Theme parks tab (nearest first), or tap Go here in the Companion. The overlay shows the destination, distance, estimated arrival and the expected wait there, each line optional, and can switch to a timer on arrival. It is in the all-in-one browser source like every other overlay; turn it on from the Overlays tab, Quick Commands or a macro. See Heading to.
The timer knows what you are queueing for
With the theme parks tab on, the Timer tab gains a What am I near? button. It reads the router's GPS fix, asks ThemeParks.wiki what is closest, and lists it nearest-first with distances. Tap one and it becomes the timer title. Rides list their posted standby wait too, and tapping one carries that wait onto the overlay beside the name. The search covers the whole destination, not just the park you picked for the overlay, because at a resort entrance the nearest thing is often in the park next door.
The title is built from three fields — Before, the name, and After — so you can set “Waiting for” and “so far” once and only ever change the middle. You can still type the title by hand; the picker only fills it in. Note that picking a ride writes After as well, replacing whatever was there with the posted wait.
Two buttons at the top of the tab collapse the whole job into one press:
- Entered queue — offers the nearest three rides, nearest first. Tap yours and it titles the timer with its name and posted wait, starts counting up, and switches the timer overlay on. Rides can sit almost on top of each other (Living with the Land is under a show at The Land in Epcot), so the nearest is not always the line you are in. If only one ride is near, it starts straight away.
- Select show — offers the nearest three shows that have a start time still ahead of them. Tap one and it titles the timer, counts down to that start time, and switches the overlay on. The overlay clears itself at zero, which is when the show begins.
Parades reach you after they start
A parade's published time is when it steps off at the top of the route, not when it arrives where you are standing. Count down to that time from halfway along and the number hits zero on an empty street, then sits at zero through the part everyone tuned in for.
So when you pick a show, a box appears reading Reaches me [ 0 ] min after it starts. Leave it at zero for anything that happens in one place — fireworks, a stage show, a character set. Type a number for a parade and the countdown re-aims straight away; there is nothing to save. Your number is remembered for next time, because where you like to stand does not usually change.
The overlay then counts down to your moment, with the published time on a smaller line underneath:
Kicks off at 10:50pm
07:32
The big number is how long until there is something worth pointing a camera at. The small line is there because your viewers have the same park app you do, and will otherwise ask why your clock disagrees with it.
If you have an AI provider set up in Settings, parades also get an Estimate with AI button that works the minutes out from where you are on the route. It only appears for things that travel, it only runs when you press it, and it is allowed to say it does not know this parade — which it will, rather than invent a number you would then go live on. The one-tap Select show button never applies an offset on its own; use the picker when it matters.
Clearing the screen when the timer ends
When you stop a timer, or a countdown reaches zero, every dashboard tab and every Companion screen asks Hide overlays?, whichever device stopped it:
- Hide all ? every overlay that is showing.
- A group ? one button per group from the Overlays tab (Groups). Pick the one offered first under Timer ? Group offered first when it stops.
- Hide selected ? tick the ones to hide.
- Keep them showing ? nothing changes.
The first answer closes the question everywhere. Afterwards a blue Bring back overlays button stays on every screen until you use it. It offers What was hidden, a group, or Bring back selected, so getting off the ride is one tap. Forget them leaves them hidden and puts the button away.
The countdown's question is raised by the router, so it is waiting for you even if your phone was asleep at zero. Nothing is hidden until somebody answers. Don't want to be asked? Switch off Timer ? When it stops, ask which overlays to hide.
Pictures and logos
ThemeParks.wiki has no logos or pictures, so The Theme parks tab has a Pictures & logos card. Give the resort, the park, a land, or any ride, show or restaurant a picture: Upload one, pick one from your Library, or press Find and choose.
Pick the resort, then a single park to list only that park's lands and attractions. All parks in the resort lists everything, grouped by park.
Find looks in four places, one tab each:
- Wikipedia: the logo from the article's information box first, then its other pictures.
- Wikimedia Commons: Wikimedia's picture library, which often has a park's or ride's logo on its own.
- Fandom: a fan wiki such as the Disney Parks Wiki. Choose it in Fandom wiki beside Find all missing, or choose Other… and type its name (the part before
.fandom.com). Find all missing looks there too; choose None to leave Fandom out. - Web page / picture URL: paste the address of any page and choose from the pictures on it, or the address of a picture itself. Addresses on your own network are refused.
Every search shows Looking at … with a link that opens that page in a new tab, so you can see where a picture came from.
Each picture is marked Transparent or Solid and shown on a checkerboard, so you can see the see-through parts. A transparent logo sits cleanly on an overlay, so it is the one to choose when there is one.
Find all missing tries every row without a picture and takes the best match it finds, transparent logos first. Tick Transparent logos only to skip anything else, and Replace solid pictures with transparent ones to look again for rows whose web picture is solid (your uploads and library picks are never replaced). It works through the list shown (one park, or the whole resort park by park in alphabetical order, so a whole resort of several hundred rows takes a while) and checks three rows at a time, showing Checked X of Y and the names it is looking up now. If a wiki or the router does not answer it tries once more and then moves on; press Find all missing again afterwards to retry those. Stop ends it after the rows being checked. Afterwards it says how many rows it could not match. Big names (the resort, the park, famous rides) usually match; small restaurants often do not.
ThemeParks.wiki has no lands, so Add a land lets you name one, give it a picture and tick the rides in it. A ride with no picture of its own then uses its land's picture.
If the usual sources do not provide a transparent logo, Find all missing also checks the matched Wikipedia article's Wikidata item for an explicitly linked logo, resolving that file through Wikimedia Commons. If there is no usable linked logo, it checks the item's official website for logo filenames matching the place. It does not assign a generic website masthead or favicon to a ride just because it appears on the same site. Credits and source links remain available; smaller places can still need a manual picture.
Step 6 has separate Names: show and Heading: show selectors. Each offers Location name only, Logo/image + location name, or Logo/image only (name when there is none). Heading to → Destination: show and Where am I? → Picture → Show offer the same choices. Picture-only hides the corresponding name/heading once its picture loads; a missing or unreadable picture leaves the text visible. Other facts and timers remain on screen. Existing settings keep their previous text-only or picture-and-text behavior. The Timer has its own Picture section.
Many logos on Wikipedia are used there under fair use, not a free licence. The card links each picture's page so you can check before using it on a commercial stream. The list of pictures is saved in settings backups; the image files themselves are not.
Chat and Featured Messages
The dashboard provides two protected, transparent browser-source overlays. Build each URL from the authenticated dashboard page, then paste it into one browser source in the encoder or scene system. Treat the copied URL as private because it contains a high-entropy overlay token.
Standard Chat Overlay
Open Chat overlay from Chat settings to create a scrolling chat browser source.
Available controls
- Text size
- Number of messages shown
- Automatic fade timing, including Never
- Direction new messages arrive from: Appear at the bottom (default) or Appear at the top
- Text, accent, background, border, and opacity colors
- Avatar visibility
- Border width and corner radius
The area outside message bubbles is transparent. The preview is a sample message; live output polls the protected router feed. A message is shown once, the requested maximum is enforced, and old rows fade after the selected delay.
Direction affects which edge of the placement box the list is anchored to. Appear at the bottom stacks the newest message at the bottom and grows upward, which suits a feed positioned low in the frame. Appear at the top stacks the newest at the top and grows downward, which keeps the newest line nearest the edge when the feed is positioned high. Older messages are always the ones removed, and the arrival animation follows the chosen direction.
URL parameters
premium-chat-overlay.php uses output=1 with a protected token. Other parameters are fs (18–96, default 34), max (1–15, default 5), fade (0–300 seconds, default 20), delay (0, 3, 5, 10, 15 or 30 seconds; default 0), bo (0–100, default 72), bw (0–12, default 1), radius (0–60, default 16), gap (0–40, default 9), bg (hex, none, or transparent=1; default #0a0e14), bc (hex or none, default #ffffff), txt (default #ffffff), accent (default #22e0c0), av (avatars, default off), dir (down means new lines appear at the top and grow down; default grows up from the bottom), layout (stacked or inline, default stacked), plat (pill, icon, text, none; default pill), pcolor (brand or accent, default brand), nm=hide to hide names, ncol (accent, platform, text, custom; default accent), ncc (default #ffd166), nsz (auto or a percentage choice, default auto), font (default system), mw (400, 500, 650, 800; default 500), fx (none, shadow, outline, glow; default none), align (left or right, default left), anim (slide, fade, pop, none; default slide), pad (compact, normal, roomy; default normal), edge, drop, celeb=plain to stop celebration styling, show_bots, show_cmds, and hide_youtube, hide_twitch, hide_kick, hide_facebook, hide_discord, hide_x, hide_other.
Featured Messages overlay
Open Featured Messages from Chat settings to create a single, queued celebration browser source.
Queue behavior
- Use
Featurebeside a host Chat message to add it to the queue. - The overlay shows one active message at a time.
- After the selected hold time, its exit animation runs, then the overlay advances to the next queued message.
- Selecting
Neverkeeps an item on screen until the host advances it or another queued item replaces it. - The
On screenhost action immediately advances to the next item or removes the active one.
Appearance controls
- Featured Chat title, text size, and hold time
- Independent entrance and exit animations from the full self-hosted Animate.css catalog
- Transition speed from Quick through five seconds
- Preview/test selector for ordinary chat and each supported celebration
- Per-celebration title, accent, duration, HTTPS graphic URL, and left/right graphic placement
- Shared text/background color, opacity, and avatar visibility
- Transparent background option
- Border color, width, corner radius, and no-border option
Graphics must be HTTPS URLs. Invalid URLs, non-HTTPS URLs, and URLs containing credentials are rejected by the output page.
URL parameters
premium-chat-highlight-overlay.php uses output=1 with a protected token. Shared card parameters are fs (22–120, default 48), bo (0–100, default 82), bw (0–12, default 2), no_border, radius (0–60, default 18), bg (hex, none, or transparent=1; default #0a0e14), bc (hex or none, default #22e0c0), accent_border, txt (default #ffffff), av (default off), font (default system), align (left or center, default left), quote (quotes or plain, default quotes), nameplace (below or above, default below), plat (show or hide, default show), gs (graphic size s, m, l, xl; default m), loop (default none), glow, no_shadow, transition (legacy preset, default fade), transition_duration (default 750), enter_animation and exit_animation, preview_event and preview. Per-card parameters repeat by event suffix: title, hold, accent, graphic and graphic_position for featured chat, then _youtube_super_chat, _youtube_super_sticker, _youtube_new_member, _youtube_member_milestone, _youtube_membership_gift and _youtube_gift_membership_received for celebrations.
Place card overlay
The Tell me about this place card on the GPS tab turns your position into two or three short lines you can read out live. Some of them are worth showing as well as saying — a name, a date, a number the audience will not catch first time.
Each answer has a Put on screen button, and so does the heading. Pressing one sends that line to the Place card overlay; pressing another replaces it. Take it off in the on-screen panel clears it.
This overlay needs an AI provider and key in Settings → AI assistant, shared with the other AI features.
Behavior
- Nothing is shown until you press Put on screen. There is no queue: a second line replaces the first.
Until I clear itkeeps the card up while you are still talking about it. Any other hold removes it automatically.- The hold is counted from when you pressed the button, so an overlay added to your encoder part-way through shows the remainder rather than restarting it.
- The panel under the answers shows what is currently on screen, including a card left up from an earlier session or put up from another phone.
Appearance controls
- Heading, text size, and auto-remove time
Match the questionheads each card with what you asked — Did you know, A bit of history, Coming up- Independent entrance and exit animations from the full self-hosted Animate.css catalog
- Transition speed from Quick through five seconds
- Accent and text color
- Background color with opacity, or no background
- Border color, width, corner radius, and no-border option
- Show or hide the supporting second line and the place name
The builder preview uses sample wording so you can style the card before you ask anything.
URL parameters
place-overlay.php — title (default “Around here”), fs (18–110, default 40), hold (0–600 seconds, default 0, meaning until cleared), bo (0–100, default 82), bw (0–12, default 2), no_border, radius (0–60, default 18), accent (default #22e0c0), txt (default #ffffff), detail (default on), showplace (default on), autotitle (default on), preview, transparent or bg=none, bg (default #0a0e14), bc (default #22e0c0), enter_animation (default fadeInUp), exit_animation (default fadeOut), transition_duration (default 750).
Trivia overlay
The Trivia tab asks the AI provider for short questions — about where you are right now, a subject you type, or rides and shows from the theme-park directory — and keeps them in a bank. Tick the ones you want to air and press Start ticked; this overlay shows them one after another: the question with a countdown, then the answer, then the next. If chat play is on, the card also names the viewer who got it first.
It needs an AI provider and key — the one in Settings → AI assistant by default, or a provider, key and model set just for trivia in the tab's Which AI writes the questions section. What is sent to that provider — and nowhere else — is your position (latitude and longitude, heading and speed when known) for Where I am, the place names you tick under What's here?, the subject you typed, the park picks you chose, and the questions already asked so the model does not repeat itself. Chat messages are never sent anywhere; answers are matched on the router. You can also write questions yourself, and a helper can prepare them for you over a share link that opens only this tab.
Behavior
- Where I am needs a GPS fix — from the puck or the Companion app, whichever the GPS tab is reading. Without one the tab explains why; A subject and Theme park picks work without a fix.
- Questions land in the bank, ticked. Untick, edit or delete anything you would not want on your stream; the model is told to stick to what it is sure of, but it is a model.
- Three timers, remembered between runs: seconds before the answer is revealed (default 20), seconds the answer stays (default 10) and a gap between questions (default 0). Loop starts over at the end.
- Start ticked airs the ticked questions in order. Each one enters with a countdown ring, shows the answer when the ring completes (lighting the right choice on a multiple-choice question), holds, exits, and the next begins.
- While a run is on air the tab offers Pause / Resume, Back, Again, Reveal now, Skip and Stop. Every viewer follows the same router clock, so all of them land on the same question at the same second.
- With Chat play on (needs Pro Chat; switch it off to just show questions on screen), viewers type the letter or the answer in chat; the first correct name appears under the answer, and points go to the leaderboard overlay below — set points, or Faster earns more, where an instant answer takes the most and a last-second one takes 1.
- A reloaded browser source lands mid-question rather than restarting, and changing a timer on the tab does not alter a run already playing.
Appearance controls
- Heading, text size
- Show or hide the countdown ring, the item counter (3 of 8), the one-line extra, the place name, the answer letters and the chat winner
- Independent entrance and exit animations from the full self-hosted Animate.css catalog
- Transition speed from Quick through five seconds
- Accent and text color
- Background color with opacity, or no background
- Border color, width, corner radius, and no-border option
The builder preview loops two sample questions on a short clock so you can style the card without generating anything.
URL parameters
trivia-overlay.php — title (up to 40 characters, default Trivia), fs (18–110, default 40), ring, count, fun, showplace, letters, winner (each 1/0, default on), accent (default #22e0c0), txt (default #ffffff), bg (hex, or none), bo (0–100, default 82), transparent, bc (hex, or none), bw (0–12, default 2), radius (0–60, default 18), no_border, enter_animation (default fadeInUp), exit_animation (default fadeOut), transition_duration (ms, default 750), preview. Content comes from trivia-feed.php, polled every two seconds.
Trivia leaderboard overlay
Who has the most points this stream, top N, updated as the router credits answers. Its own overlay rather than a panel on the question card because they belong in different corners: the question sits low and wide where the audience reads it, the board sits in a margin and stays up between questions.
Behavior
- Empty until somebody answers correctly, and hidden while empty — unless Show when empty is on or a chat-play run is on air, when it shows the heading and No answers yet.
- Ranked by points; ties go to whoever scored most recently. Points are set on the Trivia tab: a fixed amount per first and per other correct answer (defaults 3 and 1), or sliding with the countdown (Faster earns more, top score default 10).
- The board is per stream: Reset scores on the Trivia tab wipes it, so does Start fresh for a new stream on the Go Live tab, and a router reboot starts it fresh.
Appearance controls
- Heading, text size, how many rows (1–10, default 5), show or hide the points column
- Independent entrance and exit animations, transition speed
- Accent and text color; background color with opacity, or no background
- Border color, width, corner radius, and no-border option
URL parameters
trivia-board-overlay.php — title (default Leaderboard), fs (14–80, default 28), top (1–10, default 5), pts (1/0, default on), empty (1 to show while empty), accent, txt, bg (hex, or none), bo (0–100, default 82), transparent, bc (hex, or none), bw (0–12, default 2), radius (0–60, default 18), no_border, enter_animation (default fadeInRight), exit_animation (default fadeOut), transition_duration (ms, default 750), preview.
Poll overlay
The Polls tab puts a question and two to six numbered choices on screen and counts the numbers viewers type in chat — where next: 1 for the Haunted Mansion, 2 for Big Thunder. Bars grow as votes land; when voting closes the winner lights up and the rest dim. The question can be written on the card or only spoken on camera, with just the numbered choices shown. Nothing is sent to any AI provider; chat is read on the router and never leaves it.
Behavior
- Start poll on the Polls tab puts the card up. It takes votes for the poll's duration (default 120 s, or until I close it), then shows results for the hold (default 15 s, or until cleared), then fades out.
- Chat votes with a bare number (
1,#2,vote 2) or the choice written out. One vote per chat name — the last counts, unless First vote is final is on. Counting needs Pro Chat; without it the card still works as a graphic. - Results only after it closes hides the bars, counts and percentages while voting is open, so the crowd is not steered; they appear the moment it closes.
- The hint line tells chat what to type (Vote in chat: type 1 to 4) and changes to Voting closed — or It's a tie! — when it is.
- +30 s, Close now, Reopen 30 s and Clear on the tab act on the card at once; every viewer follows the same router clock, and a reloaded browser source lands mid-poll.
- Show on the overlay off (per poll, or as the tab's default) hides the card entirely while the poll still runs and counts.
Appearance controls
- Heading, text size
- Show or hide percentages, vote counts, the total, the chat hint, the countdown ring and the option numbers
- Independent entrance and exit animations from the full self-hosted Animate.css catalog
- Transition speed from Quick through five seconds
- Accent and text color
- Background color with opacity, or no background
- Border color, width, corner radius, and no-border option
The builder preview runs a sample poll with random votes on a short clock so you can style the card without asking anything. Set Sample to Open answers to preview an open question.
Open answers
For an open-answer poll the card shows chat's answers instead of numbered choices: ranked bars that slide past each other as one answer overtakes another, or a word cloud with the most popular answers biggest. The builder's Open answers section picks the view and how many bars to show. Hidden and unapproved answers never appear. With Results only after it closes, the card shows N answers so far… until voting ends.
URL parameters
poll-overlay.php — title (up to 40 characters, default Poll), fs (18–110, default 36), pct, votes, total, hint, ring, numbers (each 1/0, default on), accent (default #22e0c0), txt (default #ffffff), bg (hex, or none), bo (0–100, default 82), transparent, bc (hex, or none), bw (0–12, default 2), radius (0–60, default 18), no_border, enter_animation (default fadeInUp), exit_animation (default fadeOut), transition_duration (ms, default 750), view (bars, the default, or cloud; open answers only), rows (3–12, default 6; open-answer bars), preview. Content comes from polls-feed.php, polled every two seconds.
Joke overlay
The Jokes tab puts a joke on screen — the setup, a beat, then the punchline — and can read it out loud with the browser's own speech synthesis. Jokes are written by you or by the AI, optionally about where you actually are, and everything is held to a rating you set: G, PG, PG-13 or R.
Behavior
- Tell it on the Jokes tab puts the card up. The setup shows alone for the delay (default 3 s), the punchline lands with its own animation, and the card goes after the run (default 12 s in all).
- A one-liner has no setup: the punchline is there from the first frame and the delay is ignored.
- Read aloud speaks the setup as it appears and the punchline as it lands. This is the encoder machine talking, not a service — nothing is sent anywhere — and it only reaches the stream if the browser source may make sound (in OBS, Control audio via OBS). A Director Mini keeps overlay layers silent; there, use read it aloud on this device on the tab instead.
- Delivery set to read it aloud hides the card entirely and the joke goes out as sound only. Both does the card and the voice.
- Again re-tells the joke on screen from the top; Clear takes it off. Every viewer follows the same router clock, and a reloaded browser source lands on the right half of the joke.
- The rating badge is off by default. It is there for streamers who want the room to see the line they are working inside.
Appearance controls
- Heading, text size
- Show or hide the heading row, the countdown ring and the rating badge
- Read aloud on or off, with a voice, speed, pitch and volume, and a Test the voice button
- A separate entrance animation for the punchline, so it can arrive differently from the card
- Independent entrance and exit animations from the full self-hosted Animate.css catalog
- Transition speed from Quick through five seconds
- Accent and text color
- Background color with opacity, or no background
- Border color, width, corner radius, and no-border option
The builder preview runs two sample jokes on a short loop — one with a setup, one a one-liner — so you can style the card without telling one. The preview stays silent.
URL parameters
joke-overlay.php — title (up to 40 characters, default Joke), fs (18–110, default 38), label, ring (each 1/0, default on), rating (1/0, default off), tts (1/0, default on), voice (a voice name, up to 80 characters; blank is the browser's default), rate and pitch (50–200, default 100), vol (0–100, default 100), accent (default #22e0c0), txt (default #ffffff), bg (hex, or none), bo (0–100, default 82), transparent, bc (hex, or none), bw (0–12, default 2), radius (0–60, default 18), no_border, enter_animation (default fadeInUp), punch_animation (default fadeInUp, or none), exit_animation (default fadeOut), transition_duration (ms, default 750), preview. Content comes from jokes-feed.php, polled every two seconds.
Closest guess overlay
The Polls tab's Closest guess card runs a closest to the pin game: guess how much this churro costs. Chat types numbers, you press Reveal, and the overlay names the closest few with their guesses and how far off they were. Chat is read on the router and never leaves it; no AI is involved.
Behavior
- Start puts the question up, with how many have guessed and a countdown (default 60 s, or until I close it). Close guessing stops it early; the card then says the guesses are in and waits for you.
- The real answer is a secret until Reveal. You can type it at Start (the eye button hides it on your own screen too) or only when you reveal. Until then it is not in anything the overlay reads, so nobody can find it early.
- A guess is the first number in a short chat message:
12,$12.50,1,299,2.5k, about 40. One guess per chat name; the latest replaces the earlier unless First guess is final is on. Anything said before Start does not count. - Reveal shows the answer and the top 1–10 (default 3) for the hold (default 20 s, or until cleared). Ties go to whoever guessed first. Winner is: closest without going over (the Price is Right rule) drops every guess over the answer.
- The picture is part of the card: Grab from camera takes a still of what the camera sees, or Choose photo. It goes across the top of the card with the question written on it. Whether it is cropped to a 16:9 window or shown whole, and whether the question is written on it, are design choices in the builder — not something to set on the game.
- Reveal by itself when guessing closes: with the answer typed in at Start, the result goes on screen the moment the timer runs out or you press Close now, with no second press. An answer typed after the close waits for your Reveal. Either way, if the overlay is switched off when the result goes up, the dashboard offers to switch it on.
- A prefix and suffix (
$, '' kg'') are put around every number on screen. - Counting needs Pro Chat; without it the card still works as a graphic.
Appearance controls
- Heading, text size
- Show or hide the guess count, how far off each winner was, the chat hint, the countdown ring and the picture; how the picture is drawn (cropped to 16:9, or whole) and whether the question is written on it
- Independent entrance and exit animations from the full self-hosted Animate.css catalog
- Transition speed from Quick through five seconds
- Accent and text color
- Background color with opacity, or no background
- Border color, width, corner radius, and no-border option
URL parameters
guess-overlay.php — title (up to 40 characters, default Closest guess wins), fs (18–110, default 36), count, off, hint, ring, pic, picq (each 1/0, default on), picfit (cover — cropped to 16:9, the default — or contain), accent (default #22e0c0), txt (default #ffffff), bg (hex, or none), bo (0–100, default 82), transparent, bc (hex, or none), bw (0–12, default 2), radius (0–60, default 18), no_border, enter_animation (default fadeInUp), exit_animation (default fadeOut), transition_duration (ms, default 750), preview. Content comes from guess-feed.php, polled every two seconds.
Emoji meter overlay
The Polls tab's Emoji meter is an applause meter: spam your emoji if you want us to stay in this seat. It counts every emoji chat sends — nothing to pick or set up — and draws an animated bar graph of all of them, biggest first. A gauge above the bars shows how hard chat is going right now, and a live graph below shows the rate.
Behavior
- Every emoji counts: standard emoji (flags, skin tones and joined sequences included) and custom emotes written as
:shortcode:(how YouTube and Kick put them in the text).❤and❤️are one emoji. Twitch emotes that arrive as plain words cannot be told from words and are not counted. - One bar per emoji, keyed to the emoji: as counts change a bar grows and slides to its new rank rather than being redrawn, and its colour stays with it. New emoji fade in as chat reaches for them. Up to twelve bars are shown (default eight); the rest are counted but off the card.
- Every occurrence counts, up to a cap per message per emoji (default 5), so one viewer pasting fifty cannot pin the needle.
- The gauge looks back over the last few seconds (default 10). It fills automatically as chat gets busier, or at a number of hits you set.
- The title is optional. It runs until you press Stop, or for a set time. Stop freezes the totals, lights up the leader and shows the result for the hold (default 15 s, or until cleared). Carry on keeps counting from where it was, and Zero starts again from nothing.
- Only counts are kept; nobody's messages are stored. Counting needs Pro Chat.
Appearance controls
- Heading, text size
- How many bars (3–12), and whether bars follow the total since Start or the last few seconds
- Show or hide the gauge, the graph, the totals, the title line, the word under the gauge and the countdown ring
- Independent entrance and exit animations from the full self-hosted Animate.css catalog
- Transition speed from Quick through five seconds
- Accent and text color
- Background color with opacity, or no background
- Border color, width, corner radius, and no-border option
URL parameters
meter-overlay.php — title (up to 40 characters, default Chat meter), fs (18–110, default 36), rows (3–12, default 8), bars (total, the default, or recent), gauge, graph, total, prompt, word, ring (each 1/0, default on), accent (default #22e0c0), txt (default #ffffff), bg (hex, or none), bo (0–100, default 82), transparent, bc (hex, or none), bw (0–12, default 2), radius (0–60, default 18), no_border, enter_animation (default fadeInUp), exit_animation (default fadeOut), transition_duration (ms, default 750), preview. Content comes from meter-feed.php, polled every two seconds.
"What am I looking at?" overlay
Point the camera at something and press What am I looking at? — on the Trivia tab, the Chat tab, the Companion tab, or as a header chip. Nothing to type: the dashboard takes a still from the camera and asks your own AI provider what it is, adding your GPS position and, when The Theme parks tab has a park set, the attractions nearest to you, so it can name the ride you are standing in front of and tell its story. The answer comes to your screen first: what it is, a headline and a few lines to read out. Only if you press Put on screen does it go on stream, with or without the picture.
Behavior
- The still comes from the Companion preview, the dashboard's own preview, or your Restreamer's snapshot, whichever has a picture. With none, you can choose a photo instead.
- Only the picture, the position, the time and the names of nearby attractions are sent, and only to the AI provider you set up under Settings. It needs a model that can see pictures: most current Anthropic, Gemini and OpenAI models can; the default Groq model cannot, and the dashboard says so.
- The title and caption are filled in from the answer; you can edit them before putting it on screen, and choose how long it stays (or until I take it off). Take off removes it. If this overlay is switched off when you press Put on screen, the dashboard offers to switch it on.
- Answers are kept (the last twenty, with their pictures), so an earlier one can be put on screen later from the window or the Trivia tab's card, or deleted. Deleting an answer does not change what is on screen.
- Start fresh for a new stream on the Go Live tab takes an answer off the screen; the kept answers stay.
Appearance controls
- Heading, text size
- Show or hide the picture, the heading label and the countdown ring
- Independent entrance and exit animations from the full self-hosted Animate.css catalog
- Transition speed from Quick through five seconds
- Accent and text color
- Background color with opacity, or no background
- Border color, width, corner radius, and no-border option
URL parameters
look-overlay.php — title (up to 40 characters, default What are we looking at?), fs (16–110, default 34), pic, label, ring (each 1/0, default on), accent (default #22e0c0), txt (default #ffffff), bg (hex, or none), bo (0–100, default 84), transparent, bc (hex, or none), bw (0–12, default 2), radius (0–60, default 18), no_border, enter_animation (default fadeInUp), exit_animation (default fadeOut), transition_duration (ms, default 750), preview.
Audience numbers overlay
The numbers Restream.io reports for the live event, on screen: viewers now, the peak, total views, chat messages and chatters, across every destination. It is set up on the Restream.io tab under Audience numbers overlay, where the same numbers are also shown to you as tiles with a per-platform table.
Behavior
- It shows only while a Restream.io event is live, unless Show when not live is on.
- Restream updates viewer counts once a minute, so the numbers move once a minute.
- Restream does not report likes, followers or subscribers — those only exist on each platform — so they are not offered rather than shown as zero.
- Optional: a per-platform breakdown and a small graph of viewers per minute; a row or a column.
Appearance controls
- Heading, text size
- Choose which numbers to show, the platform breakdown, the graph, and a row or column layout
- Independent entrance and exit animations from the full self-hosted Animate.css catalog
- Transition speed from Quick through five seconds
- Accent and text color
- Background color with opacity, or no background
- Border color, width, corner radius, and no-border option
URL parameters
stats-overlay.php — title (up to 40 characters, default none), fs (14–110, default 30), m_now (default on), m_peak, m_views, m_messages, m_chatters, plat, graph, always (each 1/0, default off), layout (col for a column), accent (default #22e0c0), txt (default #ffffff), bg (hex, or none), bo (0–100, default 78), transparent, bc (hex, or none), bw (0–12, default 2), radius (0–60, default 16), no_border, enter_animation (default fadeIn), exit_animation (default fadeOut), transition_duration (ms, default 750), preview. Numbers come from live-stats.php, polled every 15 seconds.
Browser-source guidance
- Use the address exactly as shown on the Overlays page; do not remove its token or settings query parameters.
- Add the page as a browser source on the same network as the router, unless the router is reached over a secure private network.
- Keep the browser-source background transparent.
- Use a single Featured Messages browser source. Multiple copies will each poll the same queue and are not intended as separate queues.
- Test with the builder preview before going live.
Drawing overlays without a computer
Something between the camera and the platform has to draw the overlays. There are three things that can: a Magewell Director Mini, OBS Studio on a computer, or the phone app you are already streaming from, if it accepts a web page as an overlay.
The third option is worth knowing about, because the jobs a computer usually does on an IRL rig are already handled by the router — bonding several modems with SRTLA, transcoding, holding a backup picture up when the link drops, and sending the finished stream to more than one platform. Drawing the overlays is the only one left.
Moblin (iPhone, free, open source) is the one we can follow end to end. Add a Browser widget under Settings → Scenes → Widgets, paste the combined overlay URL into its URL field, and it draws the page over the camera with a transparent background. It speaks SRTLA, so it can send straight to the router. Its browser widget repaints on a timer — 5 frames per second by default, 15 at most — which is ample for wait times, speed and weather, but is the reason a clock showing seconds can look like it stutters.
Larix Broadcaster (iPhone and Android) offers the same thing under Web widgets, with a periodic refresh interval, and can push SRT to the router — but not SRTLA, so bonding would have to happen elsewhere. Two cautions: we have not confirmed that its web widget renders with a transparent background, so test it before relying on it; and the free version stops the stream after 30 minutes and watermarks it, with Larix Premium required to remove both.
Whichever you use, keep the phone awake with the app in the foreground. Phones will not run a camera encoder in the background.
Sending an overlay to your encoder
The Overlays page can install the combined overlay for you, so the address never has to be copied by hand.
- Send to OBS adds it as a browser source in the current scene. Configure the OBS address and WebSocket port in Settings first.
- Send to Director Mini adds it as a graphics layer.
- Once installed, the button becomes Update, which replaces the existing copy rather than adding a second one, and a Remove button appears.
- On the Director Mini, an update switches the layer back on if it was on air. A newly created graphic may start switched off; the success message reminds you to open GFX on the Director Mini and toggle it visible.
- Because everything is in one source that re-reads its own settings, editing a builder afterwards needs no re-send.
Local and remote addresses
The Overlays page shows a local address, and where Tailscale is running, a second address that works from anywhere.
- The local address is faster and keeps working with no internet at all. Use it for an encoder on the same network, such as the Director Mini.
- The Tailscale address is for an encoder elsewhere. It requires both machines to be signed in to the same tailnet. The short
/ovpath works there too.
Resetting a builder
Builder selections are stored on the router, so a builder set up on one device looks the same on another. The combined source re-reads them within a few seconds, so a reset reaches the stream on its own. Any individual overlay URL you copied into an encoder before is the exception — it keeps the settings encoded in that address until you replace it.
