Skip to main content

Addic7ed scraper written in Python to download subtitles (almost) automatically

Project description


This scraper is made to work with Python 3 only. It is pre-installed on many linux distribution.

If it’s not your case, install it :p


Using python-pip:
$ sudo pip install addic7ed
Using Git repository:
$ git clone addic7ed

or download/unzip archive

then (from download/clone path):

$ sudo pip install -r requirements.txt

or use python Python virtualenv and install requirements within.

Create ~/.addic7edrc file containing language you want (english for instance):

lang = en

You can find language codes here


If you installed using python-pip, just run addic7ed (otherwise file should be excutable) from the folder where your video files are,

$ addic7ed


$ /git/clone/path/
following command line arguments can be provided:
positional arguments:
    PATH                  path of file to search subtitles for (default: all
                          video from current dir).

optional arguments:
    -h, --help            show this help message and exit
    --list-lang           list supported languages.
    -n, --dry-run         do not ask or download subtitlejust output available
                            ones and leave.
    -l LANG, --lang LANG  language to search subs for (default: en).
    -k, --keep-lang       suffix subtitle file with language code.
    -f FROM_FILE, --from-file FROM_FILE
                            read files paths from a file.
    -r {none,sub,video}, --rename {none,sub,video}
                            rename sub/video to match video/sub or none at all
                            (default: none).

then it will prompt which file you want to download. If download is successful, it will rename the video file to match subtitle file.



  • Error management/reporting
  • Intelligent auto-download (using comment + completion + popularity)
  • Better file crawling (recursivity mainly)

Suggestions and/or pull requests are more than welcome!

Project details

Download files

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

Files for addic7ed, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size addic7ed-1.1.0-py3-none-any.whl (11.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size addic7ed-1.1.0.tar.gz (7.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page