Getting Started

Setting Up Folder Structure Music Sources

As well as automatically discovering iTunes, Windows Media Player, and Winamp music libraries, audio|acacia lets you setup a custom music library based off of a directory or directories of music files.


Before you can build a custom music library from a directory, you'll need to have the audio|acacia server software installed on a computer that has access to the directory of music files that you want to add. The files can either be located directly on the machine, on an external hard drive or flash drive connected to the computer, on a network share that the computer can access, or a combination. Sources can be setup using Windows, Mac, or Linux machines.

Accessing a Library

Once you've setup the new music library, it will now automatically appear in the controller interface underneath the "Music Libraries" source header. From here, you can search the entire library, see all songs artists, albums, or genres, or browse the source by the directory paths.

Note: audio|acacia derives song metadata first from embedded ID3 tags, then from song location if tags are missing or not available. When deriving by song location, it is assumed that music is organized in the following way within the file path: "/{Root Directory}/{Artist Name}/{Album Name}/song.mp3".

Updating a Library

Folder Structure music libraries automatically updated each time the server software is restarted.

Note: In a future software update, audio|acacia will track changes to the directories and update the library automatically with no need to manually reindex or restart the server.

Creating a Library

Once you have the server software installed, go to the server configuration interface at and choose the musical note tab icon. To create a new music library, press the green + icon in the "Music Libraries" row. It will automatically apply a default library name, which you can modify if you so desire. Lastly, choose a directory or group of directories that you want audio|acacia to search through for music. As you add them, it will begin searching and indexing your music.

You can create as many different libraries as you wish, with as many different directories as you wish, on as many different computers as you wish. audio|acacia supports a wide number of different audio file formats including FLAC, WavPack, Monkey's Audio, DSD, Speex, and many more. If audio|acacia isn't finding your music or can't play specific files, please get in touch.

Note: If you intend to build a music library from a USB drive attached to a Raspberry Pi running a "Lite" version of Raspbian, you will need to tell the OS to auto-mount the USB drive (the non-desktop version of Raspbian does not set this up for you by default). To do this simply run the following command from the terminal:
sudo apt-get install usbmount
Insert the USB drive and it should auto-mount to the path /media/usb/