subconvert 3.0.0

Install from PYPI

$ pip3 install --user subconvert

Install with tox

If you cloned a git repository, you can install Subconvert with help of tox.

$ cd subconvert
$ tox -e venv
$ ln -s {.venv,$HOME/.local}/bin/subconvert
$ ln -s {.venv,$HOME/.local}/share/applications/subconvert.desktop

Install with setup.py

You can alternatively create a Python distribution (like bdist_wheel) and install it:

$ cd subconvert
$ python3 setup.py bdist_wheel
$ pip3 install dist/\*.whl

Or install it directly:

$ cd subconvert
$ python3 setup.py install

Output filename syntax

It’s not uncommon to add some kind of prefix/suffix to converted subtitles. Like this:

my_subtitles.srt --> converted_my_subtitles.extension

When you specify output filename (via -o option), you can tell Subconvert to use input file name base. Subconvert will substitute with it all appearances of %f in output file name. See an example:

$ ls
$ file1.srt  file2.txt
$ subconvert -c file1.srt file2.txt -o "conv_%f.ABC"
$ ls
$ conv_file1.ABC  conv_file2.ABC  file1.srt  file2.txt

You can escape “%f” by adding second percent sign (“%”):

$ subconvert -c file1.srt -o "conv_%%f.ABC"
$ ls
$ conv_%f.ABC  file1.srt  file2.txt

You can also substitute %e, with original file extension (without a dot .):

$ subconvert -c file1.srt -o "conv_%f.%e_suffix"
$ ls
$ conv_file1.srt_suffix  file1.srt  file2.txt

Subtitle Property Files

You can create a common set of subtitle properties and apply all of them at once. Say, your subtitles are usually iso-8859-4 encoded and you usually convert them to TMP. You can set those settings with Subtitle Properties Editor (available via GUI: Tools -> Subtitle Properties Editor) and use them each time:

$ subconvert -c file1.srt file2.txt -o "~/subs/%f.tmp" -p ~/subs/iso88594_tmp.spf
$ ls ~/subs
$ file1.tmp  file2.tmp