A starting point/guide for creating custom statusline, statuscolumn, tabline & winbar for Neovim.

bars.nvim is NOT a plugin, if it wasn't clear. It's just a reference manual.

• ✨ Features
• 📚 Requirements
• 💡 Guide
• 📐 Installation
• 🧭 Configuration
• 🧰 Commands

• Actually fast,

  • Termux: average: 7ms, lowest: 5ms.
  • MacOS: average: 2ms, lowest: 1.8ms.

• Fully customisable.

• Per-window configuration.

• Ability to toggle various bars/lines via commands.

• 0.10.4 or higher recommended.

• Nerd font >= 3.0.0
• Git(branch in statusline).
• Tree-sitter parser(node in winbar).

Guide for creating your own custom statusline, statuscolumn, tabline & winbar are given below,

• Statuscolumn
• Statusline
• Winbar
• Tabline

Add this to your plugin list.

Plug "OXY2DEV/bars.nvim"

For plugins.lua users,

{
    "OXY2DEV/bars.nvim",
},

For plugins/bars.lua,

return {
    "OXY2DEV/bars.nvim",
};

local MiniDeps = require("mini.deps");

MiniDeps.add({
    source = "OXY2DEV/bars.nvim"
});

:Rocks install bars.nvim

Tagged releases can be found in the release page.

bars.nvim can be configured in 2 ways,

1. Via the setup() function.

require("bars").setup({
    global = false
});

2. Via the modules own setup function.

require("bars.statusline").setup({
    ignore_filwtypes = { "help" }
});

Check the wiki to learn about all the configuration options!

Usage instructions for different modules,

• Statuscolumn
• Statusline
• Winbar
• Tabline

bars.nvim provides a single command :Bars which has sub-commands that can be used to do different things.

USAGE,
    :Bars

    :Bars [sub-command]

    :Bars [sub-command] [modifier]

    :Bars [sub-command] [modifier] [window_1] [window_2] ..

EXAMPLE,
    :Bars toggle ? 1000

The sub-commands are given below,

All the sub-commands support modifier to specify which modules should be affected by the command.

" Toggles all bars & lines for the current window.
:Bars toggle

Modifiers are given below,

You can add any number of windows after the modifier to specify which windows to run the command on.

bars.nvim comes with the following highlight groups,

• BarsFoldClose1

• BarsFoldOpen1

• BarsFoldClose2

• BarsFoldOpen2

• BarsFoldClose3

• BarsFoldOpen3

• BarsFoldClose4

• BarsFoldOpen4

• BarsFoldClose5

• BarsFoldOpen5

• BarsFoldClose6

• BarsFoldOpen6

• BarsLineNr

• BarsWrap1<1..10>

• BarsVirtual2<1..10>

• BarsNormal<1..10>

• BarsInsert<1..10>

• BarsVisual<1..10>

• BarsVisualLine<1..10>

• BarsVisualBlock<1..10>

• BarsCommand<1..10>

• BarsNormal

• BarsInsert

• BarsVisual

• BarsVisualLine

• BarsVisualBlock

• BarsCommand

• BarsFt

• BarsFt0

• BarsFt1

• BarsFt2

• BarsFt3

• BarsFt4

• BarsFt5

• BarsFt6

• BarsGit

• BarsRuler

• BarsRulerVisual