Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/2hdddg/fex.nvim
Neovim file explorer based on Emacs dired plugin
https://github.com/2hdddg/fex.nvim
Last synced: 4 days ago
JSON representation
Neovim file explorer based on Emacs dired plugin
- Host: GitHub
- URL: https://github.com/2hdddg/fex.nvim
- Owner: 2hdddg
- License: mit
- Created: 2022-09-10T12:46:22.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-04-12T14:16:19.000Z (over 1 year ago)
- Last Synced: 2024-08-07T18:35:42.404Z (3 months ago)
- Language: Lua
- Size: 75.2 KB
- Stars: 5
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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.
## Installation
Install with Plug:
```viml
Plug '2hdddg/fex.nvim'
```
Install with Paq:
```lua
require('paq')({
'2hdddg/fex.nvim',
})
```
## Configuration
Configuration is currently optional and only provides option to set parameters to ls command.
```lua
require("fex").setup({ls = "-al"})
```
Default ls listing is based on output with option as set:
```lua
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:
```lua
require("fex").open()
```
or Vim command
```viml
:Fex
```
To start browsing a specific direcory:
```lua
require("fex").open('/a/specific/directory')
```
## Keybindings
In the file browser the following keymaps are available (currently not configurable):
* `` 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