subdownloader man page

subdownloader — the subtitle downloader


subdownloader [-h] [--help] [-g] [--gui] [-c] [--cli] [-d] [--debug] [-q] [--quiet] [-T] [--test] [-H] [--human] [-n] [--nerd] [-D] [--download] [-U] [--upload] [-L] [--list] [-V < path >] [--video=< path >] [-l < language >] [--lang=< language >] [-i] [--interactive] [--sol] [--los] [-u < username >] [--user=< username >] [-p < password >] [--passwd=< password >] [-s < address >] [--server=< address >] [-P < address >] [--proxy=< address >] [--log=< logfile >] [--version]


SubDownloader is a Free Open Source tool written in Python for automatic download/upload subtitles for videofiles (DIVX,MPEG,AVI,etc) and DVD's using fast hashing.


-h --help

Show SubDownloader command-line options.

-g, --gui

Run application in GUI mode. This is the default.

-c, --cli

Run application in CLI mode.

-d, --debug

Print debug messages to stout and logfile.

-q, --quiet

Don't print status messages to stdout.

-T, --test

Used by developers for testing.

-H, --human

Print human readable messages. Default for CLI mode.

-n, --nerd

Print messages with more details.

-D, --download

Download a subtitle. Default for CLI mode.

-U, --upload

Upload a subtitle.

-L, --list

List available subtitles without downloading.

-V path , --video= path

Full path to your video(s). Don't use '~'.

-l language , --lang= language

Used in subtitle download and upload preferences.

-i, --interactive

Prompt user when decisions need to be done.


Rename subtitles to match movie file name


Keep original subtitle names


´Server Over Local´ overwrites local subtitle with one from server. This is in cases when local subtitle isn't found on server, but server has subtitles for the movie.


´Local Over Server´ keeps local subtitles, even if another is found on server. This is the default.

-u username , --user= username username. Must be set in upload mode. Default is blank (anonymous).

-p password , --passwd= password password. Must be set in upload mode. Default is blank (anonymous).

-s address , --server= address

Server address of Opensubtitles API.

-P address , --proxy= proxy

Proxy to use on internet connections.

--log= logfile

Write the log to logfile.


Show program's version number and exit.

See Also


Ivan Garcia <>

Marco Ferreira <>

Marco Rodrigues <>