Metadata-Version: 1.1
Name: subsystem
Version: 0.5.1
Summary: Download and process subtitle files in batch
Home-page: https://github.com/brbsix/subsystem
Author: Brian Beffa
Author-email: brbsix@gmail.com
License: GPLv3
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 or Nautilus 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_).
        
        If you are used to downloading subtitles with other tools, you are in for a surprise. Not only does it pack a wicked set of features, but it makes full use your processor to download subtitles in parallel... superfast.
        
        
        Installation
        ============
        
        ::
        
          pip3 install --user subsystem
        
        The ``subsystem`` package is known to be compatible with Python 3.
        
        
        Requirements
        ============
        
        *NOTE: The most recent version of subsystem is bundled with yad 0.28.0. It is tentatively included at this time purely out of convenience for users.*
        
        A GTK dialog tool (yad or zenity) is required if you'd like to make use of the GUI renamer.
        
        yad is available via tarball (at its homepage_) or webupd8team PPA (Launchpad_):
        
        ::
        
            sudo apt-add-repository ppa:webupd8team/y-ppa-manager
            sudo apt-get update && sudo apt-get install yad
        
        In order to make use of ``subsystem``, you'll need to install a downloader. I recommend the Python 3 compatible ``ss``. In my limited experience is the fastest and most reliable tool available.
        
        ::
        
          pip3 install --user ss
        
        ``subsystem`` is also compatible with the Python 2 scripts ``periscope`` and ``subscope``
        
        ::
        
          pip2 install --user periscope
        
        ::
        
          pip2 install --user subscope
        
        
        Usage
        =====
        
        From the command line, run ``subsystem --help`` to display available options and downloaders. ``subsystem`` will use ``ss`` by default if possible, otherwise it will detect and use whatever is available.
        
        To download subtitles for files:
        
        ::
        
            subsystem FILE...
        
        To use an alternate downloader:
        
        ::
        
            subsystem -d DOWNLOADER FILE...
        
        To rename video files prior to download of subtitles:
        
        ::
        
            subsystem --rename FILE...
        
        To scan subtitles files with ``subnuker`` upon download completion:
        
        ::
        
            subsystem --scan FILE...
        
        Note: Executing subsystem with the ``--scan`` option from a GUI will open ``subnuker`` in a new terminal window. It is configured to use ``xfce4-terminal``. Let me know if you'd like to support another terminal and I'll add the feature.
        
        To silence ``notify-send`` notications upon failure:
        
        ::
        
            subsystem --quiet FILES
        
        **Note: Multiple options may be combined**
        
        
        License
        =======
        
        Copyright (c) 2015 Six (brbsix@gmail.com).
        
        Licensed under the GPLv3 license.
        
        .. _homepage: http://sourceforge.net/projects/yad-dialog
        .. _Launchpad: https://launchpad.net/~webupd8team/+archive/ubuntu/y-ppa-manager
        .. _subnuker: https://github.com/brbsix/subnuker
        
Keywords: advertising,download,periscope,rename,srt,ss,subscope,subtitle,thunar,yad
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.0
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Utilities
