RevueShow — Complete User Guide

RevueShow is a macOS app for theatrical productions. It records your camera feed with a burned-in lighting cue overlay, tracks cues from your lighting console in real time, and streams show state to venue devices via RevueShowLive.

Table of Contents

1. First Launch
2. Project & Show Setup
3. Camera Setup
4. Audio Setup
5. Recording
6. Playback
7. Cue Tracking
8. Connecting GrandMA3 ← step-by-step checklist
9. Connecting GrandMA2 ← step-by-step checklist
10. Connecting ETC Eos
11. Connecting QLab
12. RevueShowLive
13. Notes Server
14. Timecode
15. Loop Mode
16. Companion Module
17. Session Reports & Export
18. Preferences Quick Reference
19. OSC Remote Control Reference
20. License Tiers

1. First Launch

1. Open RevueShow.
2. Click New Project.
3. Type your show name (e.g. PACA FROZEN).
4. Choose a folder — your recordings will be saved here.
5. The app opens in Live mode. The camera preview shows in the centre.

Tip: The show name appears on the recorded overlay, on RevueShowLive, and in exported cue lists. You can change it later in Preferences → General.

2. Project & Show Setup

Click Project Settings (the pencil icon in the toolbar) to open the show settings sheet.

These settings travel with the .rvshow project file. Network ports stay in Preferences.

3. Camera Setup

1. Open Preferences → Camera.
2. Select your capture device from the dropdown.
3. Set the resolution. 1920×1080 (HD) is recommended.
4. The live view in the main window shows a 16:9 preview. Black bars are not recorded — the final video is always 16:9.

Capture cards: Any device that appears as a camera in macOS (Blackmagic, Elgato, Magewell) works. Select it from the dropdown like a webcam.

4. Audio Setup

Open Preferences → Audio.

Input tracks

Add up to three recording tracks. Typical setup for theatre:

Waveform source: The playback waveform is derived from Track 1. Connect your clearest full-mix signal here for the most useful waveform display.

LTC (timecode) is always captured as a separate channel — configure its source in Preferences → Timecode, not here.

Output

Configure output routing for playback audio — useful for sending to a mix-minus or cue speaker.

5. Recording

Starting a recording

1. Click the ▼ chevron next to the Record button to choose session type:
   • Tech — technical rehearsal
   • Dress — dress rehearsal
   • Show — performance
2. Click ● Record. Recording starts immediately.
3. Optionally click Setup Sheet… (from the chevron menu) before recording to add pre-session notes.
4. A Notes text field appears in the toolbar while recording. Type notes live — they are saved into the session file.
5. Click ■ Stop to end. RevueShow finalises the recording, embeds cue metadata, and generates a waveform.

File naming

RevueShow auto-names recordings using the show name and session type:

FROZEN_Tech_A.mov
FROZEN_Dress_A.mov
FROZEN_Show_A.mov

If the same session type runs more than once on the same day, a letter suffix increments (A → B → C…).

Storage indicator

The toolbar shows free disk space and estimated recording time remaining.

6. Playback

1. Click the Playback toggle in the toolbar centre to switch modes.
2. The most recent recording loads automatically.
3. To load a different file: drag it onto the player, or click the folder icon.

Keyboard shortcuts

Cue list

The Cues panel lists every cue recorded. Click any row to jump frame-accurately to that moment.

• Go on Console button (→) re-fires the cue on the connected console.
• Filter by source: All, LX (lighting), Media (QLab).
• Export as CSV: click the export icon at the top of the panel.

Loop mode

Set an In and Out point to loop a section repeatedly. Useful for rehearsing a scene.

7. Cue Tracking

RevueShow listens for OSC messages from your console on the OSC In port (default: 8000).

When a cue fires on the console, RevueShow:

1. Records the cue number and label alongside the video frame.
2. Logs it in the Cues panel with a timestamp.
3. Updates the live overlay.

The OSC In chip in the toolbar shows a green dot when the listener is active. If it is red, check Preferences → OSC and ensure the port is not blocked by macOS Firewall.

8. Connecting GrandMA3

Follow this checklist from top to bottom. Tick each item before moving to the next.

What you need

• Mac running RevueShow on the same network as the MA3 console or MA3onPC.
• The IP address of the Mac (shown in Preferences → OSC → Cue Input).
• The IP address of the MA3 console (shown on the MA3 home screen under Network).

Part A — MA3 sends cues TO RevueShow

On the MA3 console:

• 1. Press Setup (main menu).
• 2. Go to Network → OSC.
• 3. Find the OSC output line you want to use (Line 1 is fine).
• 4. Set Output Mode to Enabled.
• 5. Set Destination IP to the IP address of the Mac running RevueShow.
• 6. Set Destination Port to 8000 (or whatever port is shown in RevueShow under Preferences → OSC → Cue Input Port).
• 7. Under Output Filter, make sure Cue events are included. (Deselect other event types you don't need — this keeps traffic clean.)
• 8. Press Apply or OK to save.

Fire a cue on MA3.

• 9. In RevueShow, look at the OSC IN chip in the toolbar. It should flash briefly when a cue fires.
• 10. Open the Cues panel — you should see the cue appear with its number and label.

Nothing appearing? Check: Is the Mac on the same subnet as MA3? Does macOS Firewall block incoming UDP on port 8000? (System Settings → Network → Firewall → Options → check RevueShow is allowed.)

Part B — RevueShow sends cues BACK TO MA3 (playback control)

This lets RevueShow fire cues on the console during playback review.

In RevueShow:

• 1. Open Preferences → OSC → Console Output.
• 2. Enable Console OSC Output.
• 3. Set Console Type to GrandMA3.
• 4. Set Host to the IP address of the MA3 console.
• 5. Set Port to 8001 (MA3's default OSC input port — check MA3 Network → OSC Input if unsure).
• 6. Leave Sequence Number as Auto — RevueShow detects it from incoming cue OSC.

On the MA3 console:

• 7. Go to Setup → Network → OSC.
• 8. Enable OSC Input on an input line.
• 9. Set the input port to 8001.

Test it:

• 10. In RevueShow Playback, click a cue row's → Go button.
• 11. The cue should fire on the MA3 console.

RevueShow sends: /gma3/cmd "Go Sequence N Cue M.MM"

Part C — Optional: Current Cue Sync Plugin (recommended for reliable tracking)

Normal MA3 OSC output only fires on Go Forward / Go Back. If operators use Goto, macros, or executors, those state changes may not appear via standard OSC output.

The sync plugin polls the selected sequence every 0.25 s and sends RevueShow the current cue regardless of how it changed.

Setup:

• 1. In MA3, go to Setup → Plugins (or the Lua console).
• 2. Import the file docs/ma3-current-cue-plugin.lua from the RevueShow folder.
• 3. Open the plugin code and check line 2: local OSC_LINE = 1. Change the number to match whichever OSC output line you configured in Part A.
• 4. Run the plugin once — it prints RevueShow current cue sync starting.
• 5. Run it again to stop.

Test it: Select a sequence on MA3. Use Goto to jump to a cue. Confirm the cue appears in RevueShow's Cues panel within 0.25 seconds.

⚠️ Test with GetCurrentCue():Dump() in the MA3 Lua console on your specific MA3 software version before relying on this in show conditions — property names can vary by build.

9. Connecting GrandMA2

RevueShow receives MA2 cues via MIDI Show Control (MSC) — the simplest and most reliable method. MA2 sends MSC SysEx GO messages natively on every cue execute.

What you need

• GrandMA2 console or MA2onPC.
• A MIDI connection from MA2 to the Mac: USB MIDI (if the console has a USB-B port) or a hardware MIDI interface with a MIDI cable from MA2's DIN MIDI Out.
• The Mac must show the MIDI device in Audio MIDI Setup (macOS app).

Part A — MA2 sends cues TO RevueShow via MIDI Show Control

On the MA2 console:

• 1. Go to Setup → MIDI.
• 2. Enable Send MIDI Show Control.
• 3. Set MSC Device ID to 127 (all call — simplest setting, works with any receiver).
• 4. Set MSC Command Format to General (01) — RevueShow accepts any command format.
• 5. Press Please (MA2's confirm key) to save.

Connect the MIDI cable:

• 6. Connect MA2's MIDI Out (or USB MIDI) to the Mac. If using DIN MIDI, you need a USB MIDI interface.
• 7. On the Mac, open Audio MIDI Setup (search Spotlight). In the MIDI Studio window, verify the interface appears.

In RevueShow:

• 8. Open Preferences → MIDI. You should see the MIDI source listed.
• 9. RevueShow connects to all available MIDI sources automatically — no further configuration needed.

Test it:

• 10. Fire a cue on MA2.
• 11. In RevueShow, the Cues panel should show the cue number and list number within a fraction of a second.

Nothing appearing? Check: Is the MIDI device listed in Preferences → MIDI → Connected Sources? Try re-plugging the USB cable. On MA2onPC, ensure the software has MIDI output enabled and your interface is selected in Setup → MIDI.

Cue label: MA2 MSC sends the cue number and list number only — not the cue label. The label field will be blank in RevueShow. You can add labels later by editing the cue row in the Cues panel.

Part B — RevueShow sends cues BACK TO MA2 (playback control)

MA2 does not support OSC. RevueShow cannot currently send cue-go commands back to MA2 during playback — the Go on Console button is not available for MA2 sessions.

Use the cue list as a reference guide during playback and trigger cues manually on the console.

10. Connecting ETC Eos

Part A — Eos sends cues TO RevueShow

On the Eos console:

• 1. Go to Setup → System → OSC.
• 2. Enable OSC Output.
• 3. Set Output IP to the Mac's IP.
• 4. Set Output Port to 8000 (RevueShow's cue input port).
• 5. Fire a cue. It should appear in RevueShow's Cues panel.

Part B — RevueShow sends cues BACK TO Eos

In RevueShow:

• 1. Open Preferences → OSC → Console Output.
• 2. Enable Console OSC Output.
• 3. Set Console Type to ETC Eos.
• 4. Set Host to the Eos console IP.
• 5. Set Port to the Eos OSC input port (default 8000 on Eos).
• 6. Set Eos Cue List to the cue list number (usually 1).

RevueShow sends: /eos/cue/{list}/{cue}/fire

11. Connecting QLab

RevueShow receives QLab cue events on the same listener port as the lighting console.

In QLab:

• 1. Open Settings → OSC.
• 2. Click + under OSC Outputs.
• 3. Set IP to the Mac running RevueShow (they can be the same Mac).
• 4. Set Port to 8000.

QLab cues appear in the Cues panel with a QLAB source badge. Filter by clicking Media in the Cues panel.

12. RevueShowLive

RevueShowLive serves a web page on your local network showing live show state. Any device with a browser (iPad, laptop, phone) can connect — no app needed.

Requires: Venue licence or above.

Enabling RevueShowLive

1. Open Preferences → RevueShowLive.
2. Toggle Enable RevueShowLive on.
3. The URL is shown below the toggle (e.g. http://192.168.1.10:8080).
4. Open that URL on any device on the same WiFi network.

What the page shows

Display options

In Preferences → RevueShowLive:

• Title Mode — Show Name, Custom Text, or Logo (image from Project Settings).
• Show/hide each element individually (cue number, cue name, LTC, media cue, REC status, elapsed time).
• Accent colour — changes the highlight colour on the page.
• Hide RevueShowLive branding — Venue licence.

Mask

Tap Mask On (or send /revueshow/mask/on via OSC) to cover the output with a "BLOCKED" screen. The show name and logo remain visible above the mask.

Tap Mask Off (or /revueshow/mask/off) to restore the view.

Live messages

You can display a full-screen message on RevueShowLive:

• Via the Messages panel in the app, or via OSC.
• Pre-configured message presets (e.g. "HOUSE OPEN", "PLACES", "INTERVAL") are set up in Preferences → RevueShowLive → Messages.

Network notes

• RevueShowLive uses plain HTTP. No app is needed on viewer devices.
• If devices can't connect: check macOS Firewall (System Settings → Network → Firewall → Options) allows incoming connections on the RevueShowLive port.
• The MJPEG stream endpoint is /stream.mjpeg. The main page at / loads it automatically.

13. Notes Server

Requires: Production licence or above.

The Notes Server serves a web page where crew can submit notes from their phones during rehearsal.

1. Open Preferences → Notes Server.
2. Enable Notes Server.
3. Share the URL shown (e.g. http://192.168.1.10:8888) with crew.
4. Submitted notes appear in the Notes panel in real time and are saved with the session.

Optional: enable PIN protection to prevent unauthorised submissions.

14. Timecode

All timecode settings are in Preferences → Timecode.

RevueShow reads timecode from three sources, in priority order:

1. LTC (audio) — highest priority. Select the audio device and channel carrying your LTC stripe. The LTC chip in the toolbar turns green when locked. LTC is recorded with the video and decoded during playback.
2. sACN E1.31 — multicast UDP timecode. Enable the toggle and RevueShow joins the standard sACN multicast group automatically. Requires Solo licence or above.
3. MTC (MIDI Timecode) — assembled from MIDI quarter-frame messages (0xF1). Works with any MIDI interface — no additional setup needed if a MIDI device is connected.

LTC setup (step by step)

1. Connect the LTC source (e.g. a sidechain from your audio console or a dedicated timecode generator) to an audio interface input.
2. Open Preferences → Timecode.
3. Under LTC Source, select the audio device from the dropdown.
4. Select the channel (e.g. channel 2 if LTC is on the right side of a stereo feed).
5. The LTC chip in the toolbar should turn green within a few seconds of timecode running.

Offset compensation

If LTC arrives slightly late (e.g. due to long cable runs), set an offset in Preferences → Timecode → Offset to compensate.

15. Loop Mode

Loop mode lets you repeat a section of video for rehearsal.

1. During playback, navigate to your start point.
2. Press [ (or click Set In) to set the loop in point.
3. Navigate to your end point.
4. Press ] (or click Set Out) to set the loop out point.
5. Press L (or click Loop) to enable looping.

RevueShow plays between the in and out points continuously. Click Loop Off or press L again to stop.

16. Companion Module

The Bitfocus Companion module lets you control RevueShow from a Stream Deck or any Companion-compatible device.

Install: download the .tgz from the Companion/ folder and install via Companion → Modules → Install from file.

Configure: set the Host to the Mac's IP and Port to 8001 (RevueShow's remote control port).

Available preset button groups:

• Transport — Record, Stop, Play, Pause
• Navigation — Next/Prev Cue, Next/Prev TC Segment, +5s/-5s, Next/Prev Frame
• Loop — Set In/Out, Go In/Out, Toggle, Enable, Disable, Stop, Clear
• Messaging — Mask On/Off/Toggle, Clear Message, all configured message presets

See the Companion/ folder README for full action and variable reference.

17. Session Reports & Export

Requires: Venue licence or above.

Auto-export PDF summary

Enable Preferences → General → Auto-export PDF summary after each recording. RevueShow exports a PDF session report when recording stops, including:

• Session info (show, date, duration)
• Full cue list with timestamps
• Optionally: cue snapshots, notes

Export options

In the Cues panel, click the export icon to export:

• CSV — full cue list with timecodes, cue numbers, labels, and notes.
• FDX (Final Draft) — cue list formatted for script import.

In the Recordings panel, right-click a recording to export cue timing data alongside the video.

18. Preferences Quick Reference

19. OSC Remote Control Reference

RevueShow listens for remote control commands on port 8001 (configurable in Preferences → OSC → Remote Control Port).

Transport

Navigation

Loop

Messaging & Mask

20. License Tiers

Sign in or enter a licence key in Preferences → Account. Manage billing at showrevue.com/account.