Skip to content

Known Working PDF Viewers

Ignacio edited this page Apr 16, 2019 · 25 revisions

Generally, a PDF viewer with auto reload feature should work with vim-latex-live-preview. That is, when the pdf file opened by the viewer changes on the disk, the viewer automatically refreshes automatically. If a PDF viewer does not work, it is likely that the PDF viewer does not support auto reload. At this moment, unfortunately, we can do nothing about it to support this kind of PDF viewer on our side.

Here is a list of PDF viewers that are known to work (or partially work) with vim-latex-live-preview. Some PDF viewers would crash if you set updatetime to a very small value; if this happens, just increase the value of updatetime and try again. Built-in means vim-latex-live-preview would detect the pdf viewer automatically and choose it for you without your extra configuration. The detecting order is first evince and then okular. Feel free to add any new pdf viewers that work for you.

  • Evince (Built-in): let g:livepreview_previewer = 'evince'
    • On OS X: Evince 3 or later from MacPorts works
  • Okular (Built-in): let g:livepreview_previewer = 'okular'
  • Skim (doesn't work well when the pdf file updates too frequently): let g:livepreview_previewer = 'open -a Skim'
  • Preview (OS X): let g:livepreview_previewer = 'open -a Preview', the preview only updates when you move the focus on the Preview application.
  • MuPDF: let g:livepreview_previewer = 'mupdf'
  • vprerex Or for ubuntu (http://manpages.ubuntu.com/manpages/xenial/man1/vprerex.1.html) let g:livepreview_previewer = 'vprerex'
  • GV works flawlessly, can handle very fast updates。 Note: To enable updating in gv you must go to the top left ui icon that says "State" Then while holding left mouse button scrolling on top of "Watch file" It will make gv watch the pdf file for live updates. To complete it let go of the left mouse button and it will be selected. Happy coding! let g:livepreview_previewer = 'gv'
  • xreader works as expected: let g:livepreview_previewer = 'xreader'
  • zathura works as expected: let g:livepreview_previewer = 'zathura'
Clone this wiki locally