arena.nvim is a frecency-based
buffer switcher that allows you to hop between files as fast as you can think!
It sorts your buffers using two metrics: frequency and recency!
If you're tired of:
- Using a fuzzy-finder every time you want to switch to a file
- Persistent marks that you have to maintain yourself
- Feeling completely lost in projects with a lot of files
then the arena the perfect solution!
You can use your favorite package manager to get arena.nvim on your system.
For example, with lazy:
{
"dzfrias/arena.nvim",
event = "BufWinEnter",
-- Calls `.setup()` automatically
config = true,
}Or with packer:
use {
"dzfrias/arena.nvim",
config = function()
require("arena").setup()
end
}To make sure everything is working, restart Neovim and run :ArenaToggle!
arena.nvim comes with some default keybinds for buffer management!
| Key | Description |
|---|---|
<CR> |
Open to file |
d |
Delete the buffer under the cursor |
D |
Delete all unpinned buffers |
p |
Pin the buffer under the cursor |
<C-v> |
Open file (vsplit) |
<C-x> |
Open file (hsplit) |
<C-t> |
Open file (tab) |
If you'd like to unset any of these, set the value to nil in the keybinds
section of the config.
arena.nvim has plenty of configuration options to suit your needs! Below are
all the configuration options along with their default values.
{
-- Maxiumum number of files that the arena window can contain, or `nil` for
-- an unlimited amount
max_items = 5,
-- Always show the enclosing directory for these paths
always_context = { "mod.rs", "init.lua" },
-- When set, ignores the current buffer when listing files in the window.
ignore_current = false,
-- Options to apply to the arena buffer.
buf_opts = {
-- ["relativenumber"] = false,
},
-- Filter out buffers per the project they belong to.
per_project = false,
--- Add devicons (from nvim-web-devicons, if installed) to buffers
devicons = false,
window = {
width = 60,
height = 10,
border = "rounded",
-- Options to apply to the arena window.
opts = {},
},
-- Keybinds for the arena window.
keybinds = {
-- ["e"] = function()
-- vim.cmd("echo \"Hello from the arena!\"")
-- end
},
-- Change the way the arena listing looks with custom rendering functions
renderers = {}
-- Config for frecency algorithm.
algorithm = {
-- Multiplies the recency by a factor. Must be greater than zero.
-- A smaller number will mean less of an emphasis on recency!
recency_factor = 0.5,
-- Same as `recency_factor`, but for frequency!
frequency_factor = 1,
},
}arena.nvim has both a lua and vim API for more involved usages.
Toggles the arena window. ArenaToggle from vimscript.
require("arena").toggle()Opens the arena window. ArenaOpen from vimscript.
require("arena").open()Closes the arena window, if it exists. ArenaClose from vimscript.
require("arena").close()In the keybinds section of the config, the set functions take in the current
arena window as an argument, which
has its own API:
keybinds = {
-- An example keybind that prints the linecount of the buffer of the
-- current line in the window
["i"] = function(win)
local current = win:current()
local info = vim.fn.getbufinfo(current.bufnr)[1]
print(info.linecount)
end,
}You can check out the source code to see how the default arena keybinds are defined!
Remove a buffer from the arena window, by buffer number.
-- Remove the 42nd buffer from the arena window
require("arena").remove(42)Pin a buffer to the top of the arena window.
-- Pin the 43rd buffer
require("arena").pin(43)You may check if a buffer is pinned using the is_pinned(buf) function.
Refresh the arena window.
require("arena").refresh()The plugin falls under the MIT License.