📁 The dark powered file explorer implementation
Python Vim script Makefile
Switch branches/tags
Nothing to show
Clone or download
Shougo Merge pull request #11 from gitter-badger/gitter-badge
Add a Gitter chat badge to README.md
Latest commit f1dbf0e Aug 13, 2018
Failed to load latest commit information.
.github Add ISSUE_TEMPLATE Jan 30, 2018
autoload Add health support Aug 1, 2018
doc Update the documentation Aug 1, 2018
plugin Improve Defx command Jul 29, 2018
rplugin/python3/defx Fix lint errors Aug 1, 2018
test Fix cursor problems Jul 30, 2018
.gitignore Add mock tests Jun 10, 2018
.travis.yml Python 3.6 only Jul 16, 2018
LICENSE Add base files Jan 30, 2018
Makefile Add mock tests Jun 10, 2018
README.md Add Gitter badge Aug 13, 2018



Join the chat at https://gitter.im/Shougo/defx.nvim

Defx is a dark powered plugin for Neovim/Vim to browse files. It can replace deprecated vimfiler plugin.


  • Not depends on denite.nvim

  • Vim8/neovim compatible(nvim-yarp is needed for Vim8)

  • Implemented by Python3

  • No double filer feature

  • Column feature

  • Source feature like denite.nvim

  • Options

  • Highlight is defined by column

  • Few commands (:Defx command only?)

  • Extended rename

  • Mark

  • Windows supporters are needed

  • The original trashbox feature

  • Maximum features dislike other file managers


Note: defx requires Neovim(latest is recommended) or Vim8 with Python3.6.1+ and timers(neovim ver.0.2.0+) enabled. See requirements if you aren't sure whether you have this.

For vim-plug

if has('nvim')
  Plug 'Shougo/defx.nvim', { 'do': ':UpdateRemotePlugins' }
  Plug 'Shougo/defx.nvim'
  Plug 'roxma/nvim-yarp'
  Plug 'roxma/vim-hug-neovim-rpc'

For dein.vim

call dein#add('Shougo/defx.nvim')
if !has('nvim')
  call dein#add('roxma/nvim-yarp')
  call dein#add('roxma/vim-hug-neovim-rpc')

For manual installation(not recommended)

  1. Extract the files and put them in your Neovim or .vim directory (usually $XDG_CONFIG_HOME/nvim/).


defx requires Python3.6.1+ and Neovim or Vim8 with if_python3. If :echo has("python3") returns 1, then you have python 3 support; otherwise, see below.

You can enable Python3 interface with pip:

pip3 install neovim

Please install nvim-yarp plugin for Vim8. https://github.com/roxma/nvim-yarp

Please install vim-hug-neovim-rpc plugin for Vim8. https://github.com/roxma/vim-hug-neovim-rpc

Note: Python3 must be enabled before updating remote plugins

If Defx was installed prior to Python support being added to Neovim, :UpdateRemotePlugins should be executed manually in order to enable auto-completion.

Configuration Examples

" Todo


  • All features