OSC Eos Control
OSC provides many ways to interface with Eos, both via requesting information and controlling the console remotely. Remote control interfaces like TouchOSC can be used to create an entirely customized control layout that duplicates existing Eos functions.
All OSC sent to Eos must begin with /eos. All OSC sent from Eos will begin with /eos/out.
Jump to HeadingSetting Levels
These OSC methods provide various options for controlling intensity and parameter levels and values.
OSC Absolute Levels
Absolute level commands are used when there is an existing target already selected on the command line of the OSC user.
Set Levels
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/at | number for the level (0-100) | /eos/at= 75 | Useful for mapping to an OSC fader. |
| /eos/at/out | number for the button edge 1.0=down, 0.0=up (optional) | /eos/at/out | |
| /eos/at/home | number for the button edge 1.0=down, 0.0=up (optional) | /eos/at/home | |
| /eos/at/remdim | number for the button edge 1.0=down, 0.0=up (optional) | /eos/at/remdim | |
| /eos/at/level | number for the button edge 1.0=down, 0.0=up (optional) | /eos/at/level | |
| /eos/at/full | number for the button edge 1.0=down, 0.0=up (optional) | /eos/at/full | |
| /eos/at/min | number for the button edge 1.0=down, 0.0=up (optional) | /eos/at/min | |
| /eos/at/max | number for the button edge 1.0=down, 0.0=up (optional) | /eos/at/max | |
| /eos/at/+% | number for the button edge 1.0=down, 0.0=up (optional) | /eos/at/+% | |
| /eos/at/-% | number for the button edge 1.0=down, 0.0=up (optional) | /eos/at/-% |
Set Parameter or DMX Information
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/at/DMX | number for the DMX level | /eos/at/DMX/128 | Useful for mapping to an OSC fader. |
| /eos/param/<parameter> | number for the level | /eos/param/pan=270 | Useful for mapping to an OSC fader. |
| /eos/param/<parameter>/out | number for the button edge 1.0=down, 0.0=up (optional) | /eos/param/pan/out | |
| /eos/param/<parameter>/home | number for the button edge 1.0=down, 0.0=up (optional) | /eos/param/pan/home | |
| /eos/param/<parameter>/level | number for the button edge 1.0=down, 0.0=up (optional) | /eos/param/pan/level | |
| /eos/param/<parameter>/full | number for the button edge 1.0=down, 0.0=up (optional) | /eos/param/pan/full | |
| /eos/param/<parameter>/min | number for the button edge 1.0=down, 0.0=up (optional) | /eos/param/pan/min | |
| /eos/param/<parameter>/max | number for the button edge 1.0=down, 0.0=up (optional) | /eos/param/pan/max | |
| /eos/param/<parameter>/+% | number for the button edge 1.0=down, 0.0=up (optional) | /eos/param/pan/+% | |
| /eos/param/<parameter>/-% | number for the button edge 1.0=down, 0.0=up (optional) | /eos/param/pan/-% | |
| /eos/param/<parameter 1>/<parameter 2> | number for all parameter levels multiple numbers for each parameter level | /eos/param/pan/tilt=45 - set pan & tilt to 45) /eos/param/pan/tilt=45,90 - set pan to 45 & tilt to 90) |
OSC Color
Set Color
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/color/hs | Argument 1: Hue (0.0-360.0) Argument 2: Saturation (0.0-100.0) |
/eos/color/hs=330.0, 75.0 (pink color with 75% saturation) | |
| /eos/color/hsxy | Argument 1: X (0.0-1.0) Argument 2: Y (0.0-1.0) |
/eos/color.hsxy=0.82, 0.31 (pink color with 75% saturation) | For simulating the Hue/Saturation wheel in a 2D XY graph where bottom-left corner is (0.0, 0.0) and top-right corner is (1.0, 1.0) |
| /eos/color/rgb | Argument 1: Red (0.0-1.0) Argument 2: Green (0.0-1.0) Argument 3: Blue (0.0-1.0) |
/eos/color/rgb=1.0, 0.25, 0.63 (pink color with 75% saturation) | |
| /eos/color/xy | Argument 1: x (0.0-1.0)
Argument 2: y (0.0-1.0) |
/eos/color/xy=0.464, 0.254 (pink color with 75% saturation) | For setting (x, y) chromaticity point in the CIE 1931 xyY color space |
| /eos/color/xyz | Argument 1: X Argument 2: Y Argument 3: Z |
/eos/color/xyz=0.851, 0.466, 0.516 (pink color with 75% saturation) | For setting (X, Y, Z) color point in XYZ color space |
OSC Pan/Tilt
Set Pan/Tilt
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/pantilt/xy | Argument 1: X (0.0-1.0) Argument 2: Y (0.0-1.0) | /eos/pantilt/xy=0.5, 0.5 - sets the current selection's pan and tilt to (0,0) on the pan/tilt graph. | 2D pan/tilt graph where bottom-left corner is (0.0, 0.0) and top-right corner is (1.0, 1.0) |
Pan/Tilt Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/pantilt = <pan min>, <pan max>, <tilt min>, <tilt max>, <pan>, <tilt> | <pan min>: Float. <pan max>: Float. <tilt min>: Float. <tilt max>: Float. <pan>: Float. <tilt>: Float. | /eos/out/pantilt = -270.000, 270.000, -135.000, 135.000, 0.000, 0.000 - selected chan's pan and tilt values are at 0. | Current pan/tilt values of selected channel |
OSC Switch
Switch is a variant of Wheel with the added functionality of continuously repeating wheel ticks until a subsequent OSC switch command sets the wheel ticks to zero. This may be used to continuously tick a wheel while a button is held down, for example.
The expected argument range is -1.0 to 1.0, which affects the tick rate accordingly, but can be a smaller or larger range for more subtle or rapid movement.
Switch and Encoder Levels
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/switch/level | X level wheel ticks | ||
| /eos/switch | Set OSC wheel mode - 0 = coarse, 1 = Fine | /eos/switch=1.0 - sets the wheel mode to fine. | |
| /eos/switch/<parameter> | X OSC wheel mode ticks for specified parameter (ex: pan) | ||
| /eos/switch/<parameter 1>/<parameter 2>/... | X OSC wheel mode ticks for specified parameters (ex: red, green, blue) | ||
| /eos/switch/fine/<parameter> | X fine wheel ticks for specified parameter (ex: pan) | ||
| /eos/switch/fine/<parameter 1>/<parameter 2>/... | X fine wheel mode ticks for specified parameters (ex: red, green, blue) | ||
| /eos/switch/coarse/<parameter> | X coarse wheel ticks for specified parameter (ex: pan) | ||
| /eos/switch/coarse/<parameter 1>/<parameter 2>/... | X coarse wheel mode ticks for specified param- eters (ex: red, green, blue) |
Switch Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/switch | Current OSC wheel mode | /eos/out/switch=1.0 |
OSC Wheel
OSC Wheel can be used to adjust channel levels and parameters.
Level Wheel
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/wheel/level | number for wheel ticks for the specified wheel mode (positive or negative) | /eos/wheel/level=1.0 (increase value) /eos/wheel/level=-1.0 (decrease value) /eos/wheel/level=4.0 (increase value rapidly) ( |
Defaults to Coarse mode, but wheel mode can be changed with the /eos/wheel command below. |
| /eos/wheel | number for wheel mode: 0=coarse, 1=fine | /eos/wheel=1.0 |
Parameter Wheels and Encoders
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/wheel/<parameter> | number for wheel ticks (positive or negative) | /eos/wheel/pan=1.0 | |
| /eos/wheel/<parameter 1>/<parameter 2>/... | number for wheel ticks (positive or negative) | /eos/wheel/pan/tilt=1.0 | |
| /eos/wheel/fine/<parameter> | number for fine wheel ticks (positive or negative) | /eos/wheel/fine/pan=1.0 | |
| /eos/wheel/fine/<parameter 1>/<parameter 2>/... | number for fine wheel ticks (positive or negative) | /eos/wheel/fine/pan/tilt=1.0 | |
| /eos/wheel/coarse/<parameter> | number for coarse wheel ticks (positive or nega tive) | /eos/wheel/coarse/pan=1.0 | |
| /eos/wheel/coarse/<parameter 1>/<parameter 2>/... | number for coarse wheel ticks (positive or negative) | /eos/wheel/coarse/pan/ tilt=1.0 |
Wheel Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/wheel | number for current wheel mode: 0=coarse, 1=fine | /eos/out/wheel=1.0 | |
| /eos/out/active/wheel/# | /eos/out/active/wheel=4 | ||
| /eos/out/pantilt | Current pan/tilt values of selected channel |
OSC XYZ
OSC XYZ coordinates are measured in decimal meters, regardless of the unit selected in Setup > System > System > Metric / Imperial.
Set Position
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/xyz | XYZ coordinates | Set XYZ position of selected channel | |
| /eos/chan/#/xyz | XYZ coordinates | Set XYZ position of a specific channel | |
| /eos/cmd | Channel number, XYZ_Format Enable#, XYZ_Format Disable# | /eos/cmd=Chan 1 XYZ_Format Enable# /eos/cmd=Chan 1 XYZ Format Disable# |
Enables or disables XYZ formatting for Channel 1 |
XYZ Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/xyz | Current position of selected channel |
Command Line Control
These OSC methods allow you to directly control The Command Line.
OSC Command and Event
Command line instructions can be sent directly. String substitution with arguments is also allowed. To add a substitution, add %1 (or %2, %3, etc…) where the number given is the argument number where the actual value should be found.
- “Chan %1 At FL”, 101 - Eos will substitute 101 in place of %1, meaning the command is interpreted as Chan 101 At FL.
- “Chan %1 At %2”, 75, 50 - Eos will substitute 75 in place of %1 (the first argument), and 50 in place of %2. The command is interpreted as Chan 75 At 50.
Command or Event
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/cmd | string with command line text | /eos/cmd=”Chan 1 At 75"
|
Unterminated command. |
| /eos/cmd=”Chan 1 At 75#”
/eos/cmd=”Chan 1 At 75 Enter” |
Terminated commands. | ||
| /eos/cmd | /eos/cmd=”Chan 1 At 75"
/eos/cmd=”Chan %1 At %2#”, 1, 75 |
In-line command line. Both are valid syntaxes for setting Channel 1 to 75. | |
| /eos/cmd/<text>/<text>/<text>/... | in-line command line arguments | /eos/cmd/Chan/1/At/75
/eos/cmd/Chan/%1/At/%2#=1, 75 |
Both are valid syntaxes for setting Channel 1 to 75. |
| /eos/event | Same behavior as /eos/cmd, treated as console event. |
New Command or Event
Same behavior as above, but resets the command line first.
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/newcmd | |||
| /eos/newevent |
Command Line Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/user/<number>/cmd | String argument with current command line text for the current console user | ||
| /eos/out/cmd | String argument with current command line text |
Console Keys
These OSC methods provide the same functionality as the hardkeys and softkeys on Eos Family devices.
OSC Hardkey
OSC Hardkey allows you to create OSC analogs of the physical buttons on a console face panel.
For a list of supported key names, see OSC Dictionary > OSC Eos Keys. OSC names for each key can also be viewed on the Virtual Keyboard [Tab 7] by selecting OSC /key Names in the bottom-right dropdown menu.
Key Control
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/key/<name> | number for button edge: 1.0=down, 0.0=up (optional) | /eos/key/select active=1.0 (press [Select Active] but- ton) /eos/key/select active=0.0 (release [Select Active] but- ton) /eos/key/go 0(press & release [Go] button) |
Staging Mode
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/key/staging_mode | Toggles Staging Mode on and off. |
OSC Softkey
OSC Softkey allows you to control any of the 2 pages of 6 softkeys, numbered sequentially from 1-12.
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/softkey/<index> | number for button edge: 1.0=down, 0.0=up (optional) | /eos/softkey/1=1.0
- press 1st softkey /eos/softkey/1=0.0 - release 1st softkey |
Targets
These OSC methods allow you to select and control various show file Record Targets.
OSC Address
Address Selection
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/addr | number for address to select | /eos/addr=513 |
Set Address Levels
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/addr/<address> | number for level to set address to (0-100) | /eos/addr/513=100 | Useful for mapping to an OSC fader. |
| /eos/addr/<address>/DMX | number for DMX level to set address to (0-255) | /eos/addr/513/DMX=255 | Useful for mapping to an OSC fader. |
OSC Channel
OSC Channel allow you to select Eos channels. You can directly change the channel level information in the same command, or use this as a selection tool for other controls.
OSC channel selection behaves the same way as channel selection via the tombstone icons or direct select buttons, leaving the command line unterminated.
Channel Selection
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/chan | number for channel to select | /eos/chan=1 | |
| /eos/chan/<number> | number for channel level | /eos/chan/1=75 | Useful for mapping to an OSC fader. |
Set Channel Levels
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/chan/<number>/out | number for button edge: 1.0=down, 0.0=up (optional) | /eos/chan/1/out | |
| /eos/chan/<number>/home | number for button edge: 1.0=down, 0.0=up (optional) | /eos/chan/1/home | |
| /eos/chan/<number>/remdim | number for button edge: 1.0=down, 0.0=up (optional) | /eos/chan/1/remdim | |
| /eos/chan/<number>/level | number for button edge: 1.0=down, 0.0=up (optional) | /eos/chan/1/level | |
| /eos/chan/<number>/full | number for button edge: 1.0=down, 0.0=up (optional) | /eos/chan/1/full | |
| /eos/chan/<number>/min | number for button edge: 1.0=down, 0.0=up (optional) | /eos/chan/1/min | |
| /eos/chan/<number>/max | number for button edge: 1.0=down, 0.0=up (optional) | /eos/chan/1/max | |
| /eos/chan/<number>/+% | number for button edge: 1.0=down, 0.0=up (optional) | /eos/chan/1/+% | |
| /eos/chan/<number>/-% | number for button edge: 1.0=down, 0.0=up (optional) | /eos/chan/1/-% |
Set Parameter and DMX Levels
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/chan/<number>/DMX | number for channel DMX level | /eos/chan/1/DMX=255 | |
| /eos/chan/<number>/param/<parameter> | number for parameter level | /eos/chan/1/param/pan=90 | Useful for mapping to an OSC fader. |
| /eos/chan/<number>/param/<parameter 1>/<parameter 2>/... | number for all parameter levels multiple numbers for each parameter level | /eos/chan/1/param/pan/ tilt=90(set channel 1 pan & tilt to 90) /eos/chan/1/param/pan/ tilt=45,90(set channel 1 pan to 45 & tilt to 90) | |
| /eos/chan/<number>/param/<parameter>/DMX | number for parameter DMX level | /eos/chan/1/param/pan/ DMX=255 | |
| /eos/chan/<number>/param/<parameter 1>/<parameter 2>/.../ DMX | numbers for parameter DMX levels | /eos/chan/1/param/pan/tilt/ DMX=255 |
Channel Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/active/chan | String with active channels (selected) and current value from first channel | /eos/out/active/chan=”1-2 [100]” |
OSC Curve
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/curve | number of curve to select | /eos/curve=1 |
OSC Effects
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/fx | number of effect to select | /eos/fx=1 |
OSC Group
OSC Group allows you to select and control groups of channels, using the same syntax as OSC Channel.
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/group | number for group to select | /eos/group=1 | |
| /eos/group/<number> | number for channel level | /eos/group/1=75 | |
| /eos/group/<number>/out | number for button edge:1.0=down, 0.0=up(optional) | /eos/group/1/out | |
| /eos/group/<number>/home | number for button edge:1.0=down, 0.0=up(optional) | /eos/group/1/home | |
| /eos/group/<number>/level | number for button edge:1.0=down, 0.0=up(optional) | /eos/group/1/level | |
| /eos/group/<number>/full | number for button edge:1.0=down, 0.0=up(optional) | /eos/group/1/full | |
| /eos/group/<number>/min | number for button edge:1.0=down, 0.0=up(optional) | /eos/group/1/min | |
| /eos/group/<number>/max | number for button edge:1.0=down, 0.0=up(optional) | /eos/group/1/max | |
| /eos/group/<number>/+% | number for button edge:1.0=down, 0.0=up(optional) | /eos/group/1/+% | |
| /eos/group/<number>/-% | number for button edge:1.0=down, 0.0=up(optional) | /eos/group/1/-% | |
| /eos/group/<number>/DMX | number for DMX level1.0=down, 0.0=up(optional) | /eos/group/1/DMX=127 | |
| /eos/group/<number>/param/<parameter> | number for parameter level | /eos/group/1/param/pan=90 | |
| /eos/group/<number>/param/<parameter 1>/<parameter 2>/... | numbers for parameter levels | /eos/group/1/param/pan/tilt=90,75 | |
| /eos/group/<number>/param/<parameter>/DMX | number for parameter DMX level | /eos/group/1/param/pan=255 | |
| /eos/group/<number>/param/<parameter 1>/<parameter 2>/.../ DMX | numbers for DMX parameter levels | /eos/group/1/param/pan/tilt/DMX=255 |
OSC Macro
Selects and fires (executes) macros.
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/macro | number for macro to select | /eos/macro=1 | |
| /eos/macro/fire | number for macro to run | /eos/macro/fire=1 | |
| /eos/macro/<number>/fire | number for button edge: 1.0=down, 0.0=up (optional) | /eos/macro/1/fire=1.0 |
OSC Magic Sheet
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/ms | number of the magic sheet to open | /eos/ms=1 | |
| /eos/ms/<ms number> | number of the magic sheet view to open (optional) | /eos/ms/1=2 |
OSC Palettes
OSC Palettes allows you to select and recall the four Eos Palette Types.
Intensity Palettes
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/ip | number of intensity palette to select | /eos/ip=1 | Selects a palette. |
| /eos/ip/fire | number of intensity palette to recall | /eos/ip/fire=1 | Recalls a palette. |
| /eos/ip/<number>/fire | number for button edge: 1.0=down, 0.0=up (optional) | /eos/ip/1/fire | Fires a palette. |
Focus Palettes
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/fp | number of focus palette to select | /eos/fp=1 | Selects a palette. |
| /eos/fp/fire | number of focus palette to recall | /eos/fp/fire=1 | Recalls a palette. |
| /eos/fp/<number>/fire | number for button edge: 1.0=down, 0.0=up (optional) | /eos/fp/1/fire | Fires a palette. |
Color Palettes
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/cp | number of color palette to select | /eos/cp=1 | Selects a palette. |
| /eos/cp/fire | number of color palette to recall | /eos/cp/fire=1 | Recalls a palette. |
| /eos/cp/<number>/fire | number for button edge: 1.0=down, 0.0=up (optional) | /eos/cp/1/fire | Fires a palette. |
Beam Palettes
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/bp | number of beam palette to select | /eos/bp=1 | Selects a palette. |
| /eos/bp/fire | number of beam palette to recall | /eos/bp/fire=1 | Recalls a palette. |
| /eos/bp/<number>/fire | number for button edge: 1.0=down, 0.0=up (optional) | /eos/bp/1/fire | Fires a palette. |
OSC Pixel Map
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/pixmap | number of pixel map to select | /eos/pixmap=1 |
OSC Preset
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/preset | number of preset to select | /eos/preset=1 | Selects a preset. |
| /eos/preset/fire | number of preset to recall | /eos/preset/fire=1 | Recalls a preset. |
| /eos/preset/<number>/fire | number for button edge: 1.0=down, 0.0=up (optional) | /eos/preset/1/fire | Fires a preset. |
OSC Snapshot
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/snap | number of snapshot to recall | /eos/snap=1 |
OSC Submaster
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/sub | number for sub to select | /eos/sub=1 | |
| /eos/sub/<number> | floating point number to set sub percent to | /eos/sub/1=0.75 | Useful for mapping to an OSC fader. |
| /eos/sub/<number>/out | number for button edge: 1.0=down, 0.0=up (optional) | /eos/sub/1/out | |
| /eos/sub/<number>/home | number for button edge: 1.0=down, 0.0=up (optional) | /eos/sub/home | |
| /eos/sub/<number>/level | number for button edge: 1.0=down, 0.0=up (optional) | /eos/sub/1/level | |
| /eos/sub/<number>/full | number for button edge: 1.0=down, 0.0=up (optional) | /eos/sub/1/full | |
| /eos/sub/<number>/min | number for button edge: 1.0=down, 0.0=up (optional) | /eos/sub/1/min | |
| /eos/sub/<number>/max | number for button edge: 1.0=down, 0.0=up (optional) | /eos/sub/max | |
| /eos/sub/fire | number for sub to bump | /eos/sub/fire=1 | |
| /eos/sub/<number>/fire | number for button edge: 1.0=down, 0.0=up (optional) | /eos/sub/1/fire=1.0 - bump sub 1 on. /eos/sub/1/fire=0.0 - bump sub 1 off. |
Targets with Banks
OSC Cues and Cue List Banks
Fire and Go
OSC Cue and OSC Cue Lists allow the use of both /fire/ and /go/ to activate a cue. /go/ is specific to cues and cue lists, and advances in sequence in the same way as the physical [Go] button.
/fire/ activates the specified cue or cue list regardless of sequencing, and can also be used to activate other targets, such as OSC Macro or OSC Preset.
The incoming and outgoing OSC format Eos uses for cues and cue lists can be set via Setup > System > Show Control > OSC Cue Receive String and OSC Cue Send String. These settings can be overridden on specified cue lists using Cue Triggers.
Select Cues
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/cue | Number of cue to select | /eos/cue=1.5 | |
| /eos/cue/<list number> | Number of cue to select (in the specified cue list) | /eos/cue/1=1.5 | |
| /eos/cue/<list number>/<cue number> | Number of cue part to select (in the specified cue list and cue number) | /eos/cue/1/1.5=2 |
Run Cues
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/cue/fire | Number of cue to run | /eos/cue/fire=1 | |
| /eos/cue/<cue number>/fire | Number for button edge: 1.0=down, 0.0=up (optional) | /eos/cue/1.5/fire | |
| /eos/cue/<list number>/<cue number>/fire | Number for button edge: 1.0=down, 0.0=up (optional) | /eos/cue/1/1.5/fire | |
| /eos/cue/<list number>/<cue number>/<part number>/fire | Number for button edge: 1.0=down, 0.0=up (optional) | /eos/cue/1/1.5/2/fire | |
| /eos/key/Stop_Back_Main_CueList |
Cue List Banks
<index> is a 1-based index of any number of OSC cue list banks you wish to create. Eos will send the cue list label and cue information for all OSC cue list banks. OSC Cue List Banks is updated once per second.
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/cuelist/<index>/config/<cue list number>/<num prev cues>/<num pending cues> | /eos/cuelist/1/config/2/3/6 (create OSC cue list bank #1 for cue list 2, showing 3 previous cues, the current cue, and 6 pending cues) NOTE: s | Set <cue list number> to zero to follow the current cue list. | |
| /eos/cuelist/<index>/config/<cue list number>/<num prev cues>/<num pending cues>/<offset> | /eos/cuelist/1/config/2/3/6/10 (create OSC cue list bank #1 for cue list 2, showing 3 previous cues, the current cue, and 6 pending cues, starting at offset 10 into the cue list) offset is a zero-based index into the entire cue list, where each cue counts as one item and each cue part counts as one item NOTE: set <cue list number> to zero to follow the current cue list | ||
| /eos/cuelist/<index>/page/<delta> | /eos/cuelist/1/page/1 (page OSC cue list bank down 1 row) /eos/cuelist/1/page/-1 (page OSC cue list bank up 1 row) /eos/cuelist/1/page/0 (jump back to the current cue and follow it) | ||
| /eos/cuelist/<index>/select/<cue number> | /eos/cuelist/1/select/100.4 (jump to cue 100.4) | ||
| /eos/cuelist/<index>/reset | Resets the specified cue list bank |
OSC Faders and Fader Banks
Fader banks share fader mapping with Eos, but since an OSC Fader Bank can have any number of faders per page, the paging will be different. Like Direct Selects, you must first send one of the OSC Fader Bank creation commands before the fader pages will work. Faders will be mapped to the same fader number as Eos.
<index> is a 1-based index of any number of discrete sets of OSC fader banks you wish to create. Eos will send the description and fader labels for all OSC fader banks. Use an <index> of zero to reference the master fader.
| Action | Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|---|
| Create an OSC fader bank with a specific number of faders. | /eos/fader/<bank index>/config/<fader count> | /eos/fader/1/config/10 | OSC Fader 1/1 is the same as console fader 1/1. OSC Fader 2/1 (Fader 11) is the same as console fader 2/1. | |
| /eos/fader/1/config/5 | OSC Fader 2/1 (Fader 6) is the same as console fader 1/6 (Fader 6). OSC Fader 3/1 (Fader 11) is the same as console fader 2/1 (Fader 11). |
Create Fader Banks
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/fader/<bank index>/config/<fader count> | /eos/fader/1/config/10 (create OSC fader bank #1 with 10 faders) | ||
| /eos/fader/<bank index>/config/<page number>/<fader count> | /eos/fader/1/config/2/10 (create OSC fader bank #1 with 10 faders on page 2) Can also be used to quick jump to a specific page |
Fader Controls
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/fader/<index>/config/<page number>/<fader count> | /eos/fader/1/config/2/10 Jump to a specific fader page (OSC Fader Map 1, Page 2 of 10 faders) | ||
| /eos/fader/<index>/page/<delta> | /eos/fader/1/page/1 (page down by 1) /eos/fader/1/page/-1 (page up by 1)/eos/fader/1/page/10 (page down by 10) | ||
| /eos/fader/<index>/<fader index> | floating point number to set sub percent to | /eos/fader/1/2=0.75 (set the second fader in OSCfader bank #1 to 75%) | |
| /eos/fader/<index>/<fader index>/ load | /eos/fader/1/2/load | ||
| /eos/fader/<index>/<fader index>/ unload | /eos/fader/1/2/unload | ||
| /eos/fader/<index>/<fader index>/ stop | /eos/fader/1/2/stop | ||
| /eos/fader/<index>/<fader index>/ fire | /eos/fader/1/2/fire | ||
| /eos/fader/<index>/<fader index>/ out | /eos/fader/1/2/out | ||
| /eos/fader/<index>/<fader index>/ home | /eos/fader/1/2/home | ||
| /eos/fader/<index>/<fader index>/ min | /eos/fader/1/2/min | ||
| /eos/fader/<index>/<fader index>/ max | /eos/fader/1/2/max | ||
| /eos/fader/<index>/<fader index>/ full | /eos/fader/1/2/full | ||
| /eos/fader/<index>/<fader index>/ level | /eos/fader/1/2/level | ||
| /eos/fader/<index>/<fader index>/+% | /eos/fader/1/2/+% | ||
| /eos/fader/<index>/<fader index>/-% | /eos/fader/1/2/-% | ||
| /eos/fader/<index>/reset | Resets the specified fader bank. |
Fader Output
Eos will delay sending fader levels for faders that have been moved via OSC commands for 3 seconds. If you move a fader on an OSC remote control, Eos will send the actual fader level 3 seconds later.
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/fader/<index>/<fader>/name | String argument with fader label for OSC fader | /eos/out/fader/1/1=“S 1 Label” Sub 1 with a label “Label”/eos/out/fader/1/2=“IP 1 Label” IP 1 fader labeled “Label” | |
| /eos/out/fader/<index>/<fader>/name | Floating point argument for fader percent (0.0-1.0) | /eos/out/fader/1/1=0.75/eos/out/fader/1/2=0.0 | |
| /eos/out/fader/<index> | String argument, descriptive text for OSC fader bank at index | /eos/fader/1=“1” |
OSC Direct Selects and Direct Select Banks
OSC Direct Selects are virtual buttons and are mapped separately than standard Direct Selects [Tab 4]. To use direct selects, you must first send one of the direct select creation commands. Direct selects are mapped as a single target type. Eos will send the description and button labels for all OSC direct selects.
<index> is a 1-based index of any number of OSC direct select banks you wish to create. <target type> may be one of the following:
- Chan
- Group
- Macro
- Sub
- Preset
- IP (Intensity Palette)
- FP (Focus Palette)
- CP (Color Palette)
- BP (Beam Palette)
- MS (Magic Sheet)
- Curve
- Snap (Snapshot)
- FX (Effects)
- Pixmap (Pixel Map)
- Scene
Direct Selects Creation
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/ds/<index>/<target type>/<button count> | /eos/ds/1/chan/10 - create OSC direct select bank #1 with 10 channel buttons /eos/ds/2/group/25 - create OSC direct select bank #2 with 25 group buttons |
||
| /eos/ds/<index>/<target type>/ flexi/<button count> | /eos/ds/1/chan/flexi/10 - create OSC direct select bank #1 with 10 channel buttons, in Flexi mode | ||
| /eos/ds/<index>/<target type>/<page number>/<button count> | /eos/ds/1/chan/3/10 - create OSC direct select bank #1 with 10 channel buttons on page 3 | Can also be used to quick jump to a specific page. | |
| /eos/ds/<index>/<target type>/ flexi/<page number>/<button count> | /eos/ds/1/chan/flexi/3/10 - create OSC direct select bank #1 with 10 channel buttons on page 3, in Flexi mode | Can also be used to quick jump to a specific page. |
Direct Selects Paging
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/ds/<index>/page/<delta> | number for page delta | /eos/ds/1/page/1 - page down by 1 /eos/ds/1/page/-1 - page up by 1 /eos/ds/1/page/10 - page down by 10 |
Direct Selects Control
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/ds/<index>/<button index> | number for button edge: 1.0=down, 0.0=up (optional | /eos/ds/1/1=1.0 - press first button of OSC direct select bank #1 /eos/ds/1/1=0.0 - release first button of OSC direct select bank #1 |
Direct Selects Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/ds/<index> | String argument containing descriptive text for direct select at <index>: target name, page number, mode | /eos/out/ds/1/1=”Channels [1]”/eos/ds/1/1=”Groups [1 – Flexi]” | |
| /eos/out/ds/<index>/<button index> | String argument containing target description (name/number) | /eos/out/ds/1/1=“Cyac [1]” |
Status Information
These OSC methods provide information about the status of your show file.
OSC Active Cue
The incoming and outgoing OSC format Eos uses for cues and cue lists can be set via Setup > System > Show Control > OSC Cue Receive String and OSC Cue Send String. These settings can be overridden on specified cue lists using Cue Triggers.
OSC Active Cue is updated once per second.d
Active Cue Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/active/cue/<list>/<cue> | Float argument with percent complete 0.0=started, 1.0 complete | /eos/out/active/cue/5/1=0.75 | Updated once per second. |
| /eos/out/active/cue | Float argument with percent complete 0.0=started, 1.0 complete | /eos/out/active/cue=0.75 | Updated once per second. |
| /eos/out/active/cue/text | String argument with descriptive text about active cue | /eos/out/active/cue/text= “1/1 Label 5.00 100%” | |
| /eos/out/pending/cue/<list>/<cue> | /eos/out/pending/cue/5/1.5 | ||
| /eos/out/pending/cue/<list>/<cue>/text | String argument with descriptive text about active cue | /eos/out/pending/cue/text= “1/1.5 Label 5.00” | |
| /eos/get/setup | Gets default cue times. |
QLab Compatible Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /cue/%1/start | %1 - cue number %2 - cuelist number %3 - cue whole number only (i.e. if it's cue 17.5, send only 17) %4 - cue point number only (i.e. if it's cue 17.5, send only 5) %5 - cue label |
OSC Live/Blind State
State Output
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/out/event/state | Integer argument: 0=Blind, 1=Live |
OSC Reset
OSC Reset clears any active switches, resets all persistent OSC settings (like OSC user ID & wheel modes), and sends all implicit OSC output commands.
| Address Pattern | Arguments | Examples | Notes |
|---|---|---|---|
| /eos/reset |