Home
Welcome to the OpenSubtitlesDownload.py wiki!
OpenSubtitlesDownload.py 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 precisely 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 opensubtitles.com. 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!
You can find every version and changelogs for OpenSubtitlesDownload on the releases page.
- python 3
- zenity (only needed for native GNOME desktop environment integration)
- kdialog (only needed for native KDE desktop environment integration)
- basic unix tools (only needed for GUIs): wget & gzip (GUI subtitles download), ps & grep (GUI auto-detection)
- Usage as a CLI script
- Usage as a nautilus script (preferred method)
- Installation on linux (with GNOME or KDE desktop)
- Installation on macOS
- Installation on Windows
A valid account from opensubtitles.com is REQUIRED to use this application
Log in with a registered user like explained on this page if you experience 401 unauthorized errors.
You can adjust several settings to make OpenSubtitlesDownload.py even better experience suiting your every needs! Learn more on the Adjust settings page.
Available settings includes:
- Language(s) selection
- Full automatic mode
- GUI window size
- Additional columns for the subtitles selection window
- Language codes embedded into the subtitles files names
- And more!
Start the search with a simple right click on a video file.
If multiple subtitles are available, choose the one you want from the list!
The download will only take a moment.
Enjoy your subtitled video!
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 ;-)
OpenSubtitlesDownload.py 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 full license on the FSF website.
Emeric Grange emeric.grange@gmail.com