denite-mpc

Neovim/Vim8 MPD client for browsing your music library by categories and filters with the dark powered denite.nvim asynchronous interface framework.

Features

No dependencies (except denite.nvim)
Fast socket communication with MPD (no need for mpc)
Asynchronous denite.nvim gathering
Add / play / replace selected
Customizable formatting with special percentage treatment
Multiple query filters
Caching for large libraries

Screenshot

Installation

Requirements

Vim or Neovim
denite.nvim
Python 3.4 or later

Use your favorite plugin manager, mine is dein.vim, e.g.:

call dein#add('rafi/vim-denite-mpc', {'on_source': 'denite.nvim'})

Usage

:Denite mpc:<tag>[:filterby:query:...]

Here are a few examples:

Command	Description
`:Denite mpc:date`	Browse library by dates
`:Denite mpc:album:date:2016`	Browse albums, but just for year 2016
`:Denite mpc:artist:genre:Rock`	List all Rock (case-sensitive!) artists
`:Denite mpc:title:album:Blonde\ on\ Blonde`	List all track titles from an album
`:Denite mpc:album:genre:Electronic:date:2007`	You can combine filters

Manage Playlist

You can view your current playlist:

:Denite mpc:playlist

Actions

add - Add selected items to playlist
play - Add items and start playing
replace - Clear playlist, add items, and start playing

The default action is play.

Configuration

call denite#custom#var('mpc', 'host', 'localhost')
call denite#custom#var('mpc', 'port', 6600)
call denite#custom#var('mpc', 'timeout', 5.0)
call denite#custom#var('mpc', 'default_view', 'artist')

The default values are shown.

Customize

Example of changing formatting:

call denite#custom#var('mpc', 'formats', {
  \     'date': '{date:^100}',
  \     'genre': '{genre:>10}',
  \     'artist': '{artist}',
  \     'album': '{albumartist} - {album} ({date})',
  \     'albumartist': '{albumartist} - {album} ({date})',
  \     'title': '{track} {artist} - {title}',
  \     'playlist': '{artist:19.19} {track:4.4} {title:25.25} '
  \                 '{album:>20.20} {date:^4.4} {genre}'
  \ })

The formatting is done via str.format(), when using padding or truncating, denite-mpc will transform your integers into percentage to leverage win-width.

Planned Features

Replace playlist with random songs
Playlist items (append/delete/replace)
Playlists management (create/delete/load)

Credits & Contribution

This plugin was developed by Rafael Bodill under the MIT License.

Without Shougo this wouldn't be possible.

Pull requests are welcome.