Create Video Library
|Steps to create your Video Library|
|1. Video Guide Main Page|
|2. Naming & Folder Structure|
|3. Video File Tagging|
|4. Add Sources & Scrape|
|5. Scraping Problems
|6. Update Video Library|
|7. Library Management|
|8. NFO Files|
|10. Import Export Library|
|11. Rebuild your Video Library|
|Video Library||HOW-TO:Create Video Library|
The aim of these modules is to provide the required information to enable you to correctly set up, modify, and reinstate your Video library as required. As this guide is created for the new user, most pages have been created with minimal jargon and short explanations in an effort to reduce information overload and confusion. Where extra information is provided, note is made to what can be safely ignored.
Each page is a step in that modules particular process, and those steps have been grouped into four modules...
- Prepare the files - Best practice guides to ensure your video files are correctly named and saved.
- Creating the Library - Guide for the initial creation of the library
- Modify your Library - Techniques to modify the information and artwork displayed by your library.
- Safeguarding and Rebuilding - Backup and Rebuild your library
This guide uses the default Estuary skin. If you are using another skin, it is recommended you revert back to Estuary to ensure you are able to follow this guide easily. Location of settings and options differ between skins.
The Nav Box, located at the top right of the page, appears on every page listed in this guide. Use it to quickly jump between steps or return to this main page. On this page, you can click each header to jump to that page.
2 Prepare the Files
This section provides information to ensure your video files are correctly named and saved in the required folder structure. This is the single, most important step, to ensure correct scraping.
| Naming Video 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.
| Naming Movie Files|
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.
3 Folder & Naming Conventions
Once the Source has been created on your drive, there are are two options on how to store your movies.
3.1 Movie Folder
This is the Kodi best practide method for naming and storing movie media. See the two images below.
3.2 Filename Only
An alternate method of storing your movies is to save all the movie files inside the Source folder and omit the Movie folder. Also known as a flat folder structure. See image to right.
This method requires that the movie file is named correctly as Kodi is forced to use the movie filename to match the entry at the scraper site.
The movie filename must contain the Title and should contain the Year. Although not a strict requirement, the year should be in brackets. It should match the entry at the scraper site as shown in the above images.
3.3 Extra Video Files
It is not uncommon to have extra video files that are somehow related to the main movie. Clips such as bloopers, interviews with cast and crew, production methods, behind the scenes, etc.
Kodi will see all these additional video files saved inside the movie folder and attempt to scrape them, which will cause incorrect and unwanted multiple entries in the library. How Kodi actually treats these will depend upon which settings are enabled and which folder structure and naming convention is in use.
To safely store extra video files along with your movie, and have them accessible within Kodi, you will need to install the Extras add-on. Follow the instructions in the link below to create the correct folder structure. This add-on will only work with Movie Folders.
Requires the use of Movie Folders
The remainder of this page deals with Special Use cases and can be safely ignored. Most libraries will not require implementing the following additional name extensions.
4 Stub and Stream Files
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.
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.
5 Media Tags / Flags
It is important to note that the skin will display these flags even when these extensions are not used. The only difference being that without the extensions, the movie must be played first in order for Kodi to read the audio and video codec data.
The actual audio and video codec data will override any extension used. This means that if you set the extension of, say, .ATMOS but the video file only has a stereo track, then the .ATMOS flag will be removed.
5.1 3D movies
Some 3D movies might need an additional file name extension to be identified by Kodi as a 3D movie. See 3D for details on that additional extension, and when it is needed.
6 Split Video Files
Also known as File Stacking, allows you to combine multiple movie files so they appear and play as the one movie. No longer a common requirement, but still available in Kodi should it be needed.
An example of this use is the Special Extended DVD Edition of The Lord of the Rings- The Fellowship of the Ring. Due to the length of the movie, the movie was split and released on two DVD's requiring a DVD change half way through the movie. This means that when storing this movie, the rip creates two separate movie files. When watching the movie, there will be an interruption when the first part ends and the second part needs to be selected to play.
Two options to overcome this issue:
To use this function the following steps are required:
The default expressions will NOT stack files which use only a number without the extensions stated below (eg movie1.avi, movie2.avi). This is intentional due to false positives which can occur with sequels, eg Die Hard 1, Die Hard 2, Die Hard 3, etc.
6.1 Movie Files
These are for multi-part video files in the same Movie folder. eg *.mkv, *.mp4, *.avi etc
The following are default stacking extensions that can be added to file names.
6.2 DVD & BluRay Folders
If you have preserved the DVD or Bluray folder structure, then use this method for folder stacking.
6.3 Advanced Stacking Options
| Naming TV Show & Episode Files
Setting up TV Shows correctly is a little bit more involved than the Movies section. The first part of this page will describe the Kodi best practice to name TV Shows and Episode files and to create the folder structure to save them in. These methods are proven to be the simplest and most robust method which provides the most accurate scrape.
| Video File Tagging|
Kodi v18- Leia introduces support for embedded video tags using *.mkv and *.mp4 video files. They are similar in principle to the tags saved in audio files. Only limited movie support is available at this time.
7 Creating the Library
The following two pages will allow you to build your fully functioning library.
| Add Sources & Scrape
The Source is the main folder on your hard drive which contains your collection of Movies or TV Shows or Music Videos or Music. These four classes of media cannot be mixed in the one Source. Once the Sources are set up, Kodi can perform the appropriate actions to display your media. There is no limit to the number of Sources that can be added to Kodi for each media class.
| Troubleshoot Scraping Problems|
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.
8 Modify your Library
Should you want more control over what information has been scraped, and what artwork has been downloaded, then continue with the following pages. These can be considered advanced modules and are listed in no particular order.
| Update Library Methods
This page details the available methods to add, modify and remove videos from your existing video library. These instructions also apply to Music Videos
| Library Management|
Links to pages that describe other features to further enhance your video library
The use of artwork takes pride of place in Kodi. The artwork will transform your mundane media player into a showpiece to be proud of, especially when teamed up with your favourite skin. Kodi will allow you to display Movie Posters, Fanart, Album Covers, Actor and Artist images to name a few. Install the Kodi slideshow add-on, and you will have a constant display of video or music fanart to brighten your entertainment room.
| NFO Files|
NFO files can be used to provide metadata to the library for video and a music files. They are helpful if the metadata fetched from a web site does not match the video or music you have, or if data for that particular file does not exist, such as for home movies. It can also be used to control the search behaviour of scrapers.
9 Safeguarding and Rebuilding
The following pages offer best practice to backup and restore your library. Note that these methods are like backups. If you have not run this prior to disaster, they will not work after disaster has struck.
| Import & Export Library
Kodi has the option to Export and Import the library databases. These options may be used for a number of reasons including the following more popular ones:
| Rebuilding Your Library|
Page is a work in progress. Come back soon
|Return to top|
|Next step:||Naming Video Files|