Skip to content

nvimdev/spaceline.vim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

spaceline.vim

The best vim statusline plugin.

new

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 none
arrow arrow
arrow-fade arrow-fade
curve curve
slant slant
slant-fade slant-fade
slant-cons 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_status custom vim status display. Default is
 {"n": "πŸ… ","V":"πŸ…₯ ","v":"πŸ…₯ ","\<C-v>": "πŸ…₯ ","i":"πŸ…˜ ","R":"πŸ…‘ ","s":"πŸ…’ ","t":"πŸ…£ ","c":"πŸ…’ ","!":"SE"}
  • g:spaceline_custom_buffer_number custom buffer number display value is list

  • g:spaceline_diagnostic_tool set your diagnostic plugin. Default is coc, other values are: nvim_lsp, ale

  • g:spaceline_diagnostic_errorsign set the error sign. Default is ●

  • g:spaceline_diagnostic_warnsign set the warn sign. Default is ●

  • g:spaceline_diagnostic_oksign set the ok sign. Default is ο’‘

  • g:spaceline_git_branch_icon set the git branch icon default is empty

  • g:spaceline_custom_diff_icon custom diff icon. Default is

 ['ο‘—','ο‘™','ο‘˜']
  • g:spaceline_diff_tool set the git diff tool default is coc. Other values are: git-gutter, which requires the vim-gitgutter plugin; vim-signify, which requires the vim-signify plugin.

  • g:spaceline_function_icon set the function icon

  • g:spaceline_scroll_bar_chars set 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