Canonical source: the canonical features document for this domain is
deep-dive/features.md, rendered in the docs
center. This file is its operational companion (service topology, APIs,
schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).
Uzume provides comprehensive live entertainment production infrastructure
covering broadcast, lighting, audio, video, stage management, rigging, special
effects, crew operations, audience engagement, extended reality, safety,
scheduling, logistics, networking, power, and AI assistance as consumable
library APIs.
Named after the Japanese goddess of dawn, mirth, and revelry, Uzume is the
largest library-only domain in the Oshun ecosystem. It enables applications to
manage every aspect of live entertainment production -- from a single concert to
a multi-venue global tour -- through 22 TypeScript subsystem libraries, a shared
core framework, and a Rust/WASM protocol-engines workspace for
performance-critical AV protocols.
Domain Overview#
| Subsystem |
Library |
Engines |
Focus |
| Core Framework |
@uzume/core |
6 modules |
Config, database, errors, event bus, logging, utilities |
| Show Control Bridge |
@uzume/nexus |
-- |
Protocol bridging and subsystem integration |
| Protocol Engines |
uzume-protocol-engines |
6 Rust crates |
NDI, SMPTE ST 2110, AES67, Dante, NMOS, high-precision timing |
| Broadcast |
@uzume/broadcast |
10 |
Switching, streaming, replay, simulcast |
| Video and LED |
@uzume/prism |
15 |
Media servers, projection, LED walls, content management |
| Extended Reality |
@uzume/aurora |
25 |
XR stages, drones, digital twins, RTLS, mocap |
| Pre-Visualization |
@uzume/previz |
15 |
3D rendering, VR walkthroughs, collaborative previz |
| Audio Engineering |
@uzume/sonos |
25 |
Mixing, routing, spatial audio, RF, orchestral |
| Audience Engagement |
@uzume/echo |
20 |
Accessibility, interaction, wearables, analytics |
| Stage Management |
@uzume/koru |
15 |
Cue calling, rehearsal, blocking, reports |
| Scenic Design |
@uzume/scena |
10 |
CAD import, construction docs, props, paint, truck pack |
| Costume and Wardrobe |
@uzume/vestis |
10 |
Costume plots, fittings, quick-change, RFID tracking |
| Rigging and Motion |
@uzume/kinesis |
30 |
Hoists, flying, automation, robotics, kinetic, animatronics |
| Lighting Design |
@uzume/lumina |
20 |
Fixtures, DMX/sACN, cues, pixel mapping, effects |
| Special Effects |
@uzume/pyra |
18 |
Pyrotechnics, lasers, fog, scent, water, choreography |
| Power Distribution |
@uzume/tesla |
10 |
Diagrams, load calculation, generators, monitoring |
| Network Infrastructure |
@uzume/forge |
10 |
Topology, VLANs, PTP, bandwidth, Wi-Fi, security |
| Crew Communication |
@uzume/hermes |
10 |
Messaging, intercom, video monitoring, translation |
| Production Planning |
@uzume/atlas |
24 |
Budgets, crew, equipment, touring, sustainability |
| Scheduling |
@uzume/chronos |
10 |
Timelines, rehearsals, calendars, resource leveling |
| Safety and Compliance |
@uzume/aegis |
30 |
Risk, inspections, weather, crowd safety, OSHA/NFPA |
| AI Assistance |
@uzume/muse |
15 |
AI cue placement, generative content, NLP show control |
1. Core Framework (@uzume/core)#
The foundational layer consumed by all other Uzume libraries.
1.1 Configuration Management#
| Capability |
Description |
| Configuration contracts |
Typed, validated configuration schemas for all subsystems |
| Environment-aware config |
Configuration adapts to development, staging, and production environments |
| Schema validation |
All configuration is validated against Zod schemas at startup |
1.2 Database and Persistence#
| Capability |
Description |
| Drizzle ORM integration |
PostgreSQL database access via Drizzle ORM with typed schema |
| Migration management |
Database schema migrations with up/down/status tracking |
| Seed data |
Preview and apply seed data for development and testing |
1.3 Event Bus#
| Capability |
Description |
| NATS event bus |
Real-time event publishing and subscription across subsystems via NATS |
| Typed events |
All events are typed with structured payloads |
| Inter-subsystem communication |
Subsystems coordinate through events without direct dependencies |
1.4 Error Handling and Logging#
| Capability |
Description |
| Domain error hierarchy |
Structured error types specific to live entertainment production |
| Structured logging |
Context-rich structured logging across all subsystems |
| Shared utilities |
Common utility functions for date formatting, ID generation, and data normalization |
2. Show Control Bridge (@uzume/nexus)#
| Capability |
Description |
| Protocol bridging |
Bridge between disparate show control protocols and systems |
| Subsystem integration |
Unified control layer connecting lighting, audio, video, automation, and effects |
| Show control orchestration |
Coordinate multi-department cues through a single control surface |
3. Rust/WASM Protocol Engines (uzume-protocol-engines)#
Performance-critical protocol implementations in Rust, compiled to both native
code and WebAssembly for browser-based control surfaces.
3.1 Protocol Support#
| Crate |
Protocol |
What It Enables |
uzume-protocol-types |
Shared types |
Common type definitions for all protocol crates |
uzume-timing-core |
SMPTE timecode |
Sub-microsecond timing precision for synchronized show control |
uzume-network-io |
Low-level I/O |
High-performance network I/O for AV protocol streams |
| Crate |
Target |
What It Enables |
uzume-node-bridge |
Node.js |
Native Node.js module via napi-rs for server-side protocol handling |
uzume-control-surface-wasm |
Browser |
WebAssembly control surface for browser-based show operation |
3.3 Key Protocol Capabilities#
| Capability |
Description |
| SMPTE timecode |
High-precision SMPTE timecode generation and parsing (30fps, drop-frame, non-drop) |
| Frame-rate support |
24, 25, 29.97, 30, 50, 59.94, 60 fps timecode formats |
| Low-latency I/O |
Rust-optimized network I/O for real-time AV protocol streams |
| WASM control surfaces |
Browser-based control panels compiled from Rust with full protocol awareness |
| Native Node.js bridge |
Zero-overhead Node.js bindings via napi-rs for server-side protocol processing |
| MIDI integration |
MIDI device I/O via the midir crate for console and controller integration |
4. Broadcast and Streaming (@uzume/broadcast)#
Everything needed to switch, stream, record, and distribute live broadcast
content.
4.1 Broadcast Switching#
| Capability |
Description |
| Video switcher control |
Integrate with broadcast video switchers for live source switching |
| Mix/effect block control |
Control multiple M/E blocks with source selection and transition types (cut, dissolve, wipe) |
| Auxiliary outputs |
Route sources to auxiliary outputs for confidence monitors and recording |
| Multiviewer management |
Configure and manage multi-viewer layouts showing all sources on monitoring displays |
4.2 Replay and Recording#
| Capability |
Description |
| Replay system integration |
Control replay and slow-motion systems for live event instant replay |
| ISO recording management |
Manage isolated camera recordings with per-camera file tracking and status |
4.3 Graphics and Overlays#
| Capability |
Description |
| Broadcast graphics |
Create and control real-time broadcast graphics overlays (lower thirds, scoreboards, tickers) |
4.4 Streaming and Distribution#
| Capability |
Description |
| Multi-platform streaming |
Stream simultaneously to multiple platforms (YouTube, Twitch, Facebook, custom RTMP) |
| Stream health monitoring |
Real-time monitoring of stream bitrate, frame drops, encoder health, and CDN connectivity |
| SRT contribution feeds |
Manage SRT protocol contribution feeds for remote camera and venue integration |
| Multi-venue simulcast |
Distribute synchronized content to multiple venues simultaneously |
4.5 Audio for Broadcast#
| Capability |
Description |
| Audio split management |
Manage audio splits and bus routing between FOH mix, broadcast mix, and recording |
5. Video and LED Content (@uzume/prism)#
Video playback, projection mapping, LED wall management, and media server
integration.
| Capability |
Description |
| Disguise media server |
Integration with Disguise (d3) media servers for content playback and control |
| Resolume Arena |
Integration with Resolume Arena for real-time visual performance |
| TouchDesigner |
Integration with TouchDesigner for interactive and generative visual content |
| Notch VFX |
Integration with Notch for real-time visual effects rendering |
| Generic media server protocol |
Adapter for controlling any media server through standardized protocols |
5.2 LED and Projection#
| Capability |
Description |
| LED wall layout designer |
Design and configure LED wall layouts with panel placement and resolution mapping |
| Brompton Tessera management |
Control Brompton LED processors for color calibration and panel configuration |
| Projection mapping |
Map video content onto irregular surfaces and architectural elements |
| Projection auto-alignment |
Automatically align projectors to surfaces using calibration patterns |
5.3 Video Pipeline#
| Capability |
Description |
| Video routing matrix |
Route video signals between sources and destinations through a virtual matrix |
| Video content management |
Organize, tag, and manage video content libraries with metadata |
| Content preflight checker |
Validate video content format, resolution, codec, and duration before show time |
| Video color pipeline |
Manage color spaces, LUTs, and color calibration across the video chain |
| Video signal redundancy |
Configure primary and backup video signal paths with automatic failover |
5.4 Camera Management#
| Capability |
Description |
| IMAG camera management |
Manage image magnification (IMAG) cameras with tally, preset, and routing control |
6. Extended Reality and Virtual Production (@uzume/aurora)#
XR stages, drone shows, digital twins, real-time tracking, and virtual
production tools.
6.1 Virtual Production#
| Capability |
Description |
| Disguise XR stage management |
Manage XR LED volume stages with content zones and camera frustum tracking |
| Camera tracking distribution |
Distribute camera tracking data (position, rotation, lens) to rendering engines |
| Unreal Engine live control |
Control Unreal Engine instances in real-time for virtual set rendering |
| Virtual production color science |
Manage color science pipeline for LED volume stages (ACES, color matching, calibration) |
| Virtual set extension |
Visualize and manage virtual set extensions beyond physical LED boundaries |
| Physical-digital lighting alignment |
Synchronize real-world lighting with virtual environment lighting |
6.2 Drone Shows#
| Capability |
Description |
| Drone show design |
Design aerial drone formations, paths, and lighting sequences |
| Drone-pyrotechnic coordination |
Coordinate drone movements with pyrotechnic effects for combined aerial displays |
6.3 Digital Twins and Simulation#
| Capability |
Description |
| Real-time digital twin |
Maintain a real-time digital replica of the physical venue and show state |
| What-if simulation |
Run hypothetical scenarios on the digital twin without affecting the live show |
| AI anomaly detection |
Detect anomalies in show systems using AI pattern recognition |
| Predictive maintenance |
Predict equipment failures before they occur using ML on sensor data |
6.4 Holographic and Display Technology#
| Capability |
Description |
| Holographic display management |
Control holographic projection systems and volumetric displays |
| High-resolution LED management |
Manage large-format high-resolution LED displays with content zones |
6.5 Real-Time Tracking#
| Capability |
Description |
| Real-time body tracking |
Track performer body positions and movements for interactive content |
| UWB indoor positioning |
Ultra-wideband indoor positioning for precise performer and equipment location |
| RTLS position visualization |
Visualize real-time location system data on venue maps |
| RTLS emergency mustering |
Track personnel locations for emergency evacuation accounting |
| RTLS equipment tracking |
Track equipment location across venues and warehouses |
| Position-triggered automation |
Trigger show cues automatically based on tracked positions |
6.6 Interactive and Wearable#
| Capability |
Description |
| Interactive environments |
Create environments that respond to performer and audience movement |
| Motion capture sessions |
Manage motion capture recording sessions with performer tracking |
| Virtual performer interaction |
Enable real-time interaction between physical and virtual performers |
| Wearable technology |
Integrate performer wearables (biometrics, haptics, LED costumes) with show systems |
| Digital human rendering |
Manage real-time digital human rendering pipelines for virtual characters |
7. Pre-Visualization (@uzume/previz)#
3D simulation and previsualization tools for planning shows before physical
setup.
| Capability |
Description |
| Venue 3D rendering |
Render 3D models of venues with accurate dimensions and sightlines |
| Fixture rendering |
Visualize lighting fixtures with beam simulation and color rendering |
| LED wall and projection rendering |
Preview LED wall and projection surface content in 3D space |
| Scenic automation visualization |
Visualize scenic element movements and automation cues |
| Visual effects simulation |
Preview pyrotechnic, atmospheric, and special effects |
| Audio spatialization preview |
Preview spatial audio coverage and speaker array patterns |
| Unified timeline scrubbing |
Scrub through all department timelines simultaneously in a unified view |
| VR walkthrough (WebXR) |
Walk through the virtual venue in VR for spatial planning and design review |
| Collaborative multi-user previz |
Multiple users work in the same previz session in real-time |
| Live console connection |
Connect previz to live lighting consoles for real-time feedback |
| Rendering quality modes |
Switch between draft, preview, and high-quality rendering for speed vs. fidelity |
| Screenshot and video capture |
Capture screenshots and video recordings of previz sessions |
| Previz tool interoperability |
Import and export with industry previz tools (WYSIWYG, Vectorworks, Capture) |
| Multi-camera virtual preview |
Preview shows from multiple camera angles simultaneously |
| Performance benchmarking |
Profile and optimize previz rendering performance |
8. Audio Engineering (@uzume/sonos)#
Audio mixing, routing, spatial sound, RF management, and orchestral production.
8.1 Audio Networking#
| Capability |
Description |
| Dante network management |
Configure and manage Dante audio networks with device discovery and routing |
| AES67 interoperability |
AES67 standard audio-over-IP for cross-vendor interoperability |
| Audio patch management |
Manage audio patching across consoles, stage boxes, and processing |
8.2 Virtual Soundcheck and Recording#
| Capability |
Description |
| Virtual soundcheck recording |
Record multi-track audio for offline mixing and virtual soundcheck |
| Redundant playback monitoring |
Monitor redundant playback systems for automatic failover |
8.3 Sound System Design#
| Capability |
Description |
| Line array design |
Design and predict coverage for line array speaker systems |
| Delay system calculation |
Calculate delay times and levels for time-aligned sound systems |
| Subwoofer array configuration |
Design subwoofer arrays with cardioid, end-fire, and gradient patterns |
| Acoustic modeling |
Model room acoustics and predict sound behavior in venue spaces |
| Gain structure calculation |
Calculate optimal gain staging across the audio signal chain |
8.4 Spatial and Immersive Audio#
| Capability |
Description |
| Immersive audio objects |
Position and move audio objects in 3D space for immersive sound experiences |
8.5 RF and Wireless Management#
| Capability |
Description |
| RF frequency coordination |
Coordinate wireless microphone and IEM frequencies to avoid interference |
| Wireless microphone monitoring |
Real-time monitoring dashboard for wireless microphone battery, signal, and RF levels |
| IEM mix management |
Manage in-ear monitor mixes for performers |
| RF spectrum visualization |
Visualize the RF spectrum for frequency planning and interference identification |
| RF venue coordination database |
Database of venue-specific RF environments for pre-planning |
8.6 Playback and Integration#
| Capability |
Description |
| Ableton Live integration |
Control and synchronize Ableton Live sessions for backing track playback |
| QLab integration |
Integrate with QLab for cue-based audio playback |
| Click and guide track distribution |
Distribute click tracks and guide tracks to musicians and crew |
| Stem playback management |
Manage multi-stem playback with per-stem level and mute control |
8.7 Orchestral and Musical Theatre#
| Capability |
Description |
| Conductor camera management |
Manage conductor relay camera systems for pit musicians |
| Musician personal monitor management |
Manage individual musician monitor mixes in orchestral settings |
| Pit configuration management |
Design and manage orchestra pit layouts with stand placement |
| Music stand display system |
Digital music stand displays with score synchronization and page turning |
| Pit communication system |
Communication system between pit musicians, conductor, and stage management |
9. Audience Engagement and Accessibility (@uzume/echo)#
Audience interaction, accessibility features, and in-show experience systems.
9.1 Audience Interaction#
| Capability |
Description |
| Audience response polling |
Real-time audience polling and voting during performances |
| LED wristband control |
Control audience LED wristbands for synchronized light shows |
| Social media aggregation |
Aggregate and display social media posts on venue screens |
| Beacon/BLE proximity system |
Trigger location-based content and notifications via Bluetooth beacons |
| AR overlay mobile features |
Augmented reality overlays on mobile devices during performances |
| White-label audience app |
White-label mobile app platform for venue-branded audience experiences |
| Haptic feedback wearables |
Integrate haptic wearables for tactile audience engagement |
| Interactive LED floors |
Manage interactive LED floor surfaces that respond to movement |
| Immersive theatre audience flow |
Manage audience flow and navigation in immersive/promenade theatre |
| Audience biometric sensing |
Aggregate audience biometric and emotion data for show adaptation |
9.2 Accessibility#
| Capability |
Description |
| Comprehensive accessibility system |
Centralized accessibility management across all show systems |
| Assistive listening integration |
Integrate with hearing loop, FM, and IR assistive listening systems |
| Audio description management |
Manage live audio description for visually impaired audience members |
| Sign language interpreter integration |
Coordinate sign language interpreters with show cues and camera positions |
| Surtitle/supertitle management |
Display surtitles and translations above the stage or on screens |
| Relaxed/sensory-friendly mode |
Configure reduced-intensity shows for sensory-sensitive audiences (dimmed lights, reduced volume, relaxed house rules) |
| Tactile tour management |
Manage pre-show tactile tours for visually impaired audiences |
| Accessibility seating and services |
Manage accessible seating, companion seats, and accessibility service requests |
| Haptic and tactile feedback |
Deliver haptic feedback to deaf and hard-of-hearing audiences synchronized to music |
9.3 Crowd Analytics#
| Capability |
Description |
| Crowd analytics |
Analyze audience density, movement patterns, and engagement metrics |
10. Stage Management (@uzume/koru)#
Cue calling, rehearsal management, blocking notation, and production scheduling
from the stage manager's perspective.
10.1 Cue Management#
| Capability |
Description |
| Digital cue sheets |
Create and manage digital cue sheets with department-specific cue columns |
| Show calling interface |
Cue-calling interface for stage managers with GO button, standby, and warning functions |
| Cue light station system |
Manage cue light stations throughout the venue for silent cueing |
| Multi-department cue status |
Dashboard showing real-time cue status across all departments |
| Hold and emergency stop |
Emergency stop and hold protocols that halt all automated systems simultaneously |
| Capability |
Description |
| Rehearsal note management |
Capture, assign, and track rehearsal notes by department |
| Show report generator |
Generate standardized show reports with timing, incidents, and department notes |
| Digital blocking notation |
Record and visualize performer blocking (stage positions and movements) |
| Preset checklist system |
Department-specific preset checklists with sign-off tracking |
| Run sheet / production schedule |
Master run sheets with time-stamped event sequences |
10.3 Cast and Crew Tracking#
| Capability |
Description |
| Understudy and swing tracking |
Track understudy and swing assignments with automatic cue sheet updates |
| Digital call board |
Digital call board displaying schedules, announcements, and sign-in status |
| Intercom integration |
Integrate with production intercom systems for stage manager communication |
10.4 Scene and Show Flow#
| Capability |
Description |
| Scene change management |
Plan and track scene changes with timing, crew assignments, and scenic element lists |
| Multi-language interface |
Stage management interface available in multiple languages for international productions |
11. Scenic Design and Construction (@uzume/scena)#
Scenic design workflows from concept to fabrication to load-in.
| Capability |
Description |
| Scenic design workspace |
Digital workspace for scenic design with drawing and annotation tools |
| CAD file import |
Import scenic designs from CAD software (AutoCAD DWG/DXF, Vectorworks) |
| Construction documentation |
Generate shop drawings, cut lists, and construction documents from designs |
| Materials library |
Searchable library of scenic construction materials with specifications and costs |
| Revision tracking |
Track design revisions with version history and change annotations |
| Props management |
Track props inventory, assignments, placement, and consumption |
| Props preset tracking |
Track prop preset positions and placements for scene changes |
| Paint reference system |
Manage scenic paint samples, colors, and finish references |
| Truck pack planning |
Plan truck loading with scenic element dimensions and weight distributions |
| Scenic budget tracker |
Track scenic department budgets against actuals |
12. Costume and Wardrobe (@uzume/vestis)#
Costume management from design through fitting, performance, and maintenance.
| Capability |
Description |
| Costume plot management |
Manage costume plots with character/scene assignments and design images |
| Fitting schedule management |
Schedule and track costume fittings with measurement records |
| Garment maintenance scheduling |
Schedule cleaning, repair, and maintenance for costumes |
| LED costume control |
Control LED-embedded costumes with cue synchronization |
| Makeup design reference |
Manage makeup designs with reference photos and product specifications |
| Quick-change choreography |
Document and time backstage quick-change sequences |
| Wardrobe RFID tracking |
Track wardrobe inventory using RFID tags for automated check-in/check-out |
| Wardrobe budget tracking |
Track wardrobe department budgets with purchase and rental costs |
| Wearable tech maintenance |
Manage testing and maintenance schedules for wearable technology in costumes |
| Wig and hairpiece management |
Track wig and hairpiece inventory, fitting, and maintenance |
13. Rigging, Automation, and Motion Control (@uzume/kinesis)#
The most extensive subsystem library, covering rigging hardware, flying systems,
stage automation, robotics, kinetic elements, and animatronics.
13.1 Rigging Hardware#
| Capability |
Description |
| Chain hoist management |
Monitor and control chain hoists with load tracking and group operations |
| Counterweight fly system tracking |
Track counterweight fly systems with line set positions and loading |
| Motorized fly system control |
Control motorized fly systems with position, speed, and acceleration profiles |
| Rigging inspection documentation |
Document rigging inspections with checklists, photos, and certification records |
| Load monitoring dashboard |
Real-time dashboard showing loads across all rigging points |
| Structural load budget calculator |
Calculate structural load budgets against venue capacity with safety margins |
| Bridle calculator |
Calculate bridle leg lengths, angles, and loads for multi-point rigging |
| Safety PLC monitoring |
Interface with safety PLCs for emergency stop and overload monitoring |
13.2 Stage Automation#
| Capability |
Description |
| Automation cue programming |
Program multi-axis automation cues with position, speed, and acceleration curves |
| Automation rehearsal mode |
Safe rehearsal mode with reduced speed and enhanced monitoring |
| Turntable and revolve control |
Control turntables and revolving stages with position and speed profiles |
| Stage lift and trap control |
Control stage lifts, traps, and elevators with position and safety interlocks |
| Kabuki drop system management |
Control Kabuki curtain drop systems with cue triggering |
| Mechanical stage effects |
Control mechanical stage effects (fog reveals, trap doors, stage tilts) |
| Rain curtain and water effects |
Control rain curtain systems and water stage effects |
| Capability |
Description |
| Performer flying system control |
Control performer flying systems with 3D path programming |
| Performer flying safety |
Safety system with redundant sensors, load limits, and emergency descent |
| Track and trolley flying |
Control track-mounted flying systems for complex multi-axis performer movement |
13.4 Robotics#
| Capability |
Description |
| Industrial robot arm control |
Integrate and control industrial robot arms for scenic automation |
| Robot choreography timeline |
Timeline-based editor for programming robot movement sequences |
| Robot safety zone management |
Define and enforce safety zones around robotic equipment |
| Robotic camera system control |
Control robotic camera systems with preset positions and smooth movements |
| Robot show synchronization |
Synchronize robot movements with show timecode and cues |
13.5 Kinetic Elements#
| Capability |
Description |
| Kinetic winch system control |
Control kinetic winch systems for suspended scenic elements and lighting |
| Kinetic formation editor |
Design and program kinetic element formations and patterns |
| Kinetic anti-collision |
Anti-collision system preventing kinetic elements from intersecting paths |
| Kinetic load monitoring |
Monitor loads on kinetic elements in real-time |
| Kinetic content synchronization |
Synchronize video/LED content on kinetic elements with their physical position |
13.6 Animatronics#
| Capability |
Description |
| Animatronic figure control |
Control animatronic figures with multi-axis servo positioning |
| Animatronic choreography editor |
Timeline editor for programming animatronic movement sequences |
14. Lighting Design (@uzume/lumina)#
Fixture management, DMX/sACN control, cue programming, effects, and console
integration.
14.1 Fixture Management#
| Capability |
Description |
| Fixture patch engine |
Patch fixtures with DMX addresses, universes, and dimmer assignments |
| Fixture library manager |
Manage a library of fixture definitions with channel mappings and capabilities |
| GDTF parser |
Parse GDTF (General Device Type Format) fixture profiles for vendor-neutral fixture data |
| MVR exchange |
Import and export MVR (My Virtual Rig) files for lighting plot exchange between tools |
| Fixture parameter engine |
Control fixture parameters (intensity, color, gobo, pan, tilt, zoom, focus) |
| Console integration bridge |
Connect to lighting consoles (grandMA, ETC Eos, Chamsys) for bi-directional control |
14.2 Color Management#
| Capability |
Description |
| Color engine |
Mix and match colors across different color systems (RGB, CMY, HSB, CIE) |
| Gel library |
Searchable library of lighting gel colors with transmission spectra |
| Color picker engine |
Color picker with support for fixture-native color mixing |
| Color consistency engine |
Maintain color consistency across fixtures with different color engines |
| Subtractive mixing engine |
Simulate subtractive color mixing for gel and CMY fixtures |
14.3 Cue Programming and Playback#
| Capability |
Description |
| Tracking cue stack |
Tracking-style cue stacks where only changed values are stored in each cue |
| Fade engine |
Multi-part fade timing with independent intensity, color, and position fades |
| Cue trigger engine |
Trigger cues from timecode, MIDI, OSC, network events, and manual GO |
| Multi-cue list playback |
Run multiple independent cue lists simultaneously with master control |
| Cue macro engine |
Programmable macros that execute sequences of cue operations |
14.4 Effects and Content#
| Capability |
Description |
| Parametric effects engine |
Create parametric effects (chases, rainbows, waves, pulses) with rate and amplitude control |
| Pixel mapping engine |
Map video content onto LED fixture arrays with pixel-level control |
| Generative content engine |
Generate procedural visual content driven by audio, timecode, or parameters |
| Atmospheric effects engine |
Control atmospheric effects (haze, fog, low fog) integrated with lighting looks |
15. Special Effects (@uzume/pyra)#
Pyrotechnics, lasers, atmospheric effects, scent, water features, and
multi-sensory choreography.
15.1 Pyrotechnics#
| Capability |
Description |
| Pyrotechnic cue management |
Program and manage pyrotechnic firing cues with timing and safety interlocks |
| Firing system integration |
Integrate with electronic firing systems for remote pyrotechnic ignition |
| Flame effect control |
Control gas-based flame effects (flame bars, flame cannons, fireballs) with safety monitoring |
| NFPA 1126 compliance |
Generate NFPA 1126 compliance documentation for pyrotechnic operations |
| Pyrotechnic inventory and chain of custody |
Track pyrotechnic inventory with chain-of-custody documentation |
15.2 Laser and Light Effects#
| Capability |
Description |
| ILDA laser control |
Control show lasers via ILDA protocol with beam safety zones and audience scanning limits |
15.3 Atmospheric Effects#
| Capability |
Description |
| CO2 and cryogenic jets |
Control CO2 cryo jets with burst timing and pressure management |
| Fog and haze machines |
Manage fog and haze machines with density, timing, and zone control |
| Low fog systems |
Control low-lying fog systems (glycol/glycerin) for ground-hugging fog effects |
| Multi-effect machine control |
Unified control for multi-function atmospheric effect machines |
15.4 Scent Systems#
| Capability |
Description |
| Scent machine control |
Control scent diffusion machines with intensity and timing |
| Scent palette library |
Library of available scents with blending and layering options |
| Scent zone management |
Define and manage scent zones within the venue |
| Scent consumables and safety |
Track scent consumable inventory and manage allergy/safety documentation |
15.5 Water Features#
| Capability |
Description |
| Water screen projection |
Control water screen projection systems for mid-air image display |
| Fountain choreography |
Choreograph water fountain sequences synchronized to music and lighting |
| Water effect safety and environment |
Monitor water system safety, water quality, and environmental compliance |
15.6 Multi-Sensory Choreography#
| Capability |
Description |
| Multi-sensory effect choreography |
Choreograph and synchronize effects across light, sound, scent, water, and haptics in a unified timeline |
16. Power Distribution (@uzume/tesla)#
Electrical planning, power monitoring, and safety for production environments.
| Capability |
Description |
| Single-line diagram designer |
Design electrical single-line diagrams with standard symbols and annotations |
| Circuit loading calculator |
Calculate circuit loading with per-leg and per-phase amperage tracking |
| Generator sizing calculator |
Size generator requirements based on total production power demands |
| Circuit mapping documentation |
Document circuit maps linking panels, breakers, and end-use equipment |
| Dimmer rack management |
Manage dimmer racks with channel assignments, curve settings, and diagnostics |
| Power monitoring dashboard |
Real-time power consumption monitoring across all distribution points |
| Power quality monitoring |
Monitor power quality (voltage, THD, power factor) with alert thresholds |
| UPS and backup power |
Manage UPS systems and backup power with automatic failover tracking |
| Electrical safety management |
Track LOTO procedures, ground fault testing, and electrical safety compliance |
| Cable and connector management |
Track power cable inventory with length, gauge, connector type, and test records |
17. Network Infrastructure (@uzume/forge)#
Production network design, management, and monitoring.
| Capability |
Description |
| Network topology designer |
Design production network topologies with visual diagramming |
| VLAN template library |
Pre-configured VLAN templates for entertainment networks (lighting, audio, video, control, management) |
| Switch configuration management |
Manage network switch configurations with template deployment |
| IP address management |
Track IP address assignments across production networks |
| PTP grandmaster clock |
Manage PTP (Precision Time Protocol) grandmaster clocks for network synchronization |
| Bandwidth monitoring |
Monitor network bandwidth utilization across links and VLANs |
| Multicast traffic management |
Manage multicast groups and traffic for AV streaming protocols |
| Production Wi-Fi planning |
Plan production Wi-Fi networks with coverage mapping and interference analysis |
| Network security management |
Manage network security policies, access control, and intrusion detection |
| Cable and fiber documentation |
Document cable runs, fiber paths, and patch panel connections |
18. Crew Communication (@uzume/hermes)#
Production communication systems spanning intercom, messaging, video, and
translation.
| Capability |
Description |
| Production messaging system |
Departmental and show-wide messaging with priority levels and delivery confirmation |
| Intercom monitoring |
Monitor and manage production intercom system channels and stations |
| Video monitoring system |
Manage backstage video monitoring feeds and displays |
| God mic/paging integration |
Control venue paging and god mic systems for audience announcements |
| Production contacts database |
Centralized database of production contacts with roles and departments |
| Document management system |
Centralized document storage and distribution for production documents |
| Crew mobile app platform |
Mobile app platform for crew access to schedules, documents, and messaging |
| Digital call board integration |
Integration with digital call board for schedule and announcement display |
| Guest and visitor management |
Track guests and visitors with badge generation and access control |
| Real-time translation service |
Real-time translation for multi-language production crews |
19. Production Planning and Logistics (@uzume/atlas)#
Budgets, crew management, equipment tracking, touring, and sustainability.
19.1 Financial Management#
| Capability |
Description |
| Production budget engine |
Create and manage production budgets with department-level line items |
| Purchase order system |
Generate and track purchase orders with approval workflows |
| Financial settlement and reconciliation |
Settle and reconcile show finances with vendor invoices and actuals |
| Expense tracking and per diem |
Track crew expenses, per diems, and reimbursements |
| Financial reporting dashboard |
Financial analytics with variance analysis, burn rates, and projections |
19.2 Crew Management#
| Capability |
Description |
| Crew database and profiles |
Centralized crew database with skills, certifications, and availability |
| Crew scheduling |
Schedule crew across shows, rehearsals, and load-in/load-out |
| Call sheet generation |
Generate daily call sheets with call times, locations, and department details |
| Time tracking and payroll |
Track crew hours, overtime, and meal penalties for payroll processing |
| Skills and certification compliance |
Track crew certifications (rigger, electrician, pyrotechnician) and expiration dates |
19.3 Equipment Management#
| Capability |
Description |
| Equipment inventory |
Track equipment inventory with serial numbers, conditions, and locations |
| Equipment assignment |
Assign equipment to shows with check-out/check-in tracking |
| Maintenance scheduling |
Schedule preventive maintenance with service history tracking |
| Cross-rental and sub-rental |
Manage equipment cross-rentals and sub-rentals with vendor tracking |
| Equipment depreciation and lifecycle |
Track equipment depreciation, age, and replacement planning |
19.4 Touring and Logistics#
| Capability |
Description |
| Tour routing |
Plan tour routes with venue sequencing and travel optimization |
| Venue advance system |
Manage venue advance processes with technical requirements and contacts |
| Freight and shipping |
Manage freight logistics with truck routing, shipping manifests, and tracking |
| Accommodation and travel |
Manage crew hotel bookings, flight reservations, and ground transportation |
| Contract management |
Track contracts with venues, vendors, and crew including key dates and terms |
19.5 Sustainability#
| Capability |
Description |
| Carbon footprint calculator |
Calculate production carbon footprint from travel, power, and materials |
| Renewable energy monitoring |
Monitor renewable energy usage and integration at venues |
| Waste management tracking |
Track waste generation, recycling rates, and disposal across productions |
| Green rider policy management |
Manage sustainability policies and green rider requirements |
20. Scheduling and Calendars (@uzume/chronos)#
Production scheduling, timeline management, and resource optimization.
| Capability |
Description |
| Master production timeline |
Unified production timeline spanning pre-production through strike |
| Rehearsal scheduling |
Schedule rehearsals with room/space booking and participant management |
| Tech rehearsal templates |
Pre-configured scheduling templates for tech week sequences |
| Multi-venue production calendar |
Calendar view across multiple venues and simultaneous productions |
| Deadline tracking and notifications |
Track production deadlines with automated notifications and escalation |
| Tour routing optimization |
Optimize tour routing for travel distance, cost, and availability |
| Resource leveling |
Level crew and equipment resources across overlapping productions |
| Schedule disruption what-if |
Simulate schedule changes and assess impact before committing |
| Calendar synchronization |
Synchronize production calendars with external systems (Google, Outlook, iCal) |
| Automated schedule reporting |
Generate automated schedule reports and summaries |
21. Safety and Compliance (@uzume/aegis)#
The most safety-critical subsystem, covering risk assessment, regulatory
compliance, weather monitoring, crowd safety, training, and incident management.
21.1 Risk Assessment#
| Capability |
Description |
| Risk assessment engine |
Structured risk assessments with hazard identification, likelihood, severity, and mitigation |
| Root cause analysis framework |
Framework for post-incident root cause analysis with corrective actions |
| Safety audit trail |
Complete audit trail of safety inspections, decisions, and sign-offs |
21.2 Regulatory Compliance#
| Capability |
Description |
| OSHA compliance |
Track OSHA compliance requirements with checklist-based verification |
| NFPA compliance |
Track NFPA fire safety compliance for venues and productions |
| ANSI/ESTA compliance |
Track ANSI/ESTA entertainment technology safety standards |
| European safety standards |
Module for European safety regulations (EN standards, CE marking) |
| Jurisdiction-specific compliance |
Configure compliance requirements based on local jurisdiction regulations |
21.3 Weather Safety#
| Capability |
Description |
| Weather monitoring integration |
Real-time weather monitoring with alert thresholds for outdoor events |
| Wind speed monitoring interlock |
Automated safety interlocks triggered by wind speed thresholds |
| Weather-triggered show modifications |
Pre-defined show modifications (scenic removal, effect cancellation) triggered by weather conditions |
| Weather history and analytics |
Historical weather data logging for venue-specific planning |
21.4 Crowd Safety#
| Capability |
Description |
| Crowd safety modeling |
Model crowd behavior and identify crush risk areas in venue layouts |
| Crowd density monitoring |
Real-time crowd density monitoring with threshold alerts |
| Crowd barrier layout designer |
Design crowd barrier layouts with entry/exit flow optimization |
| Barrier hardware inventory |
Track crowd barrier hardware inventory and deployment |
| Crowd management staffing calculator |
Calculate crowd management staffing requirements based on capacity and risk |
| Emergency evacuation simulation |
Simulate evacuation scenarios with timed egress modeling |
| Front-of-house pit design |
Design front-of-house barrier configurations and pit layouts |
| Heat stress monitoring |
Monitor environmental heat stress conditions for outdoor events |
21.5 Inspection and Documentation#
| Capability |
Description |
| Safety inspection system |
Structured safety inspections with checklists, findings, and remediation tracking |
| Equipment inspection scheduling |
Schedule and track equipment safety inspections with due-date alerting |
| Safety documentation management |
Centralized safety document storage (risk assessments, method statements, permits) |
21.6 Training and Onboarding#
| Capability |
Description |
| Safety briefing management |
Manage safety briefings with attendance tracking and acknowledgment |
| Safety procedure training |
Track safety procedure training completion with assessment scores |
| Equipment operation training |
Equipment-specific training modules with competency verification |
| Show-specific crew onboarding |
Onboarding workflow for show-specific safety requirements |
| VR rigging training simulator |
Virtual reality rigging training simulator for safe skill development |
21.7 Incident Management#
| Capability |
Description |
| Structured incident reporting |
Structured incident report forms with severity classification and witness statements |
| Anonymous near-miss reporting |
Anonymous reporting system for near-miss events to encourage safety culture |
22. AI Assistance (@uzume/muse)#
AI-powered show intelligence, generative content, predictive operations, and
natural language control.
22.1 Music and Show Analysis#
| Capability |
Description |
| Musical analysis |
Analyze music tracks for key, tempo, beats, sections, and energy for cue placement |
| BPM synchronization |
Synchronize lighting and effects to music BPM in real-time |
| Show energy arc analyzer |
Analyze and visualize the energy arc of a show for pacing and impact optimization |
| Lyric-to-visual suggestion |
Analyze lyrics for imagery, emotion, and narrative and suggest visual treatments |
22.2 AI-Powered Automation#
| Capability |
Description |
| AI-powered cue placement |
Automatically suggest cue placements based on music analysis and show structure |
| AI effect choreography |
Generate effect choreography suggestions synchronized to music and narrative |
| Voice-activated show control |
Voice command interface for hands-free show control operation |
| Natural language show programming |
Program show elements using natural language descriptions instead of manual parameter entry |
22.3 Generative Content#
| Capability |
Description |
| AI generative visual content |
Generate real-time visual content using AI (backgrounds, patterns, environments) |
| AI color palette generator |
Generate color palettes from themes, moods, images, or brand guidelines |
22.4 Predictive Operations#
| Capability |
Description |
| AI anomaly detection |
Detect unusual patterns in show systems that may indicate equipment issues |
| Predictive maintenance |
Predict equipment failures using ML models on operational telemetry |
| ML-driven budget forecasting |
Forecast production budgets using ML models trained on historical data |
| AI crew scheduling optimization |
Optimize crew scheduling using AI to minimize costs and maximize coverage |
22.5 Documentation#
| Capability |
Description |
| AI automated documentation |
Automatically generate production documentation from show data |
23. Cross-Cutting Capabilities#
| Capability |
Description |
| Library metadata exports |
Every subsystem library exports a typed metadata object (ID, subsystem name, description) |
| Runtime discovery |
Applications can discover available subsystems at runtime via metadata exports |
23.2 Engine Architecture#
| Capability |
Description |
| Self-contained engines |
Each capability is packaged as an independent engine with its own types, configuration, and factory functions |
| Composable subsystems |
Engines within a subsystem can be used independently or composed together |
| Event-driven integration |
Subsystems communicate through the NATS event bus without tight coupling |
23.3 Polyglot Execution#
| Capability |
Description |
| TypeScript subsystem libraries |
22 TypeScript libraries for business logic, UI integration, and orchestration |
| Rust protocol engines |
Performance-critical AV protocols implemented in Rust for native speed |
| WASM browser support |
Rust protocols compiled to WebAssembly for browser-based control surfaces |
| Node.js native bridge |
napi-rs bridge for zero-overhead Rust-to-Node.js communication |
23.4 Observability#
| Capability |
Description |
| Structured logging |
All subsystems produce structured log output via the core logging module |
| Event audit trail |
The NATS event bus provides a complete audit trail of all subsystem interactions |
| Coverage reporting |
Test coverage across all 370+ TypeScript test files with lcov output for CI integration |
Capability Summary by Library#
| Library |
Engine Count |
Key Capability Areas |
@uzume/core |
6 modules |
Config, database, errors, event bus, logging, utilities |
@uzume/nexus |
-- |
Show control protocol bridging |
uzume-protocol-engines |
6 Rust crates |
SMPTE timing, network I/O, WASM control surfaces, Node.js bridge |
@uzume/broadcast |
10 |
Switcher, multiviewer, replay, graphics, streaming, SRT, simulcast, ISO recording |
@uzume/prism |
15 |
Media servers (Disguise, Resolume, TouchDesigner, Notch), LED, projection, IMAG, routing |
@uzume/aurora |
25 |
XR stages, drones, digital twins, RTLS, mocap, wearables, holographic, VFX |
@uzume/previz |
15 |
3D venue rendering, VR walkthrough, collaborative previz, timeline scrubbing |
@uzume/sonos |
25 |
Dante, AES67, line arrays, spatial audio, RF coordination, orchestral, QLab |
@uzume/echo |
20 |
Polling, wristbands, AR, accessibility, assistive listening, audio description, haptics |
@uzume/koru |
15 |
Cue sheets, show calling, blocking, rehearsal notes, reports, understudy tracking |
@uzume/scena |
10 |
CAD import, construction docs, props, paint, materials, truck pack |
@uzume/vestis |
10 |
Costume plots, fittings, quick-change, RFID, LED costumes, wigs, makeup |
@uzume/kinesis |
30 |
Hoists, flying, turntables, lifts, robots, kinetic elements, animatronics, safety |
@uzume/lumina |
20 |
GDTF, MVR, DMX/sACN, tracking cues, fades, pixel mapping, effects, console bridge |
@uzume/pyra |
18 |
Pyrotechnics, lasers, fog, CO2, scent, water screens, fountains, multi-sensory |
@uzume/tesla |
10 |
Single-line diagrams, load calc, generators, dimmer racks, power monitoring, UPS |
@uzume/forge |
10 |
Topology, VLANs, PTP, bandwidth, Wi-Fi, multicast, security, fiber documentation |
@uzume/hermes |
10 |
Messaging, intercom, video monitoring, paging, contacts, translation |
@uzume/atlas |
24 |
Budgets, purchase orders, crew, equipment, touring, freight, sustainability |
@uzume/chronos |
10 |
Timelines, rehearsals, tech schedules, resource leveling, disruption simulation |
@uzume/aegis |
30 |
Risk, OSHA/NFPA/ANSI, weather, crowd safety, inspections, training, incidents |
@uzume/muse |
15 |
Musical analysis, AI cues, generative content, voice control, predictive ops |