Skip to content

Latest commit

 

History

History
118 lines (94 loc) · 3.21 KB

README.md

File metadata and controls

118 lines (94 loc) · 3.21 KB

Description

A minimalistic PDF viewer with ergonomic keyboard shortcuts, bookmarks and annotations.

Known bug

When run forwarded over ssh -X, incorrect rendering at first run (see bug report). I don't know how to fix this...

Invocation

pdq filename.pdf

Command line options

-p <n>   open on page <n>

Keyboard Shortcuts

ActionKeyboard Shortcut  Button
Reload fileCtrl-l
Next Pagen
Previous Pagep
Scroll Up Slowk
Scroll Up FastShift-k
Scroll Down Slowj
Scroll Down FastShift-j
Scroll Left Slowh
Scroll Left FastShift-h
Scroll Right Slowl
Scroll Right FastShift-l
Zoom In.
Zoom Out,
Go back after link jumpb
Search ForwardCtrl-s𝒮
Search BackCtrl-r
Give Up SearchingCtrl-g𝒢
Stop SearchingReturn
Open bookmarksCtrl-b
Add bookmarkaa
Go to pageggo
Extract textttxt
Copy path to .pdf to clipboardcc

Bookmarks for the file filename.pdf (or just fielname) are stored in the XML file filename.pdq; the file is created when you add a new bookmarks (press a), or just open the bookmarks manager (press Ctrl-b).

Using the bookmarks manager

It lists bookmarks with charhints (a,b,c,d,...). Pressing the corresponding letter navigates to that bookmarked page. Pressing the letter with Shift (as if a capital letter) removes that bookmark.

Making annotations

Creating annotaions

Right click with mouse on the place where you want to place the anchor. The dialog for entering annotation will pop up.

To display an annotation, left-click on its anchor.

Annotations are saved in the same filename.pdq as bookmarks.

Editing or moving annotations

Right-click within the existing anchor (a colored circle). The anchor will disappear. Right-click again on where you want the anchor to be. The old text will be pre-filled in the dialog. (To delete the anchor, just cancel istead of ok.)

Configuration file

The configuration file is ~/.config/pdq.xml

Example is:

<config>
<dpi>112</dpi>
<invert/>
</config>

The presence of <invert/> leads to white-on-black display. The <dpi>112</dpi> is the initial DPI.