Trollibox

The hackerspace friendly ~~MPD~~ music player web client.

Features:

Control multiple music players from one webinterface
Support for MPD
Support for Logitech SlimServer and SqueezeBoxes
Track art
Listen to web radio stations
Search-as-you-type for tracks with highlighting
File browser
Album browser
Queue random tracks when the playlist is empty.
Mobile device friendly
Free Open Source Software (GPLv3)

Installing

The following tools are required to build Trollibox:

Golang

To build:

# Download Trollibox
git clone --recurse-submodules https://github.com/polyfloyd/trollibox.git trollibox
cd trollibox

# Build a release version of Trollibox containing all of its assets.
RELEASE=1 ./build.sh

# Copy and edit the configuration
cp config.example.yaml config.yaml
vim config.yaml

# Let's go!
./bin/trollibox -conf config.yaml

Configuring

Copy the example configuration to config.yaml, its default location. If you want to use a custom location for the config file, you should inform Trollibox by using the -conf option. Like this:

trollibox -conf /etc/trollibox.yaml

Inside the configuration file, you will find some options you may need to change.

For Users

Hotkeys

space: toggle playback
>: next track
<: previous track
+: increase volume
-: decrease volume
b: seek backwards in the playing track
f: seek forwards in the playing track
c: clear the yet to be played part of the playlist
1: focus library search
2: focus album browser
3: focus genre/artist browser
4: focus file browser
5: focus streams library
6: focus auto queuer configuration
7: expand player

Queueing Tracks

Tracks may be queued from the browser page using one of the views. Click on a track to append it to the queue.

An asterisk will be displayed next to tracks that have been queued by users. This feature originated at the Bitlair Hackerspace where tracks should not be skipped when they are queued by users.

The Queuer

If the queue runs out of tracks, Trollibox will pick a random track from the library and play it. The selection bias for tracks can be configured by setting one or more rules on the Queuer page.

Such rules consist of simple expressions that evaluate to a boolean value. A track must pass all rules set for it to be eligible for playing.

The matches operation takes a regular expression in Go's regexp format.

Streams

Trollibox has support for HTTP streams. You can create a custom collection using the Streams interface.

Searching

The search view allows you to search the whole library of the current player for tracks whose artist, title or album attributes contain some keywords.

Searching is case insensitive.

A track must match all keywords in order to end up in the results.

The search string is split on each space, unless you escape it with a backslash: foo\ bar.

You can annotate the keywords in your query to search other fields, You can limit a keyword to a single attribute by annotating them like this:

photographer genre:trance

The string photographer will be applied to the default attributes while the genre must match "trance".

Available attributes are:

uri
artist (default)
title (default)
genre
album (default)
albumartist
albumtrack
albumdisc

You can also use the duration attribute with relational operators to filter on whether a track's length is less, greater than or equal to some reference integer.

duration<120
duration>120
duration=120

Q & A

What does the asterisk next to queued tracks indicate?

See Queueing Tracks.

Where is the button to update the library?

There isn't. Trollibox is only a browser/player. Managing the files of the library is out of the scope of this project, which includes updating the player's database.