====== Layered overlays and branding ====== Open the Overlay Editor from the encoder browser page or ''/overlays''. The editor is available to paid subscribers through the connected Controller's subscription. Supported layers include text, graphics, uploaded videos, web pages, and widgets. {{:screenshots:overlay-editor.png?900|Actual overlay editor with an unsaved example layer stack and detailed controls}} The editor is shown with example layers. Color bars stand in for source video; the image is not a recording of program output. ===== Game-day overlays and digital-signage-style layouts ===== {{:screenshots:overlay-example.png?800|Game-day overlay example rendered by the real editor over TV color bars}} TV color bars stand in for source video. The editor renders the example text and promotional layers. {{:screenshots:signage-example.png?800|A full-screen venue promotion rendered by the real overlay editor}} Use text, graphics, uploaded videos, web content, and widgets to build full-screen promotions or over-video messages. The Android encoder can use HDMI, an uploaded MP4, or a supported direct video URL as its primary video source. ===== Editing and media limits ===== If the overlay editor is missing a feature or does not meet your needs, consider creating your composition in [[https://obsproject.com/|OBS Studio]] and feeding its output into DisplayHUB through a compatible capture path. Verify the complete output and audio path on your equipment. On updated Android encoder/controller software, layer names beside encoder previews are buttons: click a name to turn that layer on or off. Controls appear in the controller dashboard, Matrix, source details and on-screen remotes, and on the encoder management page and USB IR remote. Older encoder firmware without the layered API does not provide these controls. The fixed **Video** layer sits above the fixed **Background** layer. Set a solid color, pattern, or stretched uploaded/HTTP(S) graphic to fill the output behind the video. Move or resize the Video layer to expose the background. The preview background selector is separate and does not change the stream. Select HDMI, **Video file** (an uploaded MP4 up to 64 MB), or **Video URL** (a direct HTTP(S) media source, not a Web page) in the Video panel. Switching sources restarts capture separately from saving the layout. File and URL inputs do not send primary audio. Playback depends on Android's player and hardware codecs. For a compatible HDHomeRun network tuner, configure the association in [[:encoder:settings|encoder source settings]]. Use **80% video (leave area)** to leave room beside and below the video, or enter X, Y, width and height in design-canvas pixels. The rectangle must fit inside the canvas. Apply the design, or enable live apply, to send these edits to the stream. **Reset video size** returns the draft video rectangle to the entire canvas. **Layout templates** include centered video with four panels, upper-left/right video with adjacent panels, left/right ad columns, and a three-panel bottom strip. Video retains the canvas proportions. Panels are ordinary editable text layers with colored backgrounds. **Reset to template** explicitly warns before replacing the entire layer stack and HDMI geometry. Uploaded media is retained; Undo restores the previous draft. If live apply is enabled, confirming the warning sends the template to output automatically. An active full-frame override is retained. **Full-frame / hide overlays** immediately shows the full-size primary video with the background, overlays, and overlay audio off. **Restore layout / overlays** restores the previously applied video rectangle and layer selections, including any layers that were already off. The switch preserves the design and persists across encoder restarts. In the designer it operates the applied layout without applying unrelated draft changes. Applying or importing a design does not cancel an active full-frame override. Use **Restore layout / overlays** explicitly to put the design back on air. Both the Android encoder and controller need the updated software. ===== Widget builder ===== Choose **Widget** to configure time/date, countdown, sponsorship, stocks, weather, sports scores, headlines, announcements, slideshows or specials. The dialog controls feed options, typography, padding, layout and scrolling. Widgets support solid or transparent backgrounds and layer effects, including chroma key. Size, position, opacity and crop remain in the editor. Time/date, countdown and sponsorship work offline. {{:screenshots:widget-builder.png?900|Widget Builder showing example venue specials}} The Widget Builder preview shows an example specials layout. **Full screen** expands the builder; **Save widget** returns its changes to the draft, and **Save / Apply** sends the draft to output. Configuration sections are stacked in rows. The layer sidebar has **Fit content to layer area**, which shrinks oversized widget content without resizing the layer or changing the configured font size. Sports use ESPN scoreboards by league without an API key; existing football, basketball and soccer widgets default to NFL, NBA and MLS respectively. Stocks use Twelve Data (public display requires a suitable plan and market rights). Headlines use GNews (the free plan is non-commercial and delayed by 12 hours). Signup links for keyed feeds go through DisplayHUB. Check provider terms for display rights and keep API keys and design exports private. OpenWeather accepts coordinates or a ZIP/postal code with a two-letter country code. Existing OpenWeather keys continue to work for current conditions; forecasts and alerts require separate **One Call 3.0** access. Enable **Arrange weather blocks on the preview**, then drag blocks from the palette or click to add them. Drag or use arrow keys to reposition a block; Delete removes it. Forecast blocks support 6, 12, 24 or up to 48 hours, 3, 5 or up to 8 days, next-hour precipitation, and provider-issued alerts where available. Detailed metrics are optional. The widget shows only the data the provider returns. The fixed **Background** layer also supports two-color linear and radial gradients beneath the Video layer. Linear gradients have an adjustable angle. Legacy embed code is preserved for recovery but no longer executes. Choose a built-in widget, or use a **Web page** layer with a direct URL if these widgets do not suit your needs. The browser editor may not preview some URLs; check the program monitor. The near-full-window Widget Builder keeps every relevant section open, with no expand/collapse controls. Double-click a widget on the canvas or in the layer list to edit it. The preview receives most of the available space; **Expand preview** temporarily hides the settings for an even larger view. Each widget has its own **Starting look**, with at least nine choices per type: market walls and quote tapes, score bugs and game boards, headline crawls and digests, clocks, countdowns and sponsorship lower thirds. Weather includes current/forecast side-by-side, 12/24-hour and multi-day outlooks, scrolling strips, vertical bulletins and compact transparent designs. Weather blocks can be freely positioned or arranged in a horizontal strip or vertical stack. Select a visual example under **Templates & layout** to apply a starting look. Thumbnails use offline samples. Forecast looks select **One Call 3.0**, which requires matching provider access. Content, credentials, location, countdown target, visibility and layer placement are preserved; **Undo preset** restores the previous settings. Stock examples can supply optional sample symbols without replacing an existing list automatically. Optional repeating **Fade**, **Zoom**, **Bounce**, **Pulse** and **Slide** motion has an adjustable cycle and can be combined with scrolling. Motion consumes additional GPU resources. Weather blocks in **Free** placement have four resize handles and a separate heading toggle. Forecast ribbons can show current conditions alongside five daily icons, with or without scrolling. **Load live data** identifies the failing OpenWeather service (postal lookup, Current Weather, or One Call) and reports common provider and connection errors without exposing credentials. **Radar** uses NOAA/NWS radar and NASA GIBS imagery without a key. Configure map center, zoom, precipitation opacity, and animation speed. Coverage includes the contiguous US, Alaska, Hawaii, the Caribbean and Guam. Attribution is retained. The preview starts with sample imagery; use **Load live data** to check coverage. **Breaking news** accepts uppercase or lowercase country codes. A US ZIP finds its city and state and searches GNews for place mentions rather than category headlines; coverage varies. **Announcements** works offline: enter up to 20 lines of text, optionally in ''Heading | Message'' format, then choose a card, bulletin, or scrolling layout. Multi-city clocks accept up to six time zones; countdowns can use tiles, rings, or bars. Sports widgets can combine up to four ESPN leagues and offer compact logo ribbons, split score bars, and stacked results. Time/date and countdown widgets include split-flap and flip-card looks. Select a sponsor image from Media or use an image URL, and enter a website to display alongside the credit. Stocks and news accept optional logo mappings in ''Symbol or publication | Image URL'' format. Announcements can use ''Heading | Message | Image URL'' for individual graphics. Uploaded images remain device-local and are not embedded in exported designs. Drag the lower-right handle in the widget preview to resize the layer, then save the widget. Use the on-screen arrows beside the layer geometry for one-pixel moves (Shift moves ten). Continuous scrolling exits completely before restarting; back-and-forth and paged modes intentionally use different motion. Full-frame switches ease the video into its new position while still hiding overlay layers and audio immediately. The Android Controller dashboard places the overlay buttons directly beneath each encoder preview. **Graphical weather and sports:** choose a glass, broadcast-gradient, flat or outline **Card finish**. Weather starting looks include illustrated current conditions, icon-based forecast galleries and temperature-trend charts beside the current conditions. **Forecast graphics** selects detailed lists, icon cards or chart-plus-cards; the condition-icon and detailed-metric switches still apply. The temperature chart uses hourly temperatures or daily low/high midpoints, without estimating missing readings. Forecasts still require One Call access. Sports cards and ribbons can show **ESPN team logos** and **Team-color panels**, with independent switches. Available logos are loaded directly from ESPN's HTTPS image CDN; internet access and applicable display rights are required. Missing or unreachable logos fall back to team initials without hiding the score. Sample games use illustrative initials, not real team branding. **Clock / date face** offers styled text, a glowing digital display, animated flip cards, and an analog dial. Analog hands follow the selected time zone; the seconds switch controls the second hand. Time-and-date and date-only analog layouts retain the selected date format beneath the clock. Typography, accent, card finish, background and effects remain configurable. Every widget has left/right ribbons and up/down bulletin starting looks. Choose any of the four scroll directions, then select **Continuous crawl**, **Back and forth** or **Paged panels with pauses**. Scroll speed controls movement and **Pause at each page / end** controls pauses for the latter two modes. Back-and-forth and paged modes move only when content overflows the layer; they do not move content that already fits. Paged scrolling returns to the first panel after the last. The preview toolbar's **Fit content to layer area** is the same saved setting as the right sidebar's checkbox, not a preview-only zoom. It shrinks oversized content without changing the configured font size or layer dimensions. **Save widget** transfers the checkbox state to the sidebar and draft; **Save / Apply** sends it to output. Cancel leaves the previous setting unchanged. Fitting overflowing content can remove the overflow needed for back-and-forth or paged scrolling. The **Live preview** uses the output renderer and reflects configuration changes immediately, without changing the saved draft or on-air design. Clocks and countdowns run locally. Provider widgets initially show clearly marked sample data; **Load live data** explicitly requests data with the configured provider key and consumes provider quota. Styling edits reuse the loaded response, while changes to feed inputs return to samples until another live load. Cancel or Escape discards the modal edits and stops its preview. The transparency grid/dark/light preview canvas does not change the widget background. Preview dimensions match the layer; resize the layer or reduce font size if content is clipped. Weather controls include condition icons, optional feels-like/humidity/wind/pressure, a custom location label, and optional date/time above or below the conditions. Stock quote controls include company name, price/percentage changes, currency, volume, precision, and gain/loss colors; missing provider fields are omitted. Scores offer a team-name filter, league and status switches. News offers source, description and publication-time switches. Countdown formats include unit labels, clock-style and words, with optional days/seconds and a completion message. Date/time dropdowns show examples for the selected time zone, including medium and ISO dates. Sponsor credits can be added to other widgets with a custom label, color and size. Common controls include typography, columns, accent, padding, background color/opacity or transparency, corners, borders, effects and scrolling. The former six-item application limit has been raised to **30 symbols/items** for stocks, games and headlines. These are maximum display counts, not guaranteed provider entitlements: each stock symbol can consume credits, and provider quotas or market rights can require a paid plan. GNews defaults to **Free**, requesting at most **10 articles** even if more items are selected; choose **Paid** to request up to 30 only with a matching plan. Empty results, missing configuration, unmatched teams and provider failures hide the entire widget on output, including its background and border; previous feed results are cleared on failure. Diagnostics and sample values appear only in the designer preview. Weather blocks with unavailable data are omitted from output. Use **Browse by shape** to find horizontal ribbons, row layouts, or narrow columns for any widget. Tall sports layers stack teams and games instead of squeezing cards side by side. The selection border and handles temporarily hide during arrow nudges and X/Y edits without deselecting the layer. Each widget has its own sponsor. **Copy sponsor from another widget** copies the sponsor details and styling into the current draft and enables its credit. Changes to the copy do not affect the source widget. **Show provider attribution** defaults on and can be disabled. This display control does not waive provider attribution requirements, plan restrictions or market display rights; disable it only when the applicable agreement permits. News-source and sponsor labels have separate controls. Existing designs without the new presentation setting retain their simple-text rendering until edited. **Save widget** changes the draft; **Save / Apply** sends the draft to output. If these widgets do not suit the intended use, select a **Web page** layer with a direct URL. ===== Exporting and importing designs ===== **Export / Import design** includes all layers, widget settings and API keys, weather block positions, animations, gradients, and Video-layer placement. Uploaded local images/videos are **not included**: JSON retains only their encoder-local references. Use accessible HTTP(S) media URLs for designs intended for other encoders, or upload and relink the files on each encoder. Primary video-source settings are separate from the design, and importing preserves the receiving encoder's current full-frame override. Keep exported files containing credentials private. ===== Media and slideshows ===== Open **Media Manager** beneath Background to upload or drag in images and videos, browse thumbnails, create folders, rename and move files, and delete or create layers from a selection. The image editor crops and rotates a new PNG copy; animated images become still images. Media stays on the encoder. Files referenced in the draft or applied design cannot be deleted until their references are removed and the design is applied. Uploads are limited to 64 MB per file and 256 MB total. {{:screenshots:media-manager.png?900|Media Manager with example folder and sample image thumbnails}} The pictured library and folder are illustrative. Select multiple files to create layers, create a slideshow, add to a selected slideshow, move, or delete them. To use one file, click its name or choose **Fill selected area**. Use **Add as new layer** to keep the selected area's existing content. Media controls also accept direct HTTP(S) URLs where supported. Choose **Slideshow** in the widget builder or select images and videos in Media and create a slideshow. Enter up to **10 files** as uploaded media paths or HTTP(S) URLs, one per line; reorder them by editing the list. MP4/WebM slide URLs must end in the media extension. Videos play muted and loop during the slide's hold time. Select a slideshow layer before adding more selected media from Media. Choose fit, repeat and shuffle. Existing graphic slideshows continue to play and can be converted to the new widget. Set a hold time of **1-3600 seconds** per image, choose **Cut**, **Crossfade**, **Slide left/right/up/down** or **Zoom**, and set animated transitions to **0.1-5 seconds**. Hold time starts after the transition finishes; loading a remote image can extend it. Turning off **Visible on output** pauses cycling. If an image fails to load, the last good image stays visible and the editor reports the failed slide before continuing the cycle. Transparent **PNG and GIF** images preserve their alpha/transparency. Animated GIFs play while displayed; slideshow timing does not wait for the GIF's animation to finish. Slideshow settings and image references are included in design exports, but uploaded image files are not. Upload and relink those images on another encoder, or use accessible URLs. Files referenced by saved slides cannot be deleted until their references are removed and the design is applied. ===== Specials ===== The **Specials** widget includes venue templates for offers, menus and events. Enter up to 20 lines as ''Heading | Details | media URL'' and choose an image or muted MP4/WebM video from Media; use at most one video. A POS system can supply an optional HTTP(S) JSON feed: an array or an ''items'' array of objects with ''name'', ''description'', ''price'' and optional ''media'' or ''image'' URL. The feed must allow cross-origin requests from the encoder and does not receive credentials; do not put secrets in its URL. Manual offers appear if the feed fails. This is a generic feed format, not a direct integration with a particular POS provider. ===== Showing and hiding layers ===== Use the layer controls beneath compatible encoder previews to turn individual layers on or off. **Full-frame / hide overlays** shows the primary video without overlays; **Restore layout / overlays** restores the layout and previously selected layers. While full-frame is active, changes to layer visibility are retained for the restored layout. Use drag/resize, ordering, visibility, opacity, rotation, crop, and live apply to compose your program. Review apply errors rather than assuming a saved design is on air. Some websites block embedding; validate the program monitor. Uploaded-video audio starts disabled. Enable it and set volume deliberately; it can mix with USB HDMI sound. Hidden layers are silent. Remote video-URL and web-page audio are not supported. The editor itself stays muted. PNG/JPEG/GIF/WebP graphics and Android WebView-compatible MP4/WebM video are supported; H.264/AAC MP4 is a useful starting point. Current limits are 64 MB per file, 256 MB library, and 24 layers including six video/web layers. Copy media separately when transferring design JSON. Android Encoder **Backup & Restore** includes the saved overlay design when subscription access is available. Older settings-only backups leave the current design unchanged. The Overlay Editor still has its own design export. Uploaded media files are not included; re-upload and relink any missing media after restoring to another device. Use only material you are authorized to display. See [[:encoder:monitors]] and [[:encoder:settings]]. ---- [[:start|Knowledge home]] | [[:getting-started|Getting started]] | [[https://discord.gg/B6aSSdwFHy|Ask in Discord]]