The "IMDb ID not provided" error in a4kSubtitles usually means
the add-on cannot find the unique identifier it needs to search for subtitles
. This typically happens when the video file lack meta-data or when using external players. 🛠️ Quick Solutions Scan to Library
: The most common fix. If you are playing a local file, Kodi needs to "scrape" it into your Media Library
first. This assigns the IMDb ID to the file so a4kSubtitles can read it. Check Filename : Ensure your file is named correctly (e.g., Movie.Name.2023.1080p.mp4 ). Poorly named files prevent scrapers from finding the ID. Use Supported Add-ons : a4kSubtitles relies on the playback add-on (like
) to pass the IMDb ID. If you're using a basic player or a newer beta (like Syncler v2), the ID might not be passed correctly. Manual Search (Alternative) a4ksubtitles imdb id not provided
: a4kSubtitles does not support manual text search. If the ID is missing, try installing individual subtitle add-ons like OpenSubtitles.com , which allow you to type in the movie name manually. 🔍 Why This Happens Local Files
Files played directly from a folder often lack the metadata link to IMDb. External Players
Using an external player (like VLC or MX Player) via Kodi often breaks the ID hand-off. Scraper Issues
If your library scraper (TMDB/TVDB) is down or misconfigured, it won't fetch the IMDb ID. Obscure Content
Very new or rare titles might not have an IMDb entry or ID yet. ⚙️ Advanced Fixes Install TMDB Helper : Some users find that installing the TMDB Helper add-on The "IMDb ID not provided" error in a4kSubtitles
helps bridge the metadata gap and provides the necessary IDs. Verify Scraper Settings Settings > Media > Library
and ensure "Identify items" is active so Kodi fetches IDs at startup. Check for Updates
: Ensure you are on the latest version of a4kSubtitles from the official repository to get recent API fixes. If you're still having trouble, let me know: Are you playing local files or using a streaming add-on Kodi version are you on (e.g., Nexus, Omega)? Does this happen with every movie or just one specific title?
Here’s a helpful write‑up to explain the error “a4ksubtitles imdb id not provided”, why it happens, and how to fix it.
The root cause is almost always a metadata scraping failure. Your media player is trying to play a file, but it cannot match that file to a specific IMDb entry. Here are the five most common triggers: Why Does the "IMDb ID Not Provided" Error Occur
If A4kSubtitles keeps failing, try:
These often work with titles instead of requiring an IMDb ID.
If you are adding new movies and this happens often, check your scraper settings.
Streaming enthusiasts and users of Kodi, Stremio, and other open-source media centers have long relied on the A4kSubtitles project. This powerful add-on scrapes multiple subtitle databases (like OpenSubtitles, Podnapisi, and Subscene) to automatically fetch subtitles for your movies and TV shows.
However, a notoriously frustrating error has plagued users for years: "A4kSubtitles: IMDb ID not provided."
You select a movie, the subtitles search begins, and instead of a list of .srt files, you are met with a red error box or a log file entry stating that the IMDb ID is missing. The subtitles fail to download. The stream stops.
This article will dissect exactly what this error means, why it happens, and—most importantly—how to fix it permanently.