OSC Remote Control
ShowRevue listens for remote-control commands on port 8001 by default. You can change that in Preferences → OSC Control.
Transport
| Address | Action |
|---|---|
/showrevue/record | Start recording |
/showrevue/stop | Stop recording |
/showrevue/play | Play in playback mode |
/showrevue/pause | Pause |
Navigation
| Address | Args | Action |
|---|---|---|
/showrevue/next_cue | — | Jump to next cue |
/showrevue/previous_cue | — | Jump to previous cue |
/showrevue/next_timecode_segment | — | Next timecode segment |
/showrevue/previous_timecode_segment | — | Previous timecode segment |
/showrevue/forward | f seconds | Skip forward |
/showrevue/back | f seconds | Skip backward |
/showrevue/next_frame | — | Step forward one frame |
/showrevue/previous_frame | — | Step backward one frame |
TimeWarp (DVR)
TimeWarp (DVR) lets you scrub back through a live recording without stopping it — the recording, and any NDI/RTMP/Stage Display outputs, keep running untouched. It is a Production-tier feature, available only while recording, via the TimeWarp button in the toolbar (or the keyboard/OSC commands below). The rolling scrub buffer keeps a configurable window — Preferences → Video, default 4 hours (≈1 GB/hour on disk) — and is deleted automatically when the recording stops.
| Address | Action |
|---|---|
/showrevue/timewarp | Enter TimeWarp (begin scrubbing the live recording). Aliases: /showrevue/warp, /showrevue/dvr |
/showrevue/timewarp/off | Return to live. Aliases: /showrevue/live, /showrevue/dvr/off |
While timeshifting, the standard transport and navigation commands drive the scrub surface instead of the playback engine — so you can reuse the same OSC mapping you use for playback:
| Address | Args | Action |
|---|---|---|
/showrevue/play · /showrevue/pause | — | Play / pause the scrub playhead |
/showrevue/next_cue · /showrevue/previous_cue | — | Jump to the next / previous recorded cue |
/showrevue/forward · /showrevue/back | f seconds | Skip the scrub playhead forward / back |
Console-bound output (OSC cue fires, QLab go, LTC output) is gated off while timeshifting — scrub is monitor-only and never drives the desk backwards.
Keyboard shortcuts (while the app is focused): press D while recording to enter timeshift; then Space play/pause, ← / → skip ±10 s, < / > previous / next cue, Esc return to live.
Loop
| Address | Action |
|---|---|
/showrevue/set_loop_in | Set loop in point |
/showrevue/set_loop_out | Set loop out point |
/showrevue/go_loop_in | Jump to loop in point |
/showrevue/go_loop_out | Jump to loop out point |
/showrevue/toggle_loop | Toggle loop |
/showrevue/enable_loop | Enable loop |
/showrevue/disable_loop | Disable loop |
/showrevue/stop_loop | Stop looping and continue playback |
/showrevue/clear_loop | Clear in and out points |
Messaging and mask
| Address | Args | Action |
|---|---|---|
/showrevue/mask/on | — | Show the blocked mask in Stage Display |
/showrevue/mask/off | — | Remove the mask |
/showrevue/mask/toggle | — | Toggle the mask |
/showrevue/message/set | s text [s colorHex] [f duration] | Display a custom message |
/showrevue/message/preset | s presetId | Trigger a preset message |
/showrevue/message/toggle | s presetId | Toggle a preset message |
/showrevue/message/clear | — | Clear the current message |
Show state counter
Manually set the show phase displayed in the Show State widget.
Note: These commands only take effect when Auto-advance is turned off in Project Settings → Show Timing. When auto-advance is on, the lighting-cue-driven calculation takes precedence and overrides any manually set phase.
| Address | Args | Action |
|---|---|---|
/showrevue/showstate/preshow | — | Set phase to Preshow |
/showrevue/showstate/act | i actNumber | Set phase to Act N (timer starts now) |
/showrevue/showstate/interval | i intervalNumber [f durationSeconds] | Set phase to Interval N, optional countdown duration |
/showrevue/showstate/finished | — | Set phase to Finished |
/showrevue/showstate/reset | — | Clear manual phase (returns to auto-calculated) |
Example — set Act 2:
/showrevue/showstate/act 2
Example — set Interval 1 with 15-minute countdown:
/showrevue/showstate/interval 1 900.0
Widget control
Show, hide, toggle, or recolour individual overlay widgets. Use the widget's kind name (camelCase) or its custom OSC ID (set in the widget inspector).
| Address | Arguments | Action |
|---|---|---|
/showrevue/widget/<id>/show | — | Make widget visible |
/showrevue/widget/<id>/hide | — | Hide widget |
/showrevue/widget/<id>/toggle | — | Toggle widget visibility |
/showrevue/widget/<id>/color | s #RRGGBB | Set text colour (hex). Send none to reset to white. |
<id> is either the widget kind name or a custom OSC ID you set in Preferences → Custom Layouts → inspector → OSC ID.
Available widget kind names:
| Kind | Widget |
|---|---|
showName | Show Name |
showType | Show Type |
showNumber | Show Type / Number |
ltc | LTC |
timecodeSource | Source Pill |
recordingStatus | REC |
cueNumber | Cue Number |
cueLabel | Cue Label |
cueElapsed | Time Since Cue |
cueLine | Cue Line |
customText | Custom Text |
pngImage | PNG Image |
wallClock | Wall Clock |
numberLine | Number Line |
qlabRunningCues | QLab Running Cues |
showState | Show State |
Example — hide the LTC widget:
/showrevue/widget/ltc/hide
Example — set a custom text widget colour using its OSC ID:
/showrevue/widget/titleWidget/color "#FF8800"
/showrevue/widget/titleWidget/color "none"