Skip to content
/ pdq Public

a minimalistic PDF viewer with keyboard navigation, bookmarks and annotations

License

Notifications You must be signed in to change notification settings

amkhlv/pdq

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

a minimalistic PDF viewer with keyboard navigation, bookmarks and annotations

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published