# 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

```bash
# 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.