OSC Remote Control

Preferences → Control → OSC: listener port and the copyable OSC command reference.

ShowRevue listens for remote-control commands on port 8001 by default. You can change that in Preferences → Control.

Transport

Address	Action
/showrevue/record	Start recording
/showrevue/stop	Stop recording
/showrevue/play	Play in playback mode
/showrevue/pause	Pause
/showrevue/flag	Drop a "look here later" flag at the current position (optional s label arg)

Show timing

Drive the preshow curtain countdown (Show State widget) from a console. See Show times.

Address	Args	Action
/showrevue/showstart	s "HH:MM"	Override the next curtain to today at HH:MM
/showrevue/nextshow	—	Advance to the next configured show time

Navigation

Address	Args	Action
/showrevue/next_cue	—	Jump to next cue
/showrevue/previous_cue	—	Jump to previous cue
/showrevue/next_tc_segment	—	Next timecode segment
/showrevue/previous_tc_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

note

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/loop (or /loop/toggle)	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. IDs are listed under Preset IDs, e.g. call-5, beginners, go
/showrevue/message/toggle	s presetId	Toggle a preset message, e.g. house-open, interval, show-stop
/showrevue/message/clear	—	Clear the current message

NDI output

Switch the NDI Output source live.

Address	Args	Action
/showrevue/ndi/source	s "showrevuelive"	Send the show output (camera + overlay)
/showrevue/ndi/source	s "gui"	Mirror the GUI video area (live preview, or playback)

Accepts showrevuelive/live/show/0 and gui/mirror/1.

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	Running Media 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"