Skip to main content
Documentation
Inputs

DMX Input

Receive Art-Net or sACN and bind incoming values to actions.

DMX Input

Open from Edit > Inputs > DMX (Art-Net / sACN). The dialog is non-modal, so it stays open while you keep working in the application. The left pane lists your configured DMX input sources (ArtNet or sACN receivers). The right pane is the mapping editor for assigning incoming DMX values to Spectralite actions.

Sources pane

The left pane lists every ArtNet or sACN receiver you have configured. Each row shows the source name, its protocol, universe, the network interface it listens on, live status, and a dropdown for assigning a mapping.

Adding a source

  1. Click the + button in the Sources header
  2. Enter a name, pick ArtNet or sACN, set the universe, and choose the network interface
  3. Click Add Source

Editing or deleting a source

  • Click a source row to edit it. The same dialog opens pre-populated with the source settings.
  • Use the delete action on the row to remove a source. Deletion requires confirmation.

Assigning a mapping

Each source row has a mapping dropdown. Pick one of the mappings defined in the Mapping pane, or choose no mapping to stop routing incoming DMX to any action. Only existing mappings appear in the dropdown.

Status

The row shows whether the source is receiving data. If a source you expect to be active shows no activity, check the universe number, the network interface, and whether another process on the machine has already bound the port.

Mapping pane

The right pane holds the network input mapping editor. Its sidebar lists your defined mappings; the main area shows the assignments for the selected mapping.

Mappings sidebar

The sidebar lists every DMX input mapping. Select one to edit its assignments. Use the toolbar to add a new named mapping or import one from a file.

Assignment table

Each assignment binds incoming DMX data to a Spectralite action. The table has three columns:

  • Action - The action type (layer opacity, BPM, parameter value, and so on)
  • Target - What the action controls (a specific layer, parameter, or group)
  • DMX - The channel (within the mapping's source universe) and binding behavior, such as value range or threshold

Adding an assignment

  1. Select a mapping in the sidebar
  2. Click Add action in the toolbar
  3. Enter the DMX channel
  4. Choose the action type and target
  5. Configure the value range or threshold
  6. Click Submit

Assignment types

DMX input assignments share the action catalog with MIDI input. Layer opacity, layer solo, BPM controls, color hue, parameter value, and parameter toggles all map from an incoming DMX value (0-255) to their Spectralite action. See the MIDI Input Dialog for the full list of input assignment types.

Saving and loading

DMX input sources and mappings are stored inside the project file.

  • Save: Project > Save project
  • Load: Project > Load project
  • Export / Import: Use the mapping toolbar to export a mapping to a file or import one from the Library Manager.

Troubleshooting

Source shows no activity

  • Verify the universe number matches what the upstream sender is transmitting
  • Check the network interface selection; wrong interface is the most common cause
  • For sACN, confirm multicast is permitted on the network
  • For ArtNet, confirm no firewall is blocking UDP port 6454

Incoming value triggers the wrong action

  • Check the channel number on the assignment against the sender
  • Check for overlapping assignments on the same channel

MIDI Input

Manage MIDI devices and map controls to Spectralite actions.

NDI Input

Enable NDI video input and use it in effects

On this page

DMX InputSources paneAdding a sourceEditing or deleting a sourceAssigning a mappingStatusMapping paneMappings sidebarAssignment tableAdding an assignmentAssignment typesSaving and loadingTroubleshootingRelated