Documentation
How it works,from cable to cue.
Setup guides, hardware reference, AI scene generation, MCP server, and operations. Sourced from the project wiki so it stays in sync with the code.
14 pagesView on Wiki
01 / 03
Getting Started
- HomeWelcome to the Lights Pi documentation. Lights Pi is a headless Raspberry Pi lighting controller for studio environments — providing network-based control of DMX lighting fixtures through QLC+, plu...
- Quick StartGet your Lights Pi up and running in minutes.
- System RequirementsEverything you need to run Lights Pi.
02 / 03
Usage
- Command ReferenceComplete reference for all lightsctl.sh commands.
- AI Scene GenerationLights Pi includes an AI-powered scene generation system that translates natural language descriptions into proper DMX values for your specific fixture rig.
- Control ServerThe custom control server runs on the Pi at port 5000 and provides a richer interface on top of QLC+'s native web UI.
- Mobile and PWAThe control server UI is mobile-first and installable as a Progressive Web App on iOS and Android. Once installed, it runs chromeless — no browser address bar, app-switcher icon, splash screen.
- MCP ServerThe MCP server runs on the Pi at port 5001 and exposes the lighting rig as a Model Context Protocol endpoint. Any MCP-capable LLM client — Claude Desktop, ChatGPT, Cursor, custom agent — can discov...
- TroubleshootingCommon issues and how to fix them.
03 / 03
Advanced
- Hardware SetupGuide to setting up the physical hardware for your Lights Pi system.
- ConfigurationAll Lights Pi configuration is managed through environment variables in the .env file.
- CustomizationLights Pi is designed as a generic platform. Each deployment can be branded for
- TailscaleAccess your Lights Pi from anywhere using Tailscale, a
- ArchitectureTechnical overview of how Lights Pi components fit together.
Elsewhere