Home » LMS – Lightweight Music Server

LMS – Lightweight Music Server

LMS – Access your self-hosted music using a web interface. GPL-3.0 C++

LMS is a self-hosted music streaming software: access your music collection from anywhere using a web interface!

demo instance is available. Note the administration panel is not available.

Main features

  • Low memory requirements: the demo instance runs on a Raspberry Pi Zero W
  • Recommendation engine
  • Audio transcode for maximum interoperability and low bandwith requirements
  • Multi-value tags: artists, genres, composers, lyricists, moods, …
  • MusicBrainz Identifier support to handle duplicated artist and release names
  • ListenBrainz support for:
    • Scrobbling and synchronizing listens
    • Synchronizing ‘love’ feedbacks
  • ReplayGain support
  • User management, with several authentication backends, see Deployment
  • Subsonic API

Music discovery

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

  • Tag-based filters (ex: RockMetal and AggressiveElectronic and Relaxed, …)
  • Recommendations for similar artists and albums
  • Radio mode, based on what is in the current playqueue
  • Searches in album, artist and track names (including sort names)
  • Starred Albums/Artists/Tracks
  • Various tags to help you filter your music: moodalbummoodalbumgenrealbumgrouping, …
  • Random/Starred/Most played/Recently played/Recently added for Artist/Albums/Tracks, allowing you to search for things like:
    • Recently added Electronic artists
    • Random Metal and Aggressive albums
    • Most played Relaxed tracks
    • Starred Jazz albums

The recommendation engine uses two different sources:

  1. Tags that are present in the audio files
  2. Acoustic similarities of the audio files, using a trained Self-Organizing Map

Notes on the self-organizing map:

  • training the map requires significant computation time on large collections (ex: half an hour for 40k tracks using a Core i5)
  • audio acoustic data is pulled from AcousticBrainz. Therefore your audio files must contain the recording MusicBrainz Identifier.
  • to enable the audio similarity source, you have to enable it first in the administration panel.

Subsonic API

The API version implemented is 1.16.0 and has been tested on Android using Subsonic PlayerUltrasonic and DSub. Since LMS uses metadata tags to organize music, a compatibility mode is used to browse the collection when using the directory browsing commands. The Subsonic API is enabled by default.

Note: since LMS may store hashed and salted passwords or may forward authentication requests to external services, it cannot handle the token authentication method. You may need to check your client to make sure to use the password authentication method.

About tags

LMS relies exclusively on tags to organize your music collection.


You can specify the tags you want to be used to filter your collection. By default, GENREALBUMGROUPINGMOOD and ALBUMMOOD tags are used. In the administration panel, you can set whatever tags you want, even custom tags.

Multiple album artists

LMS requires the ALBUMARTISTS and ALBUMARTISTSSORT tags to properly handle multiple album artists on the same album. As they are a custom tags, you may need to setup your favorite tagger to add them.

Note: if you use Picard, add the following script to include these tags:


Keyboard shortcuts

  • Play/pause: Space
  • Previous track: Ctrl + Left
  • Next track: Ctrl + Right

Security considerations

Wt (the web framework used) has some built-in security measures, but LMS also has some too:

  • to mitigate brute force login attempts, LMS uses an internal login throttler based on the client IP address. The Client-IP or X-Forwarded-For headers are used to determine the real IP adress, so make sure to properly configure your reverse proxy to filter or even erase the values (see example in INSTALL.md).
  • all passwords are stored hashed and salted using bcrypt
  • all the resources relative to the music collection (tracks, covers, etc.) are private to an anthenticated session


See INSTALL.md file.

Leave a Reply

Your email address will not be published. Required fields are marked *