mistfly statusline

mistfly statusline is a simple, fast and informative statusline for Vim and Neovim.

mistfly statusline also provides optional tabline and Neovim winbar support when the appropriate settings are enabled; refer to mistflyTabLine and mistflyWinBar.

mistfly statusline will adapt it's colors to the colorscheme currently in effect. Colors can also be customized if desired.

Lastly, mistfly statusline is a light statusline plugin clocking in at about 500 lines of code. For comparison, the lightline, airline and lualine statusline plugins contain over 3,600, 7,900 and 7,300 lines of code respectively. In fairness, the latter plugins are more featureful, configurable and visually pleasing.

Screenshots

The above screenshots are using the nightfly colorscheme and the Iosevka font with a couple Git changes, a single Diagnostic warning and indent-status enabled.

Statusline Performance Comparison

A performance comparison of mistfly stautusline against various popular statusline plugins, with their out-of-the-box defaults, on a clean and minimal Neovim setup with the moonfly colorscheme. The Neovim startup times in the following table are provived by the dstein64/vim-startuptime plugin.

Startup times are the average of five consecutive runs. Note, native is run without any statusline plugin.

Startup times as of July 2022 on my system; performance on other systems will vary.

Plugins, Linters and Diagnostics supported

• vim-devicons and nvim-web-devicons via the mistflyWithNerdIcon option

• Gitsigns

• GitGutter

• Neovim Diagnostic

• ALE

• Coc

• Obsession

:zap: Requirements

mistfly statusline requires a GUI capable version of Vim or Neovim with an appropriate colorscheme set.

A GUI client, such as Gvim, or a modern terminal version of Vim or Neovim with termguicolors enabled in a true-color terminal, is required.

I encourage terminal users to use a true-color terminal, such as: iTerm2, Alacritty Windows Terminal, or kitty and enable the termguicolors option.

Installation

Install bluz71/vim-mistfly-statusline with your preferred plugin manager.

vim-plug:

Plug 'bluz71/vim-mistfly-statusline'

packer.nvim:

use 'bluz71/vim-mistfly-statusline'

Legacy Installation

mistfly statusline still supports the legacy version of this plugin, previously named moonfly statusline, via the moonfly-compat branch. That legacy version can be installed with your preferred plugin manager.

vim-plug:

Plug 'bluz71/vim-mistfly-statusline', { 'branch': 'moonfly-compat' }

packer.nvim:

use { 'bluz71/vim-mistfly-statusline', branch = 'moonfly-compat' }

Notice

File explorers, such as NERDTree and netrw, and certain other special buffers will be minimally styled by this plugin, which often is for the best for these special buffer.

Layout And Default Colors

The mistfly-statusline layout consists of two main groupings, the left-side and right-side groups as follows:

+-------------------------------------------------+
| A | B | C | D                         X | Y | Z |
+-------------------------------------------------+

Sections marked with a * are linked to a highlight group and are colored, refer to the next section for details.

Note, filenames will be compacted as follows:

• Pathless filenames only for files in the current working directory

• Relative paths in preference to absolute paths for files not in the current working directory

• ~-style home directory paths in preference to absolute paths

• Truncated, for example foo/bar/bazz/hello.txt will be displayed as f/b/b/hello.txt

• Trimmed, a maximum of four path components will be displayed for a filename, if a filename is more deeply nested then only the four most significant components, including the filename, will be displayed with an ellipses ... prefix used to indicate path trimming.

Highlight Groups And Colors

Sections marked with * in the previous section are linked to the following custom highlight groups with their associated fallbacks if the current colorscheme does not support mistfly statusline.

Note, the following colorschemes support mistfly statusline, either within the colorscheme (moonfly & nightfly) or within this plugin (all others):

• moonfly

• nightfly

• catppuccin

• dracula

• edge

• embark

• everforest

• gruvbox

• gruvbox-material

• nightfox

• sonokai

• tokyonight

Lastly, if the fallback colors do not suit then it is very easy to override with your own highlights.

:gift: Here is a simple example of customized mistfly statusline colors. Save the following either at the end of your initialization file, after setting your colorscheme, or in an appropriate after file such as after/plugin/mistfly-statusline.vim.

highlight! link MistflyNormal DiffChange
highlight! link MistflyInsert WildMenu
highlight! link MistflyVisual IncSearch
highlight! link MistflyCommand WildMenu
highlight! link MistflyReplace ErrorMsg

:wrench: Options

mistflyAsciiShapes

The mistflyAsciiShapes option specifies whether to only use Ascii characters for certain dividers and symbols.

mistfly statusline by default will use Unicode Symbols and Powerline Glyphs for certain shapes such as: Git branch, dividers and active tabs. Note, many modern fonts, such as: Hack, Iosevka, Fira Code and Jetbrains Mono, will provide these shapes.

To limit use only to Ascii shapes please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyAsciiShapes = v:true

-- Lua initialization file
vim.g.mistflyAsciiShapes = true

mistflyErrorSymbol

The mistflyErrorSymbol option specifies which character symbol to use when displaying Neovim Diagnostic, ALE or Coc errors.

By default, the x character, will be displayed.

To specify your own error symbol please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyErrorSymbol = '<<SYMBOL-OF-YOUR-CHOOSING>>'

-- Lua initialization file
vim.g.mistflyErrorSymbol = '<<SYMBOL-OF-YOUR-CHOOSING>>'

mistflyWarningSymbol

The mistflyWarningSymbol option specifies which character symbol to use when displaying Neovim Diagnostic, ALE or Coc warnings.

By default, the exclamation symbol, !, will be displayed.

To specify your own warning symbol please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWarningSymbol = '<<SYMBOL-OF-YOUR-CHOOSING>>'

-- Lua initialization file
vim.g.mistflyWarningSymbol = '<<SYMBOL-OF-YOUR-CHOOSING>>'

mistflyTabLine

The mistflyTabLine option specifies whether to let this plugin manage the tabline in addition to the statusline. By default tabline management will not be undertaken.

If enabled, mistfly statusline will render a simple numbered, and clickable, window-space layout in the tabline; note, no buffers will be displayed in the tabline since there are many plugins that already provide that capability.

To enable mistfly statusline's tabline support please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyTabLine = v:true

-- Lua initialization file
vim.g.mistflyTabLine = true

:bulb: Mappings, such as the following, may be useful to quickly switch between the numbered window-spaces:

nnoremap <Leader>1 1gt
nnoremap <Leader>2 2gt
nnoremap <Leader>3 3gt
nnoremap <Leader>4 4gt
nnoremap <Leader>5 5gt
nnoremap <Leader>6 6gt
nnoremap <Leader>7 7gt
nnoremap <Leader>8 8gt
nnoremap <Leader>9 9gt

A screenshot of the tabline:

mistflyWinBar

The mistflyWinBar option specifies whether to display Neovim's window bar at the top of each window. By default window bars will not be displayed.

Note, Neovim 0.8 (or later) is required for this feature.

Displaying a window bar is reasonable when Neovim's global statusline is enabled via set laststatus=3; the winbar will then display the file name at the top of each window to disambiguate splits. Also, if there only one window in the current tab then a winbar will not be displayed (it won't be needed).

To enable Neovim's winbar feature please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWinBar = v:true

-- Lua initialization file
vim.g.mistflyWinBar = true

mistflyWithIndentStatus

The mistflyWithIndentStatus option specifies whether to display the indentation status as the last component in the statusline. By default indentation status will not be displayed.

Note, if the expandtab option is set, for the current buffer, then tab stop will be displayed, for example Tab:4 (tab equals four spaces); if on the other hand noexpandtab option is set then shift width will be displayed instead, for example Spc:2 ('spc' short for 'space').

To enable indentation status please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWithIndentStatus = v:true

-- Lua initialization file
vim.g.mistflyWithIndentStatus = true

mistflyWithGitBranch

The mistflyWithGitBranch option specifies whether to display Git branch details in the statusline. By default Git branches will be displayed in the statusline.

To disable the display of Git branches in the statusline please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWithGitBranch = v:false

-- Lua initialization file
vim.g.mistflyWithGitBranch = false

mistflyWithGitsignsStatus

The mistflyWithGitsignsStatus option specifies whether to display Gitsigns of the current buffer in the statusline.

By default, Gitsigns will be displayed if the plugin is loaded.

To disable the display of Gitsigns in the statusline please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWithGitsignsStatus = v:false

-- Lua initialization file
vim.g.mistflyWithGitsignsStatus = false

mistflyWithGitGutterStatus

The mistflyWithGitGutterStatus option specifies whether to display GitGutter status of the current buffer in the statusline.

By default, GitGutter status will be displayed if the plugin is loaded.

To disable the display of GitGutter status in the statusline please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWithGitGutterStatus = v:false

-- Lua initialization file
vim.g.mistflyWithGitGutterStatus = false

mistflyWithNerdIcon

The mistflyWithNerdIcon option specifies whether a filetype icon, from the current Nerd Font, will be displayed next to the filename in the statusline.

Note, a Nerd Font must be in-use and the vim-devicons or nvim-web-devicons plugin must be installed and active.

By default a Nerd Font filetype icon will not be displayed in the statusline.

To display a Nerd Font filetype icon please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWithNerdIcon = v:true

-- lua initialization file
vim.g.mistflyWithNerdIcon = true

mistflyWithNvimDiagnosticStatus

mistfly statusline supports Neovim Diagnostics

The mistflyWithNvimDiagnosticStatus option specifies whether to indicate the presence of the Neovim Diagnostics in the current buffer.

By default, Neovim Diagnositics will be displayed if the nvim-lspconfig plugin is loaded.

If Neovim Diagnostic display is not wanted then please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWithNvimDiagnosticStatus = v:false

-- Lua initialization file
vim.g.mistflyWithNvimDiagnosticStatus = false

mistflyWithALEStatus

mistfly statusline supports the ALE plugin.

The mistflyWithALEStatus option specifies whether to indicate the presence of the ALE errors and warnings in the current buffer.

By default, ALE errors and warnings will be displayed if the plugin is loaded.

If ALE error and warning display are not wanted then please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWithALEStatus = v:false

-- Lua initialization file
vim.g.mistflyWithALEStatus = false

mistflyWithCocStatus

mistfly statusline supports the Coc plugin.

The mistflyWithCocStatus option specifies whether to indicate the presence of the Coc diagnostics in the current buffer.

By default, Coc diagnostics will be displayed if the plugin is loaded.

If Coc diagnostics are not wanted then please add the following to your initialization file:

" Vimscript initialization file
let g:mistflyWithCocStatus = v:false

-- Lua initialization file
vim.g.mistflyWithCocStatus = false

Sponsor

License