Running PTGui on Linux

Starting with version 12, PTGui is available for Windows, macOS and Linux. The PTGui license is platform independent, so a single license allows you to use PTGui on all major desktop platforms.

For technical and licensing reasons, PTGui for Linux is distributed as a dynamically linked binary and requires a compatible Linux environment. The PTGui application was built on Ubuntu 16 using gcc 9.3. There are many Linux distributions and we can't guarantee compatibility with every one, but it should generally run in a glibc-based linux environment capable of running gcc 9.3 or later. Some common libraries such as gtk3 and zlib are needed but these come preinstalled with most graphical Linux desktop environments. One particular requirement is the OpenCL ICD library, this is needed for OpenCL GPU acceleration. It should be installed even if OpenCL is not actually used. The PTGui Viewer requires OpenGL 3.2 which may require vendor provided GPU drivers.


Download the PTGui application from this website. You will get a .tar.gz archive. In a shell, change to the directory where PTGui should be installed and do this:
mkdir ptgui && cd ptgui
tar xvfz PTGui_X.XX.tar.gz
Replace X.XX with the actual name of the downloaded file. The directory now contains two applications named 'PTGui' and 'PTGuiViewer' and additional supporting files and folders. This folder structure should be preserved. After installing the required packages (see below), PTGui can be run by executing
in a terminal in this folder.

You can add a launcher or start menu item to your desktop. This must be done manually because it depends on the desktop environment used. Icons for PTGui and the PTGui Viewer are included.


The following packages must be installed:

Ubuntu 16 and 18:
sudo apt install ocl-icd-libopencl1
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt update
sudo apt install --only-upgrade libstdc++6

Ubuntu 20:
sudo apt install ocl-icd-libopencl1

Fedora 31:
sudo dnf install ocl-icd libglvnd-opengl


PTGui currently requires a graphical desktop, it will fail to run is $DISPLAY has not been set. This is the case even when stitching a project from the command line using the '-stitchnogui' flag. As a workaround you may create a dummy graphical desktop using VNC server and let PTGui use this. We hope to solve this in a future update.

Support and feedback

If you need more help, please post to the PTGui Support Forum. If you have tried running PTGui in other Linux distributions please let us know your experiences so we can keep this page updated.
PTGui and PTGui Pro are products of New House Internet Services B.V., Rotterdam, The Netherlands. The PTGui and PTGui Pro software, related documentation and all contents on this site are © Copyright 2000-2021 New House Internet Services B.V., Rotterdam, The Netherlands. All rights reserved.