1
0
mirror of https://github.com/SuperBFG7/ympd synced 2024-12-25 02:20:27 +00:00
ympd/README.md

2.1 KiB

Build Status ympd

Standalone MPD Web GUI written in C, utilizing Websockets and Bootstrap/JS

This fork supports display of coverimages. Link your mpd music directory to /path/to/src/htdocs/library and put folder.jpg files in your album directories

http://www.ympd.org

ScreenShot

Dependencies

Unix Build Instructions

  1. install dependencies. cmake, libmpdclient (dev), and OpenSSL (dev) are available from all major distributions.
  2. create build directory cd /path/to/src; mkdir build; cd build
  3. create makefile cmake .. -DCMAKE_INSTALL_PREFIX:PATH=/usr -DWITH_DYNAMIC_ASSETS=ON -DCMAKE_BUILD_TYPE=RELEASE
  4. build make
  5. install sudo make install or just run with ./ympd

Run flags

Usage: ./ympd [OPTION]...

 -D, --digest <htdigest>       path to htdigest file for authorization
                               (realm ympd) [no authorization]
 -h, --host <host>             connect to mpd at host [localhost]
 -p, --port <port>             connect to mpd at port [6600]
 -w, --webport [ip:]<port>     listen interface/port for webserver [8080]
 -d, --dirbletoken <apitoken>  Dirble API token
 -u, --user <username>         drop priviliges to user after socket bind
 -V, --version                 get version
 --help                        this help

SSL Support

To run ympd with SSL support:

  • create a certificate (key and cert in the same file), example:
# openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 1000 -nodes
# cat key.pem cert.pem > ssl.pem
  • tell ympd to use a webport using SSL and where to find the certificate:
# ./ympd -w "ssl://8081:/path/to/ssl.pem"

Dirble support

  1. Get an API-key from http://dirble.com
  2. Add the key at var TOKEN = "";, in mpd.js.

2013-2014 andy@ndyk.de