Skip to main content
Version: 0.5.0

Overlay Widgets

Overlay widgets are the information layer ShowRevue draws on top of the video — in the live preview, burned into the recording, and on the NDI / Stage Display feeds. You arrange them into a layout with the visual layout editor, and the layout is saved in the .srshow project.

The overlay layout editor — Layouts preferences

Preferences → Layouts: the widget palette (left), the live overlay preview on the camera feed (centre), and the Inspector for the selected widget (right). Keep multiple layouts and switch between them; each saves with the show.

Working with widgets

  • Add a widget — open the widget palette and pick one; it drops onto the canvas at a sensible default position.
  • Move / resize — drag a widget to reposition it; drag its handles to resize. Positions are stored normalised (0–1), so a layout looks the same at any output resolution.
  • Style — most text widgets let you set the colour, font size (auto-fits to the frame), justification (left / centre / right) and typeface (see below).
  • Layouts — keep several layouts (e.g. a clean broadcast look and a data-rich rehearsal look) and switch between them; they save with the show.

Typeface

The layout editor — widget palette, overlay preview and the Typeface picker

The widget palette lists Main Lighting Cue and Secondary Lighting Cue; the Inspector's Typeface picker sets the selected widget's font, and Use this font for every widget applies it across the layout.

Each widget has a Typeface picker in the Inspector, listing the fonts installed on the Mac — so a venue with branding guidelines can put its own face on the overlay. Use this font for every widget applies the choice across the whole layout in one click. The font follows through to the burned-in recording, not just the on-screen preview.

Pick a monospaced face where you can. They're grouped at the top of the list and labelled. Every digit is the same width, so timecode, cue numbers and countdowns hold their position instead of shuffling sideways as they count — a proportional face makes the overlay jitter. Widgets with no font chosen use the system monospaced face.

Many text widgets also resolve Companion variables, so you can surface remote-driven values.


Show identity

Show Name

The production name (from the project). Use it as a title slate, top-left.

Show Name widget Inspector

Show Type

The session type only — Show, Tech, Dress or Rehearsal — so anyone watching the feed knows whether this is a real show or a working session.

Show Type / Number

The session type and its number combined, e.g. "Show 1" or "Tech 2A". A compact replacement for the two widgets above when you want one label.


Timecode & clock

LTC

The live incoming timecode readout (HH:MM:SS:FF) — whatever source is feeding ShowRevue (LTC, MTC / MIDI, or sACN). The headline clock for syncing to the desk.

LTC widget Inspector

Source Pill

A small badge showing which timecode source is active (e.g. LTC / MTC / sACN) — a quick confirm that you're locked to the right feed.

Source Pill widget Inspector

Wall Clock

The real-world time of day. The format is configurable (with or without seconds, date) — handy for a session record or a back-of-house display.

Wall Clock widget Inspector

Recording

REC

The recording indicator — turns red while a recording is rolling, so the feed clearly shows when you're capturing.


Cues

Cue Number

The current lighting cue number — the most recent LX cue fired.

Cue Number widget Inspector

Cue Label

The name/label of the current cue (e.g. "Top of Act 2").

Cue Label widget Inspector

Main Lighting Cue

The full current cue line of the main show cue list — number and label together — on one line, scrolling gently if it's too long to fit. A single readout that captures "where we are" in the book.

It follows the main show cue list, the one you nominate in Project Settings → Consoles. A followspot or video-from-LX list firing in parallel never lands in this line.

Secondary Lighting Cue

The current cue of one other cue list / sequence — followspots, video-from-LX, house, anything the desk runs alongside the book.

Shows run several lists at once, so you can add as many of these as you have lists. Each one picks its list from a dropdown of every cue list / sequence the project has ever heard the desk running, and follows only that list. Turn on Show the list name and the cue is prefixed with the console's own name for it:

FOLLOWSPOTS LX 2 - PICKUP ELSA

Every list the desk sends is recorded regardless of what's on the layout — the widgets choose what is displayed, never what is captured. See ETC Eos for how the list names are read off the desk.

Time Since Cue

Seconds since the current LX cue fired — useful for spotting long holds or pacing a sequence.

Time Since Cue widget Inspector

Prev Cue Duration

How long the previous cue was held before the next one fired — a quick sense of timing between states.

Cue Progress

A progress bar for the current timed cue (e.g. a media-server cue with a known duration), filling as it runs.

Cue Progress widget Inspector

Running Media Cues

A live list of the media-server cues currently running — from QLab and Millumin (every connected media server) — each with its own progress bar, mirroring the media state right on the video.

Running Media Cues widget Inspector

TheatreMix Cue

The current TheatreMix cue — surfaces the audio-cue state coming from TheatreMix.

TheatreMix Cue widget Inspector

Audio

Audio Scene

The current mixing-console scene — number and name — captured from the audio desk (Yamaha DM7 / CL / QL / Rivage, etc.). Shows which desk scene was live at any point.

Audio Scene widget Inspector

Show timing

Show State

The Show State widget — counts down to curtain before the show, up through each act, and down through each interval (green → amber → red as it runs out), driven by your timing cues. See Show State for the full timing setup.


Stage & automation

Position Data

Live tracker / PSN position data — X / Y / Z and rotation for a bound tracker, via a configurable template so you choose exactly which fields show. Units switch between feet and metres. Pairs with the Stage Visualizer.

Position Data widget Inspector

Number Line

A centre-line stage ruler — marks numbered outward from 0 at centre (the standard stage-edge numbering used for blocking and positions). Configure marks per side, the step (usually 2), spacing, units (feet / metres), and whether the centre mark shows.

Stage Number Line widget on the live overlay preview

The Stage Number Line laid across the stage, with its Inspector options: mode, units, marks per side, step, spacing, and centre mark.


Media

Secondary Video Feed

A picture-in-picture of a second camera or NDI source, composited into the recording with its own crop and flip. See Secondary Video Feed.

Secondary Video Feed widget Inspector

Custom

Custom Text

Free text you enter — a fixed label, a credit, or a note. Supports Companion variables, so it can show a remote-driven value, and takes the usual colour / justification styling.

Custom Text widget Inspector

PNG Image

A custom PNG image — drop in a company logo, venue branding, or a watermark, sized and positioned like any other widget.

PNG Image widget Inspector