>Sho |
|
| (193 intermediate revisions by 26 users not shown) |
| Line 1: |
Line 1: |
| {{XBMC wiki toc Inline}} | | {{VideoLibraryCreate}} |
| __NOEDITSECTION__
| | {{mininav| [[Video library]] |[[HOW-TO:Create_Video_Library|Create Video Library]] }} |
|
| |
|
| XBMC has had the ability to lookup meta data and present information on TV Shows in the [[Video Library]].
| |
|
| |
|
| == TV Show support in XBMC == | | = Introduction = |
| {|
| | There are two components to TV Shows that need to be accurate for a successful scrape: |
| | valign="top" |
| | # Correct '''naming''' of the TV Show |
| TV show support is through new [[How To use Scrapers|scrapers]] and requires a connection to the internet. | | # Correct '''numbering''' of the Episodes |
| The information gathered is stored locally in the [[Video Library]] so that it is available when you are offline. The scrapers scan your TV shows and retrieve the information about them from sites like [http://TheTVDB.com TheTVDB.com] (which is the default) and [http://www.tv.com TV.com].<br>
| |
|
| |
|
| '''Note!''' you can refresh the main TV show information without rescanning all episode information by selecting ''refresh'' from the information screen and say no to the 'refresh information for all episodes' question.
| | {{note|This page details the TV Show folder. Season folders and episodes are discussed in the following pages.}} |
| |
| |
| [[image:Tv.shows.jpg|right|360px]]
| |
| |}
| |
|
| |
|
| == TV Show files naming conventions == | | = TV Show Folders = |
| The TV Show lookup scraper relies on the following naming conventions in order to work as intended.
| | {| |
| | ! scope="row" colspan="10" style="width:300px; background-color:#; text-align:left;"| |
| | ! scope="row" ! | |
| | |- |
| | | style="background-color:#;"| [[File:Video-TVShow Folder.png|left|400px|Image 1- TV Show folders]] || style="background-color:#;"| |
| | '''{{resize|1.3em|{{red|Each TV Show requires its own folder in the Source folder}} }}''' |
|
| |
|
| === Directory Structure and File Names ===
| | The naming of your TV Show folder is '''critical''' to ensure the scrapers can correctly identify the TV Show and its episodes. |
| Each TV show needs to be in its own folder for XBMC to be able to scan it into the library.
| |
| The file names for TV shows have to be matched by the regular expressions set in [[advancedsettings.xml#.3Ctvshowmatching.3E|tvshowmatching]].
| |
|
| |
|
| {|
| | '''''TV Show Name (Year)''''' - This is the correct naming format for the TV Show folder |
| |
| |
| [[image:Wide1.jpg|360px]]
| |
| | valign="top" |
| |
| '''Directory layout example:''' | |
| <pre>
| |
| TV Shows
| |
| |----TV Show 1
| |
| | |___ TV Show 1 Media files
| |
| |
| |
| |----TV Show 2
| |
| | |___ TV Show 2 Media files
| |
| |
| |
| ----TV Show 3
| |
| |___ TV Show 3 Media files
| |
| </pre>
| |
|
| |
|
| Where [[Set_Content_(Video_Library)|Content is Set]] on the top level "''TV Shows''" folder. You can have different seasons in different season subfolders under the individual TV Show folders if it suits you. XBMC does not use them, but they do not cause issues either.
| | * The TV Show folders are saved inside the '''''[[Source_folder|Source folder]]''''' |
| | * Adding the (Year) makes scraping more accurate and differentiates between original and remake versions. |
| | * For '''Country of Origin''' TV Shows, the (Year) is replaced with the country code. eg ''Hells Kitchen (UK), Hells Kitchen (US), Hells Kitchen (AU)'' etc. |
| | * '''The title and (year) displayed at the scraper site is how you should name your show.''' |
| | <br> |
| | <br> |
| | '''Note:''' If you are unsure of the name or year, then check which scraper you are using and visit the appropriate site for correct naming: |
| | * '''''[https://www.themoviedb.org/ TheMovieDB]''''' - ''(the default scraper)'' |
| | * '''''[https://www.thetvdb.com/ TVDB]''''' |
| | * '''''[https://www.tvmaze.com/ TV Maze]''''' |
| | |- |
| | ! scope="row" colspan="10" style="width:300px; background-color:#; text-align:left;"| |
| |} | | |} |
|
| |
|
| ;The defaults will match the following structures/file name formats
| |
| :foo.s01e01.*
| |
| :foo.s01.e01.*
| |
| :foo.s01_e01.*
| |
| :foo_[s01]_[e01]_*
| |
| :foo.1x01.*
| |
| :foo.101.*
| |
|
| |
| ;Defaults for two-part TV Show Episode will match:
| |
| :foo.s01e01-02.*
| |
| :foo_[s01]_[e01-02]_*
| |
| :foo.1x01.1x02.*
| |
|
| |
| ;Same with three- or four-part TV Show Episode:
| |
| :foo.s01e01-02-03-04.*
| |
| :foo_[s01]_[e01-02-03-04]_*
| |
| :foo.1x01.1x02.1x03.1x04.*
| |
|
| |
| Where foo can be anything (including nothing).
| |
|
| |
| ===Multi-part Episodes===
| |
| Handling of multi-part episodes (two part episodes in one file, multiple episodes in DVD images, etc.) is supported. The first matched tvshowmatching regexp and "[-EeXx]+([0-9]+)" will be repeatedly applied against a file name until no more seasons or episodes are found.
| |
| ;This allows for file names such as:
| |
| :foo_s01e01e02e03_s02e01e02
| |
| :foo104-05-06-201-02
| |
| :foo1x07x08x09
| |
|
| |
| ===Multi-file Episodes===
| |
| '''This feature has been temporarily disabled, the plan is to implement it in a better fashion at a future date.'''<br>
| |
| You can stack multiple files into one episode.
| |
| For that to be available the [[Videos_Settings#Library|Stack Duplicate TV Shows]] Video Library setting needs to be enabled.
| |
| All the files must have the same season and episode number and they all have to be in the same folder. (This is to prevent unwanted stacking of true duplicates in different folders). The items will be automatically stacked in sequential order based off the filenames being sorted in a "natural" order (like this: -part1.avi, -part2.avi, ..., -part10.avi.)
| |
|
| |
| ===TV Show Specials===
| |
| Special episodes are currently supported with [[TheTVDB.com (Video Library)|TheTVDB.com]] scraper. In order for the XBMC scraper regular expressions to recognize them, they should be part of season 0. (Specials naming order can be observed in the Specials Season of the relevant TV show at [http://TheTVDB.com TheTVDB.com]).
| |
| ;Example
| |
| :[http://thetvdb.com/?tab=season&seriesid=76736&seasonid=24194&lid=7 Black Adder's Christmas Carol] should have a file name that matches season 0 episode 2 (e.g. contain s00e02).
| |
|
| |
| ==Troubleshooting TV Shows lookups==
| |
| ===The scraper picks the wrong TV Show===
| |
| You can influence the search by having [[Import_-_Export_Library#Video_nfo_Files|nfo]] files alongside your media
| |
|
| |
| You can also try adding the year within parentheses to the end of the TV Show folder-name. (Note the showname on the selected site to be scraped must then include the year).
| |
| This might be need for some TV Shows such as "Battlestar Galactica", "Doctor Who", "Jericho", and "Knight Rider" which will have multiple entries on a given TV metadata database because of remakes of the original show.
| |
|
| |
| See the examples below:
| |
|
| |
| \TV Shows\Battlestar Galactica\Season 1\Battlestar Galactica - S01E01.avi (TheTVDB omits the year from the original shows)
| |
| \TV Shows\Battlestar Galactica (2003)\Season 1\Battlestar Galactica - S01E01.avi (Remakes will include year at theTVDB.com)
| |
| \TV Shows\Cupid (1998)\Season 1\Cupid - S01E01.avi
| |
| \TV Shows\Cupid (2003)\Season 1\Cupid - S01E01.avi
| |
| \TV Shows\Cupid (2009)\Season 1\Cupid - S01E01.avi
| |
| \TV Shows\Doctor Who (1963)\Season 1\Doctor Who - S01E01.avi
| |
| \TV Shows\Doctor Who (2005)\Season 1\Doctor Who - S01E01.avi
| |
| \TV Shows\Jericho (1995)\Season 1\Jericho - S01E01.avi
| |
| \TV Shows\Jericho (2006)\Season 1\Jericho - S01E01.avi
| |
| \TV Shows\Knight Rider (1982)\Season 1\Knight Rider - S01E01.avi
| |
| \TV Shows\Knight Rider (2008)\Season 1\Knight Rider - S01E01.avi
| |
|
| |
| Note! "AVI" is just an example as the same applies to all video formats that XBMC support.
| |
|
| |
| === Custom Directory Structure & File Names ===
| |
| You can make your own naming conventions / rules by adding or editing regular expressions in the [[advancedsettings.xml]] file, with the [[advancedsettings.xml#.3Ctvshowmatching.3E|tvshowmatching]] tag. When enumerating episodes for a series, XBMC '''only''' cares about the season and episode, so when designing regexps you should '''only''' be concerned with these things.
| |
|
| |
|
| Here are several common naming schemes and corresponding regexps and examples.
| |
|
| |
|
| '''\Season #\##''' (Season# is at very end of directory name, and filename starts with episode name, neither have to be a specific number of digits) :
| | == Split folders == |
| <xml>
| | Split folders are TV Shows that have episodes split between two or more folders located in different Sources.<br> |
| <tvshowmatching>
| | This may occur when a long running show is progressively saved on one drive but, over time, the drive has been filled with other content, forcing you to save new episodes on another drive. |
| <regexp>Season[\._ ]([0-9]+)[\\/]([0-9]+)[^\\/]*</regexp>
| |
| </tvshowmatching>
| |
| </xml>
| |
| '''Example''' : \Battlestar Galactica\Season 3\01 - Occupation.avi (Season 3, Episode 1)
| |
|
| |
|
| | To ensure these split TV Shows are correctly scraped as the same show, you '''must''' ensure that the TV Show folder names are identical. A slight variance could see a different show scraped for the second folder. |
|
| |
|
| '''###''' ([season#][episode#] with nothing in between all in filename, assumes episode number is always 2 digits) :
| | If using NFO Files, copy the NFO file from one location into the other split folders. |
| <xml>
| |
| <tvshowmatching>
| |
| <regexp>([0-9]+)([0-9][0-9])[^\\/]*</regexp>
| |
| </tvshowmatching>
| |
| </xml>
| |
| '''Example''' : \24\Season 6\601 - 6:00am to 7:00am.avi (Season 6, Episode 1)<br>
| |
| '''Example 2''' : \Lost\Season 1\Lost - 101.avi (Season 1, Episode 1)<br>
| |
| '''Example 3''' : \24\601 - 6:00am to 7:00am.avi (Season 6, Episode 1)
| |
|
| |
|
|
| |
|
| '''##x##''' ([season#]x[episode#] all in filename :
| |
| <xml>
| |
| <tvshowmatching>
| |
| <regexp>([0-9]+)x([0-9]+)[^\\/]*</regexp>
| |
| </tvshowmatching>
| |
| </xml>
| |
| '''Example''' : \Scrubs\Season 1\1x01.Pilot.avi (Season 1, Episode 1)
| |
|
| |
|
| If you use leading 0's (for example, \Scrubs\01x01 - Pilot.avi instead of 1x1), and are having difficulty getting the TV Show scraper to work, try
| |
|
| |
|
| '''##x##''' ([season#]x[episode#] all in filename : | | <center> |
| <xml>
| | {| style="border: 1px solid black;" |
| <tvshowmatching>
| | | scope="row" rowspan="2" style=" text-align:center;" | [[File:Mergefrom.gif|60px|link=Naming_video_files/Movies]] |
| <regexp>[0]*([0-9]+)x[0]*([0-9]+)[^\\/]*</regexp>
| | | style="width:200px; text-align:center;" | '''Previous step''' |
| </tvshowmatching>
| | | style="width:200px; text-align:center;" | '''Next step''' |
| </xml>
| | | scope="row" rowspan="2" style=" text-align:center;" | [[File:Merge-arrow.gif|60px|link=Naming_video_files/Seasons]] |
| '''Example''' : \Scrubs\Season 1\01x01.Pilot.avi (Season 1, Episode 1) | | |- |
| which simply strips leading 0's from the result.
| | | style="width:200px; text-align:center;" | '''[[Naming_video_files/Movies|Movie Setup]]''' |
| | | style="width:200px; text-align:center;" | '''[[Naming_video_files/Seasons|Seasons Setup]]''' |
| | |}</center> |
|
| |
|
| '''s##e##''' (s[season#]e[episode#] at beginning of filename)
| |
| <xml>
| |
| <tvshowmatching>
| |
| <regexp>[\\/]s([0-9]+)e([0-9]+)</regexp>
| |
| </tvshowmatching>
| |
| </xml>
| |
| '''Example''' : videos\mytv-comedy\Scrubs\season 1\s01e01 - Pilot (hdtv.xvid).avi
| |
|
| |
|
| '''Season ## - Episode ##''' (Season [season#] - Episode [episode#] in the beginning or middle of filename)
| |
| <xml>
| |
| <tvshowmatching>
| |
| <regexp>Season ([0-9]+) - Episode ([0-9]+)[^\\/]*</regexp>
| |
| </tvshowmatching>
| |
| </xml>
| |
| '''Example''' : TV Shows\Scrubs\Season 1\Scrubs - Season 1 - Episode 01 - Pilot.avi
| |
|
| |
|
| == See Also ==
| | {{top}} |
| * [[Set Content (Video Library)|HOW-To set content on a source for the video library lookups]]
| | {{updated|20}} |
| * [[Video Library|The XBMC Video Library (database)]]
| |
| * [[TheTVDB.com_(Video_Library)|The TVDB.com Lookup Scraper]]
| |
| * [[IMDb (Video Library)|IMDb Movie Lookup Scraper]]
| |
| * http://forum.xbmc.org/showthread.php?t=25349
| |
| * [[Regular Expression (RegEx) Tutorial]]
| |
|
| |
|
| [[category:Scraper]] | | [[Category:Guides]] |
| [[category:Library]] | | [[Category:Karellen]] |
| [[category:Video Library]] | | [[Category:Video library]] |
| | [[Category:First time user]] |
Video library
