OpenSubtitlesDownload

OpenSubtitlesDownload logo
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 page Release page

platforms
linux GUI | 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 by 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 and macOS
feature list

Always synced subtitles!

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!

Adjust various settings

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

SCREENSHOTS

DOWNLOAD

python script

Version 3.6 (zip)Stable and battle tested!
Dev. version (zip)If you are feeling adventurous...
Documentation

GitHub page Wiki page Release page

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

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

Dependencies
  • python (version 2 or 3)
  • zenity (for GNOME 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

    Get involved!

    Users

    You can help us find and report bugs, propose new features, help with the documentation and more! Visit the Issues section of the GitHub page to start!

    Developers

    You can browse the code on the GitHub page, submit patches and pull requests! Your help would be greatly appreciated ;-)

    License

    OpenSubtitlesDownload is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

    Read more about the GPLv3!