n8n Nodes for ETC Eos OSC Control

This package provides n8n workflow nodes for controlling ETC Eos lighting consoles via OSC (Open Sound Control).

Installation

To install this package in your n8n instance:

1. From npm:

   npm install n8n-nodes-etc-osc

2. Local/development install:

   cd n8n_etc_node
   npm run build
   npm pack
   # Install the generated tgz file in n8n via the community nodes interface

Available Nodes

ETC OSC Channel Control

Control channel intensity levels and basic parameters with support for:

• Standard percentage levels (0-100%)
• Full intensity and zero intensity shortcuts
• Remdim level setting
• Fade time support for level changes

ETC OSC Cue Control

Fire and manage cues with:

• Fire specific cues by number (e.g., "1", "2.5")
• Go button functionality
• Cue recording capability

ETC Console Command

Send ETC console-style commands using command-line syntax:

• Execute console commands (e.g., "Chan 1 At 50", "Go", "Blackout")
• Automatic command termination with "Enter"
• Full command-line interface support
• Best for complex multi-step commands

ETC OSC Command (Raw)

Send raw OSC messages using full OSC syntax:

• Custom OSC addresses (e.g., /eos/chan/1, /eos/cue/1/fire)
• Typed arguments (integers, floats, strings)
• Direct OSC protocol control
• Formatted argument parsing (comma-separated)
• Advanced OSC message construction

Configuration

Each node requires:

• Host: IP address of the Eos console (default: 127.0.0.1)
• Port: OSC receiving port (default: 3032)

Enable OSC in your Eos console via: Shell → Settings → Network → OSC RX

Usage Example

Create a workflow that:

1. Receives a webhook trigger
2. Uses "ETC OSC Channel Control" to set Channel 1 to 50%
3. Uses "ETC OSC Cue Control" to fire Cue 5
4. Logs success/failure status

Supported Eos Versions

• Eos Family v3.0+
• ETCNomad v3.0+

Development

To modify and build the nodes locally:

cd n8n_etc_node
npm install
npm run build

License

MIT

Contributing

Contributions welcome! Please submit issues and pull requests to the GitHub repository.

Resources

• ETC Eos OSC Documentation
• n8n Node Development Guide