Python Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Build Status Packages Gitter Donate

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 you need a newer version than packaged, read on.

Gaupol requires Python ≥ 3.2, 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
PyEnchant ≥ 1.4.0 spell-check
GtkSpell ≥ 3.0.0 inline spell-check
iso-codes any translations
chardet any 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 python3 \
                 python3-gi \
                 python3-gi-cairo \
                 gir1.2-gtk-3.0 \
                 gettext \
                 gir1.2-gstreamer-1.0 \
                 gir1.2-gst-plugins-base-1.0 \
                 gstreamer1.0-gtk3 \
                 gstreamer1.0-plugins-good \
                 gstreamer1.0-plugins-bad \
                 gstreamer1.0-plugins-ugly \
                 gstreamer1.0-libav \
                 python3-enchant \
                 gir1.2-gtkspell3-3.0 \
                 iso-codes \

Then, to install Gaupol, run command

sudo python3 install --prefix=/usr/local


See the releases page for installers. Note that Windows packaging is irregular, sometimes skipping a version, sometimes on hold completely, so you might need to look further than the latest release. Also note that the Windows version might lack some features, currently notably lacking the builtin video player.