1QPDFVIEW(1)                 General Commands Manual                QPDFVIEW(1)
2
3
4

NAME

6       qpdfview - tabbed document viewer
7

SYNOPSIS

9       qpdfview [options] [--] [file[#page]] [file[#src:name:line:column]] ...
10

DESCRIPTION

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

OPTIONS

17       --help Displays usage information.
18
19       --quiet
20              Suppresses  warning  messages which are displayed if the program
21              fails to open a file.
22
23       --search text
24              Initiates a search for text in the current tab.
25
26       --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
32       --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
39       --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
42              instances that have tabs stored as suggestions.
43
44       [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
49       [file[#src:name:line:column]]
50              Forward  search  using  SyncTeX  is performed using the optional
51              parameters 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

INTER-PROCESS COMMUNICATION

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
61       "local.qpdfview.name/MainWindow".
62

CONFIGURATION FILES

64       qpdfview uses configuration files usually located at
65              "~/.config/qpdfview"
66       with the majority of settings contained in "qpdfview.conf".
67
68       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
72       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
76       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
80       The mimimum 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
84       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
88       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

EXAMPLES

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
97              beginning of the document.
98
99              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
104              The command
105       qpdfview --search foo bar.pdf
106              opens "bar.pdf" in the first tab and starts a search for "foo".
107
108              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
115              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
125              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
139              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
147              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
153              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
161

BUGS

163       If you find a bug, please report it at
164              "https://launchpad.net/qpdfview".
165
166
167
168                                   July 2012                       QPDFVIEW(1)
Impressum