Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
C Python Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
PDFPRES(1) Dual head PDF presenter PDFPRES(1) NAME pdfpres - Dual head PDF presenter SYNOPSIS pdfpres [-w] [-n] [-s slides] [-c cache] [-N notes] [-T] [-C] [-V] FILE DESCRIPTION pdfpres is a presentation program for PDF files. It uses a “dual head”-layout: One window shows the previous, current and next slides while another window only shows the current slide. That additional window can be moved to an external screen (such as a beamer). Thus, you can present your slides on a beamer while keeping an eye on what's coming up next. OPTIONS -s slides This parameter allows you to specify how many slides before/after the current slide you wish to see, i.e. 3 means “preview the next 3 slides while still showing the previous 3 slides”. The default is 1. Attention: It is recommended to set the number of slides not greater than 2 unless you have a large screen with a high resolution. -c cache Specify the number of slides that can be cached/pre-ren‐ dered. Be aware, though, that this value will always be at least “number of pdf viewports” × 2. This is needed so that we can pre-render the current and next slide for each viewport. Hence, switching to the next (or previ‐ ous) slides will always be instant. -w Enables wrapping. When you're on the last slide and wrapping is enabled, switching to the “next” slide actu‐ ally switches to the very first slide. -n Enables “note control”. The number of the slide which is currently shown will be written to stdout. You can pipe this information to another program. That'll allow you to do fancy things. -N notes Allows you to specify a file with notes that will be loaded on startup. The file has to be in the same for‐ mat that pdfpres uses when saving notes. -C Forces the timer to be a clock, so it shows the current time. -T Opposite of -C, forces the timer to be a timer. -v Show current version of pdfpres. Command line arguments take precedence over permanent settings (see CONFIGURATION). KEYS Full customization of all keybinds is planned. Currently, you can only use the following fixed keybinds to control pdfpres: Use the cursor keys to navigate. Space, Return, Right, Down and Page Down also go the next slide, Left, Up and Page Up go to the previous slide. Left Mouse switches to the next slide, Right Mouse switches to the previous slide. p switches to “fit page”, this is the default. w switches to “fit width” mode, h switches to “fit height” mode. F5 emulates “Start Presentation” like in LibreOffice. That is, fullscreen is activated and the timer is started. F6 forces a full refresh. Esc and q quit the program. If q_exits_fullscreen is set (see CONFIGURATION), those keys only end fullscreen mode. You then need a second keypress to exit pdfpres. Sometimes you need to browse your slides but that would, inevitably, confuse the audience. So fixating the current slide on the beamer while still allowing free navigation in the pre‐ view window should be quite handy. Lock it by pressing l and unlock it with a capital L. In locked mode, press J to jump to the currently selected slide. Alternatively, you can press b or . (period) to blank the beamer window — it'll turn into a plain black window. Pressing b or . again will return the current slide. Note: Even with a blank beamer window you can still browse your slides. To switch to fullscreen, press f. You could also use your win‐ dow manager for this purpose. That is, Alt + F11 would do the same in Xfce. The beamer window is moved to the current monitor (that is, that monitor the mouse pointer is currently on) before fullscreen mode is activated. s starts the timer, pauses it and continues if paused. r resets the timer. c toggles cursor visibility in presentation window. i enters note edit mode, Esc leaves note edit mode. Type a number and then G or Return to jump to the appropriate slide. CONFIGURATION pdfpres writes all of its configuration variables to ~/.con‐ fig/pdfpres/config.xml on exit. This file will look like this: <?xml version="1.0" encoding="UTF-8"?> <config> <initial_fit_mode v="2"/> <slide_context v="1"/> <do_wrapping v="0"/> <do_notectrl v="0"/> <cache_max v="32"/> <font_notes v="Sans 12"/> <font_timer v="Sans 35"/> <q_exits_fullscreen v="0"/> <timer_is_clock v="0"/> <stop_timer_on_fs v="0"/> </config> For now, you're supposed to directly edit this file except for font settings. If you change fonts inside pdfpres, they'll get saved automatically. initial_fit_mode Accepts 0, 1 or 2 meaning “fit width”, “fit height” or “fit page”. slide_context Equivalent to the -s ... parameter. cache_max Equivalent to the -c ... parameter. do_wrapping Equivalent to the -w parameter. 1 enables wrapping and everything else disables it. do_notectrl Equivalent to the -n parameter. 1 enables note control and everything else disables it. font_notes font_timer Set the font for notes and timer. This string will get parsed by pango_font_description_from_string, so you might want to have a look at the GNOME API documentation (http://library.gnome.org/devel/pango/unstable/pango- Fonts.html#pango-font-description-from-string) to see what's possible. q_exits_fullscreen If this is set to 1, then pressing q or Esc only exits fullscreen mode and you'll need a second keypress on q or Esc to exit the program. If it's 0 (default), then a single keypress on q or Esc always quits pdfpres (unless you're currently editing slide notes). timer_is_clock By default (0), a timer is shown. You can start it or stop it. However, it's sometimes more useful to see the current real time. This can be done by setting this option to 1. stop_timer_on_fs By default (0), a running timer keeps running if you exit fullscreen mode. On some setups, however, it may be required for the timer to stop when fullscreen mode is being left. To do so, set this option to 1. OLD FORMAT FOR SLIDE NOTES If you already used an old version of pdfpres that didn't save the notes in XML, you can use the converter script to transform those notes into XML: $ ./legacy-notes-converter.py notes.txt > notes.xml The resulting file notes.xml can be read in pdfpres. Be aware that this script expects a file encoded with UTF-8. Use the editor of your choice or recode to transform any non- UTF-8 files (you may adjust the input encoding) before you run the converter: $ recode LATIN1..UTF8 < notes.txt > notes-utf8.txt FILES ~/.config/pdfpres/config.xml Local per user configuration. DEPENDENCIES AND BUILDING If you need to manually compile pdfpres, the following libraries and tools must be installed: · make · gtk2 (http://www.gtk.org/), minimum tested version: 2.20.0, · glib, minimum tested version: 2.24.0, · poppler and poppler-glib (http://poppler.freedesktop.org/), minimum tested version: 0.12.4. · libxml2 (http://www.xmlsoft.org/), minimum tested version: 2.7.6. Once those are installed, you can build pdfpres as follows: $ cd /path/to/sources $ make BUGS Currently, no bugs are known. If you find one, we invite you to report it at the GitHub Issue tracker (http://github.com/vain/pdfpres/issues). LICENSE pdfpres is released as “GPL3+”. See the accompanying LICENSE file. AUTHORS pdfpres was initially written by Peter Hofmann. Since then, several people contributed code. Git tells you all the names: $ git shortlog -sn SEE ALSO xpdf(1) pdfpres January 2012 PDFPRES(1)