Adding videos to the library

This page or section may require cleanup, updating, spellchecking, reformatting and/or updated images. Please improve this page if you can. The discussion page may contain suggestions.

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

Naming files

THIS IS THE MOST IMPORTANT STEP TO A SUCCESSFUL LIBRARY SCAN!

In order for the media scrapers to pick up the correct information from your file names, those file names must follow a certain format:

• /Naming movies
• /Naming TV shows

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.

• 

  Step 1: Click "Videos" in the home screen menu.

• 

  Step 2: Now click "Add Source".

• 

  Step 3: The "Add Video Source" screen will be displayed. Then click the "Browse" button.

• 

  Step 4: Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, click the "OK" button. If you keep them shared on a network drive, read the Configuring PC Shares article for more information about setting up a share on your computer first.

• 

  Step 5: Name this Video Source however you like. If it is a movie folder, you will probably want to name it "Movies", and if it is a TV Show folder then you will probably want name it TV Shows. The name doesn't matter to XBMC. Then click "OK".

• 

  Step 6: The set content window will display, this is where you tell XBMC what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)

• 

  Step 7: There are a number of option underneath, see #Set Content to check what options to enable. Then click "OK"

• 

  Step 8: Press Yes the scan the content to the library (if no is pressed it can be scanned later).

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)	Use Folder names for Lookup	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 ripped DVD-Video files using a "VIDEO_TS" folder structure	This option is intended exclusively for adding one movie at a time.
(Example)	C:\Movies\Big Buck Bunny\Big Buck Bunny.avi	C:\Movies\Big Buck Bunny\VIDEO_TS\VIDEO_TS.IFO C:\Movies\Big Buck Bunny\VIDEO_TS\VIDEO_TS.VOB	'C:\Movies\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'

Use Foldername for Lookups

Uses foldernames as basis for the search when scraping (instead of filenames). If folder contains IFO and VOB files, this is needed for any matching to take place.

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 only contains 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 only contains 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:

• IMDb scraper settings
  
• TheTVDB.com scraper settings

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.

Unmatched/missing videos

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

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