MIDI Map Editor Panel

The MIDI Map Editor lets you create mappings between MIDI controllers and Spectralite parameters. The panel has a sidebar on the left showing the last received MIDI message and your mapping list, and a main area on the right for editing the selected mapping's assignments.

Interface

The left sidebar contains two sections:

Last MIDI Message - Displays the most recently received MIDI message with details:

Device - Which MIDI device sent the message
Type - Control Change, Note On, or Note Off
Channel - MIDI channel number
Controller/Note - CC number or note number
Value - The received value

Mappings - Lists all your MIDI mappings. Select a mapping to edit its assignments in the main area. The toolbar provides:

Import mapping - Import a mapping from the Library Manager
Add mapping - Create a new named mapping

Assignment Table

The main area shows all assignments for the selected mapping in a sortable table:

Direction - Input or Output
Assignment - The action or output type
Target - What the assignment controls
MIDI Type - Control Change, Note On, or Note Off
Channel - MIDI channel
Controller - CC or note number

The toolbar provides:

Export Mapping - Save the mapping to a file
Add assignment - Create a new input or output assignment

Creating Assignments

Adding an Assignment

Select a mapping in the sidebar
Click Add assignment in the toolbar
Choose Input (MIDI controls Spectralite) or Output (Spectralite sends MIDI)
Configure the assignment type and MIDI settings
Click Submit

Applying MIDI Data

When creating or editing an assignment, the dialog shows the last received MIDI message. Click Apply to fill in the MIDI type, channel, and controller from the last received message, instead of entering them manually.

Manual Entry

For precise control:

Click Add assignment
Enter MIDI details:
- Type - Control Change, Note On, or Note Off
- Channel - MIDI channel number
- Controller - CC number or note number
Configure the action type and target
Click Submit

Input Assignment Types

Input assignments let MIDI messages control Spectralite:

Layer Controls

Layer opacity (specific layers) - Set opacity of selected layers (range 0-127)
Layer opacity (by position) - Set opacity of layers at specific timeline indexes
Layer solo (specific/by position) - Toggle solo on layers
Layer opacity override (specific/by position) - Toggle opacity override on layers
Layer toggle opacity (specific/by position) - Toggle layer opacity between 0 and 1

Timing Controls

BPM - Set the BPM (maps 0-127 to a configurable min/max range)
Tap Tempo - Tap repeatedly to set BPM from timing
Double BPM / Halve BPM - Multiply or divide current BPM
Adjust BPM - Increment or decrement BPM by a delta value
Time offset - Set the timeline time offset
Adjust time offset - Increment or decrement offset
Cue / Align Beat - Align current moment to beat 1

Color Controls

Set primary/secondary/tertiary color hue - Set a color hue from MIDI value
Adjust primary/secondary/tertiary color hue - Rotate hue by a delta
Set color from active library - Select a color from the active library items
Set color from library - Select a color from the full color library

Parameter Controls

Set parameter value - Set a fixture parameter value (maps 0-127 to 0-255)
Adjust parameter value - Increment or decrement a parameter by a delta

Output Assignment Types

Output assignments send MIDI messages from Spectralite to your controller:

Layer Assignment (by index/by layer) - Send a value when a layer matches a condition
Layer Opacity (by layer/by index) - Send layer opacity as a MIDI value
Parameter Value - Send a fixture parameter value as MIDI
Parameter Condition - Send a value when a parameter meets a condition (on/off)
Static Value - Always send a fixed MIDI value