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 and run

$ sudo python 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",


Use github issue tracker to report bugs.

Project details

Download files

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

Source Distribution

subdl-1.0.9.tar.gz (19.6 kB view hashes)

Uploaded source

Supported by

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