iberianpig / ranger-explorer.vim

ranger-explorer.vim

Vim plugin to use Ranger as a file explorer.

• Seamless switching between Vim and Ranger
• Adding buffer in the same process not a child of Ranger process.
• Selecting how to open in tabedit / vsplit / split by Ranger's keymap
• Dynamically defining above keymaps on Ranger

Requirement

• ranger(http://ranger.nongnu.org/)

Installation

"vim-plug
Plug 'iberianpig/ranger-explorer.vim'

"NeoBundle
NeoBundle 'iberianpig/ranger-explorer.vim'

NOTE: If you use Neovim, you have to add the dependency to the plugin bclose.vim:

" vim-plug
Plug 'rbgrouleff/bclose.vim'

" NeoBundle
NeoBundle 'rbgrouleff/bclose.vim'

Usage

Available Command

Keymap on Ranger

Following commands are available on ranger launched from ranger-explorer

<Ctrl-o>: edit on existing tab
<Ctrl-t>: edit on new tab
<Ctrl-v>: edit with vsplit window
<Ctrl-s>: edit with split window

Customize Keymap on Ranger

Following keymap is defined as defaut

let g:ranger_explorer_keymap_edit    = '<C-o>'
let g:ranger_explorer_keymap_tabedit = '<C-t>'
let g:ranger_explorer_keymap_split   = '<C-s>'
let g:ranger_explorer_keymap_vsplit  = '<C-v>'

Keymap on Vim

Add following keymap to ~/.vimrc (Example keymap)

nnoremap <silent><Leader>n :RangerOpenCurrentFile<CR>
nnoremap <silent><Leader>c :RangerOpenCurrentDir<CR>
nnoremap <silent><Leader>f :RangerOpenProjectRootDir<CR>

Support