1PDFPCRC(5) File Formats Manual PDFPCRC(5)
2
6 pdfpcrc - pdfpc configuration file
7
10 pdfpc(1) first reads its system-wide configuration file, followed by
11 the user-specific one if it exists.
12 Keybindings
15 The following commands are accepted:
16 bind <key> <action> [<arg>]
18 Bind a key to an action, passing a specified argument for
19 actions that require one
20 unbind <key>
22 Unbind the given key
23 unbind_all
25 Clear all the key bindings
26 mouse <button> <action>
28 Bind a mouse button to an action
29 unmouse <button>
31 Unbind a mouse button
32 unmouse_all
34 Clear all the mouse bindings
35 Key names can be obtained with the help of the xev(1) utility. Note
38 that names are case sensitive. Key combinations with modifiers can be
39 specified in the form <mod>+<key>, where <mod> is one of S (for shift),
40 C (for control) and A/M (for Alt/Meta).
41 A shorthand for specifying key combinations constituting shift and an
44 alphabetic character is to simply give the uppercase version of the
45 alphabetic character. For example, S+r and R are equivalent.
46 A list of all possible actions can be obtained via the -L command line
49 option of pdfpc(1). Use the -B command line option to list the action
50 bindings defined.
51 Options
54 Some permanent changes can be configured via the config file. The syn‐
55 tax is:
56 option <option_name> <option_value>
58 The following option_name's are recognized:
61 black-on-end
64 Add an additional black slide at the end of the presentation
65 (bool, Default is false).
66 cache-clean-period
68 Period (in units of s) to check for expired cached content (int,
69 Default is 60).
70 cache-expiration
72 Time (in units of s) to keep (pre)rendered slides in the cache
73 (int, Default is 600). Set to a negative value to keep cached
74 slides permanently.
75 cache-max-rtime
77 Maximal time (in units of ms) it takes to render a slide for its
78 cache to be protected from expiration (int, Default is 1000).
79 cache-min-rtime
81 Minimal time (in units of ms) it takes to render a slide for it
82 to be cached (int, Default is 10).
83 cache-max-usize
85 Maximal size (in units of kB) of a slide image to store it
86 uncompressed in the cache (int, Default is 256).
87 current-height
89 Percentage of the height of the presenter screen to be used for
90 the current slide (int, Default is 80).
91 current-size
93 Percentage of the presenter screen to be used for the current
94 slide (int, Default is 60).
95 disable-input-autodetection
97 Do not automatically detect type (pen or eraser) of tablet input
98 devices (bool, Default is false).
99 disable-input-pressure
101 Ignore pressure sensitivity of tablet input devices (pen or
102 eraser) even when it is supported by the hardware (bool, Default
103 is false).
104 disable-scrolling
106 Disable scrolling events on the presenter window (bool, Default
107 is false).
108 disable-tooltips
110 Disable tooltips for the toolbox (bool, Default is false).
111 enable-auto-srt-load
113 Try loading video subtitle files automatically. For each video
114 media, pdfpc will append ".srt" to the media URI and attempt to
115 load a subtitle file (in the SRT format) from that location
116 (bool, Default is false).
117 final-slide
119 Show the final slide of an overlay group instead of the next
120 slide. If the user reaches the last slide of the overlay group
121 the next slide will be shown again.
122 move-on-mapped
124 Dual-monitor full-screen window placement is a tricky business.
125 Some window managers (e.g., FVWM) ignore the placement if made
126 before the window is shown. This option enables a workaround
127 (bool, Default is false).
128 next-height
130 Percentage of the height of the presenter screen to be used for
131 the next slide (int, Default is 70).
132 overview-min-size
134 Minimum width for the overview miniatures, in pixels (int,
135 Default is 150).
136 pointer-color
138 Set the pointer color. Can be a literal color name or a #rrggbb
139 representation (default is red).
140 pointer-opacity
142 Set the pointer opacity in percent (int, default is 50).
143 pointer-size
145 Set the initial pointer size, in pixels (int, default is 10).
146 prerender-delay
148 Delay (in seconds) to launch the pre-rendering process after a
149 slide change (int, default is 4).
150 prerender-slides
152 Number of slides ahead of the current one to pre-render (int,
153 default is 2). Set to 0 to disable the pre-rendering; set to a
154 negative number to pre-render all at once.
155 presentation-screen
157 Screen to be used for the presentation (output name, see e.g.
158 "xrandr --listmonitors").
159 presenter-screen
161 Screen to be used for the presenter (output name).
162 spotlight-opacity
164 Set opacity of the area outside of the spotlight, in percent
165 (int, default is 50).
166 spotlight-size
168 Set the initial spotlight size, in pixels (int, default is 100).
169 switch-screens
171 Switch the presentation and the presenter screen (bool, Default
172 is false).
173 time-of-day
175 Display the current time instead of the timer
176 timer-pace-color
178 Enable color hints of the timer, continuously indicating whether
179 the presentation is progressing according to the expected pace
180 (bool, Default is true). See the timer operation description in
181 pdfpc(1).
182 toolbox
184 Show the toolbox on startup (bool, Default is false).
185 toolbox-direction
187 Set the toolbox direction. LtoR, RtoL, TtoB, or BtoT for the
188 left-to-right, right-to-left, top-to-bottom, or botton-to-top,
189 respectively (Default is LtoR).
190 toolbox-minimized
192 Set the initial toolbox state minimized (bool, Default is
193 false).
194 transition-fps
196 Frames-per-second for slide transitions (int, Default is 25).
197 Set to 0 to disable all transitions.
198 windowed-mode
200 Set the initial windowed mode: none, presenter, presentation, or
201 both (Default is none).
202
205 To change the drawing pen color using the numerical pad keys:
206 bind S+KP_1 setPenColor red
208 bind S+KP_2 setPenColor green
209 bind S+KP_3 setPenColor blue
210 To always activate the black-on-end option, one could add the following
213 to the config file
214 option black-on-end true
216
219 /etc/pdfpcrc
220 System-wide configuration file
221 $XDG_CONFIG_HOME/pdfpc/pdfpcrc
223 User configuration file (if $XDG_CONFIG_HOME is not set,
224 $HOME/.config will be used).
225
229 pdfpc(1)
230 PDFPCRC(5)