• supports embedded gifs and videos
• text annotations displayed in the presenter window
• natively supports beamer's notes on second screen!

•

Ubuntu [image: ubuntu logo] [image]
20.04 focal or newer, Debian [image: debian logo] [image]
11 Bullseye or newer:

apt-get install pympress libgtk-3-0 libpoppler-glib8 libcairo2 python3-gi python3-gi-cairo gobject-introspection libgirepository-1.0-1 gir1.2-gtk-3.0 gir1.2-poppler-0.18

•

RPM-based Linux (Fedora [image: fedora logo] [image]
CentOS [image: centos logo] [image]
Mageia [image: mageia logo] [image]
OpenSuse [image: suse logo] [image]
RHEL)

You can get pympress from the pympress COPR repo of your system. With yum or dnf, simply do:

dnf enable copr/cimbali
dnf install python3-pympress

With zypper, fetch the link of the .repo in the table at the bottom of the COPR page and add it as a source.

zypper addrepo https://copr.fedorainfracloud.org/coprs/cimbali/pympress/repo/opensuse-tumbleweed/cimbali-pympress-opensuse-tumbleweed.repo
zypper install python3-pympress

•

Arch Linux [image: arch linux logo] [image]
(from AUR):

git clone https://aur.archlinux.org/python-pympress.git
cd python-pympress
makepkg -si
pacman -S poppler-glib  # dependency temporarily missing from AUR package

Or using any other tool to manage AUR packages (yay, pacaur, etc.):

yay -S pympress
pacman -S poppler-glib  # dependency temporarily missing from AUR package

•

Other Linux [image: linux logo] [image]
requires python, gtk+3, poppler, and their python bindings:

pip install pympress

•

macOS [image: apple logo] [image]
using Homebrew:

brew install pympress

•

Windows [image: windows logo] [image]
with Chocolatey:

choco install pympress

Or download the installer from the latest Github release.

• To support playing embedded videos in the PDFs, your system must have VLC installed (with the same bitness as pympress). VLC is not distributed with pympress, but it is certainly available in your system’s package manager and on their website.
• On Linux, make sure you have all the dependencies, as they do not come via pip. (On Windows and macOS, they are included in the package.)
• Using pip, you may want to use python3 -m pip as the command if pip points to the python 2.x pip. You may also want to install with the --user option, or install from github or downloaded sources. See the python documentation on installing for more details.

•

If your python environment lacks the Gobject Introspections module, try

•

For manually downloaded installers, if you get an error message along the lines of "MSVCP100.dll is missing", get the Visual C++ 2010 redistributables from Microsoft (x86 (32 bit) or x64 (64 bits)). Those libraries really should already be installed on your system.

• Two-screen display: See on your laptop or tablet display the current slide, the next slide, the talk time and wall-clock time, and annotations (either PDF annotations, or beamer notes on second slide). The position of the beamer notes in the slide is detected automatically and can be overridden via a menu option.
• Media support: supports playing video, audio, and gif files embedded in (or linked from) the PDF file.
• Highlight mode: Allows one to draw freehand on the slide currently on screen.
• Go To Slide: To jump to a selected slide without flashing through the whole presentation on the projector, press G or click the "current slide" box. Using J or clicking the slide label will allow you to navigate slide labels instead of page numbers, useful e.g. for multi-page slides from beamer \pause.

  A spin box will appear, and you will be able to navigate through your slides in the presenter window only by scrolling your mouse, with the Home/Up/Down/End keys, with the + and - buttons of the spin box, or simply by typing in the number of the slide. Press Enter to validate going to the new slide or Esc to cancel.

• Software pointer: Clicking on the slide (in either window) while holding ctrl down will display a software laser pointer on the slide. Or press L to permanently switch on the laser pointer.
• Talk time breakdown: The Presentation > Timing Breakdown menu item displays a breakdown of how much time was spent on each slide, with a hierarchical breakdown per chapters/sections/etc. if available in the PDF.
• Automatic file reloading: If the file is modified, pympress will reload it (and preserve the current slide, current time, etc.)
• Big button mode: Add big buttons (duh) for touch displays.
• Swap screens: If Pympress mixed up which screen is the projector and which is not, press S
• Estimated talk time: Click the Time estimation box and set your planned talk duration. The color will allow you to see at a glance how much time you have left.
• Adjust screen centering: If your slides' form factor doesn't fit the projectors' and you don't want the slide centered in the window, use the "Screen Center" option in the "Presentation" menu.
• Resize Current/Next slide: You can drag the bar between both slides on the Presenter window to adjust their relative sizes to your liking.
• Preferences: Some of your choices are saved in a configuration file, and more options are accessible there. See the configuration file documentation for more details.
• Caching: For efficiency, Pympress caches rendered pages (up to 200 by default). If this is too memory consuming for you, you can change this number in the configuration file.

• -h, --help: Shows a list of all command line arguments.
• -t mm[:ss], --talk-time=mm[:ss]: The estimated (intended) talk time in minutes and optionally seconds.
• -n position, --notes=position: Set the position of notes on the pdf page (none, left, right, top, or bottom). Overrides the detection from the file.
• --log=level: Set level of verbosity in log file (DEBUG, INFO, WARNING, ERROR).

• Python (version 3.x strongly recommended though 2.7 should still work fine).
• Poppler, the PDF rendering library.
• Gtk+ 3, a toolkit for creating graphical user interfaces, and its dependencies, specifically:

•

PyGi, the python bindings for Gtk+3. PyGi is also known as pygobject3, just pygobject or python3-gi.

•

optionally VLC, to play videos (with the same bitness as Python)

•

using MSYS2 (replace x86_64 with i686 if you're using a 32 bit machine).

Warning: this can take a substantial amount of disk size as it requires a full software distribution and building platform.

 pacman -S --needed mingw-w64-x86_64-gtk3 mingw-w64-x86_64-cairo mingw-w64-x86_64-poppler mingw-w64-x86_64-python3 mingw-w64-x86_64-vlc python3-pip mingw-w64-x86_64-python3-pip mingw-w64-x86_64-python3-gobject mingw-w64-x86_64-python3-cairo

This is also the strategy used to automate builds on appveyor.

•

Using PyGobjectWin32. Be sure to check the supported Python versions (up to 3.4 at the time of writing), they appear in the FEATURES list in the linked page.

• Install native python for windows
• Get GTK+3, Poppler and their python bindings by executing the PyGi installer. Be sure to tick all the necessary dependencies in the installer (Poppler, Cairo, Gdk-Pixbuf).

• @Jose1711 made the AUR pympress package
• @ComFreek maintains the Chocolatey pympress package
• @mans0954 maintains the Debian pympress package and the Ubuntu pympress package

• ~/.config/pympress on Linux,
• %APPDATA%/pympress.ini on Windows,
• ~/Library/Preferences/pympress on macOS,
• in the top-level of the pympress install directory for portable installations.

•

All-horizontal layout:

+----+----+----+
| Cu | No | Nx |
+----+----+----+

Setting:

notes = {"children": ["current", "notes", "next"], "proportions": [0.33, 0.33, 0.33], "orientation": "horizontal", "resizeable": true}

•

All-vertical layout:

+----+
| Cu |
+----+
| No |
+----+
| Nx |
+----+

Setting:

notes = {"children": ["current", "notes", "next"], "proportions": [0.33, 0.33, 0.33], "orientation": "vertical", "resizeable": true}

•

Vertical layout with horizontally divided top pane:

+----+----+
| Cu | No |
+----+----+
|    Nx   |
+---------+

Setting:

notes = {"children": [


  			{"children": ["current", "notes"], "proportions": [0.5, 0.5], "orientation": "horizontal", "resizeable": true},


  			"next"


  		], "proportions": [0.5, 0.5], "orientation": "vertical", "resizeable": true}

•

Horizontal layout with horizontally divided right pane:

+----+----+
|    | Nx |
+ Cu +----+
|    | No |
+---------+

Setting:

notes = {"children": [


  			"current",


  			{"children": ["next", "notes"], "proportions": [0.5, 0.5], "orientation": "vertical", "resizeable": true}


  		], "proportions": [0.5, 0.5], "orientation": "horizontal", "resizeable": true}

• for notes: "current", "notes", "next"
• for plain: "current", "next" and "annotations" (the annotations widget is toggled with the A key by default)
• for highlight: same as plain with "highlight" instead of "current"

• If you set "resizeable" to false, the panes won’t be resizeable dynamically with a handle in the middle
• "proportions" are normalized, and saved on exit if you resize panes during the execution. If you set them to 4 and 1, the panes will be 4 / (4 + 1) = 20% and 1 / (4 + 1) = 100%, so the ini will contain something like 0.2 and 0.8 after executing pympress.