Skip to content

Installation and Usage

github-actions[bot] edited this page Nov 12, 2026 · 2 revisions

Installation and Usage

简体中文

Requirements

  • 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 (WildMenu as fallback) and Comment.

Install

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': '*' }

Usage

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{}
EOF

You can close buffers by clicking the close icon or by right clicking the tab anywhere.

Full usage reference: :help bufferlines-usage.

Migrating from bufferline.nvim

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.

Clone this wiki locally