Tag-based filters (ex: "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 very large datasets
makes use of computed data available on AcousticBrainz. Therefore your music must contain the MusicBrainz Identifier for the recommendation engine to work properly

Subsonic API

For now, the API version implemented is 1.12.0 and has been tested using the official Android application and Ultrasonic.

Please note some commands are not implemented (stars, shares, playlists). As LMS uses metadata tags to organize data, a compatibility mode is used to navigate through the collection using the directory browsing commands.

The Subsonic API is enabled by default.

Installation

Here are the required packages to build on Debian Stretch:

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.

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

make install

This command requires root privileges.

Configuration

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

All other settings are set using the web interface.

It is highly recommended to run LMS as a non root user. Therefore make sure the user has write permissions on the working directory.

Reverse proxy settings

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:5091;
      proxy_read_timeout  120;
    }
}

Running

lms [config_file]

Logs are output in the working directory, in the file 'lms.log'.

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

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