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.
jao 95cb45ecea Merge branch 'master' of jao/libmpdel into master 1 month ago
test Release 1.2.0 1 month ago
.drone.yml Add .drone.yml as Drone is the CI on gitea.petton.fr 4 months ago
.gitignore New libmpdel-directory datatype 2 months ago
.gitlab-ci.yml Replace emake with makel 1 year ago
COPYING Initial version 2 years ago
Makefile Makefile: Update makel to 0.5.3 3 months ago
README.org New libmpdel-directory datatype 2 months ago
libmpdel-directory.el Release 1.2.0 1 month ago
libmpdel.el Alternative album listing implementation 1 month 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
directory structure name, path
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
directories symbol none Represent all directories in libmpdel-music-directory
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