2018-05-22 00:36:05 +01:00
myMPD
2018-07-15 23:41:16 +01:00
=====
2014-01-17 20:03:08 +01:00
2018-05-22 00:36:05 +01:00
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.
2018-07-11 01:01:04 +01:00
myMPD is a fork of ympd (https://github.com/notandy/ympd).
2014-01-17 20:03:08 +01:00
2018-06-14 21:03:20 +01:00
This fork provides a reworked ui based on Bootstrap 4 and a modernized backend.
2014-03-11 20:29:39 +01:00
2018-07-11 01:01:04 +01:00
Design principles:
- Keep it small and simple
- Uses only mpd as source of truth
- Mobile first UI
- Keep security in mind
Featurelist:
2018-07-22 20:04:30 +01:00
- Control mpd functions (play, pause, etc.)
- Set mpd settings (repeat, random, etc.)
- Browse mpd database by albumartist
2018-07-11 01:01:04 +01:00
- Browse filesystem and playlists
- Queue management
2018-07-22 20:04:30 +01:00
- Playlist management
2018-07-11 01:01:04 +01:00
- Advanced search
- Progressiv Web App enabled
- Local coverart support
myMPD is work in progress. Bugreportes and feature requests are very welcome. Please use the issues function from github (https://github.com/jcorporation/myMPD/issues).
Planed functions are managed in a github project (https://github.com/jcorporation/myMPD/projects/1).
2018-06-04 00:30:32 +02:00
![image ](https://jcgames.de/stuff/myMPD/screenshots.gif )
2018-06-04 00:08:41 +02:00
2018-05-22 00:36:05 +01:00
UI Components
-------------
- Bootstrap 4: https://getbootstrap.com/
2018-07-10 23:57:45 +01:00
- Material Design Icons: https://material.io/tools/icons/
2018-07-02 23:02:02 +01:00
- Bootstrap Native: http://thednp.github.io/bootstrap.native/
2014-01-17 20:03:08 +01:00
2018-05-24 19:35:11 +01:00
Backend
-------
- Mongoose: https://github.com/cesanta/mongoose
- Frozen: https://github.com/cesanta/frozen
2014-01-17 20:03:08 +01:00
Dependencies
------------
- libmpdclient 2: http://www.musicpd.org/libs/libmpdclient/
- cmake 2.6: http://cmake.org/
2018-07-10 23:57:45 +01:00
- OpenSSL: https://www.openssl.org/
2018-07-16 22:39:32 +01:00
- libasan3 (for debug builds only)
2014-01-17 20:03:08 +01:00
Unix Build Instructions
-----------------------
2018-07-15 23:41:16 +01:00
1. Install dependencies: cmake, libmpdclient (dev) and OpenSSL (dev) are available from all major distributions.
2. Build and install: ```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 (mkrelease.sh tries to do this for you).
4. Configure your mpd with http stream output to use the local player.
2014-01-17 20:03:08 +01:00
2014-03-18 01:37:33 +01:00
Run flags
---------
```
2018-05-24 18:50:05 +01:00
Usage: ./mympd [OPTION]...
2014-03-18 01:37:33 +01:00
2018-07-15 23:26:59 +01:00
-h, --mpdhost < host > connect to mpd at host [localhost]
-p, --mpdport < port > connect to mpd at port [6600]
-m, --mpdpass < password > specifies the password to use when connecting to mpd
2018-06-21 23:15:54 +01:00
-w, --webport < port > listen port for webserver [80]
2018-07-09 22:58:25 +01:00
-S, --ssl enable ssl
2018-07-15 23:26:59 +01:00
-W, --sslport < port > listen port for ssl webserver [443]
-C, --sslcert < filename > filename for ssl certificate [/etc/mympd/ssl/server.pem]
-K, --sslkey < filename > filename for ssl key [/etc/mympd/ssl/server.key]
2018-05-24 18:50:05 +01:00
-s, --streamport < port > connect to mpd http stream at port [8000]
2016-09-11 17:54:25 +02:00
-u, --user < username > drop priviliges to user after socket bind
2018-05-27 15:13:42 +01:00
-i, --coverimage < filename > filename for coverimage [folder.jpg]
2018-06-21 18:28:07 +01:00
-t, --statefile < filename > filename for mympd state [/var/lib/mympd/mympd.state]
2018-05-29 23:28:11 +02:00
-v, --version get version
2016-09-11 17:54:25 +02:00
--help this help
2014-03-18 01:37:33 +01:00
```
2018-07-10 22:58:48 +01:00
SSL
---
2018-07-15 23:41:16 +01:00
1. Create ca and certificate ```/path/to/src/contrib/crcert.sh` `` (mkrelease.sh do this for you).
2018-07-15 23:43:34 +01:00
2. Start myMPD with ```-S` `` (use default certificate under ` ``/etc/mympd/ssl/` ``).
2018-07-15 23:41:16 +01:00
3. Import ```/etc/mympd/ssl/ca/ca.pem` `` in your browser to trust the certificate.
4. myMPD redirects http requests to https, ensure that myMPD hostname is resolvable.
2018-07-10 22:58:48 +01:00
2014-01-17 20:03:08 +01:00
Copyright
---------
2018-05-22 00:36:05 +01:00
ympd: 2013-2014 < andy @ndyk .de >
2018-05-24 17:26:07 +01:00
2018-05-22 00:36:05 +01:00
myMPD: 2018 < mail @jcgames .de >