Naming video files - Revision history

Karellen at 02:21, 30 January 2021

2021-01-30T02:21:36Z

← Older revision		Revision as of 02:21, 30 January 2021
Line 1:		Line 1:
	{{VideoLibraryCreate}}		{{VideoLibraryCreate}}
	{{mininav\|[[Video library]]}}		{{mininav\|[[Video library]]}}

			{{Disambiguation}}

Karellen: Replaced content with "{{VideoLibraryCreate}} {{mininav|Video library}} {| ! scope="row" style="width:400px; text-align:left;" | See the following sub-pages |- | scope="row" style="width:4..."

2021-01-30T02:17:20Z

Replaced content with "{{VideoLibraryCreate}} {{mininav|Video library}} {| ! scope="row" style="width:400px; text-align:left;" | See the following sub-pages |- | scope="row" style="width:4..."

@@ Line 3: / Line 3: @@
+{|
-= Introduction =
+! scope="row" style="width:400px; text-align:left;" | See the following sub-pages
-<section begin="intro" />{{kodi}} has the ability to display  information and artwork for your video collection. As this information and artwork comes from third-party sites, video files must be placed in a certain folder structure and named correctly so accurate matches can be made with those third-party sites. These pages describe the '''''Best Practice''''' methods to use for the most reliable scraping process.<section end="intro" />
+|-
+| scope="row" style="width:400px; text-align:left;"| {{Special:PrefixIndex/Naming_video_files/}}
-The process of matching and downloading data and artwork to your {{kodi}} library is named '''scraping'''. The sites where we obtain the information from is referred to as the '''information provider site''' (also '''scraper site'''). The wonderful add-on that enables this to occur is called the '''scraper'''. When the information comes from local NFO Files, this is called '''scanning'''.
+|}

Karellen at 02:01, 23 July 2020

2020-07-23T02:01:20Z

← Older revision		Revision as of 02:01, 23 July 2020
Line 77:		Line 77:

	While Media Managers do have a place in the {{kodi}} eco-system, we do not recommend them for general scraping.		While Media Managers do have a place in the {{kodi}} eco-system, we do not recommend them for general scraping.
	:'''''See: [[~~Rename_tools~~\|~~File Renaming~~ Tools~~]]'''''~~		:'''''See: [[Supplemental_tools\|Supplemental Tools]]'''''
	~~:'''''See: [[Library_managers\|Library Managers~~]]'''''

Karellen: Updated for v18

2019-04-18T03:17:22Z

Updated for v18

← Older revision		Revision as of 03:17, 18 April 2019
Line 5:		Line 5:

	= Introduction =		= Introduction =
	<section begin="intro" />{{kodi}} has the ability to display information and artwork for your video collection. As this information and artwork comes from third-party sites, video files must be placed in a certain folder structure and named correctly so accurate matches can be made with those third-party sites. ~~This page, and following~~ pages~~, will instruct on~~ the ~~correct~~ methods to use for the most reliable scraping process.<section end="intro" />		<section begin="intro" />{{kodi}} has the ability to display information and artwork for your video collection. As this information and artwork comes from third-party sites, video files must be placed in a certain folder structure and named correctly so accurate matches can be made with those third-party sites. These pages describe the '''''Best Practice''''' methods to use for the most reliable scraping process.<section end="intro" />

	The process of matching and downloading data and artwork to your {{kodi}} library is named '''scraping'''. The sites where we obtain the information from is referred to as the '''information provider site''' (also '''scraper site'''). The wonderful add-on that enables this to occur is called the '''scraper'''.		The process of matching and downloading data and artwork to your {{kodi}} library is named '''scraping'''. The sites where we obtain the information from is referred to as the '''information provider site''' (also '''scraper site'''). The wonderful add-on that enables this to occur is called the '''scraper'''. When the information comes from local NFO Files, this is called '''scanning'''.

	<section begin="know" />Things you should know about scraping:		<section begin="know" />Things you should know about scraping:
Line 13:		Line 13:
	*If a movie or TV show does not exist at the scraper site, then {{kodi}} cannot scrape it. Always check the entry at the scraper site.		*If a movie or TV show does not exist at the scraper site, then {{kodi}} cannot scrape it. Always check the entry at the scraper site.
	*{{Kodi}} can also read information from local files known as '''''[[NFO_files\|NFO Files]]'''''.		*{{Kodi}} can also read information from local files known as '''''[[NFO_files\|NFO Files]]'''''.
	*As the information provider sites are maintained by a small volunteer community, which provides this service at no cost, it is strongly encouraged that {{Kodi}} users contribute back to those sites when discovering errors and omissions in the ~~databases~~.		*As the information provider sites are maintained by a small volunteer community, which provides this service at no cost, it is strongly encouraged that {{Kodi}} users contribute back to those sites when discovering errors and omissions in the information.
	*Scraping problems experienced by users are attributable as follows: 95%- Incorrect naming, folder and source structure; 4%- Missing data at the scraper site; 1%- Changes at the scraper site which breaks the scraper add-on.<section end="know" />		*Scraping problems experienced by users are attributable as follows: 95%- Incorrect naming, folder and source structure; 4%- Missing data at the scraper site; 1%- Changes at the scraper site which breaks the scraper add-on.<section end="know" />
	*For a full list of metadata downloaded by the scraper see '''''[[NFO_files\|NFO Files]]'''''		*For a full list of metadata downloaded by the scraper see '''''[[NFO_files\|NFO Files]]'''''
	*For a full list of artwork that can be used by {{Kodi}} see '''''[[Artwork\|Artwork]]'''''		*For a full list of artwork that can be used by {{Kodi}} see '''''[[Artwork\|Artwork]]'''''
			*Before posting on the forum regarding library problems, read this post... '''''[https://forum.kodi.tv/showthread.php?tid=336969 Common Library Problems ]'''''


	The default scraper used by {{kodi}} for '''Movies''' is ~~the~~ TheMovieDB (TMDB). Other scrapers are available and can be found by searching the {{kodi}} site '''''[https://kodi.tv/addons/browse?keyword=&category=1185&author=&sort=title+ASC here]'''''		The default scraper used by {{kodi}} for '''Movies''' is TheMovieDB (TMDB). Other scrapers are available and can be found by searching the {{kodi}} site '''''[https://kodi.tv/addons/browse?keyword=&category=1185&author=&sort=title+ASC here]'''''
	:'''''See: [https://www.themoviedb.org/ TheMovieDB]		:'''''See: [https://www.themoviedb.org/ TheMovieDB]'''''
	:'''''See: [[Add-on:The_Movie_Database\|TheMovieDB Add-on]]		:'''''See: [[Add-on:The_Movie_Database\|TheMovieDB Add-on]]'''''
	:'''''See: [[Add-on:Universal_Movie_Scraper\|Universal Movie Scraper Add-on]]		:'''''See: [[Add-on:Universal_Movie_Scraper\|Universal Movie Scraper Add-on]]'''''


	The default scraper used by {{kodi}} for '''TV Shows''' is the ~~TheTVDB (TVDB)~~. Other scrapers are available and can be found by searching the {{kodi}} site '''''[https://kodi.tv/addons/browse?keyword=&category=1187&author=&sort=title+ASC here]'''''		The default scraper used by {{kodi}} for '''TV Shows''' is the TheMovieDB-TV Shows. Other scrapers are available and can be found by searching the {{kodi}} site '''''[https://kodi.tv/addons/browse?keyword=&category=1187&author=&sort=title+ASC here]'''''
	:'''''See: [https://www.~~thetvdb~~.~~com~~/ ~~TheTVDB~~]		:'''''See: [https://www.themoviedb.org/ TheMovieDB]'''''
	:'''''See: [[Add-on:~~The_TVDB~~\|~~TheTVDB~~ Add-on]]		:'''''See: [[Add-on:The_Movie_Database\|TheMovieDB Add-on]]'''''


	'''~~{{big~~\|~~This is the most important step to ensuring correct scraping.}}~~'''
			= Accuracy =
			<section begin="split" />No scraper or folder and naming convention is 100% accurate. There are just some cases where human intervention is required. A perfect example of this case is movies with the exact same name and year. See the following three movies as an example...
			: Split (2016) - https://www.themoviedb.org/movie/425636
			: Split (2016) - https://www.themoviedb.org/movie/409583-split
			: Split (2016) - https://www.themoviedb.org/movie/358364-split<section end="split" />


			The more accurate your naming, the less likely incorrect scrapes will occur.

			How to overcome problems such as this are explained in '''''[[Incorrect_and_missing_videos\|Scraping Problems]]'''''



	= Source Folder =		= Source Folder =
	The Source folder is the location ~~that~~ the user specifies for {{kodi}} to search for a class of media. ~~In this case of videos~~, ~~it is the folder that holds the movie files and~~ TV Shows~~. These must be separate Sources~~.		The Source folder is the location the user specifies for {{kodi}} to search for a class of media. For the video library, you would have '''separate''' sources for Movies, TV Shows and Music Videos.

	The Source must be the parent folder that holds the respective ~~movies and~~ TV Shows.		The Source must be the parent folder that holds the respective Movies, TV Shows and Music Videos.

	Notes on naming and setting a '''Source''':		Notes on naming and setting a '''Source''':
Line 44:		Line 55:
	*A single class of media can be placed in one source if you desire, though larger libraries (200 or more videos) do benefit from multiple sources		*A single class of media can be placed in one source if you desire, though larger libraries (200 or more videos) do benefit from multiple sources
	*There is no requirement on how to separate videos between Sources. Many users separate based on Genre, alphabetical listing, Video Resolution (DVD, Bluray, 4k) or any method you prefer		*There is no requirement on how to separate videos between Sources. Many users separate based on Genre, alphabetical listing, Video Resolution (DVD, Bluray, 4k) or any method you prefer
	*If you have your video collection on multiple drives, then a Source must exist on each hard drive for each ~~Class~~ of media and added to {{Kodi}}		*If you have your video collection on multiple drives, then a Source must exist on each hard drive for each class of media and added to {{Kodi}}
	*'''Never''' mix media classes. ie, ensure TV Shows, Movies, Music Videos or Music are not in the same source.		*'''Never''' mix media classes. ie, ensure TV Shows, Movies, Music Videos or Music are not in the same source, nor as a subfolder of another source.
	*'''Never''' set the entire hard drive as your Source as this will create multiple ghost entries.		*'''Never''' set the entire hard drive as your Source as this will create multiple ghost entries.

Line 64:		Line 75:
	= Supplemental tools =		= Supplemental tools =
	To help with mass file renaming and organizing, see the following pages for programs that can help automate these tasks, or do them in bulk.		To help with mass file renaming and organizing, see the following pages for programs that can help automate these tasks, or do them in bulk.

			While Media Managers do have a place in the {{kodi}} eco-system, we do not recommend them for general scraping.
	:'''''See: [[Rename_tools\|File Renaming Tools]]'''''		:'''''See: [[Rename_tools\|File Renaming Tools]]'''''
	:'''''See: [[Library_managers\|Library Managers]]'''''		:'''''See: [[Library_managers\|Library Managers]]'''''
Line 74:		Line 87:
	<div style="{{linear-gradient\|left\|#a1f5e4, #f5f5a1}}">{{next\|[[Naming_video_files/Movies\|'''Naming Movies''']]}} </div>		<div style="{{linear-gradient\|left\|#a1f5e4, #f5f5a1}}">{{next\|[[Naming_video_files/Movies\|'''Naming Movies''']]}} </div>

	{{updated\|17}}		{{updated\|18}}
	[[Category:FAQ]]		[[Category:FAQ]]
	[[Category:Index]]		[[Category:Index]]

Gamester17 at 18:23, 26 October 2018

2018-10-26T18:23:10Z

← Older revision		Revision as of 18:23, 26 October 2018
Line 5:		Line 5:

	= Introduction =		= Introduction =
	<section begin="intro" />{{kodi}} has the ability to display information and artwork for your video collection. As this information and artwork comes from ~~3rd~~ party sites, video files must be placed in a certain folder structure and named correctly so accurate matches can be made with those ~~3rd~~ party sites. This page, and following pages, will instruct on the correct methods to use for the most reliable scraping process.<section end="intro" />		<section begin="intro" />{{kodi}} has the ability to display information and artwork for your video collection. As this information and artwork comes from third-party sites, video files must be placed in a certain folder structure and named correctly so accurate matches can be made with those third-party sites. This page, and following pages, will instruct on the correct methods to use for the most reliable scraping process.<section end="intro" />

	The process of matching and downloading data and artwork to your {{kodi}} library is named '''scraping'''. The sites where we obtain the information from is referred to as the '''information provider site''' (also '''scraper site'''). The wonderful add-on that enables this to occur is called the '''scraper'''.		The process of matching and downloading data and artwork to your {{kodi}} library is named '''scraping'''. The sites where we obtain the information from is referred to as the '''information provider site''' (also '''scraper site'''). The wonderful add-on that enables this to occur is called the '''scraper'''.

	<section begin="know" />Things you should know about scraping:		<section begin="know" />Things you should know about scraping:
	*{{Kodi}} obtains artwork and metadata from ~~3rd~~ party sites that {{kodi}} has no control over. As these sites are outside the control of Kodi, it is important that your video files and folders are named correctly to ensure an accurate match with the listings at the scraper sites.		*{{Kodi}} obtains artwork and metadata from third-party sites that {{kodi}} has no control over. As these sites are outside the control of Kodi, it is important that your video files and folders are named correctly to ensure an accurate match with the listings at the scraper sites.
	*If a movie or TV show does not exist at the scraper site, then {{kodi}} cannot scrape it. Always check the entry at the scraper site.		*If a movie or TV show does not exist at the scraper site, then {{kodi}} cannot scrape it. Always check the entry at the scraper site.
	*{{Kodi}} can also read information from local files known as '''''[[NFO_files\|NFO Files]]'''''.		*{{Kodi}} can also read information from local files known as '''''[[NFO_files\|NFO Files]]'''''.
	*As the information provider sites are maintained by a small volunteer community, which provides this service at no cost, it is strongly encouraged that {{Kodi}} users contribute back to those sites when discovering errors and ~~ommissions~~ in the databases.		*As the information provider sites are maintained by a small volunteer community, which provides this service at no cost, it is strongly encouraged that {{Kodi}} users contribute back to those sites when discovering errors and omissions in the databases.
	*Scraping problems experienced by users are attributable as follows: 95%- Incorrect naming, folder and source structure; 4%- Missing data at the scraper site; 1%- Changes at the scraper site which breaks the scraper add-on.<section end="know" />		*Scraping problems experienced by users are attributable as follows: 95%- Incorrect naming, folder and source structure; 4%- Missing data at the scraper site; 1%- Changes at the scraper site which breaks the scraper add-on.<section end="know" />
	*For a full list of metadata downloaded by the scraper see '''''[[NFO_files\|NFO Files]]'''''		*For a full list of metadata downloaded by the scraper see '''''[[NFO_files\|NFO Files]]'''''

Karellen at 09:18, 6 March 2018

2018-03-06T09:18:20Z

← Older revision		Revision as of 09:18, 6 March 2018
Line 80:		Line 80:
	[[Category:Guides]]		[[Category:Guides]]
	[[Category:Manual]]		[[Category:Manual]]
			[[Category:Karellen]]
	[[Category:Video library]]		[[Category:Video library]]
	[[Category:General topics]]		[[Category:General topics]]
	[[Category:First time user]]		[[Category:First time user]]
	[[Category:Quick Start Guide]]		[[Category:Quick Start Guide]]

Karellen: Add supplemental tools links

2018-02-24T05:48:50Z

Add supplemental tools links

← Older revision		Revision as of 05:48, 24 February 2018
Line 63:		Line 63:

	= Supplemental tools =		= Supplemental tools =
	To help with mass file renaming and organizing, see ~~'''[[supplemental tools]]'''~~ for programs that can help automate these tasks, or do them in bulk.		To help with mass file renaming and organizing, see the following pages for programs that can help automate these tasks, or do them in bulk.
	:'''''See: [[~~Supplemental tools~~]]'''''		:'''''See: [[Rename_tools\|File Renaming Tools]]'''''
			:'''''See: [[Library_managers\|Library Managers]]'''''

Karellen: Add transclusion

2018-02-24T00:00:18Z

Add transclusion

← Older revision		Revision as of 00:00, 24 February 2018
Line 9:		Line 9:
	The process of matching and downloading data and artwork to your {{kodi}} library is named '''scraping'''. The sites where we obtain the information from is referred to as the '''information provider site''' (also '''scraper site'''). The wonderful add-on that enables this to occur is called the '''scraper'''.		The process of matching and downloading data and artwork to your {{kodi}} library is named '''scraping'''. The sites where we obtain the information from is referred to as the '''information provider site''' (also '''scraper site'''). The wonderful add-on that enables this to occur is called the '''scraper'''.

	Things you should know about scraping:		<section begin="know" />Things you should know about scraping:
	*{{Kodi}} obtains artwork and metadata from 3rd party sites that {{kodi}} has no control over. As these sites are outside the control of Kodi, it is important that your video files and folders are named correctly to ensure an accurate match with the listings at the scraper sites.		*{{Kodi}} obtains artwork and metadata from 3rd party sites that {{kodi}} has no control over. As these sites are outside the control of Kodi, it is important that your video files and folders are named correctly to ensure an accurate match with the listings at the scraper sites.
	*If a movie or TV show does not exist at the scraper site, then {{kodi}} cannot scrape it. Always check the entry at the scraper site.		*If a movie or TV show does not exist at the scraper site, then {{kodi}} cannot scrape it. Always check the entry at the scraper site.
	*{{Kodi}} can also read information from local files known as '''''[[NFO_files\|NFO Files]]'''''.		*{{Kodi}} can also read information from local files known as '''''[[NFO_files\|NFO Files]]'''''.
	*As the information provider sites are maintained by a small volunteer community, which provides this service at no cost, it is strongly encouraged that {{Kodi}} users contribute back to those sites when discovering errors and ommissions in the databases.		*As the information provider sites are maintained by a small volunteer community, which provides this service at no cost, it is strongly encouraged that {{Kodi}} users contribute back to those sites when discovering errors and ommissions in the databases.
	*Scraping problems experienced by users are attributable as follows: 95%- Incorrect naming, folder and source structure; 4%- Missing data at the scraper site; 1%- Changes at the scraper site which breaks the scraper add-on.		*Scraping problems experienced by users are attributable as follows: 95%- Incorrect naming, folder and source structure; 4%- Missing data at the scraper site; 1%- Changes at the scraper site which breaks the scraper add-on.<section end="know" />
	*For a full list of metadata downloaded by the scraper see '''''[[NFO_files\|NFO Files]]'''''		*For a full list of metadata downloaded by the scraper see '''''[[NFO_files\|NFO Files]]'''''
	*For a full list of artwork that can be used by {{Kodi}} see '''''[[Artwork\|Artwork]]'''''		*For a full list of artwork that can be used by {{Kodi}} see '''''[[Artwork\|Artwork]]'''''

Karellen at 00:17, 18 January 2018

2018-01-18T00:17:43Z

← Older revision		Revision as of 00:17, 18 January 2018
Line 1:		Line 1:
	{{VideoLibraryCreate}}		{{VideoLibraryCreate}}
	{{mininav\|[[Video library~~]]\|[[Video management\|Management]]\|[[Naming video files~~]]}}		{{mininav\|[[Video library]]}}

Karellen: Page re-written

2018-01-08T22:31:44Z

Page re-written

← Older revision	Revision as of 22:31, 8 January 2018
Line 1:	Line 1:
		{{VideoLibraryCreate}}
		{{mininav\|[[Video library]]\|[[Video management\|Management]]\|[[Naming video files]]}}



		= Introduction =
		<section begin="intro" />{{kodi}} has the ability to display information and artwork for your video collection. As this information and artwork comes from 3rd party sites, video files must be placed in a certain folder structure and named correctly so accurate matches can be made with those 3rd party sites. This page, and following pages, will instruct on the correct methods to use for the most reliable scraping process.<section end="intro" />

		The process of matching and downloading data and artwork to your {{kodi}} library is named '''scraping'''. The sites where we obtain the information from is referred to as the '''information provider site''' (also '''scraper site'''). The wonderful add-on that enables this to occur is called the '''scraper'''.

		Things you should know about scraping:
		*{{Kodi}} obtains artwork and metadata from 3rd party sites that {{kodi}} has no control over. As these sites are outside the control of Kodi, it is important that your video files and folders are named correctly to ensure an accurate match with the listings at the scraper sites.
		*If a movie or TV show does not exist at the scraper site, then {{kodi}} cannot scrape it. Always check the entry at the scraper site.
		*{{Kodi}} can also read information from local files known as '''''[[NFO_files\|NFO Files]]'''''.
		*As the information provider sites are maintained by a small volunteer community, which provides this service at no cost, it is strongly encouraged that {{Kodi}} users contribute back to those sites when discovering errors and ommissions in the databases.
		*Scraping problems experienced by users are attributable as follows: 95%- Incorrect naming, folder and source structure; 4%- Missing data at the scraper site; 1%- Changes at the scraper site which breaks the scraper add-on.
		*For a full list of metadata downloaded by the scraper see '''''[[NFO_files\|NFO Files]]'''''
		*For a full list of artwork that can be used by {{Kodi}} see '''''[[Artwork\|Artwork]]'''''


		The default scraper used by {{kodi}} for '''Movies''' is the TheMovieDB (TMDB). Other scrapers are available and can be found by searching the {{kodi}} site '''''[https://kodi.tv/addons/browse?keyword=&category=1185&author=&sort=title+ASC here]'''''
		:'''''See: [https://www.themoviedb.org/ TheMovieDB]
		:'''''See: [[Add-on:The_Movie_Database\|TheMovieDB Add-on]]
		:'''''See: [[Add-on:Universal_Movie_Scraper\|Universal Movie Scraper Add-on]]


		The default scraper used by {{kodi}} for '''TV Shows''' is the TheTVDB (TVDB). Other scrapers are available and can be found by searching the {{kodi}} site '''''[https://kodi.tv/addons/browse?keyword=&category=1187&author=&sort=title+ASC here]'''''
		:'''''See: [https://www.thetvdb.com/ TheTVDB]
		:'''''See: [[Add-on:The_TVDB\|TheTVDB Add-on]]


		'''{{big\|This is the most important step to ensuring correct scraping.}}'''



		= Source Folder =
		The Source folder is the location that the user specifies for {{kodi}} to search for a class of media. In this case of videos, it is the folder that holds the movie files and TV Shows. These must be separate Sources.

		The Source must be the parent folder that holds the respective movies and TV Shows.

		Notes on naming and setting a '''Source''':
		*There is no limit on the number of Sources that can be used
		*The Source names, which essentially is your folder name, can be anything that makes sense to you. The names should be unique, which makes it easier to navigate to the correct source in {{Kodi}}
		*A single class of media can be placed in one source if you desire, though larger libraries (200 or more videos) do benefit from multiple sources
		*There is no requirement on how to separate videos between Sources. Many users separate based on Genre, alphabetical listing, Video Resolution (DVD, Bluray, 4k) or any method you prefer
		*If you have your video collection on multiple drives, then a Source must exist on each hard drive for each Class of media and added to {{Kodi}}
		*'''Never''' mix media classes. ie, ensure TV Shows, Movies, Music Videos or Music are not in the same source.
		*'''Never''' set the entire hard drive as your Source as this will create multiple ghost entries.



		= Movie Naming & Folder Structure =
		{{#lst:Naming_video_files/Movies\|intro}}
		:'''''See: [[Naming_video_files/Movies\|Naming Movies]]'''''



		= TV Show Naming & Folder Structure =
		{{#lst:Naming_video_files/TV_shows\|intro}}
		:'''''See: [[Naming_video_files/TV_shows\|Naming TV Shows]]'''''



		= Supplemental tools =
		To help with mass file renaming and organizing, see '''[[supplemental tools]]''' for programs that can help automate these tasks, or do them in bulk.
		:'''''See: [[Supplemental tools]]'''''




		{{top}}

		<div style="{{linear-gradient\|left\|#a1f5e4, #f5f5a1}}">{{next\|[[Naming_video_files/Movies\|'''Naming Movies''']]}} </div>

		{{updated\|17}}
		[[Category:FAQ]]
		[[Category:Index]]
		[[Category:How-to]]
		[[Category:Guides]]
		[[Category:Manual]]
		[[Category:Video library]]
		[[Category:General topics]]
		[[Category:First time user]]
		[[Category:Quick Start Guide]]