Behringer Digital Mixer Integration For Home Assistant

This integration allows you to connect a Behringer Digital Mixer to Home Assistant.

For each mixer configured by this integration entities for the following are provided.:

For each Channel, Bus, DCA, Matrix, AuxIn, Main Faders, Channel->Bus sends and Bus->Matrix sends.

• Name (Read-only)
• Mute (SWITCH) (Read/Write)
• Fader (NUMBER) (Read/Write)
• Fader Value - dB (SENSOR) (Read-only)

In addition to these 'fader' related variables, also provided is

• Current scene/snapshot number/index (Read/Write)
• Firmware (Read only)
• USB Filename (Read only)
• USB Player/Recorder status (Read/Write)

Mixers Supported

• X32
• XR12
• XR16
• XR18

Testing has been mostly on the X32, but has been physically tested agains X32 and XR18

Data Updates

The data for the mixer is updated in real time, so each time a button is pressed or fader is moved on the mixer, this is updated in Home Assistant immediately.

Installation

HACS installation (recommended)

1. Install HACS. That way you get updates automatically.
2. Add this Github repository as custom repository in HACS settings.
3. Aearch and install "Behringer Mixer" in HACS and click install.
4. Restart Home Assistant,
5. Then you can add a Behringer Mixer integration in the integration page.

Manual installation

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called ha_berhringer_mixer.
4. Download all the files from the custom_components/ha_berhringer_mixer/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant
7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Behringer Mixer"

Configuration is done in the UI

• You are asked for the ip address/hostname
• You are asked for the type of mixer (choose from the list)
• You are asked for the name of the mixer
• You can choose which channels/busses/dcas etc to actually import (If you import everything there can be a lot)

Caveats

Connection to the mixer is performed via ip address using UDP. If the IP address for the mixer changes, you will need to edit the integration setup. To avoid this, set up a DHCP reservation on your router for your mixer so that it always has the same IP address.

This information on changes to the mixer is written to the HA history/recorder databases so this may result in lots of state being stored if the mixer changes a lot. You may want to consider excluding these entities from storing history.

Contributions are welcome

If you want to contribute to this please read the Contribution guidelines

---