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

Standalone MPD Web GUI written in C, utilizing Websockets and Bootstrap/JS. Updated and somewhat fixed fork.

Go to file

jcorporation e87c5436f5 Removed not working dirble support Removed jquery sorttable dependency Reworked html template Reworked notifications Repaired search		2018-05-23 00:07:34 +01:00
cmake	initial mongoose checkin	2014-03-08 12:30:48 +01:00
contrib	Removed not working dirble support	2018-05-23 00:07:34 +01:00
htdocs	Removed not working dirble support	2018-05-23 00:07:34 +01:00
src	Removed not working dirble support	2018-05-23 00:07:34 +01:00
tools	release build now installs assets to prefix	2014-11-11 21:13:11 +01:00
.travis.yml	update travis image	2018-01-22 04:45:59 +01:00
CMakeLists.txt	Merge pull request #16 from ffontaine/master	2018-03-12 17:51:19 +01:00
Dockerfile	Adds a Dockerfile for building a lightweight Docker container based on alpine	2017-12-23 12:11:47 -08:00
LICENSE	replaces libwebsockets with mongoose, changed licese to gpl	2014-03-08 12:30:49 +01:00
README.md	Removed not working dirble support	2018-05-23 00:07:34 +01:00
ympd.1	Update documentation for new option	2017-02-18 11:51:03 -05:00

README.md

myMPD

myMPD is a lightweight MPD web client that runs without a dedicated webserver or interpreter. It's tuned for minimal resource usage and requires only very litte dependencies. myMPD is a fork of ympd.

This fork provides a reworked ui based on Bootstrap 4.

UI Components

Bootstrap 4: https://getbootstrap.com/
Bootstrap Notify: http://bootstrap-notify.remabledesigns.com/
Bootstrap Slider: https://github.com/seiyria/bootstrap-slider
Material Design Icons: https://material.io/tools/icons/?style=baseline
Sammy.js: http://sammyjs.org/

Dependencies

libmpdclient 2: http://www.musicpd.org/libs/libmpdclient/
cmake 2.6: http://cmake.org/
OpenSSL: https://www.openssl.org/

Unix Build Instructions

install dependencies. cmake, libmpdclient (dev), and OpenSSL (dev) are available from all major distributions.
create build directory cd /path/to/src; mkdir build; cd build
create makefile cmake .. -DCMAKE_INSTALL_PREFIX:PATH=/usr -DWITH_DYNAMIC_ASSETS=ON -DCMAKE_BUILD_TYPE=RELEASE
build make
install sudo make install or just run with ./ympd
Link your mpd music directory to /path/to/src/htdocs/library and put folder.jpg files in your album directories

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]
 -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"

Copyright

ympd: 2013-2014 andy@ndyk.de myMPD: 2018 mail@jcgames.de