Organize the lighting project and ship the combined XCHC show.

Group workspaces, generators, stage map, and tests into clear folders, and add the unified cans+movers show plus a simple shared/individual RGBW control board.

Co-authored-by: Cursor <cursoragent@cursor.com>

README.md

@@ -1,2 +1,49 @@
 # 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.