Skip to content

Latest commit

 

History

History
96 lines (67 loc) · 2.54 KB

README.md

File metadata and controls

96 lines (67 loc) · 2.54 KB
Raw

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:

vim-cmus

:CmusCurrent to echo current file playing by cmus:

vim-cmus

or current stream playing by cmus:

vim-cmus

or

vim-cmus

installation

by your favourite vim plugin manager:

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

" 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.