Fyler.nvim

A file manager for Neovim

Installation

Using Lazy.nvim (Recommended)

{
  "A7Lavinraj/fyler.nvim",
  dependencies = { "nvim-mini/mini.icons" },
  branch = "stable",  -- Use stable branch for production
  lazy = false, -- Necessary for `default_explorer` to work properly
  opts = {}
}

Using Mini.deps

add({
  source = "A7Lavinraj/fyler.nvim",
  depends = { "nvim-mini/mini.icons" },
  checkout = "stable",
})

Usage

You can either open fyler by using the Fyler command:

:Fyler             " Open the finder
:Fyler dir=<cwd>   " Use a different directory path
:Fyler kind=<kind> " Open specified window kind directly

" Map it to a key
nnoremap <leader>e <cmd>Fyler<cr>

-- Or via lua api
vim.keymap.set("n", "<leader>e", "<cmd>Fyler<cr>", { desc = "Open Fyler View" })

Or using the lua api:

local fyler = require('fyler')

-- open using defaults
fyler.open()

-- open as a left most split
fyler.open({ kind = "split_left_most" })

-- open with different directory
fyler.open({ dir = "~" })

-- You can map this to a key
vim.keymap.set("n", "<leader>e", fyler.open, { desc = "Open fyler View" })

-- Wrap in a function to pass additional arguments
vim.keymap.set(
    "n",
    "<leader>e",
    function() fyler.open({ kind = "split_left_most" }) end,
    { desc = "Open Fyler View" }
)

Note

Run :help fyler.nvim OR visit wiki pages for more detailed explanation and live showcase.

Credits to other plugins for inspiration

• GrugFar
• Mini.files
• Neogit
• Nvim-window-picker
• Oil
• Snacks
• Telescope

---

Built with ❤️ for the Neovim community