Emacs library to communicate with Music Player Daemon (MPD, https://www.musicpd.org/), a flexible, powerful, server-side application for playing music.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Damien Cassou cfb18f96e3 Merge branch 'add-missing-docstrings' of mpdel/libmpdel into master 1 week ago
test Bug fix: don't add albums using `addid` 2 weeks ago
.drone.yml Add .drone.yml as Drone is the CI on gitea.petton.fr 1 month ago
.gitignore Fix comment in Makefile 1 year ago
.gitlab-ci.yml Replace emake with makel 1 year ago
COPYING Initial version 1 year ago
Makefile Makefile: Update makel to 0.5.3 1 month ago
README.org README: Remove org markup that is not supported by gitea renderer 1 month ago
libmpdel.el Add missing docstrings 1 week ago

README.org

libmpdel

MELPA Stable MELPA

Summary

The package libmpdel is an Emacs library client to communicate with Music Player Daemon (MPD), a flexible, powerful, server-side application for playing music. For a user interface, please check the mpdel project instead (which depends on this one).

Installing

Get libmpdel from melpa or melpa stable. You can also clone the git repository.

You need to install and (quickly) configure an MPD server if you don't have any yet. Don't worry, that's simple and you won't regret it.

Usage

This code is a library and is meant for Emacs Lisp developers. The source code is well documented and organized in sections. Please have a look at it.

Entities

The library is implemented around a set of entities.

*Name* *Type* *Fields* *Description*
song structure name, album, file, …
album structure name, artist
artist structure name
stored-playlist structure name A named user-specified sequence of songs
search-criteria structure type, what Read the protocol documentation
filter structure text Read the protocol documentation
artists symbol none Represent the set of all artists
albums symbol none Represent the set of all albums
current-playlist symbol none Represent the currently played sequence of songs
stored-playlists symbol none Represent the set of all stored playlists

Many functions in MPDel work on several kinds of entities (e.g., ~libmpdel-list~). These methods are implemented with cl-defgeneric~ and ~cl-defmethod.

License

See COPYING. Copyright (c) 2018 Damien Cassou.

Donate using Liberapay