Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
March 23, 2022 14:54
January 13, 2021 14:20
March 23, 2022 14:54
March 5, 2018 12:32

GitHub release GitHub contributors GitHub issues License: GPL v3

Introduction is a small software written in Python, built to help you quickly find and download subtitles for your favorite videos. It can be used as a nautilus script, or as a regular application working under GNOME or KDE desktop environments. You can also use it in full CLI mode (Command Line Interface) on your NAS, Raspberry Pi or anywhere you want really, as long as you have a working Python interpreter.

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. But what if that doesn't work? Well, a search with the filename will be performed, but be aware: results are a bit more... unpredictable (don't worry, you will be warned! and you can even disable this feature if you want).

The subtitles search and download service is powered by Big thanks to their hard work on this amazing project! Be sure to give them your support if you appreciate the service provided, they sure need donations for handling the ever growing hosting costs!


  • 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
  • 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 and folders at once
  • Detect valid video files (using mime types and file extensions)
  • Detect correct video titles by computing unique movie hash sums in order to download the right subtitles for the right file!
  • If the video detection fails, a backup search using filename is performed
  • Download subtitles automatically if only one is available, choose the one you want otherwise
  • Download the subtitles file right next to the video file (need read/write permissions)
  • Rename downloaded subtitles to match the video file. Possibility to add a language code (ex:



  • Python 3 (you can use legacy versions to continue on Python 2)
  • zenity (only needed for GNOME based desktop environments)
  • kdialog (only needed for KDE based desktop environments)
  • Common unix tools (only needed for GUIs): wget & gzip (GUI subtitles downloading), ps & grep (GUI autodetection)

Quick installation (nautilus script, with GNOME desktop environment)

For more installation options, check the wiki!

$ mkdir -p ~/.local/share/nautilus/scripts/
$ cd ~/.local/share/nautilus/scripts/
$ wget
$ chmod u+x

IMPORTANT: use an account

Following a recent policy change from, the API is now available only for logged users. More informations can be found on this discussion.
If you are concern by this issue, the symptoms are 401 unauthorized error messages. If you try too many times without a valid account, know that your IP address will be banned for 24 H.

To continue using OpenSubtitlesDownload you simply need to:


Start the search with a simple right click on a video file. Start subtitles search

If multiple subtitles are available, choose the one you want from the list! Multiple subtitles selection

The download will only take a moment. Download selected subtitles

Enjoy your subtitled video! Enjoy your subtitled video!

Get involved


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


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



You can browse the project website at
You can browse the project GitHub page at
Learn more about installation and configuration on the wiki at

License 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 the LICENSE file or consult the license on the FSF website directly.

Emeric Grange