selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
leafplayer logo

Self-host leafplayer

v1.3.0

Minimalistic self-hosted music streaming server

ReleaseOpen SourceMIT
Updated9 hours ago
LanguageTypescript
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
160
Port
3000 (HTTP web interface)
Docker
paulschwoerer/leafplayer
Install with Docker
Desktop interface showing music libraryDesktop interface second viewNight mode dark themeMobile responsive interface

What is leafplayer?

This minimalistic music streaming server lets you self-host your private music collection with a clean, responsive web interface. It extracts artwork from media tags, supports multiple users who register via invite codes, and includes fast search plus a night mode theme. Deployment options include a Docker image or a manual Linux install using Node.js 14 or 16. The server stores data in /var/lib/leafplayer and listens on port 3000. Configuration uses environment variables like APP_SECRET for session security. Licensed under MIT, the latest release is v1.3.0 from February 2022.

Should you self-host leafplayer?

leafplayer scores 43/100 on selfhost.directory (how scoring works) and ranks #37 of 59 in Music Streaming. It has 160 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is koel (75/100, 17 320 stars). It scores higher overall, so compare the two before you pick. See leafplayer vs koel side by side.

Features

  • Artwork Extraction
  • Fast search
  • Library Management
  • Multiple user accounts
  • Music Streaming
  • Native Media Controls
  • Night mode

leafplayer README

How to install leafplayer

Install leafplayer with Docker

Docker
Environment variables
APP_SECRET

docker run -d
-e "APP_SECRET=supersecret"
-v "/path/to/your/music:/music:ro"
-v "leafplayer-storage:/var/lib/leafplayer"
-p "127.0.0.1:3000:3000"
--name leafplayer
paulschwoerer/leafplayer

Replace supersecret with a secure random string and adjust the music directory path

How to configure leafplayer

  • APP_SECRETSecret key for session security, must be a secure random string

    Secret key for session security, must be a secure random string

  • NODE_ENVproductionNode.js environment mode

    Node.js environment mode

leafplayer releases & version history

More in Music Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…