Incorrect and missing videos
| The basic steps for adding|
videos to the library:
|Video library||Management||Incorrect and missing videos|
This page will show you how to add videos that got missed during the library scan, as well as how to fix mistakes that might have happened.
1 Check file names
The most common cause for something to be missing from a library scan, or to have scanned incorrectly, is if the file name of the video isn't named correctly. On problematic files you may wish to double check the naming once again, or even try alternative names or include the year the work was made.
2 Fixing individual videos
After adding new video files, if you find that the information is incorrect, select the incorrect entry and press i to bring up the movie information and then select "Refresh". From here you can also do a manual title search lookup. Sometimes using a partial title in the manual search will help when a normal search brings up nothing.
3 TV show naming issues
3.1 The scraper picks the wrong TV show
The most common cause for this is that you haven't named the show's folder correctly. Check the site being scraped, and copy the title exactly as it is displayed, including anything in brackets.
If that doesn't solve the issue, or you are unable to change the folder name, you can force a match by adding a tvshow.nfo with the url of the show's page on the scraped site.
3.2 All files are added as a single TV show
This may happen if you've set content on the wrong folder, (usually the one above the one containing your TV shows). The telltale sign will be the title of the show everything is added as: "Al TV", "Genius Series", etc. The title will be derived from the name of your top-level TV folder.
Videos <<Source folder, Content: TV Shows>> |----TV <<Scanned as "Al TV">> | |----TV Show 1 <<Ignored>> | | |--Files | |----TV Show 2 <<Ignored>> | | |--Files
In these cases, you can either remove the source and re-add the TV shows folder as source, or change the content on the source to None, and then set the content on the correct folder (see examples here).
3.3 Some files refuse to be added
The most obvious cause is that the files are not named correctly and don't match any of the patterns. In these cases you will need to rename the files, or add a custom tvshowmatching regexp to deal with them.
If the files appear to be correctly named, they may instead be matching the wrong pattern. If you use custom tvshowmatching regexps, check carefully the order in which the regexps are being matched alongside the defaults. Also check the note in the split-episode section.
Another possibility is that this is actually a case of the scraper picking the wrong TV show (the problem may be masked by the use of local artwork or lack of online artwork, although episode titles and plots should be a giveaway). In this situation even correctly named files will not get added if they lie outside the numbering of the incorrect show.
- The show Castle is a six episode documentary series about castles, not the multi-season 2009 crime drama. Any file numbered s01e07 or higher will not be added if Kodi thinks the latter is the former.
A fourth cause can be that you've different season listings than the scraper you're using. E.g. your season one is S1E01-S1E20 while according to the scraper E17-20 belongs to season two. The scraper will then add E1-16 to season one, the rest won't get scraped.
To fix this you can:
- Use a different scraper. The TV addon XEM allows you to choose use between four different sources.
- Create NFO files for the TV show.
- If you still want to add the TV show with the scraper that has different listings than you, check the scraper site and rename/move your files according to its listings.
4 Videos being added without a source
Kodi stores video sources in two places, one for files view that shows up in the GUI, and another in the database file itself. Normally, whenever you make a change or remove a source, Kodi will ask if you want to apply that change to the library, which makes sure that the sources in the GUI are the same as the sources in the database.
Sometimes users don't apply the change, the sources.xml file gets manually edited (avoid manually editing the sources.xml file, by the way), or something happens that causes there to be orphaned sources in the database that don't show up in the GUI. This is why you sometimes get videos being scanned from a folder that you don't see as having been added to Kodi, or was previously removed.
To correct such "phantom" sources, you simply need to re-add the source (or even just a parent folder to that source) to Kodi as if you were setting it up for the first time. You do not have to "set content" on the source or scan it into the library. Just add it as a video file source, then use the context menu to remove the source again. This will make Kodi ask if you want to apply the change to the library. Select yes. This should cause Kodi to remove the orphaned/phantom source from the database file.
5 Custom video entries and NFO files
Another valid way of making sure your scraper finds its way to correct information for your newly added media is by the use of NFO files. Nfo files can be used to provide data for a movie, a TV show, or influence the search behavior of scrapers (e.g by pointing it to a predefined URL).
When you need to edit/change either just one entry, or hundreds of entries, there are several tools that can make this task easier. Some examples include:
- Add-on:Missing Movie Scanner - An Kodi add-on that will search your video sources and list all movies not scanned in your library.
- Add-on:XWMM - Can be used to edit library entires from a web browser.
and various more at Supplemental tools.
7 Excluding directories/folders
Kodi can exclude certain directories from the library all together using a few different methods.
- Use the "Exclude folder from scans" option when the content type is set to "none"
- Place a file (even an empty one) named
.nomediain the directory you want to exclude.
- Folders with
samplein the name will be automatically skipped. For the exact pattern match, see here.
- Users can also add additional patterns to be excluded by using the advancedsettings.xml tag <excludefromscan>
8 Finding missing videos
If you have a small library then you can probably just use file mode and see what videos don't have metadata (thumbnails, for example). For larger video collections, see #Tools such as Add-on:Missing Movie Scanner.
Since v12 "Frodo", Kodi will record what video files didn't get matched in the kodi.log file, even if debugging is turned off. Keep in mind that the kodi.log file resets each time you start Kodi; kodi.log will contain information from the most recent time Kodi was ran, and Kodi.old.log will contain the previous time Kodi was ran. You can quickly find the entries where a movie wasn't matched by searching for
"it won't be added to the library". You can extract a list with all paths with the following command:
grep "won't be added" -i kodi.log | cut -d"'" -f2 > not_indexed.lst
9 Adding or excluding file types
A list of additional file-extensions to allow (add) or exclude (remove) in the My Video windows.
Default extensions for VIDEOS:
.m4v .3g2 .3gp .nsv .tp .ts .ty .strm .pls .rm .rmvb .mpd .m3u .m3u8 .ifo .mov .qt .divx .xvid .bivx .vob .nrg .pva .wmv .asf .asx .ogm .m2v .avi .dat .mpg .mpeg .mp4 .mkv .mk3d .avc .vp3 .svq3 .nuv .viv .dv .fli .flv .001 .wpl .vdr .dvr-ms .xsp .mts .m2t .m2ts .evo .ogv .sdp .avs .rec .url .pxml .vc1 .h264 .rcv .rss .mpls .webm .bdmv .wtv