Skip to main content

Front Button

Every IgorBox controller has a single multi-function button on the front panel. What it does on a short press depends on the front button mode you've set in IgorBox Studio.

There are four modes:

ModeWhat a press doesWhen to use it
Stop (default)Stops the currently playing show on this controller and returns to the ambient routine.Most installs — gives you an emergency "kill" button.
TriggerMakes the button act as an input you can wire to a show (or any rule) in Logic Rules.Demo modes, walk-around testing, manually re-triggering a haunt scene.
Safety LockToggles a lock that stops the show currently playing on this controller and prevents anyone from triggering new ones.Maintenance windows, daytime in a haunt, walk-throughs.
Hard LockHard-stops everything and locks the controller. Nothing plays until the controller is rebooted (power-cycled).Repairs, electrical work, construction.

You can change the mode any time from the controller's Configuration tab in Studio.

tip

Stop only stops playback on the controller you press the button on. If your show spans multiple controllers, set up a Logic Rule so a single button press can stop them together.

Holding the button (always available)

The reset behaviors are independent of the mode setting and only apply at power-on. As you hold the button, the status light flashes to confirm each step you pass, so you know you've reached the right point before you release.

  • Hold for ~7 seconds at power-on, then release — The controller clears its WiFi credentials and reboots. It stays connected to your account and remembers everything else.
  • Hold for ~20+ seconds at power-on, then release — The controller wipes its local show, media, and config files, then reboots locked. It stays registered in your Studio — Magic Provisioning re-pairs it automatically. The setup ID is unchanged either way (it's tied to the hardware). Show data and configuration in Studio are preserved.

If you release before the ~7-second mark, the controller starts up normally with no changes. See Status LED for the flash-count confirmation, and Boot Sequence for the full at-power-on behavior.

Wiring the button into your show

Even though it's a physical button on the front panel, the front button shows up in IgorBox Studio as an input — same as any wired input. That means you can wire it into Logic Rules.

important

The front button is only a Logic Rules input when its mode is set to Trigger. In any other mode, it's filtered out of the input picker so you can't accidentally bind a show to a button that does something else.

Documentation under /docs is licensed CC BY 4.0. Code samples are MIT. IgorBox™ trademarks and products are excluded — details.