Incorrect and missing videos

From Official Kodi Wiki
Revision as of 20:26, 29 May 2018 by Karellen (talk | contribs) (rewording 3.9)
Jump to: navigation, search
Steps to create your Video Library
Video.png
1. Video Guide Main Page
2. Naming & Folder Structure
2.1 Movies
2.2 TV Shows
3. Video File Tagging
4. Add Sources & Scrape
5. Scraping Problems

6. Update Video Library
7. Library Management
8. NFO Files
8.1 Movie
8.2 TV Show
9. Artwork
9.1 Movie
9.1 TV Show


10. Import Export Library
11. Rebuild your Video Library
Zappy-frodo.png
Home icon grey.png   ▶ Video library ▶ Incorrect and missing videos


1 Introduction

No scraper is 100% accurate. Errors arise from either mistakes by the user, inherent limitations of the scraper, and/or errors at the site of the information provider. If you have followed the guide, the errors you encounter will be minimal. For those errors that do occur, this page will help correct them. Sorry, but we cannot fix stubborness or laziness for those that refuse to fix their file naming problems.

If you have followed the guide, some of the information provided will sound familiar as it has been covered in earlier pages.


It is important to be aware that no scraper or folder and naming convention is 100% foolproof. There are just some cases where human intervention is required. A perfect example of this case is movies with the exact same name and year. See the following three movies as an example...

Split (2016) - https://www.themoviedb.org/movie/425636
Split (2016) - https://www.themoviedb.org/movie/409583-split
Split (2016) - https://www.themoviedb.org/movie/358364-split


2 Scraping Basics

Things you should know about scraping:

  • Kodi obtains artwork and metadata from 3rd party sites that Kodi has no control over. As these sites are outside the control of Kodi, it is important that your video files and folders are named correctly to ensure an accurate match with the listings at the scraper sites.
  • If a movie or TV show does not exist at the scraper site, then Kodi cannot scrape it. Always check the entry at the scraper site.
  • Kodi can also read information from local files known as NFO Files.
  • As the information provider sites are maintained by a small volunteer community, which provides this service at no cost, it is strongly encouraged that Kodi users contribute back to those sites when discovering errors and ommissions in the databases.
  • Scraping problems experienced by users are attributable as follows: 95%- Incorrect naming, folder and source structure; 4%- Missing data at the scraper site; 1%- Changes at the scraper site which breaks the scraper add-on.


3 Video Problems

The following are a list of common problems and their solutions


3.1 Show videos not scraped into Library

The Event Log will record any files missed when an Update Library is performed. If the log is currently empty, or lists no missing movies, TV Shows or episodes, then perform an Update Library and check the Event Log again. See: Event Log


3.2 Video title wont scrape

The following list are solutions that can be used to solve this issue. It starts with the easiest and most common fix

  1. Ensure the Movie or TV Show exists and has been correctly named in accordance with the listing at the site of the Information Provider. See: Naming Video Files
  2. Ensure your Source and Folder structure are correct. See: Naming Video Files
  3. Create a Parsing NFO file to point the scraper directly to the video title. See: Parsing NFO
  4. Ensure you are using the most current version of the scraper
  5. If the above does not fix it then you have either missed something very obvious or there is a serious problem with your installation. Create a Debug Log and submit your problem in the Kodi forum


3.3 Wrong Movie or TV Show is added

  1. Select the incorrect entry and press i to bring up the Information Page and then select Refresh. This will invoke the scraper for this video only. You will be given the option to select from a list of similarly named titles, or type in a different title.
    • If the previous step fails, then continue with the following possible solutions...
  2. Ensure the Movie or TV Show exists and has been correctly named in accordance with the listing at the site of the Information Provider. See: Naming Video Files
  3. Ensure your Source and Folder structure is correct. See: Naming Video Files
  4. Create a Parsing NFO file to point the scraper directly to the video title. See: Parsing NFO
  5. If the above does not fix it then you have either missed something very obvious or there is a serious problem with your installation. Create a Debug Log and submit your problem in the Kodi forum


3.4 The title does not exist at the Information Provider site

This can happen with obscure or foreign titles

  1. Create an account and enter the title at the Information Provider site. This benefits the entire community. See: TheMovieDB and TheTVDB
  2. Alternatively, create NFO Files. Especially useful for Home Movies, Sporting Events etc. See: NFO Files


3.5 Extra video files are added to the library

Extra video files such as Bloopers, Cast Interviews, Production Notes etc, can all be stored and accessed through Kodi. An Add-on is available that allows you to correctly store and access these video files. See: Add-on:Extras

  1. Remove the incorrect entries from the library using the Context Menu. Select Manage then Remove from library
  2. Install the Extras Add-on... See: Extras Add-on or Special Features Add-on


3.6 Movie Trailers are scraped as a movie

By default, Kodi will ignore any file with -trailer suffixed to the file name. eg: Logan (2017)-trailer note there is no space either side of the hyphen

  1. Remove the incorrect entries from the library using the Context Menu. Select Manage then Remove from library
  2. Correctly name the trailer file. The file must be named the same as the playable file with the -trailer suffix, ensuring no space either side of the hyphen.
  3. If using local trailers, ensure that Trailers is disabled in the scraper setting. See: Scraper Settings


3.7 How do I add more movies and tv shows

  1. Add the new folders and/or video files to your existing Source folder
  2. Perform an Update Library. There are many methods to update the library. See: Update Video Library


3.8 I want to list childrens or sports titles separately

The library can be divided to list particular genre's or other types of content. See: Custom Home Items


3.9 Videos being added without a source

Kodi stores video sources in two places,

1. In the Sources.xml that displays in the GUI under Videos>Files, and
2. In the library's database file, which is used for both scraping and library display.

When a change is made to a Source, or the Source removed completely, Kodi will ask if that change is to be applied to the library. This ensures that the sources displayed in Videos>Files are the same as the sources recorded in the database.

Sometimes users don't apply the change or the user manually edits the sources.xml file (avoid manually editing the sources.xml file), or something happens that results in orphaned sources in the database that don't show up in the GUI for Videos>Files. This results in videos being scanned from a folder that seems to not exist in Kodi, or coming from a Source that was previously removed.

To correct these "phantom" sources, simply re-add the source to Kodi as if you were setting it up for the first time. It is not necessary to "set content" on the source or scan it into the library. Then use the context menu to remove the source again. This will force Kodi to ask if you want to apply the change to the library. Select Yes. This will force Kodi to remove the orphaned/phantom source from the database file.


For full guide to remove sources See: Remove Sources


4 TV Show Problems

Problems specific to TV Shows. If your issue is not listed here, look in the previous section as it may also be a common problem with Movies.


4.1 Some TV Shows are mixed with other TV Shows

Most likely caused by using outdated or incorrectly created NFO Files. Ensure at least one of the following tags is in the tvshow.nfo file. If there is no ID number (eg for Home Movies) then any random number will suffice.

  <id></id>
  <uniqueid type="imdb"></uniqueid>
  <uniqueid type="tvdb" default="true"></uniqueid> 


4.2 All my TV Shows are displayed as one TV Show

  1. You have incorrectly set up your Source in Kodi. See: Naming Video Files and Add Source & Scrape
  2. See previous question Some TV Shows are mixed with other TV Shows


4.3 Episodes don't match the plot description

Results from the order of your files being different from that at the TVDB site. You possibly scraped the Aired Order but you have ripped the episodes as DVD Order or vice-versa

  1. Remove the TV Show from the library using the Context Menu. Select Manage then Remove from library
  2. Go to the site of the Information Provider. TheTVDB
  3. Check both the Aired Order listing and the DVD Order listing and determine which order your episodes are saved in. See: TVDB- Episode Orders
  4. If your episodes do not match either listing, re-organise your episodes to match
  5. Adjust the scraper settings to scrape as DVD Order or Aired Order. See: Add Source & Scrape
  6. Navigate to the TV Show in Videos>Files and press i to bring up the Information Page. This will invoke the scraper for this TV Show only.


4.4 I get the wrong version of the TV Show

Normally caused by incorrect naming of the TV Show. To ensure you are using the correct TV Show title follow this simple guideline.

  • The use of the (Year) in the title works differently for TV Shows. In TV Shows, the (Year) is only used when it is shown in the title at the scraper site. See the two images below.
  • This guideline also applies to (Country of Origin) TV Shows. For example Hells Kitchen (UK), Hells Kitchen (US), Hells Kitchen (AU), Hells Kitchen (IT) etc.
  • What you see at TVDB is how you should name your show.


Alternatively, create a Parsing NFO file to point the scraper directly to the video title. See: Parsing NFO


4.5 I have episodes missing but the files exist

Results from the order of your files being different from that at the TVDB site. Your listing may show Season 1 with 20 episodes, but the TVDB shows Season 1 with 16 episodes, and the remaining 4 episodes are part of Season 2

  1. Remove the TV Show from the library using the Context Menu. Select Manage then Remove from library
  2. Go to the site of the Information Provider. TheTVDB
  3. Check the episode listing and adjust your files to match that of the Information Provider. See: TVDB- Episode Orders
  4. Navigate to the TV Show in Videos>Files and press i to bring up the Information Page. This will invoke the scraper for this TV Show only.


4.6 New episodes will not scrape

  1. Ensure the episodes exist at the scraper site
  2. Due to the theft of API Keys by the piracy community, the API keys used by the scraper when you first added the show may have been revoked and new API Keys have been issued. This means when you add new episodes, the scraper is trying to use the original and outdated API Keys registered to the TV Show. To update the API Keys, Refresh the TV Show. No need to refresh the Episodes when asked.
  3. You may have switched scrapers, say from TheTVDB.com to TheMovieDB for TV Shows. As the API Keys are scraper specific, you will be trying to use TVDB Keys to access TMDB which will not work. The entire show needs to be refreshed as stated in the previous point.


4.7 Some files refuse to be added after following these solutions

The solutions above should solve 99.9% of problems. If you are still experiencing issues, create a Debug Log and submit your problem in the Kodi forum


Return to top


Next step: Update Video Library