Cue Lifecycle
Create, edit, duplicate, reorder, and delete cues from one main queue interface.
Core Capabilities
Multi-Target Triggering
Trigger columns, clips, group columns, and OSC commands from a single cue definition.
Show Management
Save, load, and reset shows using JSON-based show files for portability.
Network Reach
Run from phone or tablet over local WiFi for stage and projection control.
Interaction Model
- Double-click cue row for full edit.
- Shift+Click cue name or notes for inline edit.
- Per-row actions menu for duplicate/edit/delete.
- Drag handle reordering with automatic cue number updates.
Spacebar: Next Cue
Backspace: Previous Cue
N: New Cue
Enter: Edit
Quick Start
- Install backend deps: cd backend && npm install
- Install frontend deps: cd frontend && npm install
- Start backend: cd backend && npm start
- Start frontend: cd frontend && npm run dev
- Open http://localhost:3000 or network URL.
Configuration
- Use OSC_CONFIG on first run.
- Set Resolume REST host/port (default: localhost:8080).
- Enable OSC and port settings as needed (default: 7000).
- Frontend default port is 3000, backend default port is 3001.
Technical Stack
Backend: Node.js, Express, Resolume REST integration, OSC client, JSON storage. Frontend: React, TypeScript, Zustand, Tailwind, @dnd-kit, Vite.
User Instructions: Recommended Start Mode
Operator guide recommends launching through the Electron tray/menu-bar app for settings, restart controls, and easy network URLs.
- Install dependencies: npm install
- Install Electron requirements: npm run electron:install
- Run tray launcher: npm run electron:dev
- Open GUI via tray menu and configure Resolume host/port in Settings.
Operator Workflow
- Create cues with name, notes, and targets (column, clip, group, OSC).
- Use GO/BACK controls and play row action for direct cue fire.
- Reorder via drag handle and manage items from row action menu.
- Save shows to JSON with SAVE_SHOW and restore with LOAD_SHOW.
- Use SMART_BUILD to generate cues from Resolume columns containing media.
Tray Launch
Showcaller
Network Control
Showcaller and Network Notes
- Read-only monitoring view is served at /showcaller.html exactly.
- Use local/network URLs shown in tray Settings for phones/tablets on same network.
- If Showcaller loads wrong content, verify exact URL and active server port, then hard refresh.
- For bounce/ping-pong clips, remaining time can display infinity by design.
Troubleshooting Checklist
- Tray icon missing: confirm Electron app is running and inspect terminal logs.
- No Resolume connection: verify Resolume Web Server is enabled and host/port are correct.
- Actions fail: check cue target indices against current composition/layer/clip layout.
- Page unreachable: resolve auto-shifted port conflicts by checking tray Settings.
- Before live show, test GO/BACK, validate OSC targets, and keep tray process running.