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


Keywords
subtitles, addic7ed, scraper
License
MIT
Install
pip install addic7ed==0.3.4

Documentation

Addic7ed Scraper

Requirements

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

Install

Using python-pip:
$ sudo pip install addic7ed
Using Git repository:
$ git clone https://github.com/Jesus-21/addic7ed.git 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):

[addic7ed]
lang = en

You can find language codes here

Usage

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

$ addic7ed

or

$ /git/clone/path/addic7ed.py
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.

Example

TODO List

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

Suggestions and/or pull requests are more than welcome!