Eve library

Uzume Domain -- Product Capabilities

Guide

Revision 1

On this page

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

3.2 Platform Bridges#

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.

5.1 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

10.2 Rehearsal and Performance#

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

13.3 Performer Flying#

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#

23.1 Library Metadata and Discovery#

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