Skip to content

Log in with a registered user

Emeric edited this page Mar 27, 2024 · 7 revisions

Using an OpenSubtitles account

A valid account from opensubtitles.com is REQUIRED to use this application

The old opensubtitles.ORG accounts won't work anymore, unless you migrated them from the new website

To use OpenSubtitlesDownload you need to:

Using an account with the GUIs

  • Edit your OpenSubtitlesDownload.py file and look for the "OpenSubtitles.com account" section at the beginning of the file.
  • Look for the osd_username and osd_password fields:
osd_username = 'set your username, NOT your account email address'
osd_password = 'chosen password'

Using an account with the CLI

You can also set the username and password directly when using the CLI, by using --username and --password arguments.

History

January 2024 update: OpenSubtitles.com is replacing OpenSubtitles.org

After 16 years of service, the time has come to turn off our original API service, to focus our time and energy on the new REST API. Read more about details and timing below.

Zillions of requests were served by the [old xml-rpc API](https://sendy.opensubtitles.org/l/QsNN4NCqv3NM9diWDihPoQ/Og8WRUriBkJDeMT892HbObjQ/vsRbCpaRsQ28892yokYWv47A), but now we need to stop developing and servicing it. Instead our focus and development energy is moved towards modern, fast and better optimised [OpenSubtitles.com REST API](https://sendy.opensubtitles.org/l/QsNN4NCqv3NM9diWDihPoQ/ARFHmVSSZVEKcDWFac71Qg/vsRbCpaRsQ28892yokYWv47A) - which is already serving around 30 million requests per 24 hours. 

OpenSubtitles.org API important dates:

* 2022-06-15 registration of new user agents is stopped
* 2023-12-31 end of life, API endpoint will be turned off

To continue using OpenSubtitlesDownload, you simply need to:

January 2022 update: OpenSubtitles.org hacked

In January 2022 the OpenSubtitles.org website has been **targeted by hackers**, who managed to steal all user's data. Therefore **it is necessary for all users to reset their password** in order to continue using the website and its API.
If you are concerned by this issue, the symptoms are **401 unauthorized** error messages (same as when you are not logged in).

To continue using OpenSubtitlesDownload, you simply need to:

April 2020 update: OpenSubtitles API is available only for logged users

Here is a communication from opensubtitles.org

API REQUESTS MUST BE AUTHENTICATED

With Covid-19 pandemic requests for our API went skyrocket, our servers could not handle so much traffic, so we decided to limit API usage just to authenticated requests for User Agents. In short it means, you have to provide opensubtitles.org username and password in LogIn() method.

We are avare some of user agents doesn't implement authentication for numerous reasons.

What you can do for fix, if your app is affected:
- let your users know about this change
- implement LogIn() into your app with user authentication
- contact us for pricing, so your app can send unathenticated requests (e.g. if you have free and pro version of your app, it is possible free will work only with authenticated requests and pro works as before)

More info on our forum: https://forum.opensubtitles.org/viewtopic.php?f=11&t=17110

We are actively blocking IPs, which are sending unathenticated requests

Following a recent policy change from opensubtitles.org, the API is now available only for logged users.
If you are concerned by this issue, the symptoms are 401 unauthorized error messages. If you try too many times without a valid account, know that your IP address will be banned for 24 H.

To continue using OpenSubtitlesDownload, you simply need to:

  • Create an account on opensubtitles.org website
  • Use that account with the script (by editing the script and filling out account information)
Clone this wiki locally