1QPDFVIEW(1) General Commands Manual QPDFVIEW(1)
2
6 qpdfview - tabbed document viewer
7
9 qpdfview [options] [--] [file[#page]] [file[#src:name:line:column]] ...
10
12 qpdfview is a simple viewer for document files in the portable document
13 format (PDF). It uses the Poppler library for rendering and the Qt
14 toolkit for its interface.
15
17 --help Displays usage information.
18 --quiet
20 Suppresses warning messages which are displayed if the program
21 fails to open a file.
22 --search text
24 Initiates a search for text in the current tab.
25 --unique
27 If an instance of qpdfview is started with this option, any
28 files that are opened using this option afterwards, are opened
29 as tabs in the original window. If a file is already opened in a
30 tab of the original window, it is merely reloaded.
31 --instance name
33 Uses name as the name of the instance contacted or created using
34 the "--unique" option. This allows one to run multiple instances
35 and remotely open and refresh tabs in any of them by passing the
36 instance name. The argument must only contain the characters
37 "[A-Z][a-z][0-9]_" and must not begin with a digit.
38 --choose-instance
40 Can be combined with the "--unique" option to display a dialog
41 at start-up where the instance name can be chosen with all in‐
42 stances that have tabs stored as suggestions.
43 [file[#page]]
45 file specifies the file to open. The optional parameter page
46 opens the file at the given page. Multiple files will be opened
47 in separate tabs.
48 [file[#src:name:line:column]]
50 Forward search using SyncTeX is performed using the optional pa‐
51 rameters name which is the name of the source file, line which
52 is the line number in the source file and column which is the
53 column number in the source file where the number 0 matches all
54 lines respectively columns.
55
57 If the program is invoked using the "--unique" option, it registers an
58 introspectable D-Bus interface at "local.qpdfview/MainWindow" which can
59 be used to communicate with the application. If the "--instance" option
60 is used, the D-Bus interface is registered at "lo‐
61 cal.qpdfview.name/MainWindow".
62
64 qpdfview uses configuration files usually located at
65 "~/.config/qpdfview"
66 with the majority of settings contained in "qpdfview.conf".
67 Persitent state like per-file settings, bookmarks and tabs is stored in
69 an SQLite database usually located at
70 "~/.local/share/data/qpdfview/qpdfview".
71 The icon theme used by Qt can be changed by setting the key "iconTheme"
73 in the section "mainWindow". The application-wide Qt style sheet can be
74 changed by setting the key "styleSheet" in the section "mainWindow".
75 The tile size in pixels used for tiled rendering can be adjusted by
77 setting the key "tileSize" in the section "pageItem". The default value
78 is 1024 pixels.
79 The minimum resp. maximum scale factor can be modified by changing the
81 keys "minimumScaleFactor" resp. "maximumScaleFactor" in the section
82 "documentView". The default values are 0.1 resp. 10.0.
83 The timeout for auto-refresh resp. prefetch can be changed by setting
85 the keys "autoRefreshTimeout" resp. "prefetchTimeout" in the section
86 "documentView". The defaults are 750 resp. 250 milliseconds.
87 The maximum number of per-file settings can be modified by changing the
89 key "perFileSettingsLimit" in the section "mainWindow". The default
90 value is 1000.
91
93 The command
94 qpdfview foo.pdf#3 bar.pdf
95 opens "foo.pdf" in the first tab displaying the third page of
96 the document and "bar.pdf" in the second tab displaying the be‐
97 ginning of the document.
98 The command
100 qpdfview --quiet foobar/*
101 opens all files that can be opened in the directory "foobar",
102 suppressing warning messages for files that cannot be opened.
103 The command
105 qpdfview --search foo bar.pdf
106 opens "bar.pdf" in the first tab and starts a search for "foo".
107 Subsequent execution of the commands
109 qpdfview --unique foo.pdf bar.pdf
110 and
111 qpdfview --unique foo.pdf#5
112 opens "foo.pdf" and "bar.pdf", then reloads "foo.pdf" and dis‐
113 plays its fifth page.
114 Subsequent execution of the commands
116 qpdfview --unique foo.pdf
117 and
118 qpdfview bar.pdf
119 and
120 qpdfview --unique foo1.pdf bar1.pdf
121 opens "foo.pdf" in the first window, "bar.pdf" in a second win‐
122 dow and then "foo1.pdf" and "bar1.pdf" in additional tabs in the
123 first window.
124 Subsequent execution of the commands
126 qpdfview --unique --instance a foo1.pdf bar1.pdf
127 and
128 qpdfview --unique --instance b foo2.pdf bar2.pdf
129 and
130 qpdfview --unique foo3.pdf bar3.pdf
131 and
132 qpdfview --unique --instance a foo1.pdf#4 bar4.pdf
133 opens "foo1.pdf" and "bar1.pdf" in the first window, "foo2.pdf"
134 and "bar2.pdf" in the second window, "foo3.pdf" and "bar3.pdf"
135 in the third window and then reloads "foo1.pdf" and displays its
136 fourth page and opens "bar4.pdf" in an additional tab in the
137 first window.
138 Subsequent execution of the commands
140 qpdfview --unique --instance a foo.pdf bar.pdf
141 and
142 qpdfview --unique --instance a --search foobar
143 opens "foo.pdf" and "bar.pdf" in a window and then starts a
144 search for the term "foobar" in the document in the active tab
145 (which is the last opened "bar.pdf").
146 The command
148 qpdfview --unique foobar.pdf#src:foobar.tex:42:0
149 opens or refreshes "foobar.pdf" jumping to and highlighting the
150 position that corresponds to line 42 of the source file "foo‐
151 bar.tex".
152 The lines
154 [documentView]
155 autoRefreshTimeout=1250
156 [mainWindow]
157 styleSheet="QTabBar::tab { max-width: 150px; }"
158 will configure the auto-refresh timeout to 1250 milliseconds and
159 the change the maximum tab width to 150 pixel.
160
163 If you find a bug, please report it at
164 "https://launchpad.net/qpdfview".
165 July 2012 QPDFVIEW(1)