Skip to content
Emeric edited this page Mar 6, 2016 · 25 revisions

You can adjust a lot of settings to make OpenSubtitlesDownload.py even better!

Change search language

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

Find the opt_language setting and change it with the search language you want. You will need to uses a 2-letter (ISO 639-1) or 3-letter (ISO 639-2) language codes. You can check this SubLanguageIDs list, or use the one from opensubtitles.org. The default language is English.

opt_language = ['eng']

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

Option 1 download the first language available only

  • If there is only one subtitle found (either English or French), it will be automatically downloaded.
  • If there is several subtitles found (either English and/or French), the user will see the "selection window" with all subtitles found in it, and can choose which subtitle he want with the help of a "language" column.
opt_language = ['eng,fre']    # this example will use English and French

Option 2 download all selected languages

  • If there is only one subtitle found (either English or French), it will be automatically downloaded.
  • If there is only one English AND one French subtitle found, they will be automatically downloaded.
  • If there is several subtitles found (English and/or French), the user will see a different "selection window" for each language.
opt_language = ['eng','fre']    # this example will use English and French

The opt_language_suffix setting let you decide whether or not embed language codes into the subtitles file name.

opt_language_suffix  = 'auto'

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

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

Use the "search by filename" as backup?

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

Find the opt_backup_searchbyname setting, and set it to either:

  • on (default) (search subtitles using the file name if the search by movie hash fails)
  • off (exit if the search by movie hash fails)

Automatic or manual selection mode?

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

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

  • manual (default) (will let you choose the subtitles you want if more than one result is available)
  • auto (for a fully automatic subtitles search and download)

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 overriden 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 subtitles selection windows. Values are in pixels.

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

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

opt_selection_language = 'auto'  # Show subtitles language
opt_selection_hi       = 'auto'  # Is it a subtitles with Hearing Impaired informations
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 contains valuable informations. 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 informations.

Clone this wiki locally