On this page
Audio description: Problems
Find what is wrong with Audio description, then follow the numbered answer.
The chart in words
Start: Audio description is not working as it should
- Then: What does its tab say?
- Failed or Not answering: 1. Start it again
- Not supported: 2. Update it or update Starboard
- Active, but something is wrong: What is wrong?
- No Jellyfin key: 3. Add Jellyfin to Starboard
- No Reelix key: 4. Add Reelix or stop preferring
- Not checked yet: 5. Check for described titles now
- A described film is missing: 6. Check the track name
- The described track is not kept: 7. Activate the person
1 Start it again
- On Audio description's tab, read the message under its state: it says why it stopped.
- Select Try again.
- If it stopped soon after an update, select Roll back to and the version you had. Read Updates.
- Still failing: go to System, then Logs, and find its name.
It rests after 10 minutes with nothing to do, and Starboard wakes it when it is needed. Resting is not a problem.
2 Update it or update Starboard
Your Starboard's plug-in API is outside what this version of Audio description works with, so Starboard stopped it.
- Select Check for an update on its tab.
- If there is none, update Starboard. Read Update Starboard.
3 Add Jellyfin to Starboard
"Starboard has no Jellyfin key to give yet: add Jellyfin in Settings, Apps" means Starboard has no Jellyfin key for it to use.
- Go to Settings, then Apps, and add Jellyfin with its API key. Read Add an app, in Starboard's help.
- Go to Settings, then Plug-ins, then Audio description.
- Select Check for described titles now.
4 Add Reelix or stop preferring
"Starboard has no Reelix key to give yet: add Reelix in Settings, Apps" means it cannot add the Audio description format to Reelix.
- If you use Reelix, add it in Settings, then Apps, then select Apply the Reelix choice now on Audio description's tab.
- If you do not use Reelix, deactivate Prefer releases with audio description. The rest of the plug-in works without Reelix.
5 Check for described titles now
"Not checked yet" and Checks tonight mean it has not read the library yet. It checks once a night at 04:20, in quiet hours.
- Go to Settings, then Plug-ins, then Audio description.
- Select Check for described titles now.
- Wait a minute or two, then open Titles with audio description.
If it still says "Not checked yet", the card shows what went wrong instead: read Add Jellyfin to Starboard.
6 Check the track name
It finds a described track by its name, because Jellyfin does not read the flag that marks one inside a file.
- A track counts when its name says "Audio Description", "Audio described", "Descriptive audio", "Described", "DVS" or "AD" on its own, such as "English (Audio Description)".
- A track whose name mentions commentary never counts.
- A track with no name, or another name, is not found. In Jellyfin, play the film and open its list of sound tracks: it shows their names.
- A film added since the last check is found at the next one. Select Check for described titles now to check straight away.
7 Activate the person
Jellyfin cannot pick a described track by itself. For each person activated, Jellyfin remembers the sound track they choose.
- Open People who want audio description on Audio description's tab.
- Activate the person. Starboard says "Audio description activated for" and their name.
- In Jellyfin, they choose the described track once for each film and series.
If Starboard says "That person is not in Jellyfin any more. Reload the page", reload the page and try again.
Report a problem
If none of these helps, tell its maker, with what its tab and the card say: the plug-ins' issues on GitHub.
Find out more
This page on GitHub, where the help is written.