Pdf Presenter Console
The Pdf Presenter Console (PPC) is a GTK based presentation viewer application 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 left over time till the end of the presentation. The input files processed by PPC are PDF documents, which can be created using nearly any of today's presentation software.
The idea to create PPC came up during the IPC 2009 where I saw a lot of people running around with their MacBooks using Keynote to present their slides. I always liked the presenter console of Keynote. Therefore I began to research if any solution like this existed for my Linux system. I came across the Sun presenter console for Open-Office Impress, which seemed to do exactly what I wanted. Unfortunately I stopped using Impress for creating presentations in favor to Latex Beamer quite some time ago. Therefore this Open-Office plugin was no solution to my problem. I wanted something flexible which would be able to use simple PDF documents as input. I found some projects which were started having the same intentions than I did. Unfortunately these projects did either never reach the implementation phase or they were implemented but I did not get them to work properly.
All this brought me to the decision to create a simple presenter console on my own. At this point the Pdf Presenter Console was born.
In order to compile and run the Pdf Presenter Console the following requirements need to be met:
Vala Compiler Version >=0.11.0
Gnu compiler collection
CMake Version >=2.6
libPoppler with glib bindings
Compile and install
After retrieving the archive unpack it using the following command:
tar xvzf pdf_presenter_console-VERSION.tar.gz
Switch to the unpacked source directory and create some sort of build directory. This may be done as follows:
cd pdf_presenter_console-VERSION mkdir build cd build
After you are inside the build directory create the needed Makefiles using CMake:
If you have put your build directory elsewhere on your system adapt the path above accordingly. You need to provide CMake with the pdf_presenter_console directory which you just decompressed.
You may alter the final installation prefix at this time. By default the pdf_presenter_console executable will be installed under
/usr/local/bin. If you want to change that, for example to be
/usr/bin you may specify another installation prefix as follows:
cmake -DCMAKE_INSTALL_PREFIX="/usr" ../
If all requirements are met CMake will tell you that it created all the necessary build files for you. If any of the requirements were not met you will be informed of it to provide the necessary files or install the appropriate packages.
The next step is to compile the source using GNU Make or any other make derivative you may have installed. Simply issue the following command to start building the application:
After the build completes successfully the
pdf_presenter_console executable can be found inside the
src directory of you build path. If you want to install it automatically to the
bin directory below the before provided prefix do as follows:
You may need to prefix this command with a
sudo or obtain super-user rights in any other way applicable to your situation.
Congratulations you just installed Pdf Presenter Console on your system.
Startup and usage
The Pdf Presenter Console is run by calling it's executable on the commandline followed by the pdf you want to present:
Calling the application like this is the easiest way to go. There are certain commandline options you may use to customize the behavior of the presenter to your likings:
Usage: pdf_presenter_console [OPTION...] <pdf-file> Help Options: -h, --help Show help options Application Options: -d, --duration=N Duration in minutes of the presentation used for timer display. (Default 45 minutes) -l, --last-minutes=N Time in minutes, from which on the timer changes its color. (Default 5 minutes) -u, --current-size=N Percentage of the presenter screen to be used for the current slide. (Default 60) -s, --switch-screens Switch the presentation and the presenter screen. -c, --disable-cache Disable caching and pre-rendering of slides to save memory at the cost of speed. -z, --disable-compression Disable the compression of slide images to trade memory consumption for speed. (Avg. factor 30)
Caching / Prerendering
To allow fast changes between the different slides of the presentation the pdf pages are prerendered to memory. The small white line 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 a lot of 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 prerendering takes a lot of memory it can be disabled using the
--disable-cache switch at the cost of speed.
Since version 2.0 of the Pdf-Presenter-Console the prerendered 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.5gb size. Netbooks with only 1gb of memory would swap themselves to death if prerendering 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 slows down prerendering by about a factor of 2. If you have got enough memory and want to ensure the fastest possible prerendering you can disable slide compression by using the
-z switch. But be warned using the uncompressed prerendering storage will use about 30 times the memory the new compressed storage utilizes (aka the 1.5gb become about 50mb)
During the presentation the following key strokes and mouse clicks are detected and interpreted:
- Left cursor key / Page up / Right mouse button
Go back one slide
- Right cursor key / Page down / Return / Space / Left mouse button
Go forward one slide
Go back to the first slide and reset the timer
- Escape / q /Alt+F4
Quit the presentation viewer
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 titlepage of your presentation while people are still entering the room and the presentation hasn't really begun yet. If you want to start over you can use the
Home key which will make the presenter go back to the first page and reset the timer as well.
At the moment the timer reaches the defined
last-minutes value it will change color to indicate your talk is nearing its end.
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.
Every comment or idea for a future version of this presenter is welcome. Just send a mail to email@example.com.
Bug reports may be send to my mail address or added to the issue tracker at the github project page.
The current release version may be dowloaded as tar.gz archive below:
Retrieving the current trunk from the softwares git repository
If you want to use the bleeding edge version of this software, you may always retrieve the current development branch from its git repository. Do this on your own risk. It may not compile, make your socks disappear or even eat your cat ;).
The repository is hosted at github. If the git executable is available on your system it can be retrieved using the following command:
git clone git://github.com/jakobwesthoff/Pdf-Presenter-Console.git
After it has been transferred you need to switch to the
Pdf-Presenter-Console directory, which has just been created. From inside this directory use these commands to retrieve all needed submodules:
git submodule init git submodule update
You are now set to compile and install the presenter as described in the section above. However as mentioned above the code might not compile at all.
Released: 16. Jan 2010
Complete rewrite of rendering system to allow more sophisticated actions.
Changed license of the project from GPLv3 to GPLv2+ because of incompatibilities with Poppler. (Thanks to Jakub Wilk <firstname.lastname@example.org> and Barak A. Pearlmutter <email@example.com> for pointing out this out).
Implemented: Usage of left-/right mousebuttons for slide navigation.
Implemented: Handling of navigational links inside of PDF files.
Implemented: Abstraction to cache prerendered slides.
Implemented: Compressed cache for prerendered slides.
Implemented: Alternative way of executing the prerendering process to allow for smoother navigation while slides are generated.
Implemented: Means to switch displays in single monitor mode as well as dual monitor mode
Implemented: Disabled timer if a duration of 0 is provided
Fixed: Build problems on Fedora 13 due to changed linking procedure
Fixed: Slightly changed image data formats due to update of Gtk to Version 2.22 or higher.
Implemented: Removed usage of deprecated Gdk.GC in favor of Cairo.
Fixed: Compile error with newer vala versions due to wrong property visibility
Fixed: Typo in help text
Implemented: Controllable interface for cleaner controller code.
Fixed: Install target is now executable.
Fixed: Warnings shown in one-screen-presentation-mode, due to non existent process indicator.
Implemented: Presentation timer as its own GTK Widget
Implemented: Support for negative timer values (aka overtime)
Implemented: Different Timer colors for normal time, the last x minutes and overtime
Implemented: Made last-minutes time configurable
Fixed: Library paths were not used correctly for compilation
Implemented: Fullscreen window as own Gtk class
Fixed: Problem which caused the windows not be displayed on the correct displays using the Xfce4 Xfwm window manager.
Implemented: Command line option to set the size of the current slide in the presenter screen
Implemented: A few more common key bindings
Implemented: Hide cursor after 5 seconds timeout