Plethra

Getting Started

Setting Up & Managing Local Music Libraries

audio|acacia supports playing and browsing from a number of different local music libraries, such as iTunes, Windows Media Player, and Winamp. For a complete up-to-date list of the supported local music sources, click here.

Setup

To setup accessing a music library via audio|acacia, you must install the server software on the computer where the library is located. Installation manuals are available for Mac, Windows, and Linux. Once the server software is installed, it will automatically discover and start indexing music libraries on your behalf. The server does this in a very intelligent, zero-configuration manner. There is no need to tell the server of specific file paths or locations. The server uses built-in APIs of the operating system to discover what music software is installed, where the libraries are located, and in some cases even the name of the library itself (e.g. "Jared's Tunes"). There are very rare instances in which your music library isn't automatically discovered. If this is the case for you, please get in touch.

Note: Beginning in iTunes 12, Apple decided in their infinite wisdom to make the sharing of the music library database optional. If you already had iTunes installed and updated to version 12, then the option is already enabled. However, if you installed iTunes for the first time beginning with version 12, then the sharing will be disabled by default. Go into iTunes > Preferences > Advanced, and make sure that the option "Share iTunes Library XML with other applications" is ticked.


Reindexing

The server automatically takes care of reindexing your library whenever you make changes (e.g. adding a Playlist, fixing metadata, adding songs, etc.). There is no need to press a "Reindex" or "Resync" button. The server tracks the library's database file and receives events from the operating system whenever it is modified. Reindexing is also very fast. In most cases, reindexing should happen in a matter of seconds and the changes will automatically appear in the audio|acacia controller without having to close the app or refresh your browser window. If you are one of the rare individuals that has 10,000+ songs in your library, it may take longer to reindex, maybe even 60 seconds or more. The speed is highly dependent on library size and computer speed.

Note: Currently Windows Media Player libraries are not re-indexed. This will change in the future via a software update.

Managing

The are ocassions when the server will discover libraries that you either don't use, don't want to be available via audio|acacia, or are incorrectly/poorly named. If this is the case, you can manage these library settings via the server configuration interface at config.plethra.com. Click on the musical note tab icon to see discovered sources.