Skip to main content

Download and process subtitle files in batch

Project description

About

This script is intended to be a one-stop-shop for batch preparing freshly downloaded video files for use with subtitles.

The tool can be used from the command-line but is ideal for use via GUI file managers (i.e. Thunar Custom Actions). With a single click of several video files: prompt to rename files, download the best subtitle file available (displaying a popup notification upon failure), then open a terminal window to scan and remove advertising (via subnuker).

Installation

pip3 install --user subsystem

The subsystem package is known to be compatible with Python 3.

Requirements

yad or zenity is required if you’d like to make use of the GUI renamer.

yad is highly recommended and is available via sources (at its homepage) or via PPA (Launchpad):

sudo apt-add-repository ppa:webupd8team/y-ppa-manager
sudo apt-get update && sudo apt-get install yad

zenity is not particularly recommended but is available for download via:

sudo apt-get install zenity

In order to make use of subsystem, you need have external downloaders installed. I recommend the Python 3 compatible download tool ss. In my limited experience is has been the fastest and most reliable tool available.

pip3 install --user ss

subsystem is also interoperable with the Python 2 compatible downloaders periscope and subscope

pip2 install --user periscope
pip2 install --user subscope

Usage

From the command line, run subsystem --help to display options and downloaders available. Subsystem will use ss by default if possible, but will use whatever is available.

To download subtitles for files:

subsystem FILES

To use an alternate downloader:

subsystem -d DOWNLOADER FILES

To rename video files then scan upon download completion:

subsystem --rename --scan FILES

To silence popup notications upon failure:

subsystem --quiet FILES

License

Copyright (c) 2015 Six (brbsix@gmail.com).

Licensed under the GPLv3 license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

subsystem-0.3.tar.gz (5.9 kB view hashes)

Uploaded Source

Built Distribution

subsystem-0.3-py3-none-any.whl (8.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page