steveww/ympd

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

ympd

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

http://www.ympd.org

Dependencies

• libmpdclient 2: http://www.musicpd.org/libs/libmpdclient/
• cmake 2.6: http://cmake.org/

Unix Build Instructions

1. install dependencies, cmake and libmpdclient 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
4. build make
5. install sudo make install or just run with ./ympd

Run flags

Usage: ./ympd [OPTION]...

 -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]
 -a, --artwork [url template] for artwork fetch
 -u, --user <username>      drop priviliges to user after socket bind
 -V, --version              get version
 --help                     this help

Artwork

Provide a template where the artwork may be fetched from:

 http://server/music/%A/%a/cover.jpg

The available substitutions are:

 %A - Artist
 %a - Album
 %T - Title
 %t - track
 %P - Path to track (dirname)
 %% - %

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"

Copyright

2013-2014 andy@ndyk.de