The API running on OpenSubtitles.org and powering this project, has been deprecated and not possible any longer to register new user agents anymore at the end of 2023. This project is hence no longer supported or maintained, please consider using the OpenSubtitles REST API instead.
OpenSubtitles Downloader is a simple PHP console application to download subtitles from Opensubtitles.org. Just provide the IMDB Movie ID, and it will download all subtitles for the specified languages.
You need PHP >= 8.0 to use OpenSubtitles Downloader but the latest stable version of PHP is recommended. In addition, the following PHP extensions are needed:
mbstringintlsimplexmliconvxmlrpczlib
Also, you need an OpenSubtitles developer account. Please follow the instructions here: OpenSubtitles Developer Information.
Install OpenSubtitles Downloader by cloning this repository:
git clone https://gitlab.com/stelgenhof/opensubtitles.gitFor the OpenSubtitles Downloader to run correctly, the configuration variables in the .env need to be populated with
the correct values:
- OPEN_SUBTITLES_USER_AGENT The user agent string provided by OpenSubtitles. A temporary test user agent can be used, but it is strongly recommended applying for one.
- OPEN_SUBTITLES_USERNAME Your OpenSubtitles username.
- OPEN_SUBTITLES_PASSWORD Your OpenSubtitles password.
- OPEN_SUBTITLES_TARGET_ENCODING The targeted encoding. OpenSubtitles Downloader will transcode the subtitles if
they contain foreign characters. Usually
UTF-8as a value should work fine. - OPEN_SUBTITLES_LANGUAGES A (comma delimited) list of language codes for the preferred translations.
Please check the OpenSubtitles.org webpage for more information on how to obtain a user account and a application user agent.
./opensubtitles [IMDB Movie Number]The downloaded subtitles will be saved in the subtitles directory in a subdirectory named with the title of movie. For
subtitles files that are not encoded in UTF-8, these will be automatically converted to UTF-8 (if possible).
Contributions are encouraged and welcome; I am always happy to get feedback or pull requests on GitLab :) Create Issues for bugs and new features and comment on the ones you are interested in.
Please refer to the Contributing Guidelines for more details.
If you enjoy what I am making, an extra cup of coffee is very much appreciated :). Your support helps me to put more time into Open-Source Software projects like this.
Please feel free to use, modify, hack this script as you like. It is not perfect, but does the trick for now :). Consult the LICENSE file that comes with this program for more details regarding its license.