Scroll to navigation

QPDFVIEW(1) General Commands Manual QPDFVIEW(1)

NAME

qpdfview - tabbed PDF viewer

SYNOPSIS

qpdfview [options] [file(s)[#page[#top]]]

DESCRIPTION

qpdfview is a simple document viewer for PDF documents. It uses the poppler library for rendering.

OPTIONS

--unique
If an instance of qpdfview is started with this option, any files that are opened using this option afterwards, are opened as tabs in this same window. If a file is already opened in a tab of the respective window, it is merely reloaded using this option.
[file(s)[#page[#top]]]
Specifies the files to open when qpdfview starts. If this is not specified, qpdfview will open a blank window. Multiple files can be loaded in separate tabs if the file names are separated by spaces. The optional parameter #page opens the file at the given page. The optional parameter #top can take values between 0 and 1 and opens the page with the given position aligned to the top of the tab. (See examples.)

CONFIGURATION FILE

qpdfview uses a configuration file usually located at
"~/.config/qpdfview/qpdfview.conf",
which allows configuration of the toolbars and thumbnails.
 
The keys "fileToolBar", "editToolBar" and "viewToolBar" are added to the section "mainWindow". Their values are comma-separated lists. The default (available) entries are:
fileToolBar: openInNewTab, refresh (open, saveCopy, print)
editToolBar: currentPage, numberOfPages, previousPage, nextPage (firstPage, lastPage, jumpToPage, search)
viewToolBar: scaleFactor, zoomIn, zoomOut (onePage, twoPages, oneColumn, twoColumns, fitToPage, fitToPageWidth, doNotScale, rotateLeft, rotateRight, fullscreen, presentation)
The order of the items in the list defines the order of the items in the toolbar. (See examples.)
 
Setting the keys "thumbnailWidth" and "thumbnailHeight" in the section "documentView" specifies the size of the thumbnails.
 
The icon theme used by Qt can be overridden by setting the key "iconTheme" in the section "mainWindow".
 

EXAMPLES

The command
qpdfview foo.pdf#3#0.5 bar.pdf
opens foo.pdf in the first tab with the middle of page 3 aligned to the top of the tab and bar.pdf in the second tab at the beginning of the document.
 
Subsequent execution of the following commands
qpdfview --unique foo.pdf bar.pdf
qpdfview --unique foo.pdf#5
opens foo.pdf and bar.pdf, then reloads foo.pdf and displays its page 5.
 
Subsequent execution of the following commands
qpdfview --unique foo.pdf
qpdfview bar.pdf
qpdfview --unique foo1.pdf bar1.pdf
opens foo.pdf in the first window, bar.pdf in a second window and then foo1.pdf and bar1.pdf in additional tabs in the first window.
 
Adding the lines
fileToolBar=openInNewTab, refresh, saveCopy, print
editToolBar=firstPage, previousPage, currentPage, numberOfPages, nextPage, lastPage, search
viewToolBar=zoomOut, scaleFactor, zoomIn, oneColumn, twoColumns, rotateLeft, rotateRight
in section "mainWindow" of the configuration file leads to the corresponding items being displayed in the given order in the toolbars.
 

BUGS

If you find a bug, please report it at https://launchpad.net/qpdfview.

AUTHOR

Benjamin Eltzner <b.eltzner@gmx.de>
March 2012