How to install

If have pip installed on your machine. Just do

$ sudo pip install -U subdl

The -U option will just ensure that you always have the latest package.

If you do not have pip installed download this repository https://github.com/dhirajt/subdl/archive/master.zip and run

$ sudo python setup.py install

after extracting it.

How to use

subdl can download movies by detecting media files in you drive using -d flag. It’ll download the first subtitle availble.

$ subdl -d /media/Hulk    # Hulk is my drive's name!

The -d flag is optional. If you just run

$ subdl

the script will search for media files in current folder.

To choose from a list of subtitles use the choose flag.

$ subdl -cd /media/Hulk  # prompts before downloading subs

To specify a name for a movie or tv episode use name flag.

$ subdl -n 'the help'   # use quotes to specify names.

again this downloads the first subtitle available. To choose from a list use the -c flag

$ subdl -cn 'the help'  # prompts before downloading subs

To specify language use language flag.

$ subdl -cn 'the help' -l 'eng'  # downloads enlish subtitles

If no language is specified only english subtitles are downloaded. See below for supported languages.

Subtitle languages

Use only three characters for specifying language.

{
    "all": "ALL",
    "afr": "Afrikaans",
    "alb": "Albanian",
    "ara": "Arabic",
    "arm": "Armenian",
    "baq": "Basque",
    "ben": "Bengali",
    "bos": "Bosnian",
    "pob": "Portuguese-BR",
    "bre": "Breton",
    "bul": "Bulgarian",
    "bur": "Burmese",
    "cat": "Catalan",
    "chi": "Chinese",
    "hrv": "Croatian",
    "cze": "Czech",
    "dan": "Danish",
    "dut": "Dutch",
    "eng": "English",
    "epo": "Esperanto",
    "est": "Estonian",
    "fin": "Finnish",
    "fre": "French",
    "glg": "Galician",
    "geo": "Georgian",
    "ger": "German",
    "ell": "Greek",
    "heb": "Hebrew",
    "hin": "Hindi",
    "hun": "Hungarian",
    "ice": "Icelandic",
    "ind": "Indonesian",
    "ita": "Italian",
    "jpn": "Japanese",
    "kaz": "Kazakh",
    "khm": "Khmer",
    "kor": "Korean",
    "lav": "Latvian",
    "lit": "Lithuanian",
    "ltz": "Luxembourgish",
    "mac": "Macedonian",
    "may": "Malay",
    "mal": "Malayalam",
    "mon": "Mongolian",
    "nor": "Norwegian",
    "oci": "Occitan",
    "per": "Farsi",
    "pol": "Polish",
    "por": "Portuguese",
    "rum": "Romanian",
    "rus": "Russian",
    "scc": "Serbian",
    "sin": "Sinhalese",
    "slo": "Slovak",
    "slv": "Slovenian",
    "spa": "Spanish",
    "swa": "Swahili",
    "swe": "Swedish",
    "syr": "Syriac",
    "tgl": "Tagalog",
    "tam": "Tamil",
    "tel": "Telugu",
    "tha": "Thai",
    "tur": "Turkish",
    "ukr": "Ukrainian",
    "urd": "Urdu",
    "vie": "Vietnamese",
}

Bugs

Use github issue tracker to report bugs. https://github.com/dhirajt/subdl/issues