Editor for text-based subtitle files
Python Other



Build Status Gitter Downloads Downloads

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.

The Gaupol source tree also includes aeidon, a separately installable general-purpose Python package for reading, writing and manipulating text-based subtitle files. See the file README.aeidon.md for details.

Gaupol is free software released under the GNU General Public License (GPL), see the file COPYING for details.


Gaupol requires Python ≥ 3.2, PyGObject ≥ 3.12 and GTK+ ≥ 3.12. Optional, but strongly recommended dependencies include:

Dependency Version Required for
GStreamer ≥ 1.0 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 and gst-plugins-good; and for good container and codec support preferrably each of gst-plugins-bad, gst-plugins-ugly and gst-libav.

Additionally, Gaupol's external preview is preconfigured to work with mpv, MPlayer and VLC. Any other video player that supports a command line argument to set where playing begins from can be used as well, but you need to configure the command yourself.


To try Gaupol from the source directory without installation, use command bin/gaupol. For installing Gaupol, see the file INSTALL.md.