Adding videos to the library

From Official Kodi Wiki
Jump to navigation Jump to search

Template:XBMC wiki toc/v Adding videos to the library/Contents

To use your video files with "metadata" like summaries, cast info, DVD covers, thumbnails, and more, you need to add those video files to the video library.

Adding media sources

Media Sources are the links that tell XBMC where your content is stored and what type of content is contained within each one. You can have multiple sources for each media type.

You have set up a media source, content can be added to this folder then all you will have to do is tell XBMC to "refresh the library" or XBMC can be set to refresh library on start up (in XBMC's settings).


Set Content

This section is why keeping your TV Shows and Movies, or other type of content separate is important. When you click set content, you can set your video content as Music Videos, Movies, or TV Shows. Scroll through the options until you get to the correct one. Because in our example we're adding Movies, we will scroll to "Movies" and go through the Movie Settings.

Movie content options

(Option) Movies are in separate folders that match the movie title Scan Recursively Selected Folder Contains a Single Movie
(Explanation) If you keep each of your movies in its own folder with the movie name in it If your movies are categorised into sub folders (eg genres, a-z). This option is intended exclusively for adding one movie at a time.
(Example) C:\Movies\Big Buck Bunny\Big Buck Bunny.avi


C:\Movies\Action\Big Buck Bunny.avi
C:\Movies\B\Big Buck Bunny\Big Buck Bunny.avi

'C:\Movies\Big Buck Bunny\Big Buck Bunny.avi'


If you keep all your movies in one big folder, like this:

C:\Movies\Big Buck Bunny.avi
C:\Movies\Big Buck Bunny II: Rise of the Lepus.avi

Then leave all options unticked.

Options for content "None"

Exclude folder from scans
Excludes the selected folder from scans, even if it's a subfolder of a folder that has contents set.

Options After Selecting Scraper

Run Automatic Scan
Runs a scan against the selected information source (scraper) on all video files contained in the selected folder after selecting 'OK'
Movies are in separate folders that match the movie title
Supports using folder.jpg/fanart.jpg as the movie art, as well as more .nfo file reading. If no local information is found, will use the folder name to search when scraping, rather than the filename.
Folder contains a single Video
The standard assumption is that the source contains multiple video files, this option dictates that the selected source or folder contains only one video.
Folder contains a single TV Show
The standard assumption is that the source contains multiple TV shows, this option dictates that the selected source or folder contains only one TV show.
Scan Recursively
Scans subfolders two levels down or more for video files. Note that TV Show scrapers always scan recursively.
Exclude path from library updates
Excludes the selected path from scans, even if it's a subfolder of a folder that has contents set.

Scraper settings

Some scrapers like the IMDb scraper allow the user to change options related to that scraper, see more:

Switching Scrapers / Removing Folder Contents from Library

Setting the content back to <None> after previously having selected a scraper for a source, will prompt users if they want to remove the contents from the Library.
This is recommended if you wish to switch scrapers (first set content to <None> and then choose the new scraper).
Setting content to <None> also removes the contents of the selected folder from the Library altogether. This is useful if you want to remove the contents of an entire folder from the Library as The Context Menu will only remove single items.

Incorrect matches

See also: /Naming TV shows#Tweaking matches

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.

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 or influence the search behavior of scrapers (e.g by pointing it to a predefined URL).

If you would like to remove the entire video database (for example after a bad scan, or you have problems with the library, or for whatever reason), then you can either rename the MyVideos*.db, in /userdata/Databases/ to something else (i.e. MyVideos*.db.backup) or delete it. Then restart, and the movie & TV show information gathering can be redone.


You can also use Add-on:XWMM to edit library entires from a web browser.

Unmatched/missing videos

Incomplete.png INCOMPLETE:
This page or section is incomplete. Please add information or correct uncertain data which is marked with a ?

Your own movies or home movie considerations

If you are here looking to see your home videos in the library there are some special considerations you should be aware of. It took 2 days to get it and it is quite simple in hindsight. This wiki page except for this section is mainly for movies that you are adding to your collection that are referenced somewhere by a scraper tool. Here is a list of links you need to know

  • adding a source and it looking for your home movies will not make them show up - because your home movie title is most likely not a famous movie title- and cannot be referenced online by the scraper you have chosen. See below for a scraper that 'just uses the filename'.
  • add source for a directory JUST FOR your home movies (the how to is near the top - scroll up)
  • Either install the brand new 'justUseTheFilename' scraper (manual install for now - working on it) or add nfo files for each file - just read Two guys who have successfully done it - one by movie, other as tv show
  • know how to make nfo files for either each directory or each movie to STOP a scrape from happening - read the how to to look for what to name them and know that all you really need for a movie version inside the nfo file is
<?xml version="1.0" encoding="utf-8"?>
   <movie>
        <title>Some title</title>
        <originaltitle>Some title just in case - you most likely dont need this either</originaltitle>
        <sorttitle>It will sort by this title if you include it</sorttitle>
        <genre>HomeMovies</genre>
        <id>-1</id>
   </movie>
  • realize that xmbc will not look at your nfo files except ONCE. To get a refresh on a whole bunch of files, Exit the Library View (not sure where it is on the atv2 - just go to Files) and on the source you added for your home movies - set content and pick <None>, then do not delete the files, then click OK. Then set content again and re-choose the type as Movie.

If you don't do this, then you will get some light porn artwork for 'Home Movie' and another one for 'ImportExport' which you dont want your kids to ask about. If you have a large collection, the artwork might get worse!

Off-line media in the library

If you want to catalog off-line media (such as DVDs or CDs) to the library see: Media stubs

Video guides

See also