dsfe.nvim - Dim simple file explorer

A minimal file explorer plugin for Neovim.

demo.mp4

• Version: Pre-release. Under development, so there may be BREAKING CHANGES.
• Target: nvim v0.9+

Features

• Minimalist Design: Keep your Neovim environment clutter-free with a simple and unobtrusive file explorer.
• Zero Dependencies: dsfe.nvim requires no external packages or libraries, ensuring a seamless installation process.
• Effortless Usage: Start exploring and managing your files and directories within Neovim without the need for extensive configuration. You can move cursor with hjkl and open file/dir with <CR>.

Installation

You can easily install dsfe.nvim using your favorite Neovim plugin manager. Here's an example using Lazy.nvim:

1. Add the following line to your Neovim configuration file (typically ~/.config/nvim/init.lua):

require("lazy").setup({
    "sys9kdr/dsfe.nvim",
    config = function()
        require('dsfe').setup()
    end
})

2. After restart, you're all set! You can now use dsfe.nvim by invoking the file explorer with:

:e .

Use the standard Neovim navigation keys (h, j, k, l) to move around, and press Enter to open files or directories.

Note: Disable Netrw

dsfe.nvim disables some Netrw functionalities, so you don't need to disable Netrw manually. However, for a better experience, it is recommended to fully disable it using the following settings in init.lua.

-- in init.lua
vim.g.loaded_netrw = true
vim.g.loaded_netrwPlugin = true
vim.g.loaded_netrwSettings = true
vim.g.loaded_netrwFileHandlers = true

Keymappings

• <CR> on file: Open the file on existing Vim. <Plug>(dsfe-open)
• <CR> on directory: Go to the directory. <Plug>(dsfe-open)
• -: Go up parent directory. <Plug>(dsfe-up)
• ~: Go to home directory. <Plug>(dsfe-home)
• +: Toggle show hidden files. <Plug>(dsfe-toggle-hidden)
• \\: Reload. <Plug>(dsfe-reload)

Customize

Hidden files visibility is disabled by default. If you want to enable visibility set { show_hidden = true } at setup.

require("lazy").setup({
    "sys9kdr/dsfe.nvim",
    config = function()
        require('dsfe').setup({ show_hidden = true })
    end
})

Contributing

We welcome and encourage your contributions! Please feel free to submit any issues you encounter or create pull requests for improvements. We appreciate your input! 🚀

License

Apache v2.

Credits

This plugin is heavily inspired from vim-molder and lir.nvim.