Home

Lights Pi Documentation

Welcome 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+, plus a natural-language control layer for voice and chat-driven scene generation.

What is Lights Pi?

Lights Pi turns a Raspberry Pi into a dedicated DMX lighting controller that anyone on your studio network can operate from a browser, phone, or voice command. No physical access to the Pi needed.

Key capabilities:

• Control DMX fixtures through QLC+'s web interface
• Generate lighting scenes with natural language ("make it warm and dim")
• Manage fixtures and groups through a custom control server
• Provision and manage your Pi remotely with lightsctl.sh

How It Works

1. A Raspberry Pi runs QLC+ headless, connected to your fixtures via an ENTTEC DMX USB Pro
2. The QLC+ web UI (port 9999) provides full fixture control from any browser
3. A custom Flask control server (port 5000) adds AI-powered scene generation
4. The lightsctl.sh CLI handles provisioning, deployment, and diagnostics from your workstation

Getting Started

New to Lights Pi? Start here:

1. System-Requirements — Check what hardware you need
2. Quick-Start — Get up and running in 15 minutes
3. Hardware-Setup — Connect your DMX fixtures
4. Configuration — Customize your setup

Documentation Sections

Getting Started

Guides for first-time setup, from SD card preparation through your first scene.

Usage

Day-to-day commands and troubleshooting for operating your Lights Pi.

Advanced

Hardware deep-dives, multi-universe setups, and configuration reference.

Contributing to Docs

These docs are sourced from the GitHub Wiki. To contribute:

1. Click "Edit on GitHub" on any page
2. Make your changes in the wiki editor
3. Changes appear on the site within an hour (no deploy needed)

Need Help?

• Report an issue
• Join the community
• View source on GitHub