Skip to main content
Version: 0.1

Show State

ShowRevue can track where you are in the show and surface it in two places:

  • the Show State widget on the recording overlay and the layout editor,
  • the Show State pill on the ShowRevueLive web page.

It cycles through four phases driven entirely by the lighting cues you fire on the desk:

PhaseTriggerDisplay
PreshowNo timing cues fired yetPRESHOW —:—
Act NThe act-start cue firesACT N mm:ss count-up stopwatch (switches to hh:mm past one hour)
Interval NAn interval-start cue firesINTERVAL N ↓ mm:ss countdown — green > 5 min, yellow ≤ 5 min, red overtime (− mm:ss)
TotalThe show-end cue firesTOTAL mm:ss — frozen running time from show start to show end

The 1 Hz counters tick on the wall-clock second boundary so the stopwatch, countdown, time-since-cue and wall clock all flip together.


Setting it up

Open File → Project Settings → Timing and fill in the cue numbers that mark your show boundaries:

  • Show starts at cue — the first cue of Act 1.
  • Show has intervals → for each interval, the Start cue (curtain down), End cue (curtain up on the next act), and Duration (min) (the planned interval length, e.g. 20).
  • Show ends at cue — the final cue of the final act.

The same cue numbers are used by the Session Summary PDF, so you only enter them once.

Auto-advance toggle

Under SHOW STATE WIDGET, the Auto-advance Show State from lighting cues toggle controls whether firing the above cues advances the widget. Turn it off if you want the widget to stay in Preshow regardless — for example, during a tech walk-through where you'll fire cues out of order.


Adding the widget to the recording overlay

The Default layout already includes the Show State widget (top-right) so most users do not need to do anything.

To add it to a custom layout:

  1. Preferences → Custom Layouts.
  2. Duplicate a layout (the Default layout is read-only).
  3. In the Widgets palette, click Show State.
  4. Drag/resize the widget where you want it. The font scales to fill the frame, so make it as small or large as you like.

The widget honours its frame — it does not shrink-wrap to its content, so the layout will not jump as the timer ticks.


Show State on ShowRevueLive

The ShowRevueLive web page shows the Show State pill in the top-right corner (above the LTC pill) on desktop, or just above the bottom bar on mobile.

Toggle it from Preferences → ShowRevueLive → Show "Show State". The browser ticks the timer client-side from a phase + start-timestamp so it stays smooth between server pushes.

Anyone on the LAN — directors, producers, DSMs, FOH — sees the same phase at the same time as the operator.


Session Summary PDF — interval variance

Once a recording is finished, the Session Summary PDF shows each interval chip with a small footer comparing actual time to planned duration:

  • +0:35 over 10:00red, ran long
  • −1:12 under 10:00green, ran short
  • on time (planned 10:00)neutral, within ±1 s

The planned duration is the value you entered in the project's timing settings. ShowRevue captures the timing snapshot into the recording's _cues.json sidecar at the moment recording starts, so the report is accurate even if you re-export it months later from a different machine.