Reading, writing and manipulating text-based subtitle files

gstreamer, gtk, python, subtitles
pip install aeidon==1.15



Test Packages Flathub Chat

Gaupol is an editor for text-based subtitle files. It supports multiple subtitle file formats and provides means of creating, editing and translating subtitles and timing subtitles to match video.

Gaupol also includes aeidon, a separately installable general-purpose Python package for reading, writing and manipulating text-based subtitle files. See for details.




Gaupol is packaged for most of the popular distros, so easiest is to install via your distro's package management. If not packaged for your distro or you need a newer version than packaged, read below on how to install from Flatpak or the source code.


Stable releases are available via Flathub.

The development version can be installed by running command make install under the flatpak directory. You need make, flatpak-builder and gettext to build the Flatpak.


Gaupol requires Python ≥ 3.5, PyGObject ≥ 3.12 and GTK ≥ 3.12. Additionally, during installation you need gettext. Optional, but strongly recommended dependencies include:

Dependency Version Required for
GStreamer ≥ 1.6 integrated video player
gspell ≥ 1.0.0 spell-check
iso-codes ≥ 3.67 translations
charset-normalizer ≥ 2.0 character encoding auto-detection

From GStreamer you need at least the core, gst-plugins-base, gst-plugins-good and gst-plugins-bad; and for good container and codec support preferrably both of gst-plugins-ugly and gst-libav.

On Debian/Ubuntu you can install the dependencies with the following command.

sudo apt install gettext \
                 gir1.2-gspell-1 \
                 gir1.2-gst-plugins-base-1.0 \
                 gir1.2-gstreamer-1.0 \
                 gir1.2-gtk-3.0 \
                 gstreamer1.0-gtk3 \
                 gstreamer1.0-libav \
                 gstreamer1.0-plugins-bad \
                 gstreamer1.0-plugins-good \
                 gstreamer1.0-plugins-ugly \
                 iso-codes \
                 python3 \
                 python3-charset-normalizer \
                 python3-dev \
                 python3-gi \

Then, to install Gaupol, run command

sudo python3 install --prefix=/usr/local


Windows installers are no longer built due to bad tooling, bad results, lack of time and lack of motivation. The latest version available for Windows is 1.3.1. Some features do not work in the Windows version, most importantly the builtin video player is disabled.