/myMPD

myMPD is a standalone and mobile friendly web mpd client with a tiny footprint and advanced features.

Primary LanguageCGNU General Public License v3.0GPL-3.0

image

release License: GPL v3

myMPD is a standalone and lightweight web-based MPD client. It's tuned for minimal resource usage and requires only very few dependencies. Therefore myMPD is ideal for raspberry pis and similar devices.

The backend is written in C and has no dependencies to external databases or webservers. The configuration is stored in plain text files and all the data is pulled on demand from MPD. The MPD database is the only source of truth for myMPD.

The frontend is mobile friendly, written as a PWA and offers on all devices the same functionality. It communicates over AJAX and websockets using the json-rpc 2 protocol.

myMPD also integrates extended features like an advanced jukebox mode, timers, triggers and smart playlists. With the integrated lua interpreter myMPD functions can also be scripted.

Screenshots

image

Features

To use all myMPD functions you should use the latest stable MPD version.

Contribution

myMPD is in active development. If you like myMPD, you can help to improve it (no programming skills are required).

  • Star this repository to make it more popular.
  • Help to improve myMPD.
  • Use issues for bug reports only.
  • Use discussion for feature requests, questions and general feedback.
  • If I accept a feature request, I will open an issue and assign a milestone to it.
  • Consider donating a coffee to this project.

Installation

myMPD should run on all current linux distributions. There are four ways to install myMPD:

  1. Use a linux distribution that delivers a myMPD package - the easiest way: Distributions with myMPD
  2. Use a prebuild package: Prebuild-Packages
  3. Use the docker image: Docker
  4. Use the build.sh script to compile myMPD: Building myMPD

Run

On the first startup myMPD reads some environments variables and tries to autodetect the MPD connection configuration.

Usage: mympd -h

Documentation

For further information on installation and configuration, see the myMPD documentation

Copyright

2018-2022 Juergen Mang mail@jcgames.de

myMPD was originally a fork of ympd, but it has evolved into a much more featurefull MPD client.