Skip to main content

a subtitle downloader for your movies and tv-series

Project description

a subtitle downloader for your movies and tv-series

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

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 subdl, version 1.0.9
Filename, size File type Python version Upload date Hashes
Filename, size subdl-1.0.9.tar.gz (19.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page