Emacs library to communicate with Music Player Daemon (MPD, https://www.musicpd.org/), a flexible, powerful, server-side application for playing music. https://github.com/mpdel/libmpdel
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 0ccf76c860 Merge pull request 'Add libmpdel-get-state to run handler after state is get' (#31) from vonfry/libmpdel:fix/play-pause into master 1 year ago
test display file name if missing song name metadata 1 year ago
.drone.yml Use Silex images 2 years ago
.gitignore New libmpdel-directory datatype 3 years ago
.gitlab-ci.yml Replace emake with makel 4 years ago
COPYING Initial version 5 years ago
Makefile Update makel to v0.6.0 2 years ago
README.org gitlab ⇒ gitea 2 years ago
libmpdel-directory.el Update Copyright 1 year ago
libmpdel.el Add libmpdel-get-state to run handler after state is get 1 year ago

README.org

libmpdel

<a href="https://stable.melpa.org/#/libmpdel"> <img alt="MELPA Stable" src="https://stable.melpa.org/packages/libmpdel-badge.svg"/> </a> <a href="https://melpa.org/#/libmpdel"> <img alt="MELPA" src="https://melpa.org/packages/libmpdel-badge.svg"/> </a> <a href="https://drone.petton.fr/mpdel/libmpdel"> <img src="https://drone.petton.fr/api/badges/mpdel/libmpdel/status.svg" /> </a> </p>

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.

<a href="https://liberapay.com/DamienCassou/donate"> <img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"> </a>