Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
June 4, 2023 18:11
June 4, 2023 23:52
December 9, 2020 20:51



nvim-scrollview is a Neovim plugin that displays interactive vertical scrollbars and signs. The plugin is customizable (see :help scrollview-configuration).

(a scrollbar and signs can be seen near the right edge of the preceding image)


  • Handling for folds
  • Scrollbars can be dragged with the mouse
  • Partially transparent scrollbars so that text is not covered
  • Signs (diagnostics and search enabled by default)


  • nvim>=0.5
  • Scrollbar mouse dragging requires mouse support (see :help 'mouse') and nvim>=0.6
  • Signs require nvim>=0.7


A package manager can be used to install nvim-scrollview.

  • Vim8 packages:
    • git clone ~/.local/share/nvim/site/pack/plugins/start/nvim-scrollview
  • Vundle:
    • Add Plugin 'dstein64/nvim-scrollview' to ~/.config/nvim/init.vim
    • :PluginInstall or $ nvim +PluginInstall +qall
  • Pathogen:
    • git clone --depth=1 ~/.local/share/nvim/site/bundle/nvim-scrollview
  • vim-plug:
    • Add Plug 'dstein64/nvim-scrollview', { 'branch': 'main' } to ~/.config/nvim/init.vim
    • :PlugInstall or $ nvim +PlugInstall +qall
  • dein.vim:
    • Add call dein#add('dstein64/nvim-scrollview') to ~/.config/nvim/init.vim
    • :call dein#install()
  • NeoBundle:
    • Add NeoBundle 'dstein64/nvim-scrollview' to ~/.config/nvim/init.vim
    • Re-open Neovim or execute :source ~/.config/nvim/init.vim
  • packer.nvim:
    • Add use 'dstein64/nvim-scrollview' to the packer startup function
    • :PackerInstall


  • nvim-scrollview works automatically, displaying interactive scrollbars.
  • :ScrollViewDisable disables the plugin. When arguments are given, the specified sign groups are disabled.
  • :ScrollViewEnable enables the plugin. This is only necessary if nvim-scrollview has previously been disabled. When arguments are given, the specified sign groups are enabled.
  • :ScrollViewToggle toggles the plugin. When arguments are given, the specified sign groups are toggled.
  • :ScrollViewRefresh refreshes the scrollbars and signs. This is relevant when the scrollbars or signs are out-of-sync, which can occur as a result of some window arrangement actions.
  • :ScrollViewNext, :ScrollViewPrev, :ScrollViewFirst, and ScrollViewLast move the cursor to lines with signs. Arguments can specify which sign groups are considered.
  • The scrollbars can be dragged and signs can be clicked. This requires a corresponding mapping, which is automatically configured when scrollview_auto_mouse is set (see :help scrollview-mouse-customization).


There is built-in support for various types of signs (referred to as "sign groups"), listed below. The functionality is similar to the sign column, but with the same positioning logic as the scrollbar.

  • conflicts: git merge conflicts
  • cursor: cursor position
  • diagnostics: errors, warnings, info, and hints
  • folds: closed folds
  • loclist: items on the location list
  • marks
  • quickfix: items on the quickfix list
  • search
  • spell: spell check items when the spell option is enabled
  • textwidth: line lengths exceeding the value of the textwidth option, when non-zero
  • trail: trailing whitespace, when the list option is enabled and the listchars option includes "trail"

search and diagnostics groups are enabled by default. To modify which sign groups are enabled, set scrollview_signs_on_startup accordingly in your Neovim configuation (see :help scrollview_signs_on_startup), or use :ScrollViewEnable {group1} {group2} ... to enable sign groups in the current Neovim session.

The plugin was written so that it's possible to extend the sign functionality in a Neovim configuration file or with a plugin. See the documentation for details. Plugin authors can tag their repos with scrollview-signs for discoverability.


There are various settings that can be configured. Please see the documentation for details.

VimScript Example

let g:scrollview_excluded_filetypes = ['nerdtree']
let g:scrollview_current_only = v:true
let g:scrollview_winblend = 75
" Position the scrollbar at the 80th character of the buffer
let g:scrollview_base = 'buffer'
let g:scrollview_column = 80
" Enable all sign groups (defaults to ['diagnostics', 'search']).
" Set to the empty list to disable all sign groups.
let g:scrollview_signs_on_startup = ['all']
" Show diagnostic signs only for errors.
let g:scrollview_diagnostics_severities =
      \ [luaeval('vim.diagnostic.severity.ERROR')]

Lua Setup Example

  excluded_filetypes = {'nerdtree'},
  current_only = true,
  winblend = 75,
  base = 'buffer',
  column = 80,
  signs_on_startup = {'all'},
  diagnostics_severities = {vim.diagnostic.severity.ERROR}


Documentation can be accessed with:

:help nvim-scrollview

The underlying markup is in scrollview.txt.


Documentation for issues, along with some workarounds, can be accessed with:

:help scrollview-issues

Some of the known issues are regarding scrollbar synchronization, error messages, session restoration, and scrollbar floating windows being included in the window count returned by winnr('$').


The source code has an MIT License.