OpenSubtitlesDownload

Illustration by Franck Helaine. Thanks ;-)

Automatically find and download the right subtitles for your favorite videos!

The subtitles search is done by precisly identifying your video files by computing unique movie hash sums. This way, you have more chance to find the exact subtitles for your videos, avoiding synchronization problems between the subtitles and the soundtrack.

GitHub page Wiki Releases Issue tracker

platforms

linux GUI

platforms

universal CLI

license

GPLv3

FEATURES

Query subtitles in more than 60 different languages for documentaries, movies, TV shows and more...
Query subtitles in multiple languages at once
Query subtitles for multiple video files at once

Identify videos by computing unique movie hash sums in order to download the right subtitles for the right file!
If the video identification fails, a "simple" backup search using filename will be performed
Download subtitles automatically if only one is available, choose the one you want otherwise
Rename downloaded subtitles automatically to match source video file. Possibility to append the language code to the file name (ex: movie_en.srt)
Detect valid video files (using mime types and file extensions)

Use a GNOME/GTK or KDE/Qt GUI depending on your favorite desktop environment
Or just use the CLI! Great for automation, and it works on Linux, macOS and Windows

Always synced subtitles in 60 languages!

Detect correct video titles by computing unique movie hash sums in order to download the right subtitles for the right file!

Doesn't get in the way

You are one click away of understanding what's happening in your movie!

CLI mode for automation

Fully functional CLI mode for automation. Want your NAS to automatically subtitles your new files? It's easy!

Learn more!

Adjust many settings

Language selection obviously!
Language codes in file names
Manual or automatic selection modes
GUI window size, additionnal infos
And more!

Learn more!

Documentation

GitHub page Wiki Release notes Issue tracker

Installation instructions On the on the wiki page, and always up-to-date!

Configuration instructions To change the search language and more advanced tune-in (optional).

Dependencies

python (version 3)

zenity (for GNOME GUI)

kdialog (for KDE GUI)

basic unix tools: wget & gzip (subtitles downloading), ps & grep (GUI autodetection)

Quick install (as a nautilus script)

        
          # Make sure the destination directory for nautilus scripts exits
          mkdir -p ~/.local/share/nautilus/scripts/
          cd ~/.local/share/nautilus/scripts/
          # Download the script and make it executable
          wget https://raw.githubusercontent.com/emericg/OpenSubtitlesDownload/master/OpenSubtitlesDownload.py
          chmod u+x OpenSubtitlesDownload.py