Repository navigation
Installation and Usage
- Neovim 0.8+ for the default native single-row renderer.
- Neovim 0.12+ for the opt-in multiline renderer.
- A patched font (see nerd fonts).
- A colorscheme. The plugin derives colours from
Normal,String,TabLineSel(WildMenuas fallback) andComment.
Releases are tagged vX.Y.Z; version = "*" tracks the latest stable release. The
multiline renderer ships in every release (opt-in, Neovim 0.12+) — see
Multiline Buffer Tabs. Do not install bufferlines.nvim alongside
akinsho/bufferline.nvim; both own the tabline. Replace that entry and follow
Migrating from bufferline.nvim.
Lua
-- using lazy.nvim
{ "D0n9X1n/bufferlines.nvim", version = "*", dependencies = "nvim-tree/nvim-web-devicons" }
-- using packer.nvim
use { "D0n9X1n/bufferlines.nvim", tag = "*", requires = "nvim-tree/nvim-web-devicons" }Vimscript
Plug 'nvim-tree/nvim-web-devicons' " Recommended (for coloured icons)
Plug 'D0n9X1n/bufferlines.nvim', { 'tag': '*' }You need termguicolors for this plugin to work as intended, as it reads the hex gui
colour values of various highlight groups.
Lua
vim.opt.termguicolors = true
require("bufferlines").setup{}Vimscript
" In your init.lua or init.vim
set termguicolors
lua << EOF
require("bufferlines").setup{}
EOFYou can close buffers by clicking the close icon or by right clicking the tab anywhere.
Full usage reference: :help bufferlines-usage.
Every public name gains an s; casing is unchanged. Colours and layout are identical.
| Before (bufferline.nvim) | After (bufferlines.nvim) |
|---|---|
require("bufferline") |
require("bufferlines") |
:BufferLinePick and all 18 :BufferLine* commands |
:BufferLinesPick, :BufferLines*
|
BufferLineFill and every BufferLine* highlight group |
BufferLinesFill, BufferLines*
|
filetype bufferline (multiline header) |
filetype bufferlines
|
vim.g.BufferlinePositions, vim.g.BufferlinePinnedBuffers
|
vim.g.BufferlinesPositions, vim.g.BufferlinesPinnedBuffers (old values are read once automatically) |
:h bufferline |
:h bufferlines |
show_buffer_default_icon, pick_buffer, go_to_buffer, sort_buffers_by, close_buffer_with_pick
|
removed (deprecated since v4.0.0) |
There is no require("bufferline") shim, so both plugins cannot be installed at once —
replace the old plugin spec.
English
Getting started
Reference
Development