spaceline.vim
April 14, 2021 ยท View on GitHub
The best vim statusline plugin.

Features
- Fast load speed
- More separator support
- Highly customizable
- More beautiful than other statusline plugins
- Special color scheme
- File icon syntax highlight
- Scroll bar
Install
- Easy installed with a plugin manager like vim-plug
Plug 'glepnir/spaceline.vim'
" Use the icon plugin for better behavior
Plug 'ryanoasis/vim-devicons' or 'kyazdani42/nvim-web-devicons' --neovim only
Options
- spaceline provide some separator groups, the default group is
arrow
let g:spaceline_seperate_style = 'arrow'
| group | Screen shot |
|---|---|
none | ![]() |
arrow | ![]() |
arrow-fade | ![]() |
curve | ![]() |
slant | ![]() |
slant-fade | ![]() |
slant-cons | ![]() |
- Use this setting to change the spaceline colorscheme, now builtin colorscheme
space,one,nord,dracula
let g:spaceline_colorscheme = 'space'
g:spaceline_custom_vim_statuscustom vim status display. Default is
{"n": "๐
","V":"๐
ฅ ","v":"๐
ฅ ","\<C-v>": "๐
ฅ ","i":"๐
","R":"๐
ก ","s":"๐
ข ","t":"๐
ฃ ","c":"๐
","!":"SE"}
-
g:spaceline_custom_buffer_numbercustom buffer number display value is list -
g:spaceline_diagnostic_toolset your diagnostic plugin. Default iscoc, other values are:nvim_lsp,ale -
g:spaceline_diagnostic_errorsignset the error sign. Default isโ -
g:spaceline_diagnostic_warnsignset the warn sign. Default isโ -
g:spaceline_diagnostic_oksignset the ok sign. Default is๏ก -
g:spaceline_git_branch_iconset the git branch icon default is empty -
g:spaceline_custom_diff_iconcustom diff icon. Default is
['๏','๏','๏']
-
g:spaceline_diff_toolset the git diff tool default iscoc. Other values are:git-gutter, which requires the vim-gitgutter plugin;vim-signify, which requires the vim-signify plugin. -
g:spaceline_function_iconset the function icon -
g:spaceline_scroll_bar_charsset the scroll bar chars. Some alternatives:
" one char wide solid vertical bar This is default
let g:spaceline_scroll_chars = [
\ ' ', 'โ', 'โ', 'โ', 'โ', 'โ
', 'โ', 'โ', 'โ'
\ ]
" two char wide fade-in blocks
let g:spaceline_scroll_chars = [
\ ' ', 'โ ', 'โ ', 'โ ', 'โ ', 'โโ', 'โโ', 'โโ', 'โโ'
\ ]
" three char wide solid horizontal bar
let g:spaceline_scroll_chars = [
\ ' ', 'โ ', 'โ ', 'โ ', 'โ ',
\ 'โ ', 'โ ', 'โ ', 'โ ', 'โโ ',
\ 'โโ ', 'โโ ', 'โโ ', 'โโ ', 'โโ ',
\ 'โโ ', 'โโ ', 'โโโ', 'โโโ', 'โโโ',
\ 'โโโ', 'โโโ', 'โโโ', 'โโโ', 'โโโ'
\ ]
let g:spaceline_scroll_chars = ['โบ', 'โป', 'โ', 'โผ', 'โฝ'] " on macOS
let g:spaceline_scroll_chars = ['โบ', 'โป', 'โผ', 'โฝ', 'โฏ'] " on Linux
Goyo Support
- check out thinkvim usage
FAQ
- Why do the symbols look weird in my vim?
Make sure you have installed nerdfont font from https://www.nerdfonts.com/, different fonts may be inconsistent in the performance of symbols. If you are using iTerm2 on macOS, you can set a different font for symbols.
Another solution is to use kitty terminal. Kitty has built-in symbol font support and supports both Mac and Linux.
License
MIT






