Skip to content

Latest commit

 

History

History
88 lines (57 loc) · 2.03 KB

README.md

File metadata and controls

88 lines (57 loc) · 2.03 KB

Mintabline

Minimalist Tabline

mintabline screenshot

This project is inspired by tabline.

Features

  • Displays minimal characters with tab numbers.
  • Displays the directory name of Neovim terminal buffers.
  • Displays icons using nvim-web-devicons or vim-devicons.
  • Allows configuration of the maximum tab name length.
  • Allows labeling tabs with a custom prefix.
  • Adjusts tab visibility dynamically based on the current window width.

Installation

Use your favorite vim plugin management tool, e.g., vim-plug

Plug 'sangdol/mintabline.vim'

devicons

You can add icons with nvim-web-devicons or vim-devicons.

If both plugins exist nvim-web-devicons takes precedence.

" Optionally add one of these
Plug 'nvim-tree/nvim-web-devicons'
Plug 'ryanoasis/vim-devicons'

Please follow the installation guide of the plugins if icons don't show up.

Configuration

g:mintabline_tab_max_chars

You can set the maximum length of tab names with g:mintabline_tab_max_chars.

For example,

let g:mintabline_tab_max_chars = 15

The full name will be shown when a tab is active.

Usage

Tab labels

By default the tab name is drawn from the active buffer in that tab. You can set a custom prefix on the tab by setting the tab-local variable t:tab_label

A simple command to change the label is

command! -nargs=* Tablabel let t:tab_label=<q-args> | redrawtabline

Tip: accessing tabs with keymaps

A simple vimscript can be used to configure keymaps to select tabs.

For example, the script below enables Number + , to select a tab, i.e. you can type 1, to select the first tab.

for i in range(1, 9)
  exec 'nnoremap ' .. i .. ', ' .. i .. 'gt'
endfor

License

MIT