Provided by: pdf-presenter-console_4.1-2_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
-c, --disable-cache
Disable caching and pre-rendering of slides to save memory at the cost of speed.
-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))
-g, --disable-auto-grouping
Disable auto detection of overlay groups. (Default: enabled)
-h, --help
Show this help
-l, --last-minutes=N
Time in minutes, from which on the timer changes its color. (Default: 5 minutes)
-L, --list-actions
List actions supported in the config file(s)
-n, --notes=P
Position of notes on the PDF page. Position can be either left, right, top or
bottom. Disable slide auto-grouping (Default: none)
-p, --persist-cache
Persist the PNG cache on disk for faster startup.
-P, --page
Go to a specific page directly after startup. In case of overlays, the first slide
will be displayed.
-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))
-W, --wayland-workaround
Enable Wayland-specific workaround. This might fix HiDPI scaling problems.
-w, --windowed
Run in windowed mode
-z, --disable-compression
Disable the compression of slide images to trade memory consumption for speed.
(Avg. factor 30)
-Z, --size
Size of the presentation window in width:height format (forces windowed mode)
Some previous command-line options (like black-on-end) were moved to permanent config file
options. See pdfpcrc(5) for further details.
KEYBINDINGS
These are the default keybindings for pdfpc:
Right cursor key / Page down / Return / Space / Left mouse button
Go forward one slide
Shift + Right cursor key / Page down / Return / Space / Left mouse button / Mouse wheel
down or right
Go forward 10 slides
Down cursor key
Go forward one user slide (see Overlays below)
Left cursor key / Page up / Right mouse button / Mouse wheel up or left
Go back one slide
Shift + Left cursor key / Page up / Right mouse button
Go back 10 slides
Up cursor key
Go back one user slide (see Overlays below)
Home Go to the first slide
End Go to the last slide
Backspace
Go back in history. Note that history is defined by "jump" commands, not by normal
slide movement.
j / k Go to the previous / next slide, skipping over overlays that have already been
viewed, but at most one user slide.
Tab / Middle mouse button
Overview mode
g Input a slide number to jump to
Plus / Equal / KP_Add / Bracket Left
Increase font size of notes
Minus / KP_Substract / Bracket Right
Decrease font size of notes
8 Toggle pointer mode
7 Decrease pointer size
9 Increase pointer size
5 Toggle drawing mode
6 Clear the current drawing
4 Temporarily hide the current drawing and exit drawing mode
1 Decrease the pen or eraser size for drawing
3 Increase the pen or eraser size for drawing
2 Toggle between the pen and eraser tool for drawing
Escape / q
Exit pdfpc
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)
n Edit note for current slide
f Freeze the current presentation display (the presenter display is still fully
active)
o Toggle the overlay flag for one particular slide (see Overlays below)
p Pause timer
r Reset presentation (reset timer and go back to first slide)
e Define end slide
R Restore last saved session. Go to the slide which was saved with S before
S Save the current session. Store the current slide in the .pdfpc file for later
usage
Within overview mode the following key bindings are used:
Return / Left mouse button
Go to currently selected page (last page of overlay)
Shift + Return / Shift + Left 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 keybindings.
FEATURES
Caching / Pre-rendering
To allow fast changes between the different slides of the presentation 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.
As the pre-rendering takes a lot of memory it can be disabled using the --disable-cache
switch at the cost of speed.
It it also possible to store the pre-rendered slides on the disk (see --persist-cache).
This speeds up the start of the program if the slide set is used next time unchanged.
Cache compression
The pre-rendered and cached slides can be compressed in memory to save up some memory.
Without compression a set of about 100 PDF pages can easily grow up to about 1.5 GB size.
Netbooks with only 1 GB of memory would swap heavily if pre-rendering is enabled in such a
situation. The compression is enabled by default as it does not harm rendering speed in a
noticeable way on most systems. It does, however, slow down pre-rendering by about a
factor of two. If you have got enough memory and want to ensure the fastest possible pre-
rendering you can disable slide compression by using the -z switch. But be warned that
using the uncompressed pre-rendering storage will use about 30 times the memory the new
compressed storage utilizes (e.g. 50 MB will become about 1.5 GB).
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 'r' 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. A few types of PDF annotations are
understood by pdfpc and will be automatically imported and displayed (only their textual
content, no formatting attributes are preserved). The PDF annotations can be made using
many PDF editors and even viewers. These "native" PDF notes cannot be edited in pdfpc.
In addition, while in the presentation mode, pressing 'n' will allow you to take notes for
the current user slide. To exit the note editing mode, press the Escape key. Note that
while editing a note, the keybindings stop working, i.e. you are not able to change
slides. These notes are stored in the .pdfpc file in a plain text format, easy to edit
also from outside the program; see the section about the pdfpc format below. These notes
take precedence over the native PDF annotations, i.e., if a user-proveded note exists for
a given slide, any PDF annotations on that page will be silently ignored.
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.
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.
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 up and down cursor keys 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 '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.
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 'e' key. This just changes the progress display in the
presenter screen, as to have a better overview of how many slides are left.
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". pdfpc does not yet support
options that modify the playback of these movies. In LaTeX, such movies may be added to a
presentation with the "movie15" or "multimedia" package. Note that the poster, autoplay,
and repeat options are not yet supported. (Also, run ps2pdf with the -dNOSAFER flag.)
As a perhaps simpler option, pdfpc will play back movies linked from a hyperlink of type
"launch". A query string may be added to the URL of the movie to enable the "autostart",
"loop" and "noprogress" properties, if necessary. (E.g., a link to
"movie.avi?autostart&loop&noprogress" will add a video that starts playing automatically,
loops when it reaches the end, and does not show the progress bar.)
In LaTeX, such links are created with
\usepackage{hyperref}
\href{run:<movie file>}{<placeholder content>}
The movie will playback in the area taken by the placeholder content. Using a frame of
the movie will ensure the correct aspect ratio.
See our website ⟨http://pdfpc.github.io/demo/pdfpc-video-example.zip⟩ for a full example.
Pointer mode
If needed, it is possible to turn on a pointer which draws a red 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.
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 or mouse bindings.
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.
pdfpc files
Some additional information is stored in a file with the 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 stored within the
pdfpc file for later usage:
• duration
• end_time
• last_minutes
• notes (position)
• start_time
There are, however, cases where you may want to edit this file manually. The most typical
case is if you add or remove some slides after you have edited notes or defined overlays.
It may be quicker to edit the pdfpc file than to re-enter the whole information.
There is also the possibility of including notes from a different file. If pdfpc
encounters a [notes_include] section with the .pdfpc file it reads the notes only from the
included file. Changing notes within pdfpc is then forbidden.
The files are plain-text files that should be fairly self-explanatory. A couple of things
to note:
• The slide numbers of the notes refer to user slides
• Slide indexes start at 1
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.
Integration with other tools
Pdfpc provides a dbus interface that other tools can use to execute any action listed by
--list-actions. The interface appears on the session bus as io.github.pdfpc.
BUGS
Bugs can be reported at our issue tracker ⟨https://github.com/pdfpc/pdfpc/issues⟩.
ACKNOWLEDGEMENTS
pdfpc was previously developed by davvil ⟨https://github.com/davvil/pdfpc⟩.
pdfpc is a fork of Pdf Presenter Console, available online ⟨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 also specialized for beamer-produced wide PDF with notes.
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)