Skip to content
main
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
lib
 
 
 
 
web
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Leafplayer

Leafplayer is a minimalistic music streaming server with a focus on performance and a slick UI. It enables you to listen to your private music collection from anywhere in the world.

01

See more screenshots

Installation

Install using Docker

After installing Docker, use the following command to get up and running. Set APP_SECRET to a secure, random string. Also, don't forget to adjust the /path/to/your/music directory.

sudo 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

You should now see the Leafplayer web interface by navigating to localhost:3000 in your browser.

To create an initial admin account, run the following command.

sudo docker exec leafplayer node main.js \
  users:add \
  --username admin \
  --password supersecret

You can now add your music directory and start a music scan.

sudo docker exec leafplayer node main.js \
  library:dir --add /music

sudo docker exec leafplayer node main.js \
  library:scan

Note, that the setup above will only allow you to access your Leafplayer instance from your local machine. When deploying a live instance, you should setup a reverse proxy to handle TLS. See for example Caddy for a simple-to-use solution.

caddy reverse-proxy --from music.yourdomain.home --to localhost:3000

Install using NodeJS on Linux

Instructions will be added soon.

Contributing

I'm searching for contributors on this project, hit me up if you're interested.

Screenshots

02 03

About

Leafplayer is a minimalistic music streaming server with a focus on performance and a slick UI. It enables you to listen to your private music collection from anywhere in the world.

Topics

Resources

Packages

No packages published

Languages