Video management

From Official Kodi Wiki
Revision as of 20:22, 5 February 2014 by Ned Scott (talk | contribs) (Naming files)
Jump to: navigation, search
Home icon grey.png   ▶ General topics ▶ Videos ▶ Video management

Topics related to video library management. See Adding videos to the library for just the basic topics on adding videos.

1 Preparing files

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.

There are a couple of important parts to getting things imported into your XBMC library. First, the metadata for the video file should exist someplace (the metadata are things like the title of the show, the plot description, the season and episode number if the video file happens to be an episode of a TV series, the actors, the director, cover art and episode art, etc.) The second part is naming the video files so the file gets matched up with the metadata available online.

XBMC uses plugins called scrapers to pull information from a video file and coordinate it with a source of metadata available someplace on the internet. For a TV show the scraper basically looks for the show name, season number, and episode number. The default scrapers look at (for TV shows) and (for Movies).

If some video file is not scraping properly, the first step is to go to the website of the scraper you are using on that source and see if the video is already listed there. If you can't find an entry on one of those two sites for the video you're interested in, you can hunt for different scrapers which search other websites for metadata (and go through the same process of making sure your show is listed there, then naming the video files to match). Alternatively, you can create new entries on those sites with some basic information about your show, and then let the scrapers do their work. This is nice, because it means that other people will benefit from your work, and may contribute additional information about the show over time. Adding info to a site like is easy, but make sure you read the site rules before you start adding.

If none of that works, you can create .nfo files for each video by hand so that XBMC will bypass the normal looking online for information about your show. This is the least attractive option, though. It's a lot of work, and it doesn't benefit anyone else the way creating entries on the metadata sites does.

1.1 Naming files

Kodi has the ability to display information and artwork for your video collection. As this information and artwork comes from third-party sites, video files must be placed in a certain folder structure and named correctly so accurate matches can be made with those third-party sites. These pages describe the Best Practice methods to use for the most reliable scraping process.

NFO files
NFO files are used to populate the music and video library using locally stored information. They are helpful if data for your particular title does not exist, such as for home movies and sporting events. They can also be used to control the search behaviour of scrapers when problematic and ambiguous titles prevent your preferred title from being fetched.

2 Adding media sources

Video library/Adding media sources

Media sources
Media Sources are virtual links to the content you wish Kodi to use. When you enter any of the Video library, Music library, Pictures or the File manager, you will see an entry for "Add Sources". When you first start with Kodi you should at least add one source, like a drive or directory on your Kodi device to get you started.

  • Media stubs - If you have a collection of DVD's and Bluray disks but do not want to rip them to a hard drive, then a Media Stub File allows you to add the collection of disks to the Kodi Video Library. It is a simple text based file that is added to your Source in exactly the same way as any other Movie or TV Show, which is then scanned or scraped into the library.
Internet streams
Various internet video and audio streams can be played back in Kodi as if they were locally stored on your media center by using STRM files. As long as the format and streaming-method (network-protocol) is supported by Kodi, stream can be added. These are basic text files that look like <name>.strm and contain a URL to the internet stream. STRM files can also be added to the video library and can have cover art, summaries, etc.

Some internet sites may have an add-on available that can also access these media streams, rather than having to manually create STRM files. See Add-ons for more information on how to find and install add-ons.

3 Setting content and scanning

Video library/Setting content and scanning

4 Maintenance

4.1 Incorrect and missing content

Video library/Incorrect and missing content

4.2 Home videos/custom videos

Video library/Home videos/custom videos

4.3 Updating or removing videos

Video library/Updating or removing videos

5 Grouping media

File stacking
This page will describe the Kodi best practice to name Movie files and create the folder structure to save them in. Your movie folder and files will be placed within your Source folder.

Movie sets
A Movie Set, also known as movie collection, film or movie series, film or movie franchise, and cinematic universe is a collection of related films that are part of the same fictional universe. The normal scraper sites include metadata for Movie Sets which is scraped by Kodi and creates the Movie Set in your library. Movie sets are versatile and can be created to suit your own preferences as they are easily edited in Kodi using the built in sets editor or by using NFO files.

Video library tags
Video library tags, aka Tags or Keywords, can be used to further sort and organise your library into meaningful lists. Sites such as IMDB and TheMovieDB use Keywords to describe themes, plot details or character types to group and easily locate similar titles. They are generally different to the genre.

5.1 How to separate the library (cartoons, documentaries, anime, etc)

A commonly asked question is how can the Movie Library or TV Show Library be separated so not every Movie or TV Show is in one big section.

It is possible to create Main Menu items in addition to the items that appear on the default Main Menu. For example, adding Home Movies, Kids Movies or Cartoons menu items. Kodi can already filter and separate library items using a number of methods. Combined with a skin that supports Custom Home Items, the library and main menu can be laid out to meet your requirements.

This same idea can also be applied to add-ons, programs, and anything else you might want to place on the home screen.

5.2 Playlists

Kodi supports both basic playlists and smart playlists. A basic playlist is a normal text file that lists one or more media files (Audio or Video), and plays them in succession. You can either create your own or use existing playlists from other sources, such as a playlist generated from Winamp, iTunes, or other sources. Basic playlists can be created and edited directly from Kodi's GUI.

5.3 Linking movies to TV shows

Custom video nodes
Video nodes are defined views that are used to organize your media from the videos menu. Title, Director, Year, Studios, Countries, Genres are examples of Nodes. These Nodes can be customised using an XML file which gives flexibility in how you display your media. Custom nodes will work with any skin, but for ease of use a compatible skin is preferred.

6 Alternative guides

6.1 Video guides

7 See also