Skip to content
This repository has been archived by the owner on Apr 7, 2023. It is now read-only.
/ vim-denite-mpc Public archive

denite-mpc is a source for browsing and playing your MPD music library and managing playlists.

Notifications You must be signed in to change notification settings

rafi/vim-denite-mpc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 

Repository files navigation

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

vim-denite-mpc screenshot

Installation

Requirements

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.

About

denite-mpc is a source for browsing and playing your MPD music library and managing playlists.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages