Dr.Kodi helps you to inspect and partly correct a Kodi media library.
Kodi media player expects the library set up to be as follows (taken from Kodi Wiki):
- Each movie is saved in its own folder within the Source. All files and folders should be simply named with the name of the movie and the year in brackets. The name should match the name shown at the scraper site.
- Each movie file is placed into its own folder which is then added to your Source.
- Placing movies in their own folder allows saving of local artwork and NFO files alongside the movie file.
- Using this method will provide the safest and most accurate scrape of your media collection.
- Most library related add-ons will only work correctly with this method.
Since Dr.Kodi does look up all information by itself or reads it from an existing NFO file, folder naming can be less strict.
The following checks are performed. For most, an automatic fix is offered.
- The path should be a directory and not a file (see Flat Folder (https://kodi.wiki/view/Naming_video_files/Movies). Dr.Kodi offers a quick fix to wrap the media file into a directory of the same name.
- The directory should not be empty and should contain at least one media file.
- The media file (or multiple files, see Split Video Files (https://kodi.wiki/view/Naming_video_files/Movies)) needs to have the same name as the folder.
- The directory should not have subdirectories (e.g., a Subs folder containing subtitles is not supported).
Those basic checks can be performed offline and without the presence of an NFO file (see https://kodi.wiki/view/NFO_files). For the following checks, information from an NFO file is considered as well.
- The folder name should match the normalized NFO's movie title.
- The NFO's movie year (release year) should match the folder's movie year (folder naming pattern: The Matrix (1998), see Naming (https://kodi.wiki/view/Naming_video_files/Movies))
We start with a very small library that contains one movie. The 'library' is just the parent folder, in this case Movies.
We Drag & Drop it into the Main View. After selecting 'die hard.mkv', details are shown on the right.
Not a directory warning is shown and a quick-fix is offered. Applying the fix will wrap the media file in a directory of the same name.
After applying the fix the normalized movie title is used to query themoviedb to complete movie meta data. Search results are shown below the information that is already present. If Dr.Kodi detects a non-default locale, every search result is presented in the default locale (en) and as well in the current locale. In this case, an additional, localized search result is presented.
| en locale | de locale |
|---|---|
 |
 |
After taking over a search result, the movie meta data is stored as an NFO file inside the directory.
Folder year does not match warning is shown and a quick-fix is offered. Applying the fix will rename the directory after the movie title plus year (folder naming pattern: Die Hard (1988), see Naming (https://kodi.wiki/view/Naming_video_files/Movies)).
'Input' string, i.e., the 'unnormalized' query string is Der.Schatzplanet.2002.German.DL.1080p.BluRay.x264-ENCOUNTERS. The normalized string, that is used to query themoviedb is Der Schatzplanet.
'Input' string, i.e., the 'unnormalized' query string is Coming.Home.for.Christmas.Eine.Familie.zur.Bescherung.German.2013.AC3.DVDRiP.x264-SAViOUR. The normalized string, that is used to query themoviedb is Coming Home for Christmas Eine Familie zur Bescherung.
If data is incomplete, the normalized movie title is used to query theMovieDB. Found results are displayed and the user might choose any of those suggestions to take over the according information. Localized titles are suggested depending on your [locale setting](link to locale).