# 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 ```bash # 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: ```bash 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. It can run as a systemd user service the same way: ```bash 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+. ```bash 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.