Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
qlcplus
QLC+ show files, fixture definitions, and generators for the XCHC stage (8× beamZ BCC145 parcans + 2× Small Eye 7 movers).
Layout
fixtures/ Fixture definitions (.qxf) — install into QLC+ if needed
shows/ Workspaces to open in QLC+
xchc.qxw Main show (patterns + movers, unified VC)
simple.qxw Manual board: M1/M2 pads, shared + individual RGBW
small_eye.qxw Movers-only figure-of-8 show
archive/ Older scratch workspaces
scripts/ Launchers (pattern_studio.sh, flash_luxdmx_xiao.sh)
pad/ SMC-PAD tools: lamps, MIDI patching, capture decoding
shows/ Generators / patchers for the shows and Chataigne
anim/ showfile animations to preview over Art-Net
stage/ Stage map (SVG, JSON, canvas)
tests/ Art-Net / fixture helpers used by scripts
Open in QLC+
- Full show:
shows/xchc.qxw - Simple RGBW + positions:
shows/simple.qxw
Scripts
# Rebuild simple manual board
python3 scripts/shows/make_simple_vc.py
# Rewrite can/mover patterns from stage layout
python3 scripts/shows/integrate_u_patterns.py
# Unify Patterns + Movers into one Show frame
python3 scripts/shows/unify_vc.py
# Figure-of-8 (live Art-Net or write/merge workspace)
python3 scripts/shows/figure8_small_eye.py --write-qxw shows/small_eye.qxw
Fixtures / DMX
| Fixture | Mode | Addresses |
|---|---|---|
| Small Eye 7 #1–#2 | 43ch | 1–43, 45–87 |
| BCC145 #1–#8 | 8ch | 87–150 (starts 87, 95, …) |
Copy .qxf files from fixtures/ into QLC+’s fixture library if the
manufacturer/model is missing.
SMC-PAD pad controller
padcontroller.midi reads the SMC-PAD, smooths its knobs, applies the Play
layer, and sends the result on a virtual MIDI port named padcontroller for
QLC+. Run it by hand with .venv/bin/python -m padcontroller.midi, or install
it as a systemd user service that starts at login and waits for the pad:
padcontroller/systemd/install.sh
Options after the command go to the pad controller (for example --lock-knobs).
--no-enable installs it without starting it at login (start it with
systemctl --user start padcontroller). --uninstall removes the service. Logs: journalctl --user -u padcontroller -f.
Stage simulator
python -m simulator listens for Art-Net on port 6454 and draws the rig at
http://127.0.0.1:8765. The Stage drop-down on the page switches between the
stage maps in stage/. No QLC+ show is needed: stage/map.json holds every
address. --show <file.qxw> only fills in addresses a stage map leaves out and
shows where that workspace sends Art-Net. It can run as a systemd user service
the same way:
simulator/systemd/install.sh
Options after the command go to the simulator (for example --show shows/test.qxw).
--no-enable installs it without starting it at login (start it with
systemctl --user start simulator). --uninstall removes the service.
Logs: journalctl --user -u simulator -f.
Chataigne
scripts/shows/make_chataigne.py turns a show spec into a Chataigne project, so the
SMC-PAD can drive the same colour pads and sliders without QLC+.
python3 scripts/shows/make_chataigne.py shows/test.show.json chataigne/test
Open chataigne/test/test.noisette. The Pad (MIDI) module reads the SMC-PAD
directly (--pad picks the port: USB SINCO SMC-PAD-Master by default, or
SMC-PAD Bluetooth). The script does the Play-layer shift that padcontroller/layer.py does for
QLC+, with no knob smoothing, so the pad controller is not needed. Set the lamps with
scripts/pad/pad_lamps.py. The Lights (DMX) module sends Art-Net to the
node in the spec. The Preview module sends a copy to 127.0.0.1 for the simulator (--preview '' leaves it out). If it comes up on the wrong output, set DMX Type to Art-Net,
the remote host, and an output universe of net 0, subnet 0, universe 0.
The project also has a dashboard with the same buttons and sliders as the
virtual console, coloured like it. Chataigne serves it on port 9999 for a
phone or browser. Pads, knobs and dashboard stay in step.
Edit chataigne/show.template.js for behaviour; the generated test.js is
overwritten.