Skip to main content

Remove spam and advertising from subtitle files

Project description

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.


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 --user --without-gaupol clean install

Additional information on installing Gaupol is available here:


>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

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

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


Copyright (c) 2015 Six (

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

subnuker-0.4.5.tar.gz (7.5 kB view hashes)

Uploaded source

Built Distribution

subnuker-0.4.5-py3-none-any.whl (10.4 kB view hashes)

Uploaded py3

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