Description: 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 and download service is powered by http://www.opensubtitles.org. Big thanks to their hard work on this amazing project! Be sure to give them your support (http://www.opensubtitles.org/en/support) if you appreciate the service provided, they sure need donations for handling the ever-growing hosting costs!
Features:
- 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: movie_en.srt).
Requirements: - 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)
Use it: - As a CLI script - As a Nautilus script (right click on one or more video file > "scripts" > "OpenSubtitleDownload.py") - As a simple GNOME/GTK software (right click on one or more video file > "open with" > enter the script path)
- **This release requires Python 3+** - Improve login logic and error messages - Improve language code file suffix handling - Map a few more settings to CLI arguments - Make CLI interruptible with CTRL+C - Wait more time between successive subtitles download, to avoid "429 Too Many Requests" error - Add a Windows "drag & drop" batch file - Fix Linux desktop files
In Norway at least opensubtitles.org is banned and blocked by court order on the ISP level something that might give errors. Try the url in a browser first.
Doesn't work for me on 14.04. Shows the error:
"An unknown error occurred, sorry about that...
Please check:
- Your Internet connection status
- www.opensubtitles.org availability
- Your 200 downloads per 24h limit
- You are using the latest version of this software"
I have checked all of the above but still doesn't work.
Yes indeed, that's a very known bug. My problem is that I can't enable both "cancel" and the "ok" button.
Right now, if you click on the "ok" button without having selected any subtitles (by clicking on them on the list), zenity give back an error code! If you click on "cancel", zenity give back the very same error code... If you close the window with the "X" button (I'm not sure how to call this in english), the same error code is returned again. There is no way to distinguish these actions, this is very frustrating.
So if I enable the "cancel" button, the "ok" button will also be some kind of cancel button, except if you select a subtitles on the list with a single or a double click.
Some people have the habit to just click "ok" and expect opensubtitles-download to download the first subtitles on the list, I think this is the best option. What do you think ?
Because of 404 error on http://api.opensubtitles.org/xml-rpc the script can not successfully connect to the opensubtitles server and download any subtitles.
This is because opensubtitles.org api is currently down (servers are overloaded), and the admin is currently away.
This will hopefully be solved soon.
Follow progress here : http://twitter.com/opensubtitles
Thanks for the info, thought maybe the API xml-rpc url has changed again and update in the script source code is needed. But you're right, opensubtitles.org's servers fault again.
You can change edit the "Language selection" section at the begining of the script.
Replace the 3 letters code 'eng' by the language code you want (you can find langage code on this page : http://en.wikipedia.org/wiki/List_of_ISO_639-2_codes)
My advice is to create one script for each langage you want, and add a suffix to the file (ex: ***-eng.py, ***-fr.py, ...)
I will add soon the possibility to search subtitles in more than one langage at a time.
Ratings & Comments
20 Comments
10 a great app
10 10 the best
9 +
In Norway at least opensubtitles.org is banned and blocked by court order on the ISP level something that might give errors. Try the url in a browser first.
9 +
just what i've been looking for since ever thanks
perfect :)
Doesn't work for me on 14.04. Shows the error: "An unknown error occurred, sorry about that... Please check: - Your Internet connection status - www.opensubtitles.org availability - Your 200 downloads per 24h limit - You are using the latest version of this software" I have checked all of the above but still doesn't work.
Probably a temporary problem with OpenSubtitles.org; it works now!
hi. i'm using nutilus 3.2.1 on Fedora 16. It works great, nice job. The only problem is when I click cancel it downloads a subtitle anyway.
Yes indeed, that's a very known bug. My problem is that I can't enable both "cancel" and the "ok" button. Right now, if you click on the "ok" button without having selected any subtitles (by clicking on them on the list), zenity give back an error code! If you click on "cancel", zenity give back the very same error code... If you close the window with the "X" button (I'm not sure how to call this in english), the same error code is returned again. There is no way to distinguish these actions, this is very frustrating. So if I enable the "cancel" button, the "ok" button will also be some kind of cancel button, except if you select a subtitles on the list with a single or a double click. Some people have the habit to just click "ok" and expect opensubtitles-download to download the first subtitles on the list, I think this is the best option. What do you think ?
It's now at https://github.com/emericg/opensubtitles-download
doesn't work don't bother
http://www.opensubtitles.org/ was in maintenance yeasterday, it's working again today.
Smpayer include that option
Because of 404 error on http://api.opensubtitles.org/xml-rpc the script can not successfully connect to the opensubtitles server and download any subtitles.
This is because opensubtitles.org api is currently down (servers are overloaded), and the admin is currently away. This will hopefully be solved soon. Follow progress here : http://twitter.com/opensubtitles
Thanks for the info, thought maybe the API xml-rpc url has changed again and update in the script source code is needed. But you're right, opensubtitles.org's servers fault again.
can i add more languages to download?
You can change edit the "Language selection" section at the begining of the script. Replace the 3 letters code 'eng' by the language code you want (you can find langage code on this page : http://en.wikipedia.org/wiki/List_of_ISO_639-2_codes) My advice is to create one script for each langage you want, and add a suffix to the file (ex: ***-eng.py, ***-fr.py, ...) I will add soon the possibility to search subtitles in more than one langage at a time.