mirror of
https://github.com/SuperBFG7/ympd
synced 2024-11-04 22:06:16 +00:00
Standalone MPD Web GUI written in C, utilizing Websockets and Bootstrap/JS. Updated and somewhat fixed fork.
.github/ISSUE_TEMPLATE | ||
cmake | ||
contrib | ||
dist | ||
htdocs | ||
src | ||
CMakeLists.txt | ||
LICENSE | ||
mkclean.sh | ||
mkdebug.sh | ||
mkrelease.sh | ||
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 (https://github.com/notandy/ympd).
This fork provides a reworked ui based on Bootstrap 4, a modernized backend and many new features while having the same small footprint as ympd.
Design principles:
- Keep it small and simple
- Uses only mpd as source of truth
- Mobile first UI
- Keep security in mind
Featurelist:
- Control mpd functions (play, pause, etc.)
- Set mpd settings (repeat, random, etc.)
- Browse mpd database by albumartist
- Browse filesystem and playlists
- Queue management
- Playlist management
- Advanced search
- Progressiv Web App enabled
- Local coverart support (Albums and Streams)
- HTTP stream support
- Local playback of mpd http stream (html5 audio api)
- Play statistics and song voting (uses mpd stickers)
- Embedded Webserver (mongoose)
myMPD is work in progress. Bugreportes and feature requests are very welcome.
Screenshots
UI Components
- Bootstrap 4: https://getbootstrap.com/
- Material Design Icons: https://material.io/tools/icons/
- Bootstrap Native: http://thednp.github.io/bootstrap.native/
Backend
- Mongoose: https://github.com/cesanta/mongoose
- Frozen: https://github.com/cesanta/frozen
- inih: https://github.com/benhoyt/inih
Dependencies
- libmpdclient 2: http://www.musicpd.org/libs/libmpdclient/
- OpenSSL: https://www.openssl.org/
Build Dependencies
- cmake 2.6
- libasan3: for debug builds only
- Java: optional for minifying .css and .js files
Unix Build Instructions
- Install dependencies: cmake, libmpdclient (dev), OpenSSL (dev) and Java are available from all major distributions.
- Build and install:
cd /path/to/src; ./mkrelease.sh
. - Link your mpd music directory to
/usr/share/mympd/htdocs/library
and putfolder.jpg
files in your album directories (mkrelease.sh tries to do this for you). - Configure your mpd with http stream output to use the local player.
Run Flags
Usage: ./mympd /etc/mypd/mympd.conf
SSL
- Create ca and certificate
/usr/share/mympd/crcert.sh
(mkrelease.sh does this for you). - Set
ssl=true
in /etc/mympd/mympd.conf (use default certificate under/etc/mympd/ssl/
). - Import
/etc/mympd/ssl/ca/ca.pem
in your browser to trust the certificate. - myMPD redirects http requests to https, ensure that myMPD hostname is resolvable.
Copyright
ympd: 2013-2014 andy@ndyk.de
myMPD: 2018 mail@jcgames.de