Emacs user interface for Music Player Daemon (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 1707f11407 Initial README 3 years ago
media Initial README 3 years ago
test Refactor how MPD state is defined 4 years ago
.gitignore Add a README 8 years ago
.travis.yml Require Emacs 25.1 and test for it on Travis 3 years ago
COPYING Initial README 3 years ago
Makefile * Makefile: Add missing default rule 3 years ago
README.org Initial README 3 years ago
ivy-mpdel.el Require Emacs 25.1 and test for it on Travis 3 years ago
libmpdel.el Require Emacs 25.1 and test for it on Travis 3 years ago
mpdel-mode.el * mpdel-mode.el: Cleaning 3 years ago
mpdel-playlist.el Require Emacs 25.1 and test for it on Travis 3 years ago
mpdel-song.el Require Emacs 25.1 and test for it on Travis 3 years ago

README.org

MPDel

Summary

MPDel is an Emacs client for Music Player Daemon (MPD), a flexible, powerful, server-side application for playing music. MPDel provides playback control, completion-based search within your music database and current and stored playlist manipulation.

This is a screenshot of the current playlist with the currently-playing song:

/tangrammer/mpdel/src/commit/1707f1140719c4dcaf5ddf35516f39946e19a7f5/media/mpdel-playlist.png

You can navigate your music database and add songs to playlists with a completion:

/tangrammer/mpdel/src/commit/1707f1140719c4dcaf5ddf35516f39946e19a7f5/media/ivy-mpdel.png

MPDel can show information about the currently playing song or any other song:

/tangrammer/mpdel/src/commit/1707f1140719c4dcaf5ddf35516f39946e19a7f5/media/mpdel-song.png

Installing

Clone this git repository and install ivy (you don't need to use ivy as Emacs' completion system, just have it installed). I will ask to get MPDel inside melpa.

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.

Using

Start by adding these lines to your init.el file:

  (add-to-list 'load-path "~/.emacs.d/lib/mpdel")
  (require 'mpdel-mode)
  (mpdel-mode)
  (mpdel-setup)

Then, press C-x Z p to show the current playlist. The C-x Z global prefix is configurable with mpdel-prefix-key:

  (setq mpdel-prefix-key (kbd "C-. z"))

Adding songs to the current playlist

You can add songs to the playlist by typing a in the current playlist or by typing C-x Z a everywhere in Emacs. At this point, the minibuffer contains a list of artists in the database. You can add all songs from any artist by selecting the artist and pressing M-o a. You can also browse to the artist's albums by typing RET (i.e., enter). Add a complete album to the current playlist by typing M-o a or go to the album's songs by typing RET. Beyond a after M-o, you can type r (replace whole playlist by selection) or P (add to a stored playlist).

Global key bindings

Anywhere in Emacs, if you activate mpdel-mode, you have access to set of key bindings to control your music. The following key bindings must all be prefixed by mpdel-prefix-key's value (C-x Z by default):

Binding Action
SPC play / pause
S display current song
a navigate your database
p open current playlist
l navigate a stored playlist
P open a stored playlist
] start playing next song
[ start playing previous song

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>