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:
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.