Files
qlcplus/README.md
T

4.1 KiB
Raw Blame History

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.