Introduction

OpenSubtitlesDownload.py is a small Linux 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 wherever you want to bundle it 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!

Features

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

Installation

Requirements

Download

You can download the latest developer version with the downloads buttons on the header of this page, or you can find various versions and release note of OpenSubtitlesDownload on the releases page!

Quick installation

Quick installation as a nautilus script, under GNOME 3 desktop environment:

$ git clone https://github.com/emericg/OpenSubtitlesDownload.git
$ mkdir -p ~/.local/share/nautilus/scripts/
$ cp OpenSubtitlesDownload/OpenSubtitlesDownload.py ~/.local/share/nautilus/scripts/OpenSubtitlesDownload.py
$ chmod u+x ~/.local/share/nautilus/scripts/OpenSubtitlesDownload.py

Installation

Adjust various settings

After the installation you can adjust several settings to make OpenSubtitlesDownload.py an even better experience suiting your every needs! Learn more on the Adjust settings wiki page.

Available settings includes:

Contributors

License

OpenSubtitlesDownload.py is a free software released under the GPL v3 license http://www.gnu.org/licenses/gpl-3.0.txt