nvim-bitacora

Minimal Neovim File Explorer

Caveats

• Minimal File Explorer inspired partly in nvim-tree
• Integration with git and LSP diagnostics
• This plugin has been developed on and for Linux following open source philosophy.

Installation

vim.pack.add {
 "https://codeberg.org/caskstrength/nvim-bitacora",
 "https://codeberg.org/caskstrength/nvim-popcorn",
}

Configuration

require'bitacora'.setup { 
 style = {
 -- Lateral default width
 width = 40,
 -- Font Awesome icons or normal icons
 diagnostics_fa_icons = true
 },
 -- Show hidden files and folders
 show_hidden = false,
 
 -- Hide files and folders declared in .gitignore
 hide_gitignore = true,
 -- Enable debug logs
 internal = {
 log_debug = false
 }
}
vim.keymap.set("n", "<C-t>", "<Cmd>BitacoraToggle<CR>", { silent = true, desc = "Toggle Bitacora" })
vim.keymap.set("n", "<C-g>", "<Cmd>BitacoraFindFile<CR>", { silent = true, desc = "Find File Bitacora" })

Commands

Bitacora automatically loads when a directory is declared. Like nvim some/dir/ or nvim .

Basic

• Use ↑ or k and ↓ or j keys to navigate the file manager
• To open buffer of selected file or expand directory press Enter
• To close Bitacora press q
• To refresh press R
• Use Ctrl-f to toggle hidden files and directories

Edit actions

• To add a new file or directory press a
• To delete a file or directory press d
• To rename a file or directory press r
• To cut a file or directory press x
• To copy a file or directory press c
• To paste a file or directory press p

Resize and buffers

• Use Ctrl-l to increase Bitacora width
• Use Ctrl-h to decrease Bitacora width
• Use Ctrl-v to open a buffer of selected file in a vertical split
• Use Ctrl-b to open a buffer of selected file in a horizontal split

Highlights

Bitacora has the following highlights available

• BitacoraIcon
• BitacoraDir
• BitacoraGitSignsChange
• BitacoraGitSignsAdd
• BitacoraGitSignsUntracked
• BitacoraGitSignsDelete

Screenshots

NOTE: The colorscheme nox from nvim-nyctophilia is used in this image.