Files
lms/README.md
T

2.4 KiB

LMS - Lightweight Media Server

LMS is a self-hosted media streaming software, released under the GPLv3 license. It allows you to access your music and your videos using an https web interface.

Features

  • Winamp-like interface, suited for large databases
  • Audio/Video transcode for maximum interoperability and low bandwith requirements
  • User management

Please note LMS is still under development and will gain more features in the future.

LMS is written entirely in C++. Therefore, it is suitable to run on embedded devices, where space and/or memory are limited. Please note some media files may require significant CPU usage to be transcoded.

Dependencies

Debian or Ubuntu packages

$ apt-get install g++ autoconf automake libboost-dev libboost-locale-dev libboost-iostreams-dev libboost-log-dev libavcodec-dev libwtdbosqlite-dev libwthttp-dev libwtdbo-dev libwt-dev libmagick++-dev libavcodec-dev libavformat-dev libavutil

Build

$ autoreconf -vfi
$ mkdir build
$ cd build
$ ../configure --prefix=/usr

configure will complain if a mandatory library is missing.

$ make -j 4

Install

$ make install

This command requires root privileges

Running

$ /usr/bin/lms --docroot='/usr/share/lms/docroot/;/resources,/css,/images' --approot=/usr/share/lms/approot --http-address 0.0.0.0 --http-port 5081

It is highly recommended to run LMS as a non root user. The exectuable needs write accesses to the /var/lms/ directory.

Setting up SSL materials (optional)

Here is just a self signed certificate example, you could do use a CA if you want.

Generate a dh file:

$ openssl dhparam -out dh2048.pem 2048

Generate a self signed certificate:

$ openssl req -x509 -out cert.pem -keyout privkey.pem -newkey rsa:4096
$ /usr/bin/lms --docroot='/usr/share/lms/docroot/;/resources,/css,/images' --approot=/usr/share/lms/approot --https-address 0.0.0.0 --https-port 5081 --ssl-certificate cert.pem --ssl-private-key privkey.pem --ssl-tmp-dh dh2048.pem

Depending on your SSL parameters, you may be asked for the PEM passphrase to unlock the private key.

Credits