Node Editor

The Node Editor is where you create effects using visual programming. Connect nodes to build anything from simple color washes to complex generative patterns.

Interface

Canvas

The main area where nodes live. You can:

• Pan by scrolling (scroll wheel or trackpad)
• Zoom with pinch gesture or Cmd + scroll
• Select nodes by clicking them
• Drag on the background to create a selection box

Effect Selector

The toolbar includes an effect selector dropdown that lets you switch between effects, create new effects, or import effects from the library. Open it by clicking the dropdown or pressing Cmd + P.

Toolbar

• Clean Up - Auto-arrange node layout
• Copy - Duplicate the current effect
• Rename - Rename the current effect
• Delete - Delete the current effect (disabled if in use)
• Export - Export the effect to a file
• Category - Set the effect category

Node Browser

Access by pressing Shift + A or right-clicking the canvas.

Working with Nodes

Adding Nodes

1. Right-click on the canvas
2. Browse categories or search
3. Click a node to add it
4. The node appears at your cursor position

Selecting Nodes

• Click a node to select it
• Shift + Click to add to selection
• Drag a box to select multiple
• Cmd + A to select all

Moving Nodes

Drag selected nodes to move them.

Deleting Nodes

Select nodes and press Delete or Backspace.

Connections

Making Connections

1. Click an output port (right side of node)
2. Drag to an input port (left side of another node)
3. Release to connect

Or drag from input to output—direction doesn't matter.

Connection Types

Connections are color-coded by data type:

• Gray - Number
• Purple - Vector
• Blue - Color
• Green - Boolean

Breaking Connections

• Click a connection and press Delete
• Drag from a connected input to disconnect
• Right-click a connection and select Delete

Connection Validation

You can only connect compatible types. Invalid connections show a warning.

Node Types

Input Nodes

Provide values to your effect:

• Number - Constant numeric value
• Color - Constant color
• Time - Animated time value
• Fixture Index - Per-fixture index
• Pixel Position - Position map coordinates

Processing Nodes

Transform values:

• Math - Arithmetic operations
• Color - Color manipulation
• Wave - Oscillators and generators
• Comparison - Logic operations

Output Nodes

Send data to fixtures:

• Output - Sets the final color output for the effect

Parameters

When a node is selected, its parameters appear in the Parameters panel:

• Adjust values with sliders or number inputs
• Some parameters can be connected to other nodes
• Default values are used when no connection exists

Keyboard Shortcuts

Tips

Organization

• Use comments to document complex sections
• Align nodes for readability
• Group related nodes together

Performance

• Fewer nodes = faster effects
• Avoid redundant calculations
• Use the simplest node that works

Debugging

• Check connection types
• Verify parameter values
• Use preview to see intermediate values

Related Pages

• Node Categories - All available nodes
• Connecting Nodes - Detailed connection guide
• Data Types - Understanding data types