Skip to content

Neovim file explorer based on Emacs dired plugin

Notifications You must be signed in to change notification settings

2hdddg/fex.nvim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 

Repository files navigation

fex.nvim

Neovim file explorer based on ideas from Emacs dired plugin and Vims very own netrw. Basic idea is that listed files and directories should behave like read only vim buffer. Files and directories are displayed by ls command and parsed through ls dired support.

simple

symlinks

Installation

Install with Plug:

Plug '2hdddg/fex.nvim'

Install with Paq:

require('paq')({
    '2hdddg/fex.nvim',
})

Configuration

Configuration is currently optional and only provides option to set parameters to ls command.

require("fex").setup({ls = "-al"})

Default ls listing is based on output with option as set:

ls = "-ahl --group-directories-first --time-style="long-iso"

ls option must contain -l for dired data to become available.

Usage

To start browsing files in directory of current:

require("fex").open()

or Vim command

:Fex

To start browsing a specific direcory:

require("fex").open('/a/specific/directory')

Keybindings

In the file browser the following keymaps are available (currently not configurable):

  • <CR> to step into directory or open file in Fex window
  • v to open preview of directory or file in vertical split window
  • s to open preview of directory or file in split window
  • - to step into parent directory
  • % to create new file in current directory
  • d to create new directory in current directory
  • D to delete file or directory
  • R to rename current directory or file
  • Y yanks full path of the current file or directory
  • C-z switches to a terminal with cwd set to the path of the current directory or file

Future

Currently planned to implement in this order:

  • Support multiple views corresponding to different ls invocations (sorts, attrs)
  • Open file/directory in vsplit/split without attaching preview to it
  • Configurable keymaps
  • Configurable color scheme

About

Neovim file explorer based on Emacs dired plugin

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages