lualine.nvim

A customizable statusline for Neovim

Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for compat-nvim-0.6 (2023-10-18), so it may lag behind newer releases.

Are you @nvim-lualine?Claim it, and your coding agent keeps it current with each release

compat-nvim-0.6 · 18 Oct 2023 14 things you can do

Follow GitHub

Show editing context, Git changes and diagnostics in a customizable Neovim statusline.

What you can do with lualine.nvim

See your editing mode, filename, file format, encoding and cursor position in Neovim.

Present at compat-nvim-0.6

Good to know

File icons require nvim-web-devicons and a patched font.

See the Git branch and counts of added, modified and removed lines while editing.

1 other tool for: See Git changes

Present at compat-nvim-0.6

Good to know

Git information depends on the repository or a configured custom diff source.

See error, warning, information and hint counts from your diagnostic providers.

Present at compat-nvim-0.6

Good to know

Requires a configured diagnostic source; updates in insert mode are disabled by default.

See search-match counts and the size of your current selection.

Present at compat-nvim-0.6

Good to know

Search counts are shown when hlsearch is active; `maxcount` and `timeout` constrain counting.

Choose statusline themes, colors, separators, icons and component formatting.

Present at compat-nvim-0.6

Good to know

Icons require a patched font; filetype icons also use nvim-web-devicons.

Display custom information from Lua functions, Vim functions, variables and statusline items.

Present at compat-nvim-0.6

Good to know

Custom expressions and functions must be provided in the user's configuration.

Trigger a custom action by clicking a statusline component.

Present at compat-nvim-0.6

Good to know

Requires a configured callback and mouse interaction.

Show open buffers, tabs and windows, jump to a buffer and name tab pages.

Present at compat-nvim-0.6

Good to know

Jumping to a nonexistent buffer index errors unless `:LualineBuffersJump!` is used.

Show all 14

Display status information and buffer or tab lists at the top of Neovim.

Present at compat-nvim-0.6

Good to know

The tabline is empty until configured.

Display status information above each window with separate active and inactive layouts.

Present at compat-nvim-0.6

Good to know

Requires Neovim 0.8 or newer.

Show a single statusline across the bottom of Neovim instead of one per window.

Present at compat-nvim-0.6

Good to know

Requires Neovim 0.7 or newer; disabled by default.

Use different statusline layouts for file trees, quickfix lists and other special buffers.

Present at compat-nvim-0.6

Good to know

No extensions are loaded by default; plugin-specific extensions need the corresponding plugin.

Hide or restore statusline, tabline and winbar displays and disable them for selected filetypes.

Present at compat-nvim-0.6

Good to know

The hide API must be called after setup.

Display the date and time in a statusline component.

Present at compat-nvim-0.6

Good to know

The component must be added to a configured section.

lualine.nvim release history 1

compat-nvim-0.618 Oct 2023
Starting point
with compat-nvim-0.5

See your editing context in a Neovim statusline you can customize.

Details

This bootstrap records the shared compatibility-tag snapshot, not a claim that its features first appeared on the tag date. Configure `require('lualine').setup()` with sections, components, themes and optional extensions.

Also: Show Git changes and diagnostics; configure buffer lists, a tabline, winbars and filetype-specific layouts.

Install nvim-lualine/lualine.nvim pinned to compat-nvim-0.6 or compat-nvim-0.5. These tags require Neovim >= 0.5; global statusline needs >= 0.7 and winbar >= 0.8.

Added: See your editing mode, filename, file format, encod…Added: See the Git branch and counts of added, modified an…Added: See error, warning, information and hint counts fro…Added: See search-match counts and the size of your curren…Added: Choose statusline themes, colors, separators, icons…Added: Display custom information from Lua functions, Vim…Added: Trigger a custom action by clicking a statusline co…Added: Show open buffers, tabs and windows, jump to a buff…Added: Display status information and buffer or tab lists…Added: Display status information above each window with s…Added: Show a single statusline across the bottom of Neovi…Added: Use different statusline layouts for file trees, qu…Added: Hide or restore statusline, tabline and winbar disp…Added: Display the date and time in a statusline component.

Seeded by @iluxav with Codex

Read the evidence