Official Kodi Wiki - User contributions [en]

Adding video sources

2015-12-07T17:40:22Z

Slchorne: /* Adding Remote sources */

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />A video source is a kind of media source. [[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Select Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Adding Remote sources ==
For details on the supported protocols and configuration
{{See|File sharing}}

Follow the steps ([[#Adding sources|above]]) for adding a source, but when you get to the 'browse' section ('''step 4'''), you need to do one of the following:

'''If your remote device is visible from one of the existing choices''' (e.g 'Network File system' , 'UPnP Devices' etc)
*Select a remote location, and you should be able to browse to the remote server.

'''If the device is not visible, or'''
* It is a remote NAS
* It is an SMB server

You will need to add a new network location:

<gallery widths=500px heights=400px >
File:04-Add-Video-Source-Add-Network-Location-500x258.jpg | Choose '''Add network location...''' from the list of new shares. Fill in all the details and use the '''IP Address''' for the server name. (don't trust that zero-conf will work)

File:05-Add-Video-Source-Browse-Network-Share-Added-500x369.jpg|Click '''OK''' and you should see your server in the list of sources

File:07-Add-Video-Source-Main-Popup-Menu-Movie-Source-500x294.jpg|Now you should be able to add the path to the type of source from the server
</gallery>

== Making one source from multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]

Adding video sources

2015-12-07T17:33:13Z

Slchorne: /* Adding Remote sources */

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />A video source is a kind of media source. [[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Select Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Adding Remote sources ==
For details on the supported protocols and configuration
{{See|File sharing}}

Follow the steps ([[#Adding sources|above]]) for adding a source, but when you get to the 'browse' section ('''step 4'''), select a remote location (e.g 'Network File system' , 'UPnP Devices' etc) and you should be able to browse to the remote server.

If you:
* have a remote NAS
* SMB server
* The remote server is not visible

You will need to add a new network location.

<gallery widths=500px heights=400px >
File:04-Add-Video-Source-Add-Network-Location-500x258.jpg | Choose '''Add network location...''' from the list of new shares. Fill in all the details and use the '''IP Address''' for the server name. (don't trust that zero-conf will work)

File:05-Add-Video-Source-Browse-Network-Share-Added-500x369.jpg|Click '''OK''' and you should see your server in the list of sources

File:07-Add-Video-Source-Main-Popup-Menu-Movie-Source-500x294.jpg|Now you should be able to add the path to the type of source from the server
</gallery>

== Making one source from multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]

SMB

2015-12-07T17:32:03Z

Slchorne: /* Setting up SMB */

{{mininav| [[Media sources]] | [[File sharing]] }}
<section begin="intro"/>Windows File Sharing, (also known as Common Internet File System [CIFS] or Server Message Block [SMB]), is probably the most common of all of the options for sharing media between your computer or a [[NAS|NAS (Network Attached Storage)]] device and Kodi.<section end="intro"/>

* On Mac OS X it's called '''Windows Sharing'''.
* On [[samba|Linux/UNIX/BSD]] its counterpart is [http://www.samba.org SAMBA].

== Setting up an SMB Server ==
<big>
* '''[[SMB/Windows]] -'''</big> Setting up SMB on Windows

<big>
* '''[[SMB/Mac]] -'''</big> Setting up SMB on Mac OS X

<big>
* '''[[Samba]] -'''</big> Setting up SMB in Linux

== Adding an SMB media source ==

<big>
* '''[[Adding video sources#Adding Remote sources|Adding remote video sources]] -'''</big> Adding an SMB share as a source

== External links ==
* [http://www.mini-itx.com/projects/xbmc-ion/module/7 How to enable Windows File-Sharing on your Kodi Live system (mini-itx.com)]

{{Isengard updated}}

[[Category:File sharing]]
[[Category:Manual]]
[[Category:Index]]

Updating or removing videos

2015-12-07T17:30:51Z

Slchorne: /* Removing sources */

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />This page will show you the various methods of updating library information for videos and how to remove videos.<section end="intro" />
== Updating the library ==
{{see also|Set content and scan}}
{{#lst:Set content and scan|update}}

== Removing videos ==
* You can remove the contents of entire folders/sources (without deleting the actual files) from the library by setting content to <None>, even if the parent folder is still included in the library. See [[#Removing sources]] for more info.

* Individual entries can also be removed (without deleting the actual files) by bringing up the contextual menu (press {{keypress|C}} on a keyboard) and selecting "Remove from library". Those videos will be scanned in the next time the library is updated unless the parent folder's '''[[set content|content settings]]''' has '''Exclude path from library updates''' selected.

* If you've deleted or moved the actual video files and need to remove non-working library entries, you can use '''Clean library''' in {{highlight|bordered=yes|[[Settings/Videos#Library|Settings → Videos → Library → '''Clean library...''']] }}

* While most users seem to prefer using a desktop computer to manage the actual "physical" files, including deleting them, there is an option to let you delete files in {{kodi}} under {{highlight|bordered=yes|[[Settings/Appearance#File lists|Settings → Appearance → File lists → '''Allow file renaming and deletion''']] }}

== Removing sources ==
{{see also|Set content and scan}}

To remove a source you need to use the contextual menu ({{keypress|C}} on a keyboard by default) on a video source.

* Select "Videos" in the home screen menu
* Select one of the Sources ( 'Movies' , 'TV' , etc )
* Use the contextual menu ({{keypress|C}}) to bring up the additional options for that source
* Use 'Edit' or 'Delete' to modify the source

== Excluding directories/folders ==
{{main|Set content and scan}}
{{#lst:Set content and scan|exclude}}

{{Isengard updated}}

[[Category:Video library]]
[[Category:Manual]]

Updating or removing videos

2015-12-07T17:29:57Z

Slchorne: /* Removing sources */

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />This page will show you the various methods of updating library information for videos and how to remove videos.<section end="intro" />
== Updating the library ==
{{see also|Set content and scan}}
{{#lst:Set content and scan|update}}

== Removing videos ==
* You can remove the contents of entire folders/sources (without deleting the actual files) from the library by setting content to <None>, even if the parent folder is still included in the library. See [[#Removing sources]] for more info.

* Individual entries can also be removed (without deleting the actual files) by bringing up the contextual menu (press {{keypress|C}} on a keyboard) and selecting "Remove from library". Those videos will be scanned in the next time the library is updated unless the parent folder's '''[[set content|content settings]]''' has '''Exclude path from library updates''' selected.

* If you've deleted or moved the actual video files and need to remove non-working library entries, you can use '''Clean library''' in {{highlight|bordered=yes|[[Settings/Videos#Library|Settings → Videos → Library → '''Clean library...''']] }}

* While most users seem to prefer using a desktop computer to manage the actual "physical" files, including deleting them, there is an option to let you delete files in {{kodi}} under {{highlight|bordered=yes|[[Settings/Appearance#File lists|Settings → Appearance → File lists → '''Allow file renaming and deletion''']] }}

== Removing sources ==
{{main|Set content and scan}}

To remove a source you need to use the contextual menu ({{keypress|C}} on a keyboard by default) on a video source.

* Select "Videos" in the home screen menu
* Select one of the Sources ( 'Movies' , 'TV' , etc )
* Use the contextual menu ({{keypress|C}}) to bring up the additional options for that source
* Use 'Edit' or 'Delete' to modify the source

== Excluding directories/folders ==
{{main|Set content and scan}}
{{#lst:Set content and scan|exclude}}

{{Isengard updated}}

[[Category:Video library]]
[[Category:Manual]]

Adding video sources

2015-12-07T17:22:38Z

Slchorne: /* Adding Remote sources */

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />A video source is a kind of media source. [[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Select Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Adding Remote sources ==
For details on the supported protocols and configuration
{{See|File sharing}}

Follow the steps (above) for adding a source, but when you get to the 'browse' section ('''step 4'''), select a remote location (e.g 'Network File system' , 'UPnP Devices' etc) and you should be able to browse to the remote server.

If you:
* have a remote NAS
* SMB server
* The remote server is not visible

You will need to add a new network location.

<gallery widths=500px heights=400px >
File:04-Add-Video-Source-Add-Network-Location-500x258.jpg | Choose '''Add network location...''' from the list of new shares. Fill in all the details and use the '''IP Address''' for the server name. (don't trust that zero-conf will work)

File:05-Add-Video-Source-Browse-Network-Share-Added-500x369.jpg|Click '''OK''' and you should see your server in the list of sources

File:07-Add-Video-Source-Main-Popup-Menu-Movie-Source-500x294.jpg|Now you should be able to add the path to the type of source from the server
</gallery>

== Making one source from multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]

File:07-Add-Video-Source-Main-Popup-Menu-Movie-Source-500x294.jpg

2015-12-07T17:20:48Z

Slchorne: MsUpload

MsUpload

File:05-Add-Video-Source-Browse-Network-Share-Added-500x369.jpg

2015-12-07T17:18:34Z

Slchorne: MsUpload

MsUpload

File:04-Add-Video-Source-Add-Network-Location-500x258.jpg

2015-12-07T17:10:54Z

Slchorne: MsUpload

MsUpload

Adding video sources

2015-12-07T17:09:55Z

Slchorne: /* Adding sources */

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />A video source is a kind of media source. [[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Select Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Adding Remote sources ==
For details on the supported protocols and configuration
{{See|File sharing}}

== Making one source from multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]

Incorrect and missing videos

2015-12-07T17:00:22Z

Slchorne:

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />This page will show you how to add videos that got missed during the library scan, as well as how to fix mistakes that might have happened.<section end="intro" />
== Check file names ==
{{main|Naming video files}}

The most common cause for something to be missing from a library scan, or to have scanned incorrectly, is if the file name of the video isn't named correctly. On problematic files you may wish to double check the '''[[Naming video files|naming]]''' once again, or even try alternative names or include the year the work was made.

== Fixing individual videos ==
{{see also|Updating or removing videos}}
After adding new video files, if you find that the information is incorrect, select the incorrect entry and press {{keypress|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.

== TV show naming issues ==
{{Main|Naming video files/TV shows}}
<section begin="names" />
=== The scraper picks the wrong TV show ===
The most common cause for this is that you haven't named the show's folder correctly. Check the site being scraped, and copy the title exactly as it is displayed, including anything in brackets.

If that doesn't solve the issue, or you are unable to change the folder name, you can force a match by adding a [[Import - Export Library#TV Shows 2|tvshow.nfo]] with the url of the show's page on the scraped site.
=== All files are added as a single TV show ===
This may happen if you've set content on the wrong folder, (usually the one above the one containing your TV shows). The telltale sign will be the title of the show everything is added as: "Al '''TV'''", "Genius '''Series'''", etc. The title will be derived from the name of your top-level TV folder.
<pre>
Videos <<Source folder, Content: TV Shows>>
|----TV <<Scanned as "Al TV">>
| |----TV Show 1 <<Ignored>>
| | |--Files
| |----TV Show 2 <<Ignored>>
| | |--Files
</pre>
In these cases, you can either remove the source and re-add the TV shows folder as source, or change the content on the source to None, and then set the content on the correct folder (see examples [[Naming video files/TV shows#Complex|here]]).
=== Some files refuse to be added ===
The most obvious cause is that the files are not named correctly and don't match any of the patterns. In these cases you will need to rename the files, or add a custom tvshowmatching regexp to deal with them.

If the files appear to be correctly named, they may instead be matching the ''wrong pattern''. If you use custom tvshowmatching regexps, check carefully the order in which the regexps are being matched alongside the defaults. Also check the note in the [[Naming video files/TV shows#Split-episode|split-episode]] section.

Another possibility is that this is actually a case of the scraper picking the wrong TV show (the problem may be masked by the use of local artwork or lack of online artwork, although episode titles and plots should be a giveaway). In this situation even correctly named files will not get added if they lie outside the numbering of the incorrect show.
;Example
:The show [http://www.thetvdb.com/?tab=series&id=82607&lid=7 Castle] is a six episode documentary series about castles, not the [http://www.thetvdb.com/?tab=series&id=83462 multi-season 2009 crime drama]. Any file numbered s01e07 or higher will not be added if Kodi thinks the latter is the former.
<br />
A fourth cause can be that you've different season listings than the scraper you're using. E.g. your season one is S1E01-S1E20 while according to the scraper E17-20 belongs to season two. The scraper will then add E1-16 to season one, the rest won't get scraped.<br />
To fix this you can:
* Use a different scraper. The TV addon [[Add-on:XEM | XEM]] allows you to choose use between four different sources.
* [[NFO files#Create an .NFO file .28recommended.29|Create NFO files]] for the TV show.
* If you still want to add the TV show with the scraper that has different listings than you, check the scraper site and rename/move your files according to its listings.

<section end="names" />

== Videos being added without a source ==
Kodi stores video sources in two places, one for files view that shows up in the GUI, and another in the database file itself. Normally, whenever you make a change or remove a source, Kodi will ask if you want to apply that change to the library, which makes sure that the sources in the GUI are the same as the sources in the database.

Sometimes users don't apply the change, the sources.xml file gets manually edited (avoid manually editing the sources.xml file, by the way), or something happens that causes there to be orphaned sources in the database that don't show up in the GUI. This is why you sometimes get videos being scanned from a folder that you don't see as having been added to Kodi, or was previously removed.

To correct such "phantom" sources, you simply need to re-add the source (or even just a parent folder to that source) to Kodi as if you were setting it up for the first time. You do not have to "set content" on the source or scan it into the library. Just add it as a video file source, then use the context menu to remove the source again. This will make Kodi ask if you want to apply the change to the library. Select '''yes'''. This should cause Kodi to remove the orphaned/phantom source from the database file.

== Custom video entries and NFO files ==
{{main|Custom video entries|NFO files}}
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, a TV show, or influence the search behavior of scrapers (e.g by pointing it to a predefined URL).

== Tools ==
{{Main|Rename tools|Library managers}}
When you need to edit/change either just one entry, or hundreds of entries, there are several tools that can make this task easier. Some examples include:
* [[FileBot]]
* [[Add-on:Missing Movie Scanner]] - An Kodi add-on that will search your video sources and list all movies not scanned in your library.
* [[Add-on:XWMM]] - Can be used to edit library entires from a web browser.

and various more at '''[[Supplemental tools]]'''.

== Excluding directories/folders ==
{{main|Set content and scan}}
{{#lst:Set content and scan|exclude}}

== Finding missing videos ==
If you have a small library then you can probably just use file mode and see what videos don't have metadata (thumbnails, for example). For larger video collections, see [[#Tools]] such as [[Add-on:Missing Movie Scanner]].

Since v12 "Frodo", Kodi will record what video files didn't get matched in the [[kodi.log]] file, even if debugging is turned off. Keep in mind that the kodi.log file resets each time you start Kodi; kodi.log will contain information from the most recent time Kodi was ran, and Kodi.old.log will contain the previous time Kodi was ran. You can quickly find the entries where a movie wasn't matched by searching for <code>"it won't be added to the library"</code>. You can extract a list with all paths with the following command:

<pre> grep "won't be added" -i kodi.log | cut -d"'" -f2 > not_indexed.lst</pre>

== Adding or excluding file types ==
You can add or exclude additional file types/extensions when scanning files into the library via an [[advancedsettings.xml]] file and the [[advancedsettings.xml#<videoextensions>|<videoextensions> tag]]:

{{#lst:advancedsettings.xml|videoextensions}}

{{Isengard updated}}

[[Category:Video library]]
[[Category:Manual]]

Archive:Custom video entries

2015-12-07T16:59:44Z

Slchorne:

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />Need to add videos such as home movies or other videos that are not normally found by Kodi's scrapers? This page will show you a few solutions on adding custom videos, such as home movies, clips, special editions, and more. <section end="intro" />

== JustUseTheFileName ==
To simply add videos to the library as movies without any special info you can [[add-on manager|install]] the JustUseTheFileName scraper: http://up.kibje.com/20130711/metadata.justUseFilename.org.zip

== NFO files ==
{{main|NFO files}}
* Add [[NFO files]] for each file. For step-by-steps look at the additional guides below.
* Here's a basic/bare minimal example of an NFO file:
<syntaxhighlight lang="xml" enclose="div">
<?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>
</syntaxhighlight>
* Kodi will only look at your NFO files ONCE. To refresh see: [[Video library/Updating or removing videos#Refreshing the library]]

== Filtering custom videos ==
{{see|Custom home items}}

== Additional guides ==
* [http://forum.kodi.tv/showthread.php?tid=118344&pid=1299816#pid1299816 Best way to have "home videos" in Kodi (Kodi forum)]

{{Isengard updated}}

[[Category:Manual]]
[[Category:Video library]]

Adding video sources

2015-12-07T16:58:25Z

Slchorne: /* Adding Remote sources */

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />A video source is a kind of media source. [[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Seclect Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Adding Remote sources ==
For details on the supported protocols and configuration
{{See|File sharing}}

== Making one source from multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]

Updating or removing videos

2015-12-07T16:55:52Z

Slchorne:

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />This page will show you the various methods of updating library information for videos and how to remove videos.<section end="intro" />
== Updating the library ==
{{see also|Set content and scan}}
{{#lst:Set content and scan|update}}

== Removing videos ==
* You can remove the contents of entire folders/sources (without deleting the actual files) from the library by setting content to <None>, even if the parent folder is still included in the library. See [[#Removing sources]] for more info.

* Individual entries can also be removed (without deleting the actual files) by bringing up the contextual menu (press {{keypress|C}} on a keyboard) and selecting "Remove from library". Those videos will be scanned in the next time the library is updated unless the parent folder's '''[[set content|content settings]]''' has '''Exclude path from library updates''' selected.

* If you've deleted or moved the actual video files and need to remove non-working library entries, you can use '''Clean library''' in {{highlight|bordered=yes|[[Settings/Videos#Library|Settings → Videos → Library → '''Clean library...''']] }}

* While most users seem to prefer using a desktop computer to manage the actual "physical" files, including deleting them, there is an option to let you delete files in {{kodi}} under {{highlight|bordered=yes|[[Settings/Appearance#File lists|Settings → Appearance → File lists → '''Allow file renaming and deletion''']] }}

== Removing sources ==
{{main|Set content and scan}}
{{#lst:Set content and scan|remove source}}

== Excluding directories/folders ==
{{main|Set content and scan}}
{{#lst:Set content and scan|exclude}}

{{Isengard updated}}

[[Category:Video library]]
[[Category:Manual]]

SMB

2015-12-07T16:50:12Z

Slchorne: add links to adding a media source

{{mininav| [[Media sources]] | [[File sharing]] }}
<section begin="intro"/>Windows File Sharing, (also known as Common Internet File System [CIFS] or Server Message Block [SMB]), is probably the most common of all of the options for sharing media between your computer or a [[NAS|NAS (Network Attached Storage)]] device and Kodi.<section end="intro"/>

* On Mac OS X it's called '''Windows Sharing'''.
* On [[samba|Linux/UNIX/BSD]] its counterpart is [http://www.samba.org SAMBA].

== Setting up SMB ==
<big>
* '''[[SMB/Windows]] -'''</big> Setting up SMB on Windows

<big>
* '''[[SMB/Mac]] -'''</big> Setting up SMB on Mac OS X

<big>
* '''[[Samba]] -'''</big> Setting up SMB in Linux

== Adding an SMB media source ==

<big>
* '''[[Adding video sources#Adding Remote sources|Adding remote video sources]] -'''</big> Adding an SMB share as a source

== External links ==
* [http://www.mini-itx.com/projects/xbmc-ion/module/7 How to enable Windows File-Sharing on your Kodi Live system (mini-itx.com)]

{{Isengard updated}}

[[Category:File sharing]]
[[Category:Manual]]
[[Category:Index]]

Media sources

2015-12-07T16:45:32Z

Slchorne: /* Network file sharing */

{{mininav|[[Video library]]{{l2|[[Music library]]}} }}
<section begin="intro" />Media Sources are virtual links to the content you wish Kodi to use. When you enter any of the [[Videos]], [[Music]], [[Pictures]] or the [[Filemanager]], 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.<section end="intro" />

If you select "Add sources" a dialog appears, where you may manually input a path, or browse to a source that contains media that you would like Kodi to use and display. As an example, if you enter the Music section, you could tell Kodi where it should look for your music. This can be as simple as selecting a folder on your computer or you can also choose to browse your home network for media.

== Adding media sources ==
[[File:Add pictures.jpg|right|300px]]
{{See|Adding video sources}}

You can select as many sources you like if you have content in different places. When you have finished browsing and found the folder you would like, you should input a name for your source. This name will be displayed when you browse your sources under Videos -> Files. When a source, or a folder within a source, has '''[[adding video sources|content set]]''' then those entries will be added to the '''Movies''' and '''TV Shows''' libraries, which then show up on the [[home screen]].

By default every root section includes a ''Add Sources'' button that you can click to start adding sources. This can be disabled though [[Appearance Settings#View Options|Settings/Appearance/View Options/Disable add source buttons in file lists]].
{{-}}

== Network file sharing ==
For details on the supported protocols and configuration
{{See|File sharing}}
For details on how to add a shared source
{{See| Adding video sources#Adding Remote sources}}

== Internet streams ==
{{main|STRM|Add-ons|RSS media source}}
{{#lst:STRM|intro}}
{{-}}

== Scanning sources into the library ==
{{main|Set content and scan}}
{{#lst:Set content and scan|intro}}
{{-}}

== Locking ==
{{see also|Settings/System#Master lock}}
<section begin="Locking" />
If you want to make a source more private, you can use ''lockcodes or passwords'' to protect that source. The easiest way to accomplish this in Kodi, is using the GUI dialogs. First, enable the Master Lock in {{highlight|bordered=yes|[[Settings/System/Master lock]]}}. After enabling the Master Lock, a ''Set Lock'' button will pop up in the ''Context Menu'' allowing you to set a lock on specific sources. Kodi will ask for the ''master lock code'' and then give you the opportunity to set a unique ''Password'' on that specific share. To ''Remove the Lock'' you need to remember the ''Master Lock'' code.<br />

{{note| Locking a source means you only give it protection in Kodi. Outside Kodi the source is still available and only protected, or not protected at all, by the Operating System. In the same way, if someone has access to manually edit the ''sources.xml'' he or she can remove or change the settings for the locked source. So, don't feel too safe when you protect a source in Kodi.}}
<section end="Locking" />

== See also ==
* [[Adding videos to the library]]
* [[Set content and scan]]
* [[File sharing]]
* [[Filemanager]]
* [[Sources.xml]]

{{Helix updated}}

[[Category:Manual]]
[[Category:Settings]]
[[Category:File sharing]]
[[Category:Video library]]
[[Category:Music library]]

Media sources

2015-12-07T16:44:17Z

Slchorne: /* Network file sharing */

{{mininav|[[Video library]]{{l2|[[Music library]]}} }}
<section begin="intro" />Media Sources are virtual links to the content you wish Kodi to use. When you enter any of the [[Videos]], [[Music]], [[Pictures]] or the [[Filemanager]], 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.<section end="intro" />

If you select "Add sources" a dialog appears, where you may manually input a path, or browse to a source that contains media that you would like Kodi to use and display. As an example, if you enter the Music section, you could tell Kodi where it should look for your music. This can be as simple as selecting a folder on your computer or you can also choose to browse your home network for media.

== Adding media sources ==
[[File:Add pictures.jpg|right|300px]]
{{See|Adding video sources}}

You can select as many sources you like if you have content in different places. When you have finished browsing and found the folder you would like, you should input a name for your source. This name will be displayed when you browse your sources under Videos -> Files. When a source, or a folder within a source, has '''[[adding video sources|content set]]''' then those entries will be added to the '''Movies''' and '''TV Shows''' libraries, which then show up on the [[home screen]].

By default every root section includes a ''Add Sources'' button that you can click to start adding sources. This can be disabled though [[Appearance Settings#View Options|Settings/Appearance/View Options/Disable add source buttons in file lists]].
{{-}}

== Network file sharing ==
For details on the supported protocols and configuration
{{See|File sharing}}
For details on how to add a shared source
{{See| Adding_video_sources#Adding_Remote_sources}}

== Internet streams ==
{{main|STRM|Add-ons|RSS media source}}
{{#lst:STRM|intro}}
{{-}}

== Scanning sources into the library ==
{{main|Set content and scan}}
{{#lst:Set content and scan|intro}}
{{-}}

== Locking ==
{{see also|Settings/System#Master lock}}
<section begin="Locking" />
If you want to make a source more private, you can use ''lockcodes or passwords'' to protect that source. The easiest way to accomplish this in Kodi, is using the GUI dialogs. First, enable the Master Lock in {{highlight|bordered=yes|[[Settings/System/Master lock]]}}. After enabling the Master Lock, a ''Set Lock'' button will pop up in the ''Context Menu'' allowing you to set a lock on specific sources. Kodi will ask for the ''master lock code'' and then give you the opportunity to set a unique ''Password'' on that specific share. To ''Remove the Lock'' you need to remember the ''Master Lock'' code.<br />

{{note| Locking a source means you only give it protection in Kodi. Outside Kodi the source is still available and only protected, or not protected at all, by the Operating System. In the same way, if someone has access to manually edit the ''sources.xml'' he or she can remove or change the settings for the locked source. So, don't feel too safe when you protect a source in Kodi.}}
<section end="Locking" />

== See also ==
* [[Adding videos to the library]]
* [[Set content and scan]]
* [[File sharing]]
* [[Filemanager]]
* [[Sources.xml]]

{{Helix updated}}

[[Category:Manual]]
[[Category:Settings]]
[[Category:File sharing]]
[[Category:Video library]]
[[Category:Music library]]

Media sources

2015-12-07T16:41:37Z

Slchorne: /* Adding media sources */

{{mininav|[[Video library]]{{l2|[[Music library]]}} }}
<section begin="intro" />Media Sources are virtual links to the content you wish Kodi to use. When you enter any of the [[Videos]], [[Music]], [[Pictures]] or the [[Filemanager]], 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.<section end="intro" />

If you select "Add sources" a dialog appears, where you may manually input a path, or browse to a source that contains media that you would like Kodi to use and display. As an example, if you enter the Music section, you could tell Kodi where it should look for your music. This can be as simple as selecting a folder on your computer or you can also choose to browse your home network for media.

== Adding media sources ==
[[File:Add pictures.jpg|right|300px]]
{{See|Adding video sources}}

You can select as many sources you like if you have content in different places. When you have finished browsing and found the folder you would like, you should input a name for your source. This name will be displayed when you browse your sources under Videos -> Files. When a source, or a folder within a source, has '''[[adding video sources|content set]]''' then those entries will be added to the '''Movies''' and '''TV Shows''' libraries, which then show up on the [[home screen]].

By default every root section includes a ''Add Sources'' button that you can click to start adding sources. This can be disabled though [[Appearance Settings#View Options|Settings/Appearance/View Options/Disable add source buttons in file lists]].
{{-}}

== Network file sharing ==
{{See|File sharing}}

== Internet streams ==
{{main|STRM|Add-ons|RSS media source}}
{{#lst:STRM|intro}}
{{-}}

== Scanning sources into the library ==
{{main|Set content and scan}}
{{#lst:Set content and scan|intro}}
{{-}}

== Locking ==
{{see also|Settings/System#Master lock}}
<section begin="Locking" />
If you want to make a source more private, you can use ''lockcodes or passwords'' to protect that source. The easiest way to accomplish this in Kodi, is using the GUI dialogs. First, enable the Master Lock in {{highlight|bordered=yes|[[Settings/System/Master lock]]}}. After enabling the Master Lock, a ''Set Lock'' button will pop up in the ''Context Menu'' allowing you to set a lock on specific sources. Kodi will ask for the ''master lock code'' and then give you the opportunity to set a unique ''Password'' on that specific share. To ''Remove the Lock'' you need to remember the ''Master Lock'' code.<br />

{{note| Locking a source means you only give it protection in Kodi. Outside Kodi the source is still available and only protected, or not protected at all, by the Operating System. In the same way, if someone has access to manually edit the ''sources.xml'' he or she can remove or change the settings for the locked source. So, don't feel too safe when you protect a source in Kodi.}}
<section end="Locking" />

== See also ==
* [[Adding videos to the library]]
* [[Set content and scan]]
* [[File sharing]]
* [[Filemanager]]
* [[Sources.xml]]

{{Helix updated}}

[[Category:Manual]]
[[Category:Settings]]
[[Category:File sharing]]
[[Category:Video library]]
[[Category:Music library]]

Adding video sources

2015-12-07T16:40:13Z

Slchorne: add links to network sources

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />A video source is a kind of media source. [[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Seclect Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Adding Remote sources ==
{{see| Media_sources#Network_file_sharing}}

== Making one source from multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]

Adding videos to the library

2015-12-07T16:36:17Z

Slchorne: reformatted the page to match the style of all the related pages

== Preparing files ==
{{see|Video_management#Preparing_files}}
{{#lst:Video management|intro}}

=== Naming files ===
{{See|Naming video files}}
{{#lst:Naming video files|intro}}

* [[Naming video files/Movies]]
* [[Naming video files/TV shows]]
* [[Naming video files/Music videos]]

== Adding media sources ==
{{See|Adding video sources}}
{{#lst: Adding video sources |intro}}

== Set the content type and scan ==
{{See|Set content and scan}}
{{#lst:Set content and scan|intro}}

== See Also ==
* [[Incorrect and missing videos]]
* [[Custom video entries]]
* [[Updating or removing videos]]
* [[Video library/Alternative and video guides|Alternative and video guides]]

[[Category:Adding videos to the library guide]]

Naming video files/TV shows

2015-12-07T16:28:38Z

Slchorne: remove circular content links

{{mininav|[[Video library]]|[[Video management|Management]]|[[Naming video files]]}}
{{#lst:Naming video files|naming files}}
Kodi requires each TV show to be in its own folder, and for each file to contain a pattern from which Kodi can determine the season and episode number (e.g. "S01E01").

:'''Folder name''' = Show title
:'''File name''' = Season/Episode number

The folder name will be [[Userdata/advancedsettings.xml#.3Ccleanstrings.3E|cleaned]] of commonly used strings, such as DVDRip, 1080p, x264, etc. before being passed to the scraper. If the year of release is included, this will be [[advancedsettings.xml#.3Ccleandatetime.3E|extracted]] and used by the scraper to assist in making a match.

Spaces, periods, or underscores may be used to separate words in the folder and file names, but shouldn't be mixed in the same folder name. Note also the caution [[#Split-episode|below]] regarding file names with periods.

{{Note|Flat structures with files for different shows in a single directory are '''''not supported'''''.}}
== Directories ==
You must set the content to TV Shows on the directory directly above the individual show folders.
To ensure accurate matches for your TV shows, the folder names should match the title displayed on the site being scraped.
For the default TVDB scraper this may mean including the year of release, e.g. [http://www.thetvdb.com/?tab=series&id=83462 Castle (2009)] (in cases of duplicate titles), or the country of origin, e.g. [http://www.thetvdb.com/?tab=series&id=196921 Being Human (US)] (in cases of foreign remakes).

Below the show folder, the files may be organized how you wish, e.g. into separate season folders, or by year. These folders will be ignored.
=== Simple ===
Typically, you will add the top-level directory as a source and set the content to TV shows when you add it.
;Example
:{|
|
<pre>
TV Shows <<Source folder, Content: TV shows>>
|----TV Show 1
| |----Season #
| |--Files
|----TV Show 2 (year)
| |--Files
|----TV Show 3
| |----2008
| |--Files
</pre>
|}
=== Complex ===
{{note|This is generally discouraged as it's really easy for the sub-folders to be mistakenly picked up as false TV show matches. While it's still possible to work through such false-matches, it's a pain in the butt if you need to update the library on those same folders, as the false TV show might get re-added each time.}}

In more complex situations where your top-level directory is further sub-divided before the show folders, you can add the top-level as source but not set the content, and then set the content to TV shows on each sub-folder.
;Example
:{|
|
<pre>
TV Shows <<Source folder, Content: None>>
|----A-M <<Content: TV shows>>
| |----TV Show 1
| |--Files
|----N-Z <<Content: TV shows>>
| |----TV Show 2
| |--Files
</pre>
|}
It's also possible to have a sub-folder group multiple shows together in an otherwise normal directory structure. Just change the content on the sub-folder and de-select the "Selected folder contains a single TV show" setting.
;Example
:{|
|
<pre>
TV Shows <<Source folder, Content: TV shows>>
|----TV Show 1
| |----Season #
| |--Files
|----Star Trek Series <<Content:TV shows>>
| |----Star Trek
| | |--Files
| |----Star Trek The Next Generation
| |--Files
</pre>
|}
In these cases, it's best to refrain from scanning the files into the library until the content is set correctly for all folders, to avoid incorrect results and the need to rescan.

== Files ==
Kodi uses a series of regular expressions to determine the season and episode numbers from the file name.
These are checked in order with the first match being the one used. Anything else included in the file name is ignored.

There are '''7''' default patterns, plus a separate multi-episode pattern. Use of any other numbering scheme will require you to edit your [[advancedsettings.xml]] (see [[#Using custom file names|below]]).

{{note|In the examples we will mostly use the format:
:''anything''_'''<<pattern>>'''.ext,
where ''name'' is the title of the show, and .ext is a [[advancedsettings.xml#.3Cvideoextensions.3E|recognized video file extension]], but '''''any format''''' will work, so long as the pattern is included somewhere in it. '''''name'' is optional''' and could just as easily be after the pattern, or excluded entirely. }}
=== Single episode ===
Most of the time you will only have a single episode per file.

The order in which the patterns are checked for by Kodi is included in brackets after each example below (most patterns allow some variation, hence the duplicate numbers). If your file name contains more than one pattern, only the first one checked for will be used.

All the examples will be read as season 1, episode 2.
;With season
:The most common scenario.
:''anything''_'''s01e02'''.ext <sup>(1)</sup>
:''anything''_'''s1e2'''.ext <sup>(1)</sup>
:''anything''_'''s01.e02'''.ext <sup>(1)</sup>
:''anything''_'''s01_e02'''.ext <sup>(1)</sup>
:''anything''_'''1x02'''.ext <sup>(5)</sup>
:''anything''_'''102'''.ext <sup>(6)</sup>
;Without season
:In cases where you only have one season (or are using absolute order in the TVDB scraper), you may want to forego the inclusion of the season number.
:''anything''_'''ep02'''.ext <sup>(2)</sup>
:''anything''_'''ep_02'''.ext <sup>(2)</sup>
:You may also use Roman numerals (I, IV, XI, etc.), often used for mini-series or short documentary series.
:''anything''_'''part.II'''.ext <sup>(7)</sup>
:''anything''_'''pt.II'''.ext <sup>(7)</sup>
:''anything''_'''pt_II'''.ext <sup>(7)</sup>
;By date
:Common for long-running daily shows, you can also use the date the episode aired.
:''anything''_'''1996.11.14'''.ext <sup>(3)</sup>
:''anything''_'''1996-11-14'''.ext <sup>(3)</sup>
:''anything''_'''14.11.1996'''.ext <sup>(4)</sup>

=== Multi-episode ===
{{note|When you use a single video file for multiple episodes you can now tell Kodi when each episode starts using episode '''[[bookmarks]]'''.}}
In cases where your file contains more than one episode, you can specify all the episodes included. Everything after the first found pattern match will be checked for further matches to the same pattern.
;Examples
:''anything''_'''s01e01'''_'''s01e02'''.ext
:''anything''.'''s01e01'''.''episode1.title''.'''s01e02'''.''episode2.title''.ext
:''anything''.'''s01e01'''.'''s01e02'''.'''s01e03'''.ext
:''anything''.'''1x01'''_'''1x02'''.ext
:''anything''.'''ep01'''.'''ep02'''.ext
:{{s|''anything''.'''s01e01''' 1x02.ext}} (mixed patterns do not work)

The remainder will also be checked against a shorter form [[Userdata/advancedsettings.xml#.3Ctvmultipartmatching.3E|multi-episode pattern]].
;Examples
:''anything''.'''s01e01e02'''.ext
:''anything''.'''s01e01-02-03'''.ext
:''anything''.'''1x01x02'''.ext
:''anything''.'''ep01_02'''.ext
The '''ex-_''' are fully interchangeable and stackable, e.g. ''name''.'''1x01e02_03-x-04'''.ext is perfectly valid (if somewhat odd).

{{Note|Only the episodes in the file name will be added, e.g. ''name''.'''s01e01-03'''.ext will not include episode 2.}}

=== Split-episode ===
Typical for childrens cartoons, files which only contain a distinct part of an episode may be named as to which part, if the scraper supports it.
;Examples
:''anything''.'''s01e01.1'''.ext
:''anything''.'''s01e01a'''.ext
:''anything''.'''1x01.1'''.ext
:''anything''.'''1x01a'''.ext
:''anything''.'''ep01.1'''.ext
:''anything''.'''101.1'''.ext
Up to 9 sub-parts are allowed (using either .1-.9 or a-i).

These can also be combined with the multi-episode pattern, if your file contains all parts joined as a single episode.
;Examples
:''anything''.'''s01e01.1.s01e01.2'''.ext
:''anything''.'''1x01.1x01.2'''.ext (note this is (1x01.1)x(01.2) not (1x01).(1x01.2))
:''anything''.'''ep01a_01b'''.ext

Each part will be added to the library just with its full episode number, the sub-part will not be displayed.

{{Note|If you use periods in your file names and include material after the episode number (such as the episode title), you may get a false match to a split-episode pattern if that material begins with a number below 10, e.g.
:''Nikita''.'''S01E02.2'''.0.mkv
:''24''.'''1x02.1'''.00.am-2.00.am.avi
:''anything''.'''1x01.1'''x'''02'''.ext (i.e. (1x01.1) x (02) )
This will likely lead to the episode not being added to the library. The recommendation is to use a space or underscore instead to separate the numbers for those files, e.g.
:''Nikita''.'''S01E02'''_2.0.mkv
:''24''.'''1x02'''_1.00.am-2.00.am.avi
:''anything''.'''1x01''' '''1x02'''.ext (i.e. (1x01) (1x02) )
}}

=== Special episodes ===
Special episodes, if supported by your scraper, should be marked as being season 0. You should check the site being scraped to see what episode number to use, as they can be fairly arbitrary. For example, [http://thetvdb.com/?tab=season&seriesid=76736&seasonid=24194&lid=7 BlackAdder's Christmas Carol] should have a file name that matches season 0 episode 3, e.g.:
:''BlackAdder''.'''s00e03'''.BlackAdder's Christmas Carol.mkv

== The TVDB scraper ==
{{main|Set content and scan}}
The default TV show scraper uses [http://thetvdb.com The TVDB] to scan your TV shows into the library. You should search on the site before adding a new show to ensure you're using the right title. Caution should be taken over using aliases or alternative titles, although these will work in a website search, they don't work in the API the scraper uses.

The TVDB scraper has three possible settings for determining episode order: Aired order, DVD order, and Absolute order. These will affect how you name your files, or vice versa, how you name your files will affect which setting you should use.
;Aired order
:The default, episodes are ordered by season and numbered as they were originally broadcast. For split-episodes, each part is given its own distinct episode number.
:Visible when you click on any season link on the show page.
;DVD order
:Episodes are ordered by season and numbered as they appeared on DVD release. Split-episodes are numbered by episode and sub-part.
:Visible when you click the "DVD Order" link on any season page for the show.
;Absolute order
:Episodes are ordered as a single season and numbered sequentially from start to finish. Split episodes have distinct episode numbers. Commonly used for anime.
:Visible when you click the "Absolute Order" link on the All seasons page for the show.

== Media source tags ==
{{main|Media flags#Media source}}
Depending on the interface [[skin]] you are using, you can add additional media source information to a movie entry in Kodi. For example, in the default skin "Confluence" you can label when a file was ripped from a bluray disc by including BLURAY, BRRIP, BD25, or BD50 in the file name after the title. The exact options are different for each interface skin, but a list for the default Confluence skin can be seen on [[Media flags#Media source]].

;Example
:<code>Back to the Future (1985).bluray.mkv</code>

== Advanced usage ==
=== 3D episodes ===
{{Main|3D}}
Some 3D episodes 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.

=== Supplemental tools ===
A variety of [[supplemental tools]] exist to automatically rename files and folders into Kodi compatible formats.
* [[Supplemental tools/Linux#Rename tools|Renaming tools for Linux]]
* [[Supplemental tools/Mac OS X#Rename tools|Renaming tools for Mac OS X]]
* [[Supplemental tools/Windows#Rename tools|Renaming tools for Windows]]
{{-}}

=== Changing scraper settings for one show ===
A very common situation, when you have one or more shows that require different scraper settings (particularly episode order) to the other shows in your folder, it is possible to change the settings for individual shows. Just navigate to the show's folder in file view and select Change content from the context menu and then alter the settings from there. If the files have already been incorrectly added to the library, you will need to refresh the folder (e.g. from the info screen).

The classic example is Firefly, whose aired order differs greatly from its DVD order:
<pre>
TV Shows <<Source folder, Content: TV shows, Scraper: TVDB - default settings>>
|----TV Show 1
| |----Season 1
| |--Files
|----TV Show 2
| |--Files
|----Firefly <<Scraper: TVDB - DVD order>>
| |----1x01.Serenity.ext
| |----1x02.The Train Job.ext
</pre>
=== Using custom file names ===
It's possible to use custom file names that don't match any of the default patterns by editing your [[advancedsettings.xml]] file to include a [[advancedsettings.xml#.3Ctvshowmatching.3E|tvshowmatching]] tag containing regular expressions.

A tvshowmatching regexp needs up to three capturing groups:
:1 capturing group = episode number (season will default to season 1), no multi-episode matches will be attempted
:2 capturing groups = season number + episode number (in that order), no multi-episode matches will be attempted
:3 capturing groups = season number + episode number + multi-episode matching part (typically just the remainder of the file name)
(A capturing group is essentially a part of the regexp contained inside brackets.)

To have no season but multi-episode matching, use three groups but leave the first empty.

Date-based regexps are also possible, and are marked by a bydate="true" attribute in the regexp. These also use three capturing groups, either as year-month-day or day-month-year, the lengths must be exactly 4-2-2 or 2-2-4.

Your custom tvshowmatching regexps can be either checked for before the default set (action="prepend") or after (action="append"). Not including an action will result in only your regexps being tested. Care should be taken to ensure that the right regexp matches your file names, particularly in regard to the three digit "102" pattern seen [[#single episode|above]].
The regexps should be grouped together inside a single tvshowmatching tag, although you can use two if you wish to prepend ''and'' append different regexps.

You can also change the multi-episode matching regexp by including a [[Userdata/advancedsettings.xml#.3Ctvmultipartmatching.3E|tvmultipartmatching]] tag in your advancedsettings.xml (separate from the tvshowmatching tag).
There can be only one tvmultipartmatching expression, whatever you use will overwrite the default, so take care to only expand on the default pattern unless you are certain.
The tvmultipartmatching requires one capturing group for the episode number.

{{note|For simplicity, the split-episode pattern has been excluded from the examples below.}}
To allow for split-episodes, replace the <code>[0-9]+</code> in the episode capturing group with <code>[0-9]+(?:(?:[a-i]|\.[1-9])(?![0-9]))?</code>
==== Examples ====
A fairly straightforward example to begin.
;Season ## - Episode ##
:"Season [season#] - Episode [episode#]" anywhere in the file name
:{|
|
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching action="prepend">
<regexp>Season ([0-9]+) - Episode ([0-9]+)([^\\/]*)$</regexp>
</tvshowmatching>
</syntaxhighlight>
|}
:'''Example''' : TV Shows\Scrubs\Season 1\Scrubs - '''Season 1 - Episode 01''' - Pilot.avi
:The first two capturing groups should be obvious, the third group <code>([^\\/]*)</code> captures everything up to the end of the file name <code>$</code>, this allows for multi-part file names such as ''name''.'''Season 1 - Episode 01''' - '''Season 1 - Episode 02'''.ext as well as the simpler ''name''.'''Season 1 - Episode 01-02'''.ext

The entire file path is passed to the regexps, so care should be taken to ensure the matches can't occur earlier in the path, but this does mean for example, you can capture the season number from a sub-folder name.
;\Season #\##
:Season [season#] at the end of the directory name, file name starts with [episode#]
:{|
|
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching action="prepend">
<regexp>Season[\._ ]([0-9]+)[\\/]([0-9]+)([^\\/]*)$</regexp>
</tvshowmatching>
</syntaxhighlight>
|}
:'''Example''' : \Battlestar Galactica (2003)\'''Season 3\01''' - Occupation.avi (Season 3, Episode 1)
:Again we use three groups here to allow for multi-episode, but in this case (obviously) only the shorter multi-episode pattern can occur, e.g. '''Season 1\01x02''' - Episode title.ext.

For numbering without a season, you should ensure that only the episode number gets matched against and not another number in the title or episode title, or a number as part of a different pattern.
; - ## -
:" - [episode#] - " anywhere in the file name
:{|
|
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching action="prepend">
<regexp> - ()([0-9]+)((?:-[0-9]+)*) - [^\\/]*$</regexp>
</tvshowmatching>
</syntaxhighlight>
|}
:'''Example''' : \One Piece\One Piece''' - 099 - '''Spirit of the Fakes! Heart of the Rebel Army, Kamyu!.avi ("Season 1", Episode 99) (Using Absolute order)
:Here, the first capturing group is left empty, and there is a distinct pattern before and after the episode number to ensure only it gets matched. Also instead of capturing the remainder of the file name for multi-part matching, we only capturing a single repeating pattern so only a '''- 01-02-03 -''' format will work.

It's also possible to specify a different default season for without-season regexps.
;\Specials\##
:Directory name is Specials, file name starts with [episode#]
:{|
|
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching action="prepend">
<regexp defaultseason="0">Specials[\\/]()([0-9]+)([^\\/]*)$</regexp>
</tvshowmatching>
</syntaxhighlight>
|}
:'''Example''' : \Firefly\'''Specials\04''' - Browncoats Unite.mkv (Season 0, Episode 4)
:A combination of the previous two examples, allowing special episodes to reside in a "Specials" folder rather than a "Season 0" folder.

The default date-based regexps only allow for periods or hyphens as delimiters...
;<nowiki>####_##_##</nowiki>
:[year]_[month]_[day] anywhere in the file name
:{|
|
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching action="prepend">
<regexp bydate="true">([0-9]{4})_([0-9]{2})_([0-9]{2})[^\\/]*$</regexp>
</tvshowmatching>
</syntaxhighlight>
|}
:'''Example:''' : \The Colbert Report\'''2005_10_17'''.avi
:The exact number of digits is specified for each group to ensure compliance. A separate [month]_[day]_[year] regexp would be needed if both formats are in use.

The default regexps don't allow for DVD folder structures, this can usually be remedied by replacing the final <code>$</code> with <code>(?:(?:[\\/]video_ts)?[\\/]video_ts\.ifo)$</code>
;S##E##\VIDEO_TS\VIDEO_TS.IFO
:{|
|
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching action="append">
<regexp>[Ss]([0-9]+)[ ._-]*[Ee]([0-9]+)([^\\/]*)(?:(?:[\\/]VIDEO_TS)?[\\/]VIDEO_TS\.IFO)$</regexp>
</tvshowmatching>
</syntaxhighlight>
|}
:'''Example:''' \Battlestar Galactica (2003)\The Mini-Series '''S00E01E02'''\VIDEO_TS\VIDEO_TS.IFO
:The VIDEO_TS folder is optional, e.g. '''S01E01'''\VIDEO_TS.IFO will also work.

Similarly for Bluray folder structures, you can replace the final <code>$</code> with <code>(?:(?:[\\/]bdmv)?[\\/]index\.bdmv)$</code>
;<nowiki>#</nowiki>x##\BDMV\index.bdmv
:{|
|
<syntaxhighlight lang="xml" enclose="div">
<tvshowmatching action="append">
<regexp>[\\/\._ \[\(-]([0-9]+)x([0-9]+)([^\\/]*)(?:(?:[\\/]bdmv)?[\\/]index\.bdmv)$</regexp>
</tvshowmatching>
</syntaxhighlight>
|}
:With Bluray folders, you'll also run into trouble with the various mpls and m2ts files incorrectly matching other patterns, so you should also exclude all the other folders and files from being scanned:
:{|
|
<syntaxhighlight lang="xml" enclose="div">
<video>
<excludetvshowsfromscan action="append">
<regexp>[\\/](auxdata|backup|clipinf|playlist|stream|certificate)[\\/]</regexp>
<regexp>movieobject\.bdmv</regexp>
</excludetvshowsfromscan>
</video>
</syntaxhighlight>
|}

Finally, a tvmultipartmatching example.
;S##E##+##
:Multiple episode numbers, separated by a + sign
:{|
|
<syntaxhighlight lang="xml" enclose="div">
<tvmultipartmatching>^[-_EeXx+]+([0-9]+)</tvmultipartmatching>
</syntaxhighlight>
|}
:'''Example:''' : \Lost\Lost.'''S01E23+24'''.Exodus.mkv
:In this case we can simply add the + sign to the default symbols, thus preserving the defaults as well.

== All advanced settings related to TV show/episode names ==
{{main|advancedsettings.xml}}
* [[advancedsettings.xml#tvshowmatching|<tvshowmatching>]]
* [[advancedsettings.xml#tvmultipartmatching|<tvmultipartmatching>]]
* [[advancedsettings.xml#excludetvshowsfromscan|<excludetvshowsfromscan>]]
* [[advancedsettings.xml#cleanstrings|<cleanstrings>]]
* [[advancedsettings.xml#videoextensions|<videoextensions>]]
* [[advancedsettings.xml#discstubextensions|<discstubextensions>]]

== Troubleshooting ==
{{main|Incorrect and missing videos}}

{{#lst:Incorrect and missing videos|names}}

{{Isengard updated}}

[[Category:Video library]]
[[Category:Manual]]

Naming video files/Movies

2015-12-07T16:28:11Z

Slchorne: remove circular content includes

{{mininav|[[Video library]]|[[Video management|Management]]|[[Naming video files]]}}
{{#lst:Naming video files|naming files}}
__TOC__
== Naming conventions ==
In order to be scanned correctly, '''movie''' folder names should only have the title and the '''year (optional)'''.
'''[[Media flags#Media source|Media source flags]]''' can also be added via file names to indicate source/quality of the movie (see link for more info).

'''To improve''' matching add the '''year''' within parenthesis to the end of the foldername, or filename - depending on your scanning method and folder structure (before the extension, if filename), this naming standard seems to yield the best results.

;Movies stored in individual folders

\Movies\The Man With the Golden Gun\goldengun.avi

\Movies\Avatar (2009)\somefilename.mkv
\Movies\The Usual Suspects (1995)\somefilename.avi

\Movies\The Usual Suspects (1995)\somefilename-cd1.avi
\Movies\The Usual Suspects (1995)\somefilename-cd2.avi
\Movies\Avatar (2009)\Avatar (2009)-cd1.mkv
\Movies\Avatar (2009)\Avatar (2009)-cd2.mkv

{{note|If the wrong movie is picked up even if foldername or filename is correct, the movie can have an earlier original title. This often happens to movies made in 1950's and after.}}

;Movies based on file name alone

\Movies\The Man With The Golden Gun.avi
\Movies\Pulp Fiction (1994).avi
\Movies\Reservoir Dogs (1992).avi
\Movies\The Usual Suspects (1995).avi

\Movies\Avatar (2009)-cd1.mkv
\Movies\Avatar (2009)-cd2.mkv

And for DVD-Video movies stored in file-mode on the harddrive or [[SMB]] [[NFS]]:
\Movies\Alien (1979)\VIDEO_TS.IFO
\Movies\Léon (1994)\VIDEO_TS.IFO
\Movies\Scarface (1983)\VIDEO_TS.IFO
Alternatively:
\Movies\Alien (1979)\VIDEO_TS\VIDEO_TS.IFO
\Movies\Léon (1994)\VIDEO_TS\VIDEO_TS.IFO
\Movies\Scarface (1983)\VIDEO_TS\VIDEO_TS.IFO
{{note|If using VIDEO_TS folder structure you must enable "recursive" lookup when adding the source directory.}}

== 3D movies ==
{{Main|3D}}
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.

== Media source tags ==
{{main|Media flags#Media source}}
Depending on the interface [[skin]] you are using, you can add additional media source information to a movie entry in Kodi. For example, in the default skin "Confluence" you can label when a file was ripped from a bluray disc by including BLURAY, BRRIP, BD25, or BD50 in the file name after the title. The exact options are different for each interface skin, but a list for the default Confluence skin can be seen on [[Media flags#Media source]].

;Example
:<code>Back to the Future (1985).bluray.mkv</code>

== Split video files (file stacking) ==
By using the following naming extensions and enabling {{highlight|bordered=yes|[[Settings/Videos#File lists|Settings -> Videos -> File lists -> Combined split video items]]}}, you can enable "file stacking" for split video files. File stacking allows multiple video files to appear and play as if it were one movie file.

=== Name extensions for stacking ===
'''For single files:'''

The following are default stacking extensions that can be added to file names These are for video file names that are in the same folder.

'''#''' can be '''1''' through '''9''' or '''A''' through '''D'''. No spaces between the extension and number.
* {{code|part#}}
* {{code|cd#}}
* {{code|dvd#}}
* {{code|pt#}}
* {{code|disk#}}
* {{code|disc#}}

You can also use:
* moviename'''#'''.ext
where '''#''' can be '''A''' through '''D'''.

{{divbox|blue|Example:|
* <code>Avatar part1.mkv</code>
* <code>Avatar part2.mkv</code>
in the same folder will appear as a single "Avatar" entry in both library and file views.
}}

'''For video files in folders:'''

Such as VIDEO_TS folders (DVD rips that are not in ISO format), you can stack them using the folder name that contains the movie name.

'''#''' can be '''1''' through '''9'''. No spaces between the extension and number.
* {{code|cd#}}
* {{code|dvd#}}
* {{code|disc#}}
* {{code|disk#}}

{{divbox|blue|Example:|
*<code>The Lord of the Rings - The Fellowship of the Ring DVD1/VIDEO_TS/etc...</code>
*<code>The Lord of the Rings - The Fellowship of the Ring DVD2/VIDEO_TS/etc...</code>
will appear as a single "The Lord of the Rings - The Fellowship of the Ring" entry in both library and file views.
}}

;Notes
* The default expressions will NOT stack files which use only a number as the volume token (eg movie1.avi, movie2.avi). This is intentional due to false positives which can occur with sequels in a flat directory layout. Some solutions to this problem (in order of best to worst) follow...
*# Use a dir-per-movie directory layout, see the '''append''' example of the [[Advancedsettings.xml#.3Cmoviestacking.3E|moviestacking]] advanced setting.
*# Rename offending files to match one of the more specific volume tokens (ie. cd1, part1, etc).
*# Create special-case regular expressions for those files that fail to stack (see [[#Advanced stacking options]]).

=== NFO files for stacking ===
{{main|NFO files/Movies}}
{{#lst:NFO files/Movies|stacking note}}

=== Advanced stacking options ===
File stacking can be tuned by the user to match obscure cases using the '''[[Advancedsettings.xml#moviestacking|<moviestacking>]]''' and '''[[Advancedsettings.xml#folderstacking|<folderstacking>]]''' advancedsettings.xml settings.

{{Isengard updated}}

[[Category:Video library]]
[[Category:Manual]]

Adding video sources

2015-12-07T16:26:20Z

Slchorne: remove circular content includes

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />A video source is a kind of media source. [[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Seclect Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Making one source from multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]

Set content and scan

2015-12-07T16:25:48Z

Slchorne: remove circular content links

{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />When you "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. If you did not "Set Content" when you added a source, you can do so later by selecting the source and bringing up the contextual menu ({{keypress|C}} on a keyboard by default).<section end="intro" />

== Setting content for subfolders ==
You can also "set content" for subfolders, even if the parent folder has content set that is using a different setting. For example, you can have a folder for your TV shows, and in that folder have a folder for "Star Trek" that contains the different Star Trek TV shows. If you do this normally then Kodi will think that "Star Trek" is one single show, but if you set content on that specific folder, then it will scan everything in correctly.

Avoid adding a subfolder as a separate source, as Kodi will might make duplicates if there are two sources that lead to the same files.

== Movie content options ==
[[File:Set content.movies.png|500px|right]]
;Movies are in separate folders that match the movie title
:If you keep each of your movies in its own folder with the movie name in it
:{{highlight|'''Example:''' /Movies/Big Buck Bunny/Big Buck Bunny.mkv}}
:If you keep all your movies in one big folder then leave this option unchecked.
;Scan recursively
:Scans sub folders for movies as well as the main folder. Great for if your movies are categorized into sub folders (e.g. genres, a-z), etc.
:{{highlight|'''Example:''' /Movies/Action/Big Buck Bunny.mkv}}
;Selected folder contains a single movie
:This option is intended for adding one movie at a time.
;Exclude path from library updates
:Excludes the selected path from scans and updates, even if it's a subfolder of a folder that has contents set.
{{-}}
=== Movie scraper settings ===
{{see also|Add-on:The MovieDB}}
{{#lst:Add-on:The MovieDB|Scraper settings}}

== TV show content options ==
[[File:Set content.TV shows.png|500px|right]]
;Folder contains a single TV Show
:This option is intended for adding one TV show at a time.
;Exclude path from library updates
:Excludes the selected path from scans and updates, even if it's a subfolder of a folder that has contents set.
{{-}}
=== TV show scraper settings ===
{{see also|Add-on:The TVDB#Scraper settings}}
{{#lst:Add-on:The TVDB|Scraper settings}}
{{-}}
=== Season ordering ===
{{see also|Add-on:The TVDB#Season ordering}}
{{#lst:Add-on:The TVDB|Season ordering}}
{{-}}

== Music video content options ==
[[File:Set content.music videos.png|500px|right]]
;Run Automatic Scan
:Scans the source's files into the library after selecting 'OK'
;Scan recursively
:If your music videos are categorized into sub folders (e.g. genres, a-z).
;Exclude path from library updates
:Excludes the selected path from scans and updates, even if it's a subfolder of a folder that has contents set.
{{-}}
=== Music video scraper settings ===
{{see also|Add-on:TheAudioDb.com for Music Videos}}
{{#lst:Add-on:TheAudioDb.com for Music Videos|Scraper settings}}

== Local NFO only options ==
{{main|NFO files}}

NFO files are an alternative to going online for the library data. Kodi will always look for the existence of an NFO file before going online to download that data, even if you have setup an online scraper.

After the videos and NFO files are scanned into the library, the NFO file is no longer used and only serves as a backup. If you make changes to the NFO file you will need to '''[[refresh]]''' that library entry for the changes to be loaded into Kodi.

{{Note|The local-NFO-only option is only needed if you want to prevent Kodi from using scrapers for video files that do not yet have NFO files. This option is not needed to actually use NFO files, and Kodi will aways prefer the data from NFO files when they are available.}}

For example, if you use a 3rd party [[media manager]] to make NFO files and you haven't generated NFO files for your new video additions. The NFO-only mode will prevent the videos without NFO files from being added to the library until they have NFO files.

If you are only using NFO files to restore from a backup of the library, or doing something like moving from a local library to [[MySQL]], then you will want to use the normal scraper settings and '''not''' use the NFO-only option. This way Kodi will still use the online scrapers for new videos, but only for those new videos that don't have NFO files.

== (None) content options ==
[[File:Set content.none.png|500px|right]]
Settings a scraper to {{big|'''(None)'''}} on folders or subfolders can be used explicitly to set '''no scraper''' so that when excluding a path that contains no valid scrapable media info, can be easily achieved. In combination with other options this maximizes the effectiveness of excluding a path from scans.

;The directory contains {{big|'''(None)'''}} Current scraper
:Ensure that the selected source '''doesn't have a content set''', works with exclude path from scans, even when it's a subfolder of a folder that has contents set.
:To exclude folder from scans, '''check''' the option as well.
:Also a intermediary choice when changing content on a source. '''''see also:''''' '''[[#Switching scrapers and removing sources from the library |Switching scrapers and removing sources from the library]]'''
{{-}}

== Excluding directories/folders ==
<section begin="exclude" />
Kodi can exclude certain directories from the library all together using a few different methods.

* Use the '''"Exclude folder from scans"''' option when the content type is set to '''"[[#(None) content options|none]]"'''

* Place a file (even an empty one) named '''<code>.nomedia</code>''' in the directory you want to exclude.
::{{note|Windows users should name the file <code>.nomedia.</code> which will trick Windows into using the proper <code>.nomedia</code> name.}}

* Folders with '''<code>-trailer</code>''' or '''<code>sample</code>''' in the name will be automatically skipped. For the exact pattern match, see '''[[Advancedsettings.xml#excludefromscan|here]]'''.

* Users can also add additional patterns to be excluded by using the [[advancedsettings.xml]] tag '''[[Advancedsettings.xml#excludefromscan|<excludefromscan>]]'''
<section end="exclude" />

== Scanning and updating files ==
<section begin="update" />There are several ways you can scan your videos into the [[Video library]]:

* When a source or file has "content set" or changed, Kodi will ask you if you wish to update the library after you are done.
* In Library view you can choose "Update library" from the lefthand sidebar menu by pressing {{keypress|left}} (left).
* Select the item in file view and either press {{keypress|I}} on the keyboard, or bring up the contextual menu (press {{keypress|C}}) and select "Movie information" or "TV show information"
** If the file is already scanned in, you can also use the info screen to refresh/update that entry in the library.
* You can select the share, folder, or TV show (anything that is basically a folder) that your videos are in and choose "Scan for new content" from the contextual menu (press {{keypress|C}} or {{button|Menu}}), which scans all files in that specific share/folder.
* Have Kodi scan for new items upon start up by going to {{highlight|bordered=yes|[[Settings/Video#Library|Settings -> Video -> Library -> Update library on startup]]}}
* [[Add-on:XBMC Library Auto Update]] can be used to schedule automatic updates to the library.
* [[Add-on:Library watchdog]] can be used to watch folders for new files to trigger library updates.

== Refreshing the library ==
{{Note|Kodi only scans each video once for information. The next time you update it will only add new videos, but won't download new art/summaries/etc for existing videos. }}
To refresh the information for existing videos:
;<big><u>Refresh individually</u></big>
# Select the item in file view and either press {{keypress|I}} on the keyboard, or bring up the contextual menu (press {{keypress|C}}).
# Select "Movie information" or "TV show information".
# Then select "Refresh".

When refreshing individually you can also choose to just refresh or manually select images for various views (cover art, fanart, thumbnails, etc).

;{{big|<u>Refresh by source/folder</u>}}
# Remove a source/folder from the library by changing the [[Set content and scan|content setting]] to "None".
# When Kodi asks you if you want to remove those items from the library, say yes.
# Kodi will then show a progress bar and remove those entries.
# Change the content setting back to what it was before.
# Kodi will then rescan in those entries.<section end="update" />

== Switching scrapers and removing sources from the library ==
<section begin="remove source" />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 video library as removing entries from the contextual menu will only remove single items.<section end="remove source" />

{{Isengard updated}}

[[Category:Manual]]
[[Category:Video library]]
[[Category:Settings]]

Adding videos to the library

2015-12-07T16:18:32Z

Slchorne:

{| class="{{{1|infobox}}}"
| {{big|'''The basic steps for adding<br />videos to the library:'''}}
'''1.''' [[Naming video files]]
* [[Naming video files/Movies|Movies]]
* [[Naming video files/TV shows|TV shows]]
* [[Naming video files/Music videos|Music videos]]
'''2.''' [[Adding video sources]]<br />
'''3.''' [[Set content and scan]]
----

|}<noinclude>
{{mininav|[[Video library]]|[[Video library/Management|Management]]}}
{{main|Video management}}

{{bigger|'''To use your video files with "metadata" like summaries, cast info, movie covers, thumbnails, fanart backdrops, and more, you need to add those video files to the video library by following these steps in the righthand box: -->'''}}

The menu on the right hand side will walk you through all of these steps.</noinclude>

== Preparing files ==
{{main|Video_management#Preparing_files}}
{{#lst:Video management|intro}}

=== Naming files ===
{{See|Naming video files}}
{{#lst:Naming video files|intro}}

* [[Naming video files/Movies]]
* [[Naming video files/TV shows]]
* [[Naming video files/Music videos]]

== Adding media sources ==
{{See|Adding video sources}}

== Set the content type and scan ==
{{See|Set content and scan}}

== See Also ==
* [[Incorrect and missing videos]]
* [[Custom video entries]]
* [[Updating or removing videos]]
* [[Video library/Alternative and video guides|Alternative and video guides]]

[[Category:Adding videos to the library guide]]

Video management

2015-12-07T16:07:20Z

Slchorne: made <prep> section smaller, to fix embedding in other pages

{{mininav|[[Video library]]}}
<section begin="intro" />To use your video files with "metadata" like summaries, cast info, DVD covers, thumbnails, and more, you need to '''[[Adding videos to the library|add those video files]]''' to the [[video library]].<section end="intro" />

See '''[[Adding videos to the library]]''' for just the basic topics on adding videos.

== 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.

<section begin="intro" />There are a couple of important parts to getting things imported into your {{Kodi}} 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.
<section end="intro" />

<section begin="prep" />
{{Kodi}} 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 TheTVDB.com (for TV shows) and TheMovieDB.org (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 TheTVDB.org 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 {{Kodi}} 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.<section end="prep" />

=== Naming files ===
{{main|Naming video files}}
{{#lst:Naming video files|intro}}

* [[Naming video files/Movies]]
* [[Naming video files/TV shows]]
* [[Naming video files/Music videos]]

=== NFO files ===
{{Main|NFO files}}
{{#lst:NFO files|intro}}

== Media sources ==
{{Main|Media sources}}
{{#lst:Media sources|intro}}

=== Adding video sources ===
{{main|Adding video sources}}
{{#lst:Adding video sources|intro}}

== Media stubs ==
{{Main|Media stubs}}
{{#lst:Media stubs|intro}}
{{-}}

== Internet streams ==
{{Main|Internet streams}}
{{#lst:Internet streams|intro}}

== Setting content and scanning ==
{{main|Set content and scan}}
{{#lst:Set content and scan|intro}}

=== Incorrect and missing videos ===
{{Main|Incorrect and missing videos}}
{{#lst:Incorrect and missing videos|intro}}

=== Custom video entries ===
{{Main|Custom video entries}}
{{#lst:Custom video entries|intro}}

=== Updating or removing videos ===
{{Main|Updating or removing videos}}
{{#lst:Updating or removing videos|intro}}

== Grouping media ==

=== File stacking ===
{{Main|File stacking}}
{{#lst:File stacking|intro}}

=== Movie sets ===
{{Main|Movie sets}}
{{#lst:Movie sets|intro}}

=== Video library tags ===
{{Main|Video library tags}}
{{#lst:Video library tags|intro}}

=== How to separate the library (cartoons, documentaries, anime, etc) ===
{{Main|Custom home items}}
{{#lst:Custom home items|intro}}

=== Playlists ===
{{Main|Playlists}}
* {{big|'''[[Basic playlists]] -'''}} {{#lst:Basic playlists|intro}}

* {{big|'''[[Smart playlists]] -'''}} {{#lst:Smart playlists|intro}}

=== Linking movies to TV shows ===
{{#lst:Linking movies to TV shows|movie TV link}}
{{-}}

=== Video nodes ===
{{Main|Video nodes}}
{{#lst:Video nodes|intro}}
{{-}}

== Alternative guides ==
<section begin="Alternative guides" />
* [http://lifehacker.com/5900626/create-a-kickass-seamless-play+everything-media-center-the-complete-guide Lifehacker.com - Create a Kickass, Seamless, Play-Everything Media Center: The Complete Guide]
* [http://tbueter.com/?page_id=324 The Frodo Guide] by Henry Ford
* [http://kordkutters.com/setting-up-your-kodi-movies-and-tv-shows-library/ Beginner Tip: How to add videos to Kodi from a network share] by Nathan Betzen
* [http://www.makeuseof.com/pages/xbmc-full-html Makeuseof.com - How to set up your Kodi Media Center]
* [http://youresuchageek.blogspot.fr/2012/06/xbmc-install-and-config-howto-for-linux.html Kodi Install and Config] HOW-TO for Linux Its for xvba, however apart from drivers the rest is a '''MUST''' read for Linux novices.

=== Video guides ===

{{youtube|UBGKcLu7aGk}} {{youtube|EkWYxqoOF3c}} {{youtube|ueqwMbdMVHU}}
<section end="Alternative guides" />

== See also ==
* [[Import-export library]]
* [[Parental controls|Locking video sources / Parental controls]]
* [[Video library settings]]
* [[First time user]]
* [[UPnP]]

{{Helix updated}}

[[Category:Video library]]
[[Category:Manual]]
[[Category:Index]]

Adding video sources

2015-12-07T15:41:49Z

Slchorne: /* Making one source for multiple locations */

{{:Adding videos to the library/Contents}}
{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />A video source is a kind of media source. [[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Seclect Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Making one source from multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]

Video management

2015-12-07T15:39:52Z

Slchorne: cleanup of circular link loop

{{mininav|[[Video library]]}}
<section begin="intro" />To use your video files with "metadata" like summaries, cast info, DVD covers, thumbnails, and more, you need to '''[[Adding videos to the library|add those video files]]''' to the [[video library]].<section end="intro" />

See '''[[Adding videos to the library]]''' for just the basic topics on adding videos.

== 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.

<section begin="prep" />There are a couple of important parts to getting things imported into your {{Kodi}} 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.

{{Kodi}} 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 TheTVDB.com (for TV shows) and TheMovieDB.org (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 TheTVDB.org 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 {{Kodi}} 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.<section end="prep" />

=== Naming files ===
{{main|Naming video files}}
{{#lst:Naming video files|intro}}

* [[Naming video files/Movies]]
* [[Naming video files/TV shows]]
* [[Naming video files/Music videos]]

=== NFO files ===
{{Main|NFO files}}
{{#lst:NFO files|intro}}

== Media sources ==
{{Main|Media sources}}
{{#lst:Media sources|intro}}

=== Adding video sources ===
{{main|Adding video sources}}
{{#lst:Adding video sources|intro}}

== Media stubs ==
{{Main|Media stubs}}
{{#lst:Media stubs|intro}}
{{-}}

== Internet streams ==
{{Main|Internet streams}}
{{#lst:Internet streams|intro}}

== Setting content and scanning ==
{{main|Set content and scan}}
{{#lst:Set content and scan|intro}}

=== Incorrect and missing videos ===
{{Main|Incorrect and missing videos}}
{{#lst:Incorrect and missing videos|intro}}

=== Custom video entries ===
{{Main|Custom video entries}}
{{#lst:Custom video entries|intro}}

=== Updating or removing videos ===
{{Main|Updating or removing videos}}
{{#lst:Updating or removing videos|intro}}

== Grouping media ==

=== File stacking ===
{{Main|File stacking}}
{{#lst:File stacking|intro}}

=== Movie sets ===
{{Main|Movie sets}}
{{#lst:Movie sets|intro}}

=== Video library tags ===
{{Main|Video library tags}}
{{#lst:Video library tags|intro}}

=== How to separate the library (cartoons, documentaries, anime, etc) ===
{{Main|Custom home items}}
{{#lst:Custom home items|intro}}

=== Playlists ===
{{Main|Playlists}}
* {{big|'''[[Basic playlists]] -'''}} {{#lst:Basic playlists|intro}}

* {{big|'''[[Smart playlists]] -'''}} {{#lst:Smart playlists|intro}}

=== Linking movies to TV shows ===
{{#lst:Linking movies to TV shows|movie TV link}}
{{-}}

=== Video nodes ===
{{Main|Video nodes}}
{{#lst:Video nodes|intro}}
{{-}}

== Alternative guides ==
<section begin="Alternative guides" />
* [http://lifehacker.com/5900626/create-a-kickass-seamless-play+everything-media-center-the-complete-guide Lifehacker.com - Create a Kickass, Seamless, Play-Everything Media Center: The Complete Guide]
* [http://tbueter.com/?page_id=324 The Frodo Guide] by Henry Ford
* [http://kordkutters.com/setting-up-your-kodi-movies-and-tv-shows-library/ Beginner Tip: How to add videos to Kodi from a network share] by Nathan Betzen
* [http://www.makeuseof.com/pages/xbmc-full-html Makeuseof.com - How to set up your Kodi Media Center]
* [http://youresuchageek.blogspot.fr/2012/06/xbmc-install-and-config-howto-for-linux.html Kodi Install and Config] HOW-TO for Linux Its for xvba, however apart from drivers the rest is a '''MUST''' read for Linux novices.

=== Video guides ===

{{youtube|UBGKcLu7aGk}} {{youtube|EkWYxqoOF3c}} {{youtube|ueqwMbdMVHU}}
<section end="Alternative guides" />

== See also ==
* [[Import-export library]]
* [[Parental controls|Locking video sources / Parental controls]]
* [[Video library settings]]
* [[First time user]]
* [[UPnP]]

{{Helix updated}}

[[Category:Video library]]
[[Category:Manual]]
[[Category:Index]]

Adding video sources

2015-12-07T15:39:04Z

Slchorne:

{{:Adding videos to the library/Contents}}
{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />A video source is a kind of media source. [[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Seclect Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Making one source for multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]

Adding video sources

2015-12-07T15:35:19Z

Slchorne:

{{:Adding videos to the library/Contents}}
{{mininav|[[Video library]]|[[Video management|Management]]}}
<section begin="intro" />[[Media sources]] are the links that tell {{Kodi}} where your content is stored and what type of content is contained within each one.

You can have multiple sources for each media type. <section end="intro" />

You can use local media, file shares, removable USB drives, etc. '''[[UPnP]] won't work with the library features (scanning data in like summaries and movie covers) in {{Kodi}}''', but just about all the other options should be fine.

__TOC__
{{-}}
== Adding sources ==
<section begin="adding video" />
<gallery widths=500px heights=313px>
File:Quick-start-1.png|'''Step 1:''' Select "Videos" in the home screen menu.
File:Quick-start-2.png|'''Step 2:''' Seclect Files, then select "Add Videos".
File:Quick-start-3.png|'''Step 3:''' The "Add Video Source" screen will be displayed. Then select the "Browse" button.
File:Quick-start-4.png|'''Step 4:''' Now browse to where you keep your videos stored. Once you have found the folder you keep your videos in, select 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.
File:Quick-start-5.png|'''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 {{Kodi}}. Then select "OK".
File:Quick-start-6.png|'''Step 6:''' The set content window will display, this is where you tell {{Kodi}} what type of media is in the folder. Press the down arrow until you reach the correct type (in this example movies)
File:Quick-start-7.png|'''Step 7:''' There are a number of options underneath, see '''[[Adding videos to the library/Setting content and scanning|Setting content and scanning]]''' to check what options to enable. Then select "OK"
File:Quick-start-8.png|'''Step 8:''' Press Yes to scan the content to the library (if no is pressed, it can be scanned later).
</gallery>
<section end="adding video" />

== Making one source for multiple locations ==
[[File:Multi locations in one source.png|right|500px]]

You might notice that {{Kodi}} has an "ADD" button in addition to a "BROWSE" button when you are adding a source. After you add your first location, you can add a second location (network or local. you can even mix them) and {{Kodi}} will show both folders as a single folder/source.

{{Kodi}} will also combine the subfolders within the source/locations. For example, if you had a hard drive for TV shows, but ran out of space, you could make a second hard drive with the same folder paths and {{Kodi}} would merge them together to a single directory path. Such as

:<code>Hard drive 1/TV shows/<br />
:Hard drive 2/TV shows/</code>

and the same is true for an additional nested folder with the same way:

:<code>Hard drive 1/TV shows/American Dad/<br />
:Hard drive 2/TV shows/American Dad/</code>

You could have half of a show on one hard drive, half on another, and {{Kodi}} will show it to you as if it was in a single location by using multiple locations in a single source.

{{note|This only impacts the basic "Files view". The default Library nodes will combine things by show even if their files are spread across multiple drives. '''Most users will not really benefit from using multiple paths in a single source.'''}}
{{-}}

== Password protected sources ==
{{See|Media sources#Locking}}

== See also ==
* [[Media sources]]
* [[File sharing]]

{{Gotham updated}}

[[Category:Scraper]]
[[Category:Manual]]
[[Category:Video library]]