/defx.nvim

:file_folder: The dark powered file explorer implementation for neovim/Vim8

Primary LanguagePythonMIT LicenseMIT

defx.nvim

Note: Active development on defx.nvim has stopped. The only future changes will be bug fixes.

Please see ddu.vim and ddu-ui-filer.

About

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

Please read help for details.

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

Concept

  • Doesn't depend 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

  • Maximum features dislike other file managers

Installation

Note: defx requires Neovim 0.4.0+ or Vim8.2+ with Python3.6.1+. See requirements if you aren't sure whether you have this.

For vim-plug

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

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')
endif

For manual installation(not recommended)

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

Requirements

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

Note: The latest Neovim is recommended, because it is faster.

You can enable Python3 interface with pip:

pip3 install --user pynvim

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.

Configuration Examples

Please see :help defx-examples.

Screenshots

Please see: Shougo#18

Multi root feature Defx -split=vertical Defx -new