Low memory requirement (the demo instance runs on a Raspberry Pi3B+, using less than 10% of total memory even when transcoding)
User management
Recommendation engine
Audio transcode for maximum interoperability and low bandwith requirements
Persistent play queue across sessions
Subsonic API
Album artist
Multi-value tags (artists, genres, ...)
Custom tags (ex: mood, genre, albummood, albumgrouping, ...)
MusicBrainzID support to handle duplicated artist and release names
Playlists (only using Subsonic API for now)
Starred Album/Artist/Tracks (only using Subsonic API for now)
Systemd integration

Recommendation engine

LMS provides several ways to help you find the music you like:

Tag-based filters (ex: Rock, Metal and Aggressive, Electronic and Relaxed, ...)
Recommendations for similar artists and albums
Radio mode
Searches in album, artist and track names
Most played/Recently added music

The recommendation engine makes use of Self-Organizing Maps.
Please note this engine:

may require some significant computation time on large collections (ex: half a hour per 40k tracks)
makes use of computed data available on AcousticBrainz. Therefore your music files must contain the MusicBrainz Identifier for the recommendation engine to work properly (otherwise, only tag-based recommendations are provided)

Subsonic API

The API version implemented is 1.12.0 and has been tested on Android using the official application, Ultrasonic and DSub.

Since LMS uses metadata tags to organize music, a compatibility mode is used to navigate through the collection using the directory browsing commands.

The Subsonic API is enabled by default.

Installation

This installation process and the default values of the configuration file and the systemd service file have been written for Debian Stretch.

Therefore, you may have to adapt commands and/or paths in order to fit to your distribution.

Build dependencies

apt-get install g++ autoconf automake libboost-filesystem-dev libboost-system-dev libavcodec-dev libavutil-dev libavformat-dev libav-tools libmagick++-dev libpstreams-dev libconfig++-dev libpstreams-dev ffmpeg libtag1-dev

You also need wt4, that is not packaged yet on Debian. See installation instructions. Due to memory limitations, you may need to build Wt4 in Release mode if you want to compile it natively on a Raspberry Pi3B+.

Build

Get the latest stable release and build it this way:

git clone https://github.com/epoupon/lms.git lms
cd lms
autoreconf -vfi
mkdir build
cd build
../configure --prefix=/usr --sysconfdir=/etc

configure will report any missing library.

make

Note: you can use make -jN to speed up compilation time (N is the number of compilation workers to spawn)

Deployment

The following commands require root privileges.

make install

In order to customize the installation directories, you have to:

use the following options of the configure script: ** --prefix (default to /usr/local) ** --sysconfigdir (/default to /usr/local/etc) ** --with-systemdunitdir (default to /lib/systemd/system)
edit the /etc/lms.conf file
edit the /lib/systemd/system/lms.service file

Create a dedicated lms system user:

useradd --system lms

Create working directories and give access to the lms user:

mkdir /var/lms
touch /var/log/lms.log
touch /var/log/lms.access.log
chown lms:lms /var/lms /var/log/lms.log /var/log/lms.access.log

Configuration

LMS uses a configuration file, installed in '/etc/lms.conf'. It is recommended to edit this file and change relevant settings (listen address, listen port, working directory, Subsonic API activation, ...)

All other settings are set using the web interface.

Reverse proxy settings

LMS is shipped with an embedded web server, but it is recommended to deploy behind a reverse proxy. You have to set the 'behind-reverse-proxy' option to 'true' in the configuration file.

Here is an example to make LMS properly work on myserver.org using nginx.

server {
    listen 80;

    server_name myserver.org;

    access_log            /var/log/nginx/myserver.access.log;

    proxy_request_buffering off;
    proxy_buffering off;
    proxy_buffer_size 4k;

    location / {

      proxy_set_header        Host $host;
      proxy_set_header        X-Real-IP $remote_addr;
      proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header        X-Forwarded-Proto $scheme;

      proxy_pass          http://localhost:5082;
      proxy_read_timeout  120;
    }
}

Running

service lms start

Logs are output in /var/log/lms.log and /var/log/lms.access.log

To connect to LMS, just open your favorite browser and go to http://localhost:5082

To make LMS run automatically during startup:

service lms enable

Credits

Wt (http://www.webtoolkit.eu/)
bootstrap3 (http://getbootstrap.com/)
ffmpeg project (https://ffmpeg.org/)
Magick++ (http://www.imagemagick.org/Magick++/)
MetaBrainz (https://metabrainz.org/)
Bootstrap Notify: https://github.com/mouse0270/bootstrap-notify