Adjust settings

You can adjust several settings to make opensubtitles-download even better!

Change search language

Edit your opensubtitles-download.py file and look for the "Language selection" section.

Find the SubLanguageIDs parameter 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.

SubLanguageIDs = ['eng']

You can also search for subtitles in several languages ​​at once. To do that, you need to change your SubLanguageIDs 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.

SubLanguageIDs = ['eng,fre']

Option 2 download all selected languages

• If there is only one subtitle found (either English of 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.

SubLanguageIDs = ['eng','fre']

Subtitle selection windows

Edit your opensubtitles-download.py file and look for "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:
gui_width  = 720
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_cd       = 'auto'  # Number of CD
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.

Other options

Edit your opensubtitles-download.py file and look for "Settings" section. The opt_file_languagecode parameter let you decide whether or not embed language codes into the subtitles file name.

opt_file_languagecode  = 'off'

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

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