Documentation
Everything you need to get started with LTCue.
System Requirements
| Platform | Requirements |
|---|---|
| macOS | 11.0+ (Big Sur or later) |
| Windows | 10 or later |
| Resolume | Arena 7.x or later |
You'll also need:
- An audio interface with LTC input
- SMPTE/LTC timecode source
Installation
macOS
- Download the .dmg from the download page
- Open the .dmg file
- Drag LTCue to your Applications folder
- First launch: Right-click → Open (to bypass Gatekeeper)
Required: Install the libltc library:
brew install libltc
Windows
- Download the installer from the download page
- Run the installer
- Follow the installation prompts
- Launch LTCue from the Start menu
Resolume OSC Setup
LTCue communicates with Resolume Arena via OSC. Configure Resolume:
- Open Resolume Arena
- Go to Preferences → OSC
- Enable OSC Input on port
7000 - Enable OSC Output on port
7001 - Click OK
Audio Setup
- Open LTCue and go to the Settings tab
- Select your audio interface from the Device dropdown
- Select the Channel receiving LTC timecode (0 = first channel)
- Set the Framerate to match your timecode source (usually 30 fps)
Your First Scan
- Make sure Resolume Arena is running with a composition loaded
- Ensure some clips have SMPTE timecode offsets configured
- Click Scan Resolume in LTCue
- Wait for the scan to complete
- Select which layers to monitor using the checkboxes
Engine Modes
Single Engine Mode
One LTC stream triggers clips across all selected layers. Use this for simple shows with a single timecode source.
Dual Engine Mode (Licensed)
Two independent LTC streams, each controlling specific layers. Perfect for:
- A-roll and B-roll on separate timelines
- Main show + backup timecode
- Complex multi-timeline productions
Toggle between modes using the switch in the top-right corner.
Trigger Parameters
Access these in the Settings tab:
| Parameter | Default | Description |
|---|---|---|
| Tolerance | 15.0s | How far from the clip offset timecode can be and still trigger |
| Lookahead | 2 frames | Trigger clips this many frames early to compensate for latency |
| Jump Threshold | 1.0s | If timecode jumps by more than this, LTCue enters rearm mode |
Jump Detection
When LTCue detects a timeline jump (scrubbing, looping, or seeking), it automatically:
- Resets all clip trigger status to "ready"
- Enters rearm mode for 3 frames
- Only triggers clips that have been passed
This prevents double-triggering when scrubbing through your timeline.
Layer Selection
Use the layer checkboxes to control which Resolume layers LTCue monitors:
- Only clips in selected layers will appear in the clip table
- Only clips in selected layers will be triggered
- In Dual Engine mode, each engine has its own layer selection
Configuring SMPTE Offsets
For LTCue to trigger a clip, the clip must:
- Have its transport type set to SMPTE 1 or SMPTE 2
- Have a SMPTE offset time configured
To set this up in Resolume:
- Select a clip
- In the clip properties, find Transport
- Set transport to SMPTE 1 (or SMPTE 2 for dual engine setups)
- Set the Offset to when the clip should trigger (HH:MM:SS:FF)
Transport Types
LTCue only triggers clips with these transport types:
- SMPTE 1 — Triggered by Engine 1
- SMPTE 2 — Triggered by Engine 2 (Dual mode)
Clips with other transport types (Timeline, BPM, Denon, Pioneer) are ignored.
Trial Limitations
The free trial includes:
- 1 layer maximum
- 10 clips per layer
- Single engine mode only
- 60-minute session limit
Activating a License
- Purchase a license from the download page
- You'll receive a license key via email
- In LTCue, go to Settings → License
- Enter your license key and click Activate
License Transfer
To move your license to a new machine:
- On your old machine: Settings → License → Deactivate
- On your new machine: Enter your key and click Activate
License terms:
- One license per machine
- Easy transfer to new machines
- Lifetime updates for the major version purchased (v1.x)
- 30-day revalidation (works offline, checks online monthly)
Troubleshooting
No Timecode Displayed
- Check your audio interface is selected in Settings
- Verify the correct channel is selected
- Ensure LTC audio is being sent to that channel
- Try a different framerate setting
Clips Not Triggering
- Verify clips have SMPTE 1 or SMPTE 2 transport type
- Check clip offsets are set correctly in Resolume
- Ensure the layer containing the clip is selected
- Increase the Tolerance setting if timecode is slightly off
Scan Finds No Clips
- Ensure Resolume is running with a composition loaded
- Check OSC is properly configured
- Verify some clips have SMPTE offsets configured
App Won't Launch (macOS)
If macOS blocks the app:
- Go to System Preferences → Security & Privacy
- Click "Open Anyway" for LTCue
- Or right-click the app and select "Open"
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Cmd/Ctrl + 1 |
Switch to Main View |
Cmd/Ctrl + 2 |
Switch to Settings |
Cmd/Ctrl + S |
Save Configuration |
Cmd/Ctrl + O |
Load Configuration |
Cmd/Ctrl + , |
Open Settings (macOS) |
Cmd/Ctrl + Q |
Quit |
Need more help?
Can't find what you're looking for? Get in touch with our support team.
Contact Support