How to install tabby.nvim with lazy.nvim?

Add 'nanozuki/tabby.nvim' to your lazy.nvim config with a setup function or opts. For example, use opts to define your tabline renderer, and set vim.o.showtabline = 2 to always display the tabline, as shown in the README installation section.

tabby.nvim vs barbar.nvim: which is better?

tabby.nvim focuses on managing Vim tab pages as workspaces for window grouping, while barbar.nvim is a bufferline plugin for listing open files. Choose tabby for workspace organization and barbar for buffer-centric workflows.

Can tabby.nvim rename tabs?

Yes, use the command 'Tabby rename_tab ' to rename tabs, and display the name in your config using tab.name(). Fallback names can be configured in the line options for unlabeled tabs.

How to customize the tabline appearance in tabby.nvim?

Provide a Lua function in the setup that uses the line object to construct nodes. The README includes detailed examples and a playground feature for testing configurations without affecting your main Neovim setup.

Does tabby.nvim work with bufferline plugins?

tabby.nvim is specifically for tablines and uses Vim's tab pages, so it's not compatible with bufferline plugins that list buffers linearly. However, you can configure it to show buffer names within window labels.

What are the presets in tabby.nvim?

Presets like 'active_wins_at_tail' and 'tab_only' offer ready-to-use tabline configurations. They use Nerd Fonts for icons and can integrate with Lualine themes, allowing quick setup without custom Lua coding.

Is tabby.nvim slow or performance-intensive?

The README states that tabby.nvim is not slow and doesn't require lazy loading, but rendering custom Lua functions on each redraw could impact performance if configurations are overly complex or inefficient.

Open-Awesome

tabby.nvim

MITLuav2.8.1

A declarative, highly configurable Neovim tabline plugin that transforms Vim tabs into a workspace multiplexer.

GitHub

774 stars27 forks0 contributors

What is tabby.nvim?

tabby.nvim is a Neovim plugin that replaces the default tabline with a configurable interface for managing Vim tab pages as workspaces. It solves the problem of disorganized buffers by allowing users to group related windows (like code files, terminals, and tools) into separate tabs, turning Vim into a workspace multiplexer.

Target Audience

Neovim users who work with multiple files and tools simultaneously and want to organize their editing environment into logical workspaces using Vim's tab pages.

Value Proposition

Unlike bufferline plugins that list all open files linearly, tabby.nvim leverages Vim's native tab semantics for better workspace separation, offers extensive customization via Lua, and includes features like tab renaming and jump mode for efficient navigation.

Overview

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

Use Cases

Best For

Organizing Neovim windows into project-specific workspaces
Customizing the tabline appearance with Lua code
Managing multiple tabs with descriptive names
Quickly jumping between tabs with a single key
Integrating with other Neovim plugins like nvim-tree or Neogit
Using preset configurations for a fast setup

Not Ideal For

Users who prefer a flat buffer list over tab-based workspace organization
Developers wanting drop-in tabline styles without writing Lua configuration code
Teams prioritizing long-term API stability, as v3 will introduce breaking changes

Pros & Cons

Pros

Native Tab Integration

Leverages Vim's built-in tab pages to group windows into logical workspaces, avoiding the clutter of a flat buffer list as described in the README.

Lua-Powered Customization

Offers a highly configurable API using pure Lua, allowing developers to tailor the tabline's appearance and behavior without a restrictive DSL.

Useful Workspace Features

Includes tab renaming, a window picker for cross-tab navigation, and a jump mode for quick tab switching, enhancing productivity in multi-file projects.

Quick Start Presets

Provides several preset configurations with Nerd Fonts and Lualine theme support, enabling users to get started rapidly without coding.

Cons

Configuration Complexity

Requires writing Lua code for customization, which can be daunting for users unfamiliar with programming or those seeking a plug-and-play solution.

Upcoming Breaking Changes

The README acknowledges compatibility challenges and plans for v3 to deprecate APIs and remove Vimscript, potentially disrupting existing setups.

External Dependencies

For file icons, it relies on optional plugins like nvim-web-devicons, adding extra steps to the setup process and increasing maintenance overhead.

Frequently Asked Questions

Related Projects

bufferline.nvim

A snazzy bufferline for Neovim

Stars4,377

Forks239

Last commit1 year ago

barbar.nvim

The neovim tabline plugin.

Stars2,733

Forks96

Last commit3 months ago

nvim-cokeline

:nose: A Neovim bufferline for people with addictive personalities

Stars634

Forks43