Metadata-Version: 2.0
Name: subnuker
Version: 0.2
Summary: Remove advertising from subtitle files
Home-page: https://github.com/brbsix/subnuker
Author: Brian Beffa
Author-email: brbsix@gmail.com
License: GPLv3
Keywords: advertising,srt,subtitle
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: 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 :: Text Processing
Classifier: Topic :: Utilities
Requires-Dist: batchpath
Requires-Dist: chardet

About
=====

This script is intended to scan subtitle files (or folders containing subtitle files) and prompt to remove cells with advertising. Subtitle files may be searched via regular expression or plaintext. The script can handle srt subtitle files natively or other formats (ass, srt, ssa, sub) via the Python module **aeidon**.


Installation
============

::

  pip3 install subnuker

The :code:`subnuker` package is known to be compatible with Python 3.

Subnuker can process srt subtitle files right out of the box. If you wish to handle other types of subtitle files (ass, srt, ssa, sub), you'll need to install the aeidon module.

On Debian/Ubuntu, try:

::

  sudo apt-get install python3-aeidon

Or download the tarball for Gaupol_.
After unpacking, run:

::

  python3 setup.py --user --without-gaupol clean install

Additional information on installing Gaupol is available here:

https://github.com/otsaloma/gaupol/blob/master/README.aeidon.md


Usage
=====

>From the command line, run :code:`subnuker --help` to display available options.

You may scan srt subtitle files with or without the regex flag, though there are likely to be less false positives with regex:

::

  subnuker --regex FILE1.srt FILE2.srt FILE3.srt

Or scan entire folders containing srt subtitle files:

::

  subnuker FOLDER1 FOLDER2 FOLDER3

By default, `subnuker` scans subtitles with a built-in list of plaintext search terms or regular expression. Subnuker can also obtain patterns from multiple pattern files, similar to :code:`grep`'s :code:`--file` option.

::

  subnuker --file PATTERNFILE FILE.srt

The :code:`--aeidon` option indicates the use of the aeidon module. The aeidon module has full support for all options:

::

  subnuker --aeidon FILE.srt


License
=======

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

Licensed under the GPLv3 license.

.. _Gaupol: http://home.gna.org/gaupol/download.html


