pdfpcrc man page

pdfpcrc — pdfpc configuration file

Description

pdfpc(1) first reads its system-wide configuration file, followed by the user-specific one if it exists.

Keybindings

The following commands are accepted:

bind <key> <func> [<arg>]

Bind a key to a function, passing a specified argument for functions which require one

unbind <key>

Unbind the given key

unbind_all

Clear all the key bindings

mouse <button> <func>

Bind a mouse button to a function

unmouse <button>

Unbind a mouse button

unmouse_all

Clear all the mouse bindings

A list of all possible functions can be obtained via the -L command line option of pdfpc(1).

Options

Some permanent changes can be configured via the config file. The syntax is:

option <option_name> <option_value>

The following option_name's are recognized:

black-on-end

Add an additional black slide at the end of the presentation (bool, Default is false).

current-height

Percentage of the height of the presenter screen to be used for the current slide (int, Default is 80).

current-size

Percentage of the presenter screen to be used for the current slide (int, Default is 60).

disable-caching

see pdfpc(1)

disable-compression

see pdfpc(1)

disable-input-autodetection

Do not automatically detect type (pen or eraser) of tablet input devices (bool, Default is false).

disable-scrolling

Disable scrolling events on the presenter window (bool, Default is false).

enable-auto-srt-load

Try loading video subtitle files automatically. For each video media, pdfpc will append ".srt" to the media URI and attempt to load a subtitle file (in the SRT format) from that location (bool, Default is false).

move-on-mapped

Dual-monitor full-screen window placement is a tricky business. Some window managers (e.g., FVWM) ignore the placement if made before the window is shown. This option enables a workaround (bool, Default is false).

next-height

Percentage of the height of the presenter screen to be used for the next slide (int, Default is 70).

overview-min-size

Minimum width for the overview miniatures, in pixels (int, Default is 150).

pointer-color

Set the pointer color. Can be a literal color name or a #rrggbb representation (default is red).

pointer-opacity

Set the pointer opacity in percent (int, default is 50).

pointer-size

Set the initial pointer size, in pixels (int, default is 10).

presentation-screen

Screen to be used for the presentation (output name, see e.g. "xrandr --listmonitors").

presenter-screen

Screen to be used for the presenter (output name).

switch-screens

Switch the presentation and the presenter screen (bool, Default is false).

time-of-day

Display the current time instead of the timer

timer-pace-color

Enable color hints of the timer, continuously indicating whether the presentation is progressing according to the expected pace (bool, Default is true). See the timer operation description in pdfpc(1).

toolbox

Show the toolbox on startup (bool, Default is false).

toolbox-direction

Set the toolbox direction. LtoR, RtoL, TtoB, or BtoT for the left-to-right, right-to-left, top-to-bottom, or botton-to-top, respectively (Default is LtoR).

toolbox-minimized

Set the initial toolbox state minimized (bool, Default is false).

Examples

Key names can be obtained with the help of the xev utility. Note that names are case sensitive. Modifiers can be specified in the form <mod>+<key> where <mod> is one of S (for shift), C (for control) and A/M (for Alt/Meta). E.g.

bind S+Next    next10

A shorthand for specifying key combinations constituting shift and an alphabetic character is to simply give the uppercase version of the alphabetic character. For example, to bind <shift>+r to the 'reset' function, use

bind R reset

To always activate the black-on-end option, one could add the following to the config file

option black-on-end true

Files

/etc/pdfpcrc

System-wide configuration file

$XDG_CONFIG_DIR/pdfpc/pdfpcrc

User configuration file (if $XDG_CONFIG_DIR is not set, $HOME/.config will be used).

See Also

pdfpc(1)

Referenced By

pdfpc(1).