Skip to content
avuserow edited this page Sep 13, 2010 · 1 revision

conf/acoustics.ini is the master configuration file for Acoustics.

Quick Configuration

Copy over the sample file (conf/acoustics.ini.sample) to conf/acoustics.ini, and fill in the relevant values. At minimum, you need to adjust the database section, remove the scanner section, set up the RPC system, and set the webauth section to use module=Acoustics::Web::Auth::Simple with field=REMOTE_ADDR.

Explanation of Sections

database

data_source: the DBI connection string. See ‘perldoc DBI’ for too much information.
user: the user for Acoustics to use for the database.
pass: the password for the Acoustics database user.

scanner

Optional:
require_prefix: enforces a prefix for the music to be found. Useful to prevent the scanning of an entire filesystem (or a networked one)!

player

Determines what module and options to use for Acoustics to output sound.

module: The module to use. Valid options: Acoustics::Player::MPlayer
plugins: …
queue: the queue module to use. Valid options: RoundRobin (turn-based on song count) or TimeSlice (turn-based on song length).
max_votes: prevents a user from voting up more than this many songs.

rpc

Selects the RPC module and configuration options for it to communicate with the player. See RPC.

webauth

Provides configuration and selects the module to use to authenticate the web user. See Authentication.

Clone this wiki locally