obaland / vfiler.vim

:file_folder: File explorer plugin for Neovim/Vim

File explorer plugin for Neovim/Vim

Description

• 📄 Performing basic file operations.
• 📑 Supports easy-to-use 2-window filer.
• ❇️ Light operability.
• 🛃 Customizable to your liking.
• 🔗 Not depends on other plugins or external.

Requirements

vfiler.vim requires Neovim(0.5.0+) or Vim8.2+ with if_lua.

Installation

Using vim-plug

Plug 'obaland/vfiler.vim'

Using dein.vim

call dein#add('obaland/vfiler.vim')

Using packer.nvim

use {
  'obaland/vfiler.vim',
}

Usage

Quick Start

Basically, after installing in any way, start with the VFiler command. The vfiler.vim will start in the current directory.

:VFiler

You can do various things with options.
See command usage for details.

Start by Lua function

vfiler.vim can also be started by calling a require'vfiler'.start().

require('vfiler').start({path})

You can do various things with configs.
See Lua function usage for details.

More details

• Please see more details: Usage

Customization

vfiler.vim can be customized to your liking.
The following is an example.

Explorer style

Start by command:

:VFiler -auto-cd -auto-resize -keep -layout=left -name=explorer -width=30 -columns=indent,icon,name

Start by Lua script:

require('vfiler/config').setup {
  options = {
    auto_cd = true,
    auto_resize = true,
    keep = true,
    layout = 'left',
    name = 'explorer',
    width = 30,
    columns = 'indent,icon,name',
  },
}

require('vfiler').start()

More details

vfiler.vim has various other customization mechanisms.

• Please see more details: Customization

Extension plugins

There are also some extension plugins for vfiler.vim.
Please use it as you like.

• obaland/vfiler-column-devicons
• obaland/vfiler-fzf

Screenshots

Basic (with devicons)

Operation with two buffers

Explorer style (with devicons)

Floating window style (only Neovim)

Feedback

I am hoping to continually improve it as far as time permits.
Welcome your requests and suggestions, so please create an issue.

License

vfiler.vim is licensed under the MIT license.
Copyright © 2018, obaland