Skip to main content

subnuker

https://img.shields.io/pypi/v/subnuker.svg https://img.shields.io/pypi/l/subnuker.svg https://img.shields.io/pypi/dm/subnuker.svg

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.

I recommend you check out my project subsystem. It is used for batch processing of subtitle/video files from the terminal or GUI (i.e. Thunar custom actions or Nautilus actions). It allows you to rapidly do the following in order: rename video file(s), download subtitle file(s), then scan subtitle file(s) with subnuker.

Installation

pip3 install --user subnuker

The subnuker package is 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, 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 subnuker --help to display available options.

The recommended way to scan any subtitle files (or folders containing subtitles):

subnuker -ar TARGET...

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 grep’s --file option.

subnuker --file PATTERNFILE FILE.srt

The --aeidon option indicates the use of the aeidon module. The aeidon module has full support for all subnuker options. I strongly recommend the use of the --aeidon flag to process subtitle files suspected of damage.

subnuker --aeidon FILE.srt

In general, I strongly recommend using the --regex flag. The built-in regex “wordlist” will identify almost all advertisements with zero to no false positives. To scan srt subtitle files with regular expressions, run the following:

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

License

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

Licensed under the GPLv3 license.

Metadata

Release files for subnuker 0.4.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for subnuker 0.4.5
File Size Uploaded Provenance Actions
subnuker-0.4.5.tar.gz 7.5 kB Without provenance Details for subnuker-0.4.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for subnuker 0.4.5
File Interpreter ABI Platform Actions
subnuker-0.4.5-py3-none-any.whl Python 3 none any Details for subnuker-0.4.5-py3-none-any.whl

Total release size: 17.9 kB

Release files / subnuker-0.4.5.tar.gz

Download URL subnuker-0.4.5.tar.gz
Size 7.5 kB
Tags Source
SHA-256 checksum
How to use checksums
74b13bfeb2ef8182b70f64488298c317ef9c64d412a68e6ae1d5b88e15e419b9
BLAKE2b-256 checksum
How to use checksums
7411e4685bafa57f9d4776e8843a4b955c082b4638806cfc4b9b5e074a458dac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / subnuker-0.4.5-py3-none-any.whl

Download URL subnuker-0.4.5-py3-none-any.whl
Size 10.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2bf03104a3d54955afbfe660dcd30a59289cf4fde461d585d5ad8438df0d7660
BLAKE2b-256 checksum
How to use checksums
74d7de98a31b13001bad1547f98caf9f0a33e41ab483ed76061dd1f13821c061
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for subnuker 0.4.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page