Skip to content
Emeric edited this page Apr 1, 2019 · 52 revisions

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!

Installation

Download

You can find every version and changelogs for OpenSubtitlesDownload on the releases page.

Requirements

  • 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)

Installation

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!

Screenshots!

Start subtitles search

Download selected subtitles

Enjoy your subtitled video! Enjoy your subtitled video!

If multiple subtitles are available, just pick one from the list! Multiple subtitles selection

You can even enables more infos on the selection windows: Custom subtitles selection

Use OpenSubtitlesDownload to search for subtitles in different languages simultaneously: Multiple languages

Get involved

Users

You can help us find and report bugs, propose new features, help with the documentation and more! Visit the Issues section 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.py is a free software released under the GPL v3 license.

You can’t perform that action at this time.