Skip to content
Emeric edited this page Mar 27, 2024 · 25 revisions

You can adjust so many settings to make OpenSubtitlesDownload.py even better!

For OpenSubtitlesDownload v6 and up, stay here ;-)
For OpenSubtitlesDownload v3.6+
For OpenSubtitlesDownload v3.5
For OpenSubtitlesDownload v3.0+

Log in with a registered user

A valid account from opensubtitles.com is REQUIRED to use this application

The old opensubtitles.ORG accounts won't work anymore, unless you migrated them from the new website

To use OpenSubtitlesDownload you need to:

  • Create an account on opensubtitles.com website
  • Edit your OpenSubtitlesDownload.py file and look for the "Opensubtitles.org server settings" section at the beginning of the file.
  • Look for osd_username and osd_password fields:
osd_username = 'set your username, NOT your account email address'
osd_password = 'chosen password'

Change search language

Edit your OpenSubtitlesDownload.py file and look for the "Language settings" section.

Language

Find the opt_languages setting and change it with the search language you want. You will need to use any 2-letter (ISO 639-1) language code. You can check this Language list, or use the one from opensubtitles.com. The default language is set to English.

opt_languages = 'en'

You can also search for subtitles in several languages ​​at once. To do that, you need to change the opt_languages setting like this:

opt_languages = 'en,fr' # this example will use English and French

Language suffix

The opt_language_suffix setting let you decide whether or not to embed language codes into the subtitles file name. You can also customize the separator!

opt_language_suffix = 'auto'
opt_language_separator = '_'

The subtitles files will look like this when this feature is enabled:

/videos/mymovie.mp4
/videos/mymovie_en.srt
/videos/mymovie_fr.srt

Adjust search mode

Edit your OpenSubtitlesDownload.py file and look for the "Search settings" section.

Find the opt_search_mode setting, and set it to either:

  • hash_then_filename (search by hash, then filename if no results) (default)
  • hash_and_filename (search using both methods)
  • hash (search by hash)
  • filename (search by filename)

Adjust selection mode?

Edit your OpenSubtitlesDownload.py file and look for the "Search settings" section.

Find the opt_selection_mode setting and change it with one of the two modes available:

  • manual (always let you choose the subtitles you want)
  • default (default) (in case of multiple results, let you choose the subtitles you want)
  • auto (automatically select the best subtitles found)

GUI settings

GUI selection

Edit your OpenSubtitlesDownload.py file and look for the first item in the "Settings" section.

# Select your GUI:
opt_gui = 'auto'

You can use this setting to force a GUI if the autodetection isn't good enough for you. This setting can also be overridden at run time with '--gui=xxx'.

  • auto (autodetect, fallback on CLI)
  • gnome (GNOME/GTK based environments, using 'zenity' backend)
  • kde (KDE/Qt based environments, using 'kdialog' backend)
  • cli (Command Line Interface)

Subtitle selection windows

Edit your OpenSubtitlesDownload.py file and look for "GUI settings" section. You can change the width and the height of the subtitle selection windows. Values are in pixels.

# You can change the subtitle selection GUI size:
opt_gui_width  = 720
opt_gui_height = 320

Subtitle selection settings

You can also choose to show or hide additional columns from the selection windows:

opt_selection_hi        = 'auto'  # Is it a subtitle with Hearing Impaired information
opt_selection_language  = 'auto'  # Show subtitles language
opt_selection_matchedby = 'auto'  # Show subtitles search mode
opt_selection_rating    = 'off'   # User rating for the subtitles
opt_selection_count     = 'off'   # Number of user downloads for the subtitle

If you choose "auto", these additional columns will only be displayed if they contain valuable information. For instance, the "language" will only be displayed if you are looking for multiples languages at once, and the HI column will only be displayed if at least one of the subtitles found has hearing impaired information.