How do I install barbar.nvim with lazy.nvim?

Use the Lua snippet from the README, specifying dependencies like nvim-web-devicons and gitsigns.nvim in the lazy.nvim setup. Set vim.g.barbar_auto_setup = false and configure opts for customization, ensuring the version is pinned to ^1.0.0 for stability.

barbar.nvim vs bufferline.nvim, which should I use?

barbar.nvim excels with unique features like persistent jump letters and better sidebar integration, while bufferline.nvim might have more community themes. Choose barbar if you prioritize advanced keyboard navigation and integrated sorting options.

Why isn't my barbar.nvim tabline showing up?

Check if other plugins like lightline are interfering, and add the configuration to disable lightline's tabline as per the known issues. Also, ensure barbar is properly loaded in your init file and that you've set up mappings or enabled it with :BarbarEnable.

How to use the jump-to-buffer mode in barbar.nvim?

Map a key to the BufferPick command, like , to enter jump-to-buffer mode. Letters are assigned based on buffer names or usability order, and you can type them to quickly switch buffers, with letters persisting for the buffer's lifetime.

Can I use barbar.nvim without nerd fonts?

Yes, but file icons will be disabled or require configuration of nvim-web-devicons to use alternative icons. The plugin functions without icons, but visual appeal is reduced, and you might need to adjust the icons.filetype.enabled setting.

How to integrate barbar.nvim with session managers like persistence.nvim?

Use the provided snippets in the README for persistence.nvim or other session plugins, ensuring sessionoptions include 'globals' and hooking the SessionSavePre event to save buffer order and pins during session saves.

What are common fixes for sidebar startup issues with barbar.nvim?

For sidebars like NvimTree that open on startup, refer to issue #421 for workarounds, as the sidebar_filetypes option may not work perfectly initially. Adjusting autocmds or delaying sidebar loading can help mitigate this.

Open-Awesome

barbar.nvim

Luav1.9.1

A Neovim tabline plugin with re-orderable, auto-sizing, clickable tabs, icons, and a magic jump-to-buffer mode.

GitHub

2.7k stars96 forks0 contributors

What is barbar.nvim?

barbar.nvim is a tabline plugin for Neovim that provides enhanced buffer management through a tab-based interface. It solves the problem of managing multiple open buffers in Neovim by offering re-orderable, auto-sizing tabs with unique features like persistent jump-to-buffer letters and intelligent sorting options.

Target Audience

Neovim users who work with multiple buffers simultaneously and want a more visual and interactive way to manage them, particularly those coming from other editors with traditional tab interfaces.

Value Proposition

Developers choose barbar.nvim for its unique jump-to-buffer mode with persistent letters, comprehensive tab management features, and seamless integration with the Neovim ecosystem including file icons and git status indicators.

Overview

The neovim tabline plugin.

Use Cases

Best For

Neovim users wanting traditional editor-style tabs
Managing large numbers of open buffers efficiently
Quick keyboard navigation between frequently used files
Visual organization of buffers by project or file type
Working with duplicate filenames across different directories
Integrating buffer management with sidebar plugins like NvimTree

Not Ideal For

Users relying on lightline or similar statusline plugins that override tabline settings
Projects using netrw as the primary file explorer due to compatibility issues
Developers who prefer a minimal setup without mouse interactions or graphical elements
Teams needing instant out-of-the-box functionality with zero configuration

Pros & Cons

Pros

Persistent Jump-to-Buffer

Assigns constant letters to buffers for lifetime, enabling rapid keyboard navigation by typing a single character, as shown in the jump-to-buffer mode GIF where letters like 'r' for README.md remain stable.

Intelligent Tab Management

Offers auto-sizing tabs that fill available space, multiple sorting options (by name, directory, etc.), and unique naming for duplicate filenames, optimizing organization based on workflow.

Seamless Sidebar Integration

Automatically offsets the tabline when sidebars like NvimTree are open, preventing overlap and maintaining a clean interface, as demonstrated in the filetree-with-offset image.

Comprehensive Feature Set

Includes re-orderable tabs, pinned buffers, scrollable tabs, and integrations with git status and file icons via optional plugins, providing a full-featured tabline solution.

Cons

Plugin Interference

Conflicts with plugins like lightline require manual fixes (e.g., disabling lightline's tabline), and netrw support is limited due to inherent bugs, as admitted in the known issues section.

Steep Configuration Curve

No default key mappings are provided, and setup involves extensive options in Lua or Vim script, demanding significant time and effort for customization beyond basic use.

Dependency on External Plugins

Full visual enhancements like file icons and git status rely on optional plugins like nvim-web-devicons and gitsigns.nvim, adding extra installation and configuration steps.

Frequently Asked Questions

Related Projects

bufferline.nvim

A snazzy bufferline for Neovim

Stars4,383

Forks239

Last commit1 year ago

tabby.nvim

A declarative, highly configurable, and neovim style tabline plugin. Use your nvim tabs as a workspace multiplexer!

Stars772

Forks27

Last commit9 months ago

nvim-cokeline

:nose: A Neovim bufferline for people with addictive personalities

Stars634

Forks43

Last commit4 months ago

luatab.nvim

Tabline lua plugin for neovim

Stars214

Forks21