Files
qlcplus/README.md
T
2026-10-22 11:44:19 +13:00

2.5 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/      Generators / patchers for the shows
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/make_simple_vc.py

# Rewrite can/mover patterns from stage layout
python3 scripts/integrate_u_patterns.py

# Unify Patterns + Movers into one Show frame
python3 scripts/unify_vc.py

# Figure-of-8 (live Art-Net or write/merge workspace)
python3 scripts/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.

Chataigne

scripts/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/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 pad_layer.py does for QLC+, with no knob smoothing, so smooth_smc_pad.py is not needed. Set the lamps with scripts/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.