Arch Linux from AUR (maintained by @Jose1711)

git clone https://aur.archlinux.org/python-pympress.git
cd python-pympress
makepkg -si

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

yay -S python-pympress

macOS using Homebrew

brew install pympress

Or using MacPorts

port install pympress

Windows with Chocolatey (maintained by @ComFreek)

choco install pympress

Or using the Windows Package Manager (winget)

winget install pympress

Or download the latest installer from the latest Github release.

• 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.

Other systems, directly from PyPI − requires python, gtk+3, poppler, and their python bindings:

pipx install --system-site-packages "pympress"

• Make sure you have all the dependencies. (These are already included in binary packages or their dependencies.)

• If your python environment lacks the Gobject Introspections module, try

  1. using --system-site-packages for pipx or virtual environments,
  2. installing pygobject and pycairo with pipx (pipx inject pympress pygobject pycairo), which requires the correct development/header packages be present on your system. See the PyPI installation instructions of PyGObject for your system.

• As per the python documentation on installing, it is recommended to install packages in virtual environments. Since mid 2022, the pipx tool automates this process. Your distribution (or Homebrew on macOS) should have a version you can install. Alternately, you can get the same effect with the standard venv and pip modules:

  # Create virtual environment
  python3 -m venv --system-site-packages ~/.local/lib/venv/pympress
  # Install pympress
  ~/.local/lib/venv/pympress/bin/python3 -m pip install pympress
  # Link to the executable from a place in your path
  ln -s ~/.local/lib/venv/pympress/bin/pympress ~/.local/bin/
  

  Note that:

  • If you don’t want to use system packages, you can build and install pygobject/pycairo in the virtual environment using ~/.local/lib/venv/bin/pip install pygobject pycairo
  • You can adjust the ~/.local/lib/venv/ path to your personal preference.

• Unfortunately, installing pympress in a virtual environment means you will not get desktop integration (i.e. installing pympress' desktop and png files to have pympress show up in your menus etc).

  This is by design, as desktop applications are intended to be installed through system packages (rpm, apt, etc.). You can work around this in 2 ways:

  1. Manually (note that links/copied files will need to be removed):

     cp "`pipx environment -V PIPX_LOCAL_VENVS`/pympress/share/applications/io.github.pympress.desktop" ~/.share/applications/
     ln -s "`pipx environment -V PIPX_LOCAL_VENVS`/pympress/share/pixmaps/pympress.png" ~/.share/pixmaps/
     

  2. Relying on the deprecated data_files, that only work outside of virtual environments. This means installing with pip:

     python3 -m pip install --user --break-system-packages pympress