Welcome to the OpenSubtitlesDownload.py wiki!
OpenSubtitlesDownload.py is a small Linux/macOS 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!
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 opensubtitles.org. 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 (version 2 or 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 regular CLI script
- Usage as a nautilus script (preferred method)
- Installation under GNOME desktop environment
- Installation under KDE desktop environment
Adjust various settings
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!
Enjoy your subtitled video!
If multiple subtitles are available, just pick one from the list!
You can even enables more infos on the selection windows:
Use OpenSubtitlesDownload to search for subtitles in different languages simultaneously:
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 a free software released under the GPL v3 license.