vim-cmus

vim-cmus: cmus directly from vim/neovim.

cmus is an small, fast, no nonsense and powerful console music player for unix-like operating systems.

This plugin helps you to control cmus right from your vim/neovim/gvim/macvim session.

features

• vim-cmus is a single vim script and does not depend on python or any other runtime (new versions do not need python as requirement anymore)
• shows meta/tag information of current file/stream of cmus, including: stream info, title, artist, album, track number, date, file name, ...
• supports control commands: previous, play, pause, stop and next
• supports setting aaa_mode: all, album and artist

screen shots

:Cmus as a command, shows an interactive menu:

:CmusCurrent to echo current file playing by cmus:

or current stream playing by cmus:

or

installation

by your favourite vim plugin manager:

• vim-plug

" cmus remote control
Plug 'azadkuh/vim-cmus'

• vundle

" cmus remote control
Plugin 'azadkuh/vim-cmus'

obviously you need cmus itself to be installed. to check it, please try:

# must be accessible from your ${PATH}
$> cmus-remote -Q

command list

at the moment following commands are implemented:

• :Cmus shows an interactive menu to send a command to cmus remotely

• :CmusCurrent shows the information of current song

• :CmusPrevious

• :CmusPlay

• :CmusPause

• :CmusStop

• :CmusNext

You can optionally add following mappings to your .vimrc:

" cmus controls
nnoremap <leader>i :CmusCurrent<cr>
nnoremap <leader>z :CmusPrevious<cr>
nnoremap <leader>x :CmusPlay<cr>
nnoremap <leader>c :CmusPause<cr>
nnoremap <leader>v :CmusStop<cr>
nnoremap <leader>b :CmusNext<cr>

there is another sister project cmus-osx who integrates cmus into MacOS notification menu and captures Fn music keys.

License

MIT license - see license for more details.