Configuration UI
The Configuration UI is the admin workspace for the controller. Use it to configure networking, hardware, behavior, lighting, integrations, maintenance tools, and the Prop Wizard.
Open configuration
- Open the controller in a browser.
- From the Operator page, choose Open Configuration near the bottom of the page.
- If prompted, enter the admin or SimpleUI (if configured) password.
- Use the top tabs to move between Connections, Definitions, Behavior, and Lighting.
- Most sections will automatically save, any that don’t will have a glowing green button and warn when navigating away that there are unsaved changes that need to be applied.
Page map
| UI area | Sections you use there | Main job |
|---|---|---|
| Connections | Connection & Identity, Simple UI Setup, Inputs, Outputs, and Modules, Integrations | Device identity, network access, external system connections, and physical I/O |
| Defintions | States, Variables, Level Inputs, RFID Tag Sets, Default Debounce, Gestures, Audio Files | Items and settings that will be used by actions and behaviors |
| Behavior | Logic Rules, Action Triggers, Operator Controls, Live Monitor, Input Sequences, Output Sequences, Collections | Puzzle logic and runtime behavior |
| Lighting | Pixel setup, groups, palettes, effects, sequences, DMX | Addressable LED and DMX configuration |
| System Setup | Backup, restore, firmware update, reset, Prop Wizard | Maintenance and recovery |
| Board Pinout | Print, Board Pinout, Wiring Diagram | Lsit and diagram of all configured physical modules |
Recommended build order
- Configure Connection & Identity.
- Add physical inputs, outputs, and modules.
- Apply I/O changes and allow the controller to reboot.
- Verify the Board Pinout and make your physical connections.
- Create all of your Definitions (states, variables, etc).
- Add input definitions such as Level Inputs, RFID Tag Sets, and Audio Files.
- Build actions, rules, sequences, collections, and operator controls.
- Configure lighting and DMX targets.
- Add Simple UI only for safe user-facing edits.
- Download a config backup.
Save and apply controls
| Control | What it affects | When to use it |
|---|---|---|
| Save & Connect | Network identity and connection settings | After changing device name, Wi-Fi, Ethernet, MQTT, or admin access |
| Apply I/O Changes (Reboot) | Inputs, outputs, buses, modules, and pin assignments | After adding or changing physical hardware |
| Save Pixel Layout | Addressable pixels | Whenever editing the layout, elements nad groups |
The network and I/O save functions will automatically reboot the controller and refresh the page.
Board Pinout
Use Board Pinout after any I/O edit. It helps verify that each assigned pin, bus, chip select, relay, pixel output, servo, or module matches the actual wiring.
Check Board Pinout before final install because behavior rules can look correct while the physical pin assignment is still wrong.
Live Monitor
Use Live Monitor while physically interacting with the prop. It is the fastest way to answer whether the controller sees an input, output, RFID reader, sequence event, analog value, or runtime event.
If the monitor does not see the event, fix wiring or I/O configuration before editing behavior.
Identify
Use Identify when multiple controllers are online. It flashes the controller status indicator so you can confirm which physical controller you are editing before saving, rebooting, or updating.