xair-cli

Installation

xair-cli

go install github.com/onyx-and-iris/xair-cli/cmd/xair-cli@latest

x32-cli

go install github.com/onyx-and-iris/xair-cli/cmd/x32-cli@latest

Configuration

Flags

• --host/-H: Host of the mixer.
• --port/-P: Port of the mixer.
• --timeout/-T: Timeout for OSC operations.
• --loglevel/-L: The application's logging verbosity.

Pass --host and any other configuration as flags on the root commmand:

xair-cli --host mixer.local --timeout 50ms --help

Environment Variables

Or you may load them from your environment:

Example xair .envrc:

#!/usr/bin/env bash

export XAIR_CLI_HOST=mixer.local
export XAIR_CLI_PORT=10024
export XAIR_CLI_TIMEOUT=100ms
export XAIR_CLI_LOGLEVEL=warn

Example x32 .envrc:

#!/usr/bin/env bash

export X32_CLI_HOST=x32.local
export X32_CLI_PORT=10023
export X32_CLI_TIMEOUT=100ms
export X32_CLI_LOGLEVEL=warn

---

Use

For each command/subcommand in the tree there exists a --help flag, use it to print usage information.

• xair-cli
• x32-cli

Examples

Fade out main LR all the way to -∞ over a 5s duration

xair-cli main fadeout

enable phantom power and set the gain to 28.0dB over a 10s duration for headamp (strip) 09

xair-cli headamp 9 phantom on

xair-cli headamp 9 gain --duration 10s 18.0

set strip 09 send level for bus 5 to -18.0dB

xair-cli strip 9 send 5 -- -18.0

enable eq for strip 01

xair-cli strip 1 eq on true

rename bus 01 to 'vocal mix'

xair-cli bus 1 name 'vocal mix'

set bus 03 eq band 03 (LoMid) gain

xair-cli bus 3 eq 3 gain -- -3.5

Send a raw OSC message to the mixer

xair-cli raw /xinfo

xair-cli raw /ch/01/config/name 'rode podmic'
xair-cli raw /ch/01/config/name

Save current mixer state to a snapshot

xair-cli snapshot 20 save 'twitch live'

---

License

xair-cli is distributed under the terms of the MIT license.

Notes

For an alternative, python implementation consider checking out dc-xair-cli. It supports some operations like batch commands and network discovery which this CLI doesn't (and I have no plans to implement them).