Sync with upstream
[llpp/slowscroll.git] / KEYS
blobf8fcbd52f7b35c39409a8026e23834653adb7f59
1 -----Quitting-----
2 escape/q                - quit
3 Q                       - quit without saving the configuration or changes
4 W                       - save changes
6 -----Movement-----
7 up/down arrow           - scroll up/down
8 j/k                     - scroll up/down
9 left/right arrow        - pan left/right (when zoomed in)
10 Ctrl-arrows             - scroll up/down, pan left/right (by half a screen width/height)
11 space                   - go to the next page
12 delete                  - go to the previous page
13 pageup/pagedown         - go forward/backward one screen-full
14 g, G                    - go to first/last page
15 home/end                - go to first/last page
17 -----Advanced Movement / History-----
18 backspace               - go back after jumping (clicking link and suchlike) [1]
19 Alt-left/right arrow    - go backward/forward in history
20 0..9                    - enter page number to jump to
21 t                       - align top of the screen with the top of the page
22 <,>                     - rotate
23 Ctrl-pageup/pagedown    - align top of the screen with first/last visible page
24 F                       - go to hinted link
25 a                       - autoscroll
26 if auto scrolling is active:
27     up/down arrows and mouse buttons 3/4 will make scrolling go faster/slower
29 -----Mouse-----
30 primary mouse button[2] - click on link or select text[3]
31   when shift is held    - execute "synctex command" with coordinates of the point [4]
32   when control is held  - pan
33   zoom to block         - when in block zoom mode
34   otherwise             - pan if there's no text/link under the cursor
35 mouse buttons 3/4       - scroll up/down (aka mouse wheel)
36   when control is held  - zoom
37 mouse buttons 5/6       - pan left/right (aka horizontal mouse wheel)
38 other mouse button[2]   - select rectangle to zoom to
39   when shift is held    - add text annotation
41 Note:
42   moving mouse while holding primary mouse button will pan the page,
43   if the mouse is over selectable element (text/link) holding control
44   will make the page pan instead of the default action (selecting text/
45   clicking link)
47 -----Bookmarks-----
48 m                       - create named bookmark
49 ~                       - create quick bookmark
51 -----Zoom-----
52 control + shift up/down - set previous zoom level
53 B                       - toggle zoom block mode
54 w                       - change height of the window to encompass all of the page
55 Alt-c                   - center view
56 Ctrl-+/Ctrl-=           - zoom in
57 Ctrl--                  - zoom out
58 Ctrl-0                  - reset zoom and panning
59 Ctrl-1                  - fit tallest page
60 Ctrl-2                  - fit tallest page height exactly
61 Ctrl-3                  - cycle fit models
62 Ctrl-4                  - 1:1 zoom
63 Ctrl-9/F9               - enter bird's eye view
65 -----Actions-----
66 u                       - dehighlight
67 r                       - reload document [5]
68 y                       - select link and paste its description to the clipboard
69 |                       - pipe selection through specified command
70 x                       - run pax command on selected region
71 Ctrl-p                  - launch a command with the document path as an argument
72 return                  - (in link navigation mode) follow link
73 =                       - show current position
74 e                       - view error log
75 z                       - crop
77 -----Search-----
78 /,?                     - enter text to search for (/ - forward, ? - backward)
79 n                       - repeat last search (forward)
80 p, N                    - repeat last search (backward)
81 Ctrl-g                  - interrupt search
83 -----Settings / Modes-----
84 [,]                     - decrease/increase page brightness
85 +                       - set page bias
86 -                       - toggle/set tunable
87 b                       - toggle scroll bar
88 l                       - toggle highlighting of the links
89 f                       - toggle fullscreen
90 insert                  - toggle link navigation mode
91 o                       - switch to outline/table of contents mode
92 '                       - switch to bookmark mode
93 H                       - switch to history mode
94 h,F1                    - switch to help mode
95 i                       - switch to info mode
96 P                       - switch to "presentation" mode
97 c                       - switch to previous column layout
99 -----Tunables-----
100 -i                      - toggle case sensitivity of searches
101 -s<number>              - set scroll step (pixels)
102 -S<number>              - set space between pages (pixels)
103 -c                      - toggle crop hack
104 -a                      - toggle throttled scrolling
105 -R<number>              - rotate
106 -p                      - toggle preloading
107 -v                      - toggle verbosity
108 -P                      - toggle persistent bookmarks
109 -h                      - toggle maxfit
110 -l                      - toggle proportional display
111 -Z<number>              - set zoom (percent)
112 -A<number>              - set auto scroll step (pixels)
113 -t<number>              - set thumbnail width (pixels)
114 -T                      - toggle trimming of margins
115 -I                      - invert colors
116 -M                      - toggle pax mode
117 -C<number>              - set column count
118 -x<string>              - set command to run on selection
119 -f                      - toggle "what's under cursor" identification
120                         - (or "what's currently selected" in link navigation mode)
121                         -     (font name of the text under cursor or link target)
123 -----Bird's eye mode-----
124 Ctrl-9,F9,esc           - leave bird's eye view
125 Ctrl-l                  - center the view on the currently selected page
126 (page)up/(page)down     - navigate
127 home/end                - go to first/last page
128 enter                   - select the page and leave bird's eye mode
129 1st mouse button        - select the page under cursor and leave bird's eye mode
131 -----Outline/bookmark/help/info/history mode-----
132 esc                     - leave outline/bookmark mode
133 up/down                 - select previous/next item
134 alpha-numeric           - quick search
135 Ctrl-s                  - repeat search (forward)
136 Ctrl-r                  - repeat search (backward)
137 Ctrl-l                  - center on current item
138 Ctrl-left/right         - pan text left/right
139 Ctrl-up/down            - scroll view up/down
140 Ctrl-insert             - copy active item's text to clipboard
142 -----Outline/history mode-----
143 left/right              - go up/down a level
144 Ctrl-a                  - toggle auto narrowing
145 /                       - enter auto narrowing
146 tab                     - begin nested narrowing
147 Ctrl-n                  - narrow to search pattern
148 Ctrl-u                  - undo narrowing
149 Ctrl-S                  - synchronize
151 -----Info mode-----
152 enter                   - toggle/enter new value for selected parameter
154 -----When entering search pattern/page number-----
155 up/down arrow           - previous/next entered text
156 enter                   - confirm
157 Ctrl-g,esc              - cancel
159 double/triple/quadruple/... clicks in view mode will pipe the
160 word/line/block/page through pax command when control is held
161 and selection command otherwise
163 [1] if the document was previously visited initial backspace will
164     jump to the last visited place
166 [2] i'm somewhat mouse button confused, since i use "left handed" mouse
167     while not being left handed
169 [3] text selection requires
170     X11     - xsel http://www.vergenet.net/~conrad/software/xsel/
171     ⋯       - xclip https://github.com/astrand/xclip
172     Windows - wsel http://repo.or.cz/w/llpp.git/blob/master:/wsel.c
173     OS X    - pbcopy ships with the system
175 [4] arguments to the command are:
176     1 = path to the document
177     2 = zero based page number
178     3 = X coordinate within the page
179     4 = Y ..........................
181 [5] document will also be reloaded upon reception of the HUP signal
183 -----Caveat emptor-----
184 o Selection can not cross page boundaries
185 o Text searching is very naive