KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

subdl

★ 9 Open GitHub ↗

a subtitle downloader for your movies and tv-series

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

subdl
=====

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

subdl

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README