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:
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 sibtitle file with language ISO code.
    -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.

Filename, size & hash SHA256 hash help File type Python version Upload date
addic7ed-0.3.2-py3-none-any.whl (11.5 kB) Copy SHA256 hash SHA256 Wheel py3
addic7ed-0.3.2.tar.gz (7.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page