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.

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	Step 2
Click "Videos" in the home screen menu.	Now click "Add Source".

Step 3	Step 4
The "Add Video Source" screen will be displayed. Then click the "Browse" button.	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.

REMEMBER: When you begin using the library, you will find that it is a really good idea to keep your different types of content stored in separate directories, so keep that in mind.

Step 5	Step 6
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". (In this example it is called "Movies" - which is the default XBMC name)	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	Step 8
There are a number of option underneath, see setting content (or scroll down a bit more) to check what options to enable. Then click "OK"	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.

Additional information

On movie naming conventions, see the movies documentation page.

On TV show naming conventions for TV shows scraper, see the TV Shows documentation page.

After adding new video files, if you find that the information is incorrect then you can simply remove that lookup information from the database by switching the view to "Title" and pressing the black-button on the controller.

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 simply use the Filemanager or FTP, and either rename the MyVideos*.db, in directory Q:\UserData\Database, to something else (i.e. MyVideos*.db.backup) or delete it. Then restart, and the movie & TV show information gathering can be redone.

*TIP!: If you like to use lookup to catalog off-line DVD-Video library (or other movies stored on DVD/CD media) see

• HOW-TO: Catalog and use lookups on your offline DVD/CD movie library (via fake files)