1
0
mirror of https://github.com/SuperBFG7/ympd synced 2024-11-17 11:04:48 +00:00
ympd/README.md
2018-07-09 22:58:25 +01:00

62 lines
2.2 KiB
Markdown

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 and a modernized backend.
![image](https://jcgames.de/stuff/myMPD/screenshots.gif)
UI Components
-------------
- Bootstrap 4: https://getbootstrap.com/
- Material Design Icons: https://material.io/tools/icons/?style=baseline
- Bootstrap Native: http://thednp.github.io/bootstrap.native/
Backend
-------
- Mongoose: https://github.com/cesanta/mongoose
- Frozen: https://github.com/cesanta/frozen
Dependencies
------------
- libmpdclient 2: http://www.musicpd.org/libs/libmpdclient/
- cmake 2.6: http://cmake.org/
Unix Build Instructions
-----------------------
1. install dependencies. cmake and libmpdclient (dev) are available from all major distributions.
2. build and install it ```cd /path/to/src; ./mkrelease.sh```
3. Link your mpd music directory to ```/usr/share/mympd/htdocs/library``` and put ```folder.jpg``` files in your album directories
4. Configure your mpd with http stream output to use the local player
Run flags
---------
```
Usage: ./mympd [OPTION]...
-h, --host <host> connect to mpd at host [localhost]
-p, --port <port> connect to mpd at port [6600]
-w, --webport <port> listen port for webserver [80]
-S, --ssl enable ssl
-W, --sslport listen port for ssl webserver [443]
-C, --sslcert filename for ssl certificate [/etc/mympd/server.pem]
-K, --sslkey filename for ssl key [/etc/mympd/server.key]
-s, --streamport <port> connect to mpd http stream at port [8000]
-u, --user <username> drop priviliges to user after socket bind
-m, --mpdpass <password> specifies the password to use when connecting to mpd
-i, --coverimage <filename> filename for coverimage [folder.jpg]
-t, --statefile <filename> filename for mympd state [/var/lib/mympd/mympd.state]
-v, --version get version
--help this help
```
Copyright
---------
ympd: 2013-2014 <andy@ndyk.de>
myMPD: 2018 <mail@jcgames.de>