Luma Documentation
Documentation for Luma, a semantic lighting control application that makes light shows portable between venues.
Welcome to Luma
Luma is a desktop application for semantic lighting control. Instead of recording hardware-specific DMX instructions, Luma records your artistic intent -- creating a universal language for light shows that works on any venue.
Think of it like the difference between sheet music and an audio recording. Sheet music says "play a C major chord" and it works on piano, guitar, synthesizer, anything. A recording is locked to the specific instrument that played it. Luma is sheet music for lighting. Your creative work travels with you. The venue provides the instruments.
How It Works
Luma separates what you want (your creative intent) from how to do it (venue-specific hardware):
-
Your Library -- Your creative identity. Tracks, patterns, annotations. Completely hardware-agnostic. Syncs through the cloud.
-
Venues -- How your library gets translated into a specific room's equipment. A venue knows what lights are in the room, where they are, and what they can do.
Getting Started
Why Luma
The problem Luma solves and the philosophy behind it
Define Your Venue
Patch fixtures and set up your physical space
Groups and Tags
The system that makes shows portable
Build Patterns
Create reusable light behaviors with node graphs
Explore the Docs
User Guide
Follow the step-by-step workflow from venue setup to live performance. Start with Why Luma for the philosophy, then work through each step.
Node Reference
Complete documentation for every node type in the pattern graph editor. Organized by category: input, audio, analysis, selection, color, signal, position, and output. Plus common recipes for typical effects.
Architecture
Deep dives into Luma's internals for developers: the signal system, node graph engine, compositor, DMX pipeline, and more.
Glossary
A complete terminology reference covering every key concept in Luma.