Provided by: pdf-presenter-console_4.6.0-1_amd64 
NAME
pdfpc - PDF presenter console with multi-monitor support
SYNOPSIS
pdfpc [options] PDF-file
DESCRIPTION
pdfpc is a GTK-based presentation viewer which uses Keynote-like multi-monitor output to
provide meta information to the speaker during the presentation. It is able to show a
normal presentation window on one screen while showing a more sophisticated overview on
the other one, providing information like a picture of the next slide, as well as the time
left in the presentation. pdfpc processes PDF documents, which can be created using nearly
all modern presentation software.
By default the presenter view appears in the primary monitor and the presentation view in
the second monitor (provided you have two monitors).
OPTIONS
-B, --list-bindings
List action bindings defined
-C, --time-of-day
Display the time of the day
-d, --duration=N
Duration in minutes of the presentation used for timer display. If not given or if
a value of 0 is specified, the clock just measures the time in the presentation.
-e, --end-time=T
End time of the presentation. (Format: HH:MM (24h))
-f, --note-format=FORMAT
Enforce format of notes (plain or markdown. Default: markdown)
-g, --disable-auto-grouping
Disable auto detection of overlay groups. (Default: enabled)
-h, --help
Show this help
-l, --last-minutes=N
In the old timer mode (see Timer below), defines time in minutes before the end of
the talk when the timer changes its color. (Default: 5 minutes)
-L, --list-actions
List actions supported
-M, --list-monitors
List monitors known to the operating system
-n, --notes=P
Position of second-screen beamer notes on the PDF page (left, right, top, bottom,
or none. Default: none). Note that this disables slide auto-grouping.
-N, --no-install
Allow for testing pdfpc without proper installation. Icons, configuration files,
etc. will be loaded from the source path locations. Mostly intended for developers.
-p, --rest-port
Port the REST server binds to. (Default: 8088)
-P, --page
Go to a specific page directly after startup. In case of overlays, the first slide
will be displayed.
-r, --page-transition=TRANSITION
Set default page transition. The TRANSITION specification is of the form
type[:duration[:angle[:alignment[:direction]]]]. See the Page transitions section
for the list of supported types. duration is in seconds and set to 1 by default.
The accepted values for angle are 0/90/180/270; alignment can be h[orizontal] of
v[ertical] and direction i[nward] or o[utward]. The last three optional settings
are meaningless for some of the transition types and can be left empty. Examples:
"push", "dissolve:1.5", "wipe:1:90", "split:1::vertical:outward".
-R, --pdfpc-location=LOCATION
Use custom pdfpc file.
-s, --switch-screens
Switch the presentation and the presenter screen.
-S, --single-screen
Force to use only one screen
-t, --start-time=T
Start time of the presentation to be used as a countdown. (Format: HH:MM (24h))
-T, --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.
-V, --enable-rest-server
Enable REST server for remote control of pdfpc.
-W, --wayland-workaround
Enable Wayland-specific workaround. This might fix HiDPI scaling problems.
-w, --windowed=MODE
Run in the given windowed mode (presenter|presentation|both|none). The default mode
is "presenter" (only the presentation window is fullscreen).
-X, --external-script=FILENAME
Specify a script to be executed with the 'X' (Shift+x) key during the presentation.
The script must be executable but can otherwise be written in any language. The
script is called with the following command line arguments:
• Name of pdf file
• Total slide count
• Current slide number
• Current user slide number
If the script exits with a non-zero return value, whatever the script wrote to
stdout is printed in the console. Otherwise nothing is printed.
-Z, --size
Size of the presentation window in width:height format (forces windowed mode)
-1, --presenter-screen=MONITOR
Monitor to be used for the presenter screen (see the -M option).
-2, --presentation-screen=MONITOR
Monitor to be used for the presentation screen (see the -M option).
KEYBINDINGS
These are the default keybindings for pdfpc:
Right cursor key / Down cursor key / Page down / Return / Space / 1st mouse button / Mouse
wheel down
Go forward one slide
Left cursor key / Up cursor key / Page up / Backspace / 3rd mouse button / Mouse wheel up
Go back one slide
Shift + Page down
Go forward one user slide (see Overlays below)
Shift + Page up
Go back one user slide (see Overlays below)
Shift + Right cursor key / 1st mouse button / Mouse wheel down
Go forward 10 slides
Shift + Left cursor key / 3rd mouse button / Mouse wheel up
Go back 10 slides
Shift + n
Go forward 1 slide irrespectively of its "hidden" attribute
Shift + p
Go backward 1 slide irrespectively of its "hidden" attribute
Home Go to the first slide
End Go to the last slide
Shift + Backspace / Shift + Space
Go back /forward in history.
Shift + Home / Shift + End
Go to the previous / next slide, skipping over overlays that have already been
viewed, but at most one user slide.
Tab / 2nd mouse button
Overview mode
g Input a slide number to jump to
m Bookmark the current slide and store it in the .pdfpc file for later usage
Shift + m
Load the bookmarked slide which was saved with m before
t Toggle the toolbox
1 / KP_1
Switch to the normal mode (pen/eraser and pointer are off)
2 / KP_2
Switch the pointer mode on
3 / KP_3
Switch the pen drawing mode on
4 / KP_4
Switch the eraser drawing mode on
5 / KP_5
Switch the spotlight mode on
Plus / KP_Add / Equal
Depending on the current mode, increase font size of notes or pointer size or the
size of pen or eraser or spotlight
Minus / KP_Subtract
Depending on the current mode, decrease font size of notes or pointer size or the
size of pen or eraser
c Clear the drawing on the current page
d Toggle visibility of the drawings; if in the drawing mode (pen/eraser), exit it
f Freeze the current presentation display (the presenter display is still fully
active)
w Toggle between the fullscreen and windowed mode of the presenter screen
Shift + a
Maximize/unmaximize the current slide view (e.g., to increase accuracy while
drawing)
b Turn off the presentation view (i.e. fill it with a black color)
h Hide the presentation window (i.e. make other windows on the other screen visible)
Escape Exit any "special" state (pause, freeze, blank)
Ctrl + n
Edit notes for the current slide (press Escape to exit this mode)
Ctrl + z
In drawing and eraser mode, undo the last added stroke or erase curve.
Ctrl + y
In drawing and eraser mode, redo the last undone stroke or erase curve.
s Start timer
p Pause/continue timer
Shift + t
Cycle between the timer view modes (count up/count down/current time), when
applicable
Ctrl + t
Reset timer
Ctrl + o
Toggle the overlay flag for one particular slide (see Overlays below)
Ctrl + h
Toggle the hidden attribute for the current slide (see Hidden slides below)
Ctrl + e
Define end slide
Ctrl + r
Reload the presentation (e.g., if the PDF file has been updated)
Ctrl + q
Exit pdfpc
? Show a cheat sheet with the keyboard and mouse bindings; press Escape or Return to
exit it
Within the overview mode, the following key bindings are used:
Return / 1st mouse button
Go to currently selected page (last page of overlay)
Shift + Return / Shift + 1st mouse button
Go to currently selected page (first page of overlay)
Cursor left / Page up
Select previous slide
Cursor right / Page down
Select next slide
See pdfpcrc(5) if you want to customize the key or mouse bindings. Please note though,
that only in the normal mode the mouse bindings are configurable.
FEATURES
Caching / Pre-rendering
To allow fast changes between the presentation slides, the PDF pages are pre-rendered to
memory. The progress bar on the bottom of the presenter screen indicates how many percent
of the slides have been pre-rendered already. During the initial rendering phase this
will slow down slide changes, as most CPU power is used for the rendering process in the
background. After the cache is fully primed, however, the changing of slides should be
much faster, as with normal PDF viewers.
To avoid excessive memory consumption, cached are only slides that took a significant time
to render; this threshold is configurable. In order to further reduce memory consumption,
the pre-rendered and cached slides are selectively compressed in memory. The compression
factor is typically 10-30, however, it takes some CPU time to compress and uncompress, so
there is a trade-off. Small images below a certain (configurable) threshold will not be
compressed.
Please refer to the pdfpcrc(5) man page for options to fine tune the caching algorithm.
Timer
If a duration is given (-d option), the timer will show a countdown with the given
parameters. If no duration is specified (or if a value of 0 is given to the -d option),
the timer will show how much time has been spent. The duration is stored automatically,
so you do not need to repeat it for every invocation.
The timer is started if you are navigating away from the first page for the first time.
This feature is quite useful as you may want to show the title page of your presentation
while people are still entering the room and the presentation has not really begun yet.
If you want to start over you can use the 'Ctrl + t' key which will make the presenter
reset the timer.
If a duration is given, the timer also provides hints aiding the presenter to judge
whether the talk would end on time. There are two modes in which pdfpc can operate. In
the old (and the only one available up to, and including pdfpc-4.0.8) mode, at the moment
the timer reaches the defined last-minutes value it will change color to indicate your
talk is nearing its end, thus mimicking a chairman frantically pantomiming in front of you
with five (four, three, ...) fingers up. A drawback of this approach is it is often too
late at that moment to alter the presentation pace without ruining to some extent the rest
of the talk. On the other hand, the warning indication provides an unnecessary
distraction if you have been perfectly conveying the talk and the remaining time is
adequate.
Contrary to that, in the new (default) mode, pdfpc tracks your progress continuously,
calculating the expected time as (talk_duration)*(current_user_slide_number -
0.5)/(total_number_of_user_slides) and comparing it to the actual wall time since
beginning of the talk. If these two numbers differ by more than 60 seconds, the timer
changes its color to either orange (indicating you need to speed up) or a blueish one
(need to slow down). Once the optimal progress is recovered, the timer becomes white
again. In this mode, the last-minutes option (-l) has no effect. The previous behavior
can be restored by setting the 'timer-pace-color' option to 'false' in the configuration
file, see pdfpcrc(5).
In any case as soon as the timer reaches the zero mark (00:00:00), it will turn red and
count further down showing a negative time, to provide information on how many minutes you
are overtime.
Notes
Textual notes can be displayed for each slide. pdfpc understands the Markdown syntax,
which allows for rendering anything from plain text to a very rich formatting, if so
desired. A few types of PDF annotations are understood by pdfpc and will be automatically
imported and displayed. The PDF annotations can be made using many PDF editors and even
viewers; when using LaTeX, the pdfpc package (see below) provides a convenient macro.
These "native" PDF notes cannot be edited in pdfpc.
In addition, while in the presentation mode, pressing 'Ctrl + n' will allow you to take or
edit notes for the current slide. These notes are stored in the .pdfpc file. The native
PDF annotations take precedence over these notes, i.e., if a note exists for a given slide
in the .pdfpc file, any PDF annotation on that page will silently override it. While
editing a note, the normal keybindings are disabled, e.g., you are not able to change
slides. To exit the note editing mode, press the Escape key.
Although mixing the two types of notes is possible, for a given presentation one will
likely want to have either only the "native" notes (produced by the same PDF authoring
software used for making the slides), or only the "pdfpc" ones. Note that if the PDF
presentation changes, the notes stored in the respective .pdfpc file may get out of sync.
pdfpc also supports old-style beamer notes (see the -n option), which are typeset on a
half of the "virtual" slide twice as large as the real one. Note that due to a bug in
beamer, the auto-grouping feature does not work with such presentations.
Overview mode
Pressing the Tab key enters the overview mode, where thumbnails of the slides are shown in
a grid. You can select a slide to jump to with the mouse or with the arrow keys. You can
also define overlays and the end slide (see next sections) in this mode. Press Escape to
exit the mode without making an change.
Overlays
Many slide preparation systems allow for overlays, i.e. sets of slides that are logically
grouped together as a single, changing slide. Examples include enumerations where bullet
items are displayed one after another, or rough "animations", where parts of a picture
change from slide to slide. Pdfpc includes facilities for dealing with such overlays.
In this description, we will differentiate between slides (i.e. pages in the PDF
document) and "user slides", that are the logical slides. The standard forward movement
command (page down, enter, etc.) moves through one slide at a time, as expected. This
means that every step in the overlay is traversed. The backward movement command works
differently depending on whether the current and previous slides are part of an overlay:
• If the current slide is part of an overlay we just jump to the previous slide. That
means that we are in the middle of an overlay and can jump forward and backward through
the single steps of it
• If the current slide is not part of an overlay (or if it is the first one), but the
previous slides are, we jump to the previous user slide. This means that when going
back in the presentation you do not have to go through every step of the overlay, pdfpc
just shows the first slide of each overlay. As one typically goes back in a
presentation only when looking for a concrete slide, this is more convenient.
The Shift + Page up/down key combinations work on the "user slide" basis. You can use
them to skip the rest of an overlay or to jump to the previous user slide, ignoring the
state of the current slide.
When going through an overlay, two additional previews may be activated in the presenter
view, just below the main view, showing the next and the previous slide in an overlay.
Pdfpc tries to find these overlays automatically by looking into the page labels in the
PDF file. For LaTeX this works correctly at least with the beamer class and also
modifying the page numbers manually (compiling with pdflatex). If your preferred slide-
producing method does not work correctly with this detection, you can supply this
information using the 'Ctrl + o' key for each slide that is part of an overlay (except the
first one!). The page numbering is also adapted. This information is automatically
stored.
Hidden slides
When preparing presentation from an existing set of slides, it is sometimes helpful to
mark certain slides to be skipped during the talk. The 'Ctrl + h' combination toggles the
"hidden" attribute of the current slide, making it essentially invisible. It is still
possible to navigate to a hidden slide either in the Overview mode, using the Goto action
('g'), or by hitting 'Shift + n' or 'Shift + p' to switch to the next/previous slide,
respectively, ignoring the "hidden" attribute.
End slide
Some people like to have some additional, backup slides after the last slide in the actual
presentation. Things like bibliographic references or slides referring to specialized
questions are typical examples. Pdfpc lets you define which is the last slide in the
actual presentation via the 'Ctrl + e' key. This just changes the progress display in the
presenter screen, as to have a better overview of how many slides are left.
Page transitions
Pdfpc supports almost all standard animated PDF page transitions: blinds, box, cover,
dissolve, fade, glitter (except the diagonal one), push, split, uncover, and wipe,
including various alignments, angles, and directions (where applicable). The transitions
are enabled only for sequential (either forward or backward) movement; in the later case,
the transition is "inverted".
Advancing slides automatically is also supported.
Movies
Pdfpc can play back movies included in the PDF file. Movies may be started and stopped by
clicking within their area. For the presenter, a progress bar is drawn along the bottom
of the movie. This expands when the mouse hovers over it, allowing one to seek by
clicking or dragging within the progress bar. Switching slides automatically stops
playback, and movies will be reset after leaving and returning to a slide.
Movies may be included in PDF files as "screen annotations". In LaTeX, such movies may be
added to a presentation with the "multimedia" package. Note that the autoplay option is
not yet supported.
pdfpc will also play back movies linked from a hyperlink of type "launch".
See our website ⟨http://pdfpc.github.io/demo/pdfpc-video-example.zip⟩ for a detailed
explanation with examples.
Pointer mode
If needed, it is possible to turn on a pointer which draws a red (by default) dot in the
place pointed by mouse cursor on both presenter and presentation screens. It is also
possible to increase and decrease the pointer size. Additionally, when the pointer is
enabled, it is possible to highlight some area of the current slide using the drag mouse
motion. The area outside the selected region will be dimmed. You can zoom in the selected
area by pressing 'z'; press 'Escape' to exit the zoom mode. You can highlight another
region while zoomed in, but there will be no further action on pressing 'z'. Drawing is
also disabled in this mode.
Spotlight mode
Spotlight mode is similar to the pointer mode: a circular area that moves with the mouse
and can be adjusted in size, but instead of highlighting the spot by a different color, it
shades the background.
Drawing mode
It is possible to turn on a mode which allows drawing over slides with the mouse cursor or
a connected tablet. When drawing mode is enabled, drawings can be made on the presenter
screen. A separate drawing will be kept in memory for each slide (based on user slide
numbers, so consolidating overlay slides). Drawings are presently not saved between
sessions.
In the drawing mode, there are two drawing tools, a pen and an eraser. An indicator in the
bottom-left corner of the presenter screen will indicate which is active. When in the pen
mode, the color and size of the pen will be indicated by the cursor. The pen size can be
increased or decreased using hot keys specified in the key bindings. When the eraser tool
is active, the size of the cursor indicates the amount to erase.
The color of the pen can be changed through key bindings or using the toolbox.
If you are using a tablet, the pen or eraser tool will be selected based on whether the
tablet reports a pen or eraser input device is being used, overriding the normal selection
of the drawing tool. Also for pressure-sensitive input devices, the pressure will affect
the line width and the eraser size. Both these features can be disabled in the
configuration file, if desired.
Monitor Plug and Play
Pdfpc can handle monitor plug and play. E.g. if pdfpc was started before the presentation
screen was attached to the computer, pdfpc can create and show the presentation screen
after the second screen was attached. This allows the user to rehearse the slides and
switch to a normal presentation without having the full setup at the computer in advance.
pdfpc files
Notes, user-defined overlays, and some additional information are stored in a file with
extension "pdfpc". When pdfpc is invoked with a PDF file, it automatically checks for and
loads the associated .pdfpc file, if it exists. This means that you normally do not have
to deal with this kind of files explicitly.
Beside internal configuration, the following command-line options are saved in the pdfpc
file for later usage:
• duration
• end_time
• last_minutes
• notes (position)
• page_transition
• start_time
Appearance
With GTK3 it is possible to modify the appearance of pdfpc. There are two locations where
pdfpc is looking for files. The default location is /usr/share/pixmaps/pdfpc/pdfpc.css. It
can be copied to $XDG_CONFIG_HOME/pdfpc/pdfpc.css and modified to the user's liking.
The geometry of various views (the current/next etc slide) in the presenter window can be
adjusted at run time in the "Customization" mode, which is activated by pressing Shift+c.
In this mode, mouse-draggable handles will appear. Exit the customization with Escape.
Desktop integration
Pdfpc provides a DBus interface that appears on the session bus as io.github.pdfpc. Other
applications can, in particular, execute any action listed by --list-actions. It is also
possible to control pdfpc from the command line (and write shell scripts) using the dbus-
send(1) utility. For example, to advance to the next slide, run
dbus-send --type=method_call --session --dest=io.github.pdfpc
/io/github/pdfpc io.github.pdfpc.TriggerAction string:next
For actions that require an argument, use TriggerActionArg, e.g.,
dbus-send --type=method_call --session --dest=io.github.pdfpc
/io/github/pdfpc io.github.pdfpc.TriggerActionArg string:switchMode
string:pointer
In addition to TriggerAction*, the pdfpc DBus interface exposes the GetNotes method, three
properties (NumberOfOverlays, NumberOfSlides, Url) and two signals (OverlayChange and
SlideChange).
Remote control
Pdfpc has a built-in REST server. When enabled (off by default), it allows for controlling
presentations over network, e.g., using a mobile device as a smart controller. (This
section will be extended with more details when the REST interface sufficiently
stabilizes.)
LaTeX package
A tiny LaTeX package is available for pdfpc at CTAN. It provides a convenient way to
specify notes and to define certain meta properties of the presentation. For a full
documentation, please consult the pdfpc package documentation. You can open it with:
$ texdoc pdfpc
BUGS
Bugs can be reported at our issue tracker ⟨https://github.com/pdfpc/pdfpc/issues⟩.
ACKNOWLEDGEMENTS
pdfpc was previously developed by David Vilar ⟨https://github.com/davvil/pdfpc⟩, which in
turn was a fork of Jakob Westhoff's PDF Presenter Console ⟨https://github.com/
jakobwesthoff/Pdf-Presenter-Console⟩.
SEE ALSO
pdfpcrc(5)
There are several other programs with similar functionality.
impressive(1) has nice transition effects.
hpdfp(1) is the Haskell PDF Presenter ⟨http://michaeldadams.org/projects/
haskell-pdf-presenter/⟩ program, which packs an amazing level of functionality into not
many lines of Haskell.
pympress(1) is a little PDF reader written in Python ⟨https://github.com/Cimbali/pympress⟩
which handles dual screens and beamer notes.
dspdfviewer(1) is a specialized Dual-Screen PDF Viewer for latex-beamer ⟨https://
github.com/dannyedel/dspdfviewer⟩ for beamer-produced wide PDF with notes on the right.
Many PDF viewers have full-screen presentation modes, but without dual-monitor preview or
notes or a timer. These include zathura(1), evince(1), and okular(1).
PDFPC(1)