Plethra

Documentation

Setting Up the audio|acacia Server on a Raspberry Pi

The Raspberry Pi makes a great dedicated audio|acacia server. It's compact, affordable, and something you can leave powered ON indefinitely without feeling like you're wasting energy.

The Components

Buy yourself a Raspberry Pi 2, an 8GB or larger microSD card, & case all for less than $50 shipped. If you won't be able to hardwire the Pi directly to your network (which is the easiest and preferred method), you'll also need to buy a USB WiFi dongle, such as this official one.

The Setup

Install the Raspbian Operating System (version Jessie or newer is recommended; official OS image downloads are here) and then write the OS to the microSD card (directions are available for how to do this from a Mac, Windows, or Linux computer here). This is honestly the toughest part of the entire process. Other Linux OSes for the Pi may also work, but are not covered in this tutorial.

Once you have the OS installed on the microSD, plug it into the Pi and turn it on by providing power. You'll also need to temporarily plug an HDMI or DVI display into the Pi as well as a keyboard and mouse so that you can see what you're doing. Don't worry though, these are temporary. When all is said and done you can run audio|acacia on the Pi without any of this plugged in.

It might take a few minutes for the Pi to boot up for the very first time, but then it will boot much faster each time after that.

Server Installation

If you installed a full-desktop version of the Raspbian OS on the Pi, due to a bug in "packagekitd" you currently cannot simply double-click the downloaded .deb from the GUI to install the audio|acacia server. You must install from the terminal by entering these commands:

1. Download the audio|acacia server -
wget http://install.plethra.com/prelude/linarmhf32/audio-acacia.deb

2. Install the audio|acacia Server -
sudo dpkg --install audio-acacia.deb

You can then verify that the server is running by calling:
systemctl status AcaciaService.service

To uninstall the server completely, issue this command:
sudo dpkg --remove audio-acacia

Note: Only the Raspberry Pi 2/3 is capable of running the full version of the audio|acacia server software. If you intend to install audio|acacia on the original Raspberry Pi, the server will only run as an audio end-point (also called a "sink").

Accessing the Server Remotely

Now that you've got the audio|acacia server installed and running, use the controller for iOS, Android, or the Web to control it. No need to type in IP Addresses anywhere. The controller app should automatically discover and connect to the audio|acacia server so long as both devices are connected to the same local network.