/gaupol

Editor for text-based subtitle files

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Gaupol

Test Packages Flathub

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 README.aeidon.md for details.

Installing

Linux

Packages

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.

Flatpak

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.

Source

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 \
                 python3-gi-cairo

Then, to install Gaupol, run command

sudo python3 setup.py install --prefix=/usr/local

Windows

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.