General Information
===================

Gaupol is an editor for text-based subtitle files. It supports multiple
subtitle file formats and provides means of creating subtitles, editing
texts and timing subtitles to match video. The user interface is
designed with attention to batch processing of multiple documents and
convenience of translating.

Gaupol contains aeidon, a separately installable general-purpose
Python package for reading, writing and manipulating text-based
subtitle files. See the file 'README.aeidon' for details.

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

Dependencies
============

Gaupol requires Python <http://www.python.org/> 3.2 or greater,
PyGObject <http://wiki.gnome.org/Projects/PyGObject> 3.6.0 or
greater and GTK+ <http://www.gtk.org/> 3.2 or greater. Optional,
but strongly recommended dependencies follow.

 * GStreamer <http://gstreamer.freedesktop.org/> 1.0 or greater
   (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)
   -- required for the integrated video player
 * PyEnchant <http://pythonhosted.org/pyenchant/> 1.4.0 or greater
   -- required for spell-checking
 * GtkSpell <http://gtkspell.sourceforge.net/> 3.0.0 or greater
   -- required for inline spell-checking
 * iso-codes <http://pkg-isocodes.alioth.debian.org/>
   -- required to translate language and country names
 * Universal Encoding Detector (a.k.a. chardet)
   <http://pypi.python.org/pypi/chardet>
   -- required for character encoding auto-detection
 * MPlayer <http://www.mplayerhq.hu/> or
   VLC <http://www.videolan.org/vlc/>
   -- recommended for preview
 * PT Sans Caption and PT Mono fonts <http://www.paratype.com/public/>
   -- recommended and used by default for integrated video player's
   subtitle and timecode overlays

Running
=======

To try Gaupol from the source directory without installation, use
command 'python3 bin/gaupol'. Installation is, however, necessary for
mimetype integration, application menu entry and user interface
translations. For installing Gaupol, see the file 'INSTALL'.
