sponsor Vim development Vim logo Vim Book Ad

vpager : Pipe input from Vims internal terminal back into Vim

 script karma  Rating 0/0, Downloaded by 543  Comments, bugs, improvements  Vim wiki

created by
Christian Brabandt
script type
This plugin contains a shell implementation of a pager, that will take the input and send it to a vim plugin. The Vim plugin processes the input and stores it in a new window.

See also the following screencast: https://raw.githubusercontent.com/chrisbra/vpager/master/vpager.gif

This makes use of Vims built in terminal and the provided terminal API. You need at least Vim version 8.0.1647

Use the provided vpager shell script and pipe input into it. I suggest to put it into your $PATH, to be easily available.

The script supports the following options:

    This script vpager can be used as pager from inside Vims built-in
    terminal. The output will be copied to a new buffer in Vim.

    vpager [-n -C option]
    vpager [-h|-v]

    -v  display version
    -h  display help
    -C  Pass options to Vim. Can be used to e.g. set the filetype for
        correct syntax highlighting.
    -n  Clear the previous buffer in Vim
    -V  create a new vertical window in Vim

  git diff | vpager -nC 'ft=diff'

  Copies the output of git diff into a buffer inside Vim. Any previous
  output in the buffer will be cleared and the filetype will be set
  to "diff", for proper syntax highlighting.

License & Copyright

2018 by Christian Brabandt. The Vim license (see :h license) applies to the Vim plugin, the shell script is licensed under the BSD license.

install details
Copy the plugin into your Vims packpath (e.g. ~/.vim/package/dist/start/vpager), creating non-existing directories.

Or use the plugin manager of your choice with the github plugin URL https://github.com/chrisbra/vpager

rate this script Life Changing Helpful Unfulfilling 
script versions (upload new version)

Click on the package to download.

package script version date Vim version user release notes
vpager.zip 1 2018-05-08 8.0 Christian Brabandt Initial upload
ip used for rating:

If you have questions or remarks about this site, visit the vimonline development pages. Please use this site responsibly.
Questions about Vim should go to the maillist. Help Bram help Uganda.