OpenSource-Hub
L

LMS - Lightweight Music Server

1.6k stars·System Optimization·SHA-256 checksum verified

A self-hosted, lightweight music streaming server with advanced metadata support and recommendation engine.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Lightweight self-hosted music server with rich metadata and recommendation engine.

Core Features

  • Subsonic/OpenSubsonic API support
  • Multi-valued tags: genre, mood, artists
  • Artist relationships: composer, conductor, etc.
  • Release group support for album versions
  • MusicBrainz identifiers for duplicate handling

What It Can't Do

  • 1) Recommendation engine may slow down UI with large libraries; disable in settings. 2) Requires well-structured tags (Picard recommended). 3) Built-in web UI is basic; use third-party Subsonic clients for advanced playback.

Use Cases

  • Personal cloud music library accessible from any browser
  • Advanced browsing and discovery for well-tagged collections
  • Alternative to Navidrome/Airsonic with richer metadata and recommendations

Detailed Introduction

LMS is a self-hosted music streaming server that lets you access your music collection from anywhere via a web interface. It supports the Subsonic/OpenSubsonic API, multi-valued tags (genre, mood, artists), artist relationships, release groups, MusicBrainz identifiers, ListenBrainz scrobbling and love feedback sync, a recommendation engine, multi-library, ReplayGain, audio transcoding, user management with multiple auth backends, podcasts, playlists, lyrics, and jukebox mode. It offers tag-based filtering, artist info folders, and extensive keyboard shortcuts. LMS works best with properly tagged libraries (e.g., using Picard) to fully leverage its metadata capabilities.

Troubleshooting & FAQ (2)

Troubleshooting
How to fix missing icons (404 on font-awesome.min.css) in LMS web UI after installing on Ubuntu?

This occurs when Wt is installed with a prefix other than /usr (e.g., /usr/local) but lms.conf expects resources in /usr/share/Wt/resources. Update the 'wt-resources' setting in lms.conf to match the actual installation directory, e.g., '/usr/local/share/Wt/resources'. Alternatively, rebuild Wt with -DCMAKE_INSTALL_PREFIX=/usr to match the default configuration.

GitHub Issue #828
Troubleshooting
How to use a non-UUID token as ListenBrainz API key in LMS?

LMS previously enforced that ListenBrainz API tokens be UUIDs, but this constraint was removed entirely. You can now use any alphanumeric token, including those generated by alternative scrobble servers like Koito. Simply enter the token in the LMS settings; no special configuration is required.

GitHub Issue #825

Tags

music-streamingself-hostedsubsonic-apimetadatarecommendation-enginelightweight

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

1. Download the package or Docker image from GitHub Releases

4

2. Configure media directory and database (default SQLite) as in INSTALL.md

5

3. Start the service, open web UI, create admin account

Install Guide
  1. 1. Download the package or Docker image from GitHub Releases
  2. 2. Configure media directory and database (default SQLite) as in INSTALL.md
  3. 3. Start the service, open web UI, create admin account
File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Delete the installation directory or Docker container. Remember to back up database and config.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseGPL-3.0
Last Updated2026-06-26 15:15:19
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

2 FAQs

Similar Projects