Getting Started

Setting Up & Customizing Additional Rooms/Zones

In addition to automatically discovering 3rd-party speaker systems (e.g. AirPlay, Sonos, Google Cast, etc.) audio|acacia allows you to manually setup and customize additional rooms/zones using computer sound cards.


To use a computer and its sound cards for setting up rooms, begin by installing the server software on the host computer. Once installed, the server will automatically discover the sound devices and make them available for configuration via the web interface under the speaker tab icon. Nearly all sound cards, regardless of interface type (e.g. PCI, PCIe, USB, HDMI, Bluetooth, etc.) are supported. By default audio|acacia creates a zone/room, what we call a 'sink' on the first output of the operating system's current default system sound device. It names the zone after the machine name and labels it with the machine icon. If you do not want this sink, simply click the red - button to delete it. It will not return unless you completely uninstall and reinstall the server software.

Customizing a Sink

The 'Sink Detail's portion of the interface allows you to customize the settings of the zone/room. Here you can set its name, icon, and maximum volume. You can also set an availability schedule for the sink. This allows you to define exact times when music can be played to that room/zone. For example, you may have a young teenager that you only want to allow them to play music in his/her room between 7 AM and 10 PM on weekdays, and 10 AM to midnight on the weekend. To do this, you define rules that get added together to create the 'Compiled Schedule'. You can be as simple or as complex in the rules as you want.

Hint: To define a rule with minute precision, drag your finger or cursor further away vertically from the slider as you continue to drag horizontally to change the time.

Expanding Your System

There is no limit to the number of computers on which you can install the server software. All discovered server installations on a network will automatically appear together within the configuration interface. It also doesn't matter where you open, so long as you are connected to the same local network. This is especially helpful if you've installed the server software on a headless machine with no monitor attached. Simply visit using a different machine on your network.

Note: If visting doesn't automatically discover all the audio|acacia servers on your network, try this troubleshooting technique or this one. If that still doesn't work, please get in touch.

Note: If a soundcard and all its inputs and outputs are not correctly showing up for you, first make sure that it is correctly configured in the operating system for multi-channel input/output. If that still doesn't work, please get in touch.

Creating a Sink

To create a new sink, simply press the green + button on the pair of sound card output channels you wish to use. It will automatically provide a default name and icon, which can be modified in the 'Sink Details' portion of the interface. Where possible, we've color coded the outputs to help you to identify which is which on the physical hardware. You can also press the blue-grey wave button to send a static test tone to the output channels to make sure you're connecting to the correct output pair. If you've accidentally selected the wrong output pair or sound card, simply drag-and-drop the sink into the correct output pair. This way you can make and test changes without having to start over. All of your changes are seen and heard real-time, without ever having to restart any server or controller application.

Note: You can't currently drag-and-drop sinks between different machines running the server. You can only drag-and-drop sinks between different sound cards or channels on the same machine.