Avoid opensubtitles token expiry

[antoniocomelli 0]

Hi, I’m experiencing a persistent issue with the OpenSubtitles integration in Emby. Whenever I try to download subtitles for any item in my library, Emby returns the following error:

Codice

 

emby {"message":"invalid token","uk":"app_102497_2001:b07:5d2e:5a11:9107:5a2b:67bf:170f","uid":2,"ts":1773761929}

Observed behavior

• The issue happens on all clients, including browser and native apps.

• It also occurs on direct LAN, without any reverse proxy.

• Logging out/in, clearing cache, and restarting the server does not fix it.

• The OpenSubtitles token seems to expire immediately or is not accepted by Emby.

What I’ve already checked

• No network or DNS issues.

• No proxy, no header rewriting.

• OpenSubtitles credentials are correct.

• Emby server is updated to the latest stable version.

• No other errors in the logs besides “invalid token”.

Possible cause

It looks like Emby is generating or validating the OpenSubtitles token incorrectly, causing immediate expiration or rejection.

Request

I’d like to know whether:

• This is a known issue with the OpenSubtitles integration.

• There’s a bug in Emby’s token handling.

• There’s any procedure to reset or regenerate the OpenSubtitles token inside Emby.

• A fix is needed on Emby’s side or on the provider’s side.

I can provide full logs and system details if needed.

Thanks in advance.

 

[antoniocomelli 0]

Hi, quick correction to my previous message — I realized I described the issue inaccurately.

The OpenSubtitles token does not expire immediately. The actual behavior is:

• Subtitle downloads work normally for a while.

• After some time, the OpenSubtitles token expires.

• Once it expires, Emby can no longer download subtitles at all and every request fails with invalid token.

• The only way to make subtitle downloads work again is to restart the Emby server, which generates a new valid token.

• After the restart, everything works again until the token expires once more.

So the problem is not that the token is invalid from the start — it’s that Emby doesn’t seem to refresh or renew the token when it expires, forcing a full server restart each time.

Just wanted to clarify the correct behavior so the issue can be diagnosed properly. I can provide logs if needed.