This app is your xLights show technical reference — a fast lookup tool for channel numbers, controller ports, wire assignments, and physical locations. Your data is private to your account; each user sees only their own imported show data and wiring notes.

Click ↑ Import XML in the header. You'll need two files from your xLights show folder:

• → xlights_networks.xml — controller definitions (IPs, protocols, channel counts)
• → xlights_rgbeffects.xml — model layout (props, nodes, ports, groups)

You can upload either file independently to refresh just that section. Wiring notes are always preserved across re-imports.

Every prop/model in your show. Columns:

• → Start / End Ch — absolute universe channel, or controller-relative channel if model uses relative addressing
• → Nodes — pixel count for the model
• → Controller / Port / Protocol — which output port and pixel protocol (ws2811, etc.)
• → Wiring — green badge means wiring info recorded; grey means not yet documented

Click any row to expand sub-models, aliases, groups, and wiring detail. Click any column header to sort. Use the search box to filter by name, channel, controller, group, type, or wiring info. Use the controller filter buttons to narrow to a single controller.

One card per controller. Shows IP address (clickable link to the controller web UI), protocol, max channels, and a port-by-port list of every model assigned to it. Wiring summary is shown inline per port. Click any port row to open the wiring modal for that model.

All xLights model groups imported from your rgbeffects file. Each card shows group name, member count, aliases, and the list of models in that group.

Click any model row → Add / Edit Wiring Info, or click the wiring badge, or click a port row in the Controllers tab. Fields:

• → Wire Color — wire color and gauge (e.g. Red 18AWG)
• → Connector Type — connector style at the prop end (e.g. 3-pin JST, waterproof)
• → Physical Location — where in the yard/house this prop lives
• → Wire Route / Run — how the cable runs from controller to prop
• → Power Injection — PSU details and injection points
• → Long Range Receiver — unit number and port number if signal travels through an LR receiver board
• → Repeater — unit number and port number if signal passes through a repeater board
• → Notes — troubleshooting tips, known issues, anything else

Click ⇪ Bulk Fill to record LR boards fast. Type one line per LR port — unit, port, prop name (e.g. 2-3 Mega Tree). Each prop gets its LR unit/port set and the LR board channel label filled in. For more fields (wire color, location, notes…) download the CSV template, fill it in, and upload it.

Admins see a 👥 Users button in the header. From there you can add new users (assign User or Admin role), remove users, and manage accounts. Each user has their own independent show data — importing XML or saving wiring notes never affects another user's data.

• → Know the channel number? → Models tab, sort by Start Channel
• → Prop not lighting up? → Controllers tab → find the port → check wiring notes
• → Wrong colors? → Check Protocol column — confirm ws2811 vs ws2812 etc.
• → Signal dying mid-run? → Check Long Range Receiver and Repeater fields in wiring notes
• → Need to find a group of props? → Groups tab, or search the model name in Models tab
• → Re-imported XML and lost data? → You won't — wiring notes are always preserved on import