User:Karellen/scratchpad: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
← Older editNewer edit →
TV Show Naming
TV Show Naming Cleared
Line 1: Line 1:
{{VideoLibraryCreate}}
{{mininav|[[Video library]]|[[Video management|Management]]|[[Naming video files]]}}


= Introduction =
<section begin="intro" />Setting up TV Shows correctly is a little bit more involved than the Movies section, but not more difficult. This page will describe the '''{{Kodi}} recommended method''' to name TV Shows and Episode files and to create the folder structure to save them in. These methods are proven to be the simplest, most accurate and robust methods which provide the most accurate scrape.<section end="intro" />
Any allowable variances to the recommended method will be mentioned (but not displayed in the images) throughout the page.
= TheTVDB =
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]]
The TVDB scraper has three possible settings for determining episode order: '''Aired order, DVD order''', and '''Absolute order'''. These will affect how you name and number your files.
;Aired Order
*TVDB lists all TV shows in the original '''Aired Order'''. The first time a show is ever broadcast, that is the listing shown. The site is not concerned with how it was broadcast the 2nd, 3rd or 15th time, or how it was broadcast in other countries, or during syndication. It only lists the order of the FIRST TIME ever broadcast, whether that be on Free To Air or Subscription Television.
*Episodes are grouped and listed into Seasons and each episode is numbered sequentially from 1, which resets for each season.
;DVD Order
*In many cases, DVD's are released with a different episode listing, normally being the original order envisioned by the Director. To accomodate this, the site also has a '''DVD Order''' listing.
*Episodes are grouped and listed into Seasons and each episode is numbered sequentially from 1, which resets for each season.
*The first listing (the default listing) displayed by TVDB is '''Aired Order'''. If scraping by DVD Order (which is set in the scraper settings), the view listing in TVDB must be changed from Aired Order to DVD Order. At the bottom of the episode list, are the following links. Click on DVD Order, and the screen will refresh with the DVD Order listing.
:{| class="prettytable"
|-
! scope="row" ! style="width:400px; background-color:#b6d316; text-align:left;"| Previous Season | Next Season | Aired Order | DVD Order
|}
*There are many TV Shows on the TVDB site that do not have the DVD Order data entered. If this is the case, it is a simple matter to create an account and complete the listing. The scraper will default back to Aired Order if there is no DVD Order information listed.
;Absolute Order
*A third Order option exists. The '''Absolute Order'''. This order ignores Seasons and gives each episode an incremental number starting at 1. This order is used for Anime type shows.
To ensure you are using the correct TV Show title follow this simple guideline.
*The use of the '''(Year)''' in the title works differently for TV Shows. In TV Shows, the '''(Year)''' is only used when it is shown in the title at the scraper site. See the two images below.
*This guideline also applies to Country of Origin TV Shows. For example Hells Kitchen (UK), Hells Kitchen (US), Hells Kitchen (AU), Hells Kitchen (IT) etc. What you see on TVDB is how you should name your show.
<gallery widths=500px heights=250px>
File:TVDB1.JPG|Image 1- No (Year) is displayed. Enter the TV Show name as shown without the year
File:TVDB2.JPG|Image 2- (Year) is displayed. Enter the TV Show name with the year.
</gallery>
= TV Show Folder =
[[File:Video-TVShow Folder.png|500px|right]]
'''Each TV Show requires its own folder''' as the Show Title is extracted from the folder name for a match with with the Information Provider site. For this reason, {{Kodi}} '''cannot''' support the flat folder structure for TV Shows where all episodes from different TV Shows are in the same folder.
The TV Show folders are located inside the '''''[[Naming_video_files#Source_Folder|Source folder]]''''', explained in the previous page.
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. The examples on this page use a ''Space'' as the seperator. Note also the issue with Split-episodes regarding file names with periods, discussed later.
== Recommended ==
The '''Kodi Recommended Method''' is detailed in the image to the right. It has proven to be the simplest, most accurate and reliable method.
The image to the right displays the simplest folder structure and naming convention. The following, commonly used formats, are shown as examples
*Single File episodes (Angel),
*DVD folders (Battlestar Galactica)
*Bluray folders (Battlestar Galactica (2003))
{{-}}
== Other ==
'''{{red|These other methods are available but NOT recommended. The sub-folders are easily mistaken and scraped as false TV shows. While it is possible to find and fix the ghost entries, the extra time and work involved will override any possible benefits. If you need to re-build your library at a later stage, the problems will need to be solved again.}}'''
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
:{| class="prettytable" style="width:500px; background-color:#a1f5e4; text-align:left;"
|
<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 is 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
:{| class="prettytable" style="width:500px; background-color:#a1f5e4; text-align:left;"
|
<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.
= Season Folder =
Season folders can be added to the TV Show and all episodes sorted into their respective Season folder.
Even though {{kodi}} can accommodate the Season folder, it will ignore them. Instead it looks for the correctly numbered episode files.
= Episode Files =
All Episode files must be named correctly for the Kodi scraper to match the correct episode at the scraper site.
Kodi uses a series of regular expressions to determine the season and episode numbers from the file name. These are checked in a pre-determined order with the first match being the one used and everything else in the file name is ignored.
There are 8 default patterns, plus a separate multi-episode pattern. Using any other numbering convention will require you to edit your advancedsettings.xml to insert your custom RegEx.
Spaces, periods, or underscores may be used to separate words in the folder and file names, but shouldn't be mixed in the same name. The regex is not case-sensitive and either uppercase or lowercase may be used. The examples on this page use uppercase.
In the examples the following format will be used to demonstrate the naming conventions and regex patterns:
:{| class="prettytable"
|-
! scope="row" ! style="width:300px; background-color:#a1f5e4; text-align:left;"| name <<pattern>>.ext
|}
where:
*'''name''' is the title of the show and is optional. It could just as easily be after the pattern, or excluded entirely.
*'''<<pattern>>''' is one of the expressions in the following tables and
*'''.ext''' is a recognized video file extension, (mkv, avi, ts, mp4, etc) or ommitted entirely if using DVD or Bluray folders. (see image above)
Any format will work, so long as the pattern is included somewhere in it.
It is also important to note that Season Numbers may not be basic numbers. Many shows use the '''Year''' as the Season number. This is quite common with older shows and also daytime soaps and talk shows. '''Always check the site'''
<gallery widths=500px heights=100px>
File:TVDB03.JPG|Image 1- Extract from TVDB showing '''Year''' as the Season Number
File:TVDB04.JPG|Image 2- Extract from TVDB showing standard Season Numbers
</gallery>
== Special Episodes ==
Special Episdes are episodes that don't fit into the normal storyline of the TV Show. They may include items such as:
*Christmas Specials,
*Season recap episodes
*Made for TV Movies that extend the storyline
*Unaired Pilots
'''All Special Episodes use Season 00''' eg:
:{| class="prettytable"
|-
! scope="row" ! style="width:300px; background-color:#a1f5e4; text-align:left;"| Doctor Who (2005) S00E50
|}
Check the site of the information provider to confirm your files are in the same order as the listing at the scraper site. If not, images and metadata will not match your files.
== Single Episodes ==
Most files should contain a single episode. This is the easist and most flexible method.
The following table lists:
*The pattern that {{kodi}} will search for.
*The order of the search. ie. Patterns numbered '''1''' will be matched first and those numbered '''7''' will be matched last.
;With Season
:The most common scenario
;No 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.
;By date
:Common for long-running daily shows, allows the use of aired date of the episode.
{| class="prettytable"
|-
! colspan="2" style="background-color:#a1f5e4;" | With Season
! colspan="2" style="background-color:#a1f5e4;" | No Season
! colspan="2" style="background-color:#a1f5e4;" | By Date
|+
! style="background-color:#f5f5a1;" | Order
! style="background-color:#f5f5a1; width:200px" | Episode Naming
! style="background-color:#f5f5a1;" | Order
! style="background-color:#f5f5a1; width:200px" | Episode Naming
! style="background-color:#f5f5a1;" | Order
! style="background-color:#f5f5a1; width:200px" | Episode Naming
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:left;"|''Name'' '''S01E02'''.ext
|style="width:50px; text-align:center;"|2
|style="width:50px; text-align:left;"|''Name'' '''ep02'''.ext
|style="width:50px; text-align:center;"|3
|style="width:50px; text-align:left;"|''Name'' '''yyyy.mm.dd'''.ext
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:left;"|''Name'' '''S1E2'''.ext
|style="width:50px; text-align:center;"|2
|style="width:50px; text-align:left;"|''Name'' '''ep_02'''.ext
|style="width:50px; text-align:center;"|3
|style="width:50px; text-align:left;"|''Name'' '''yyyy-mm-dd'''.ext
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:left;"|''Name'' '''S01.E02'''.ext
|style="width:50px; text-align:center;"|7
|style="width:50px; text-align:left;"|''Name'' '''part.II'''.ext
|style="width:50px; text-align:center;"|4
|style="width:50px; text-align:left;"|''Name'' '''dd.mm.yyyy'''.ext
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:left;"|''Name'' '''S01_E02'''.ext
|style="width:50px; text-align:center;"|7
|style="width:50px; text-align:left;"|''Name'' '''pt.II'''.ext
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:left;"|
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:left;"|''Name'' '''S01xE02'''.ext
|style="width:50px; text-align:center;"|7
|style="width:50px; text-align:left;"|''Name'' '''pt_II'''.ext
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:left;"|
|-
|style="width:50px; text-align:center;"|5
|style="width:50px; text-align:left;"|''Name'' '''1x02'''.ext
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:left;"|
|-
|style="width:50px; text-align:center;"|6
|style="width:50px; text-align:left;"|''Name'' '''102'''.ext
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|}
----
'''{{big|{{red|The remainder of this page deals with Special Use cases and can be safely ignored. Most libraries will not require implementing the following additional name extensions.}}}}'''
----
== Multi-Episodes ==
In cases where the file contains more than one episode, it is possible to specify all the episodes included in that file. Everything after the first found pattern match will be checked for further matches to the same pattern.
When using a single video file for multiple episodes it is possible to tell Kodi when each episode starts using '''''[[bookmarks|Episode Bookmarks]]'''''
Two versions are shown- Long version and Short version. Only the episodes in the file name will be added, e.g. ''name''.'''s01e01-03'''.ext will not include episode 2.}
Using the patterns from the previous section, they have been extended to include multiple episodes. The Order has been ommitted.
:'''''See also: [[Userdata/advancedsettings.xml#.3Ctvmultipartmatching.3E|multi-episode pattern]]'''''
{| class="prettytable"
|-
! colspan="2" style="background-color:#a1f5e4;" | Complex Pattern
! colspan="2" style="background-color:#a1f5e4;" | Short Pattern
|+
! style="background-color:#f5f5a1;" | Order
! style="background-color:#f5f5a1; width:350px" | Example Name
! style="background-color:#f5f5a1;" | Order
! style="background-color:#f5f5a1; width:200px" | Example Name
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''s01e01'''-'''s01e02'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|''name'' '''s01e01e02'''.ext
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''s01e01'''-''episode1.title''-'''s01e02'''-''episode2.title''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|''name'' '''s01e01-02-03'''.ext
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''s01e01'''-'''s01e02'''-'''s01e03'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|''name'' '''1x01x02'''.ext
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''1x01'''-'''1x02'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|''name'' '''ep01-02'''.ext
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''ep01'''-'''ep02'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|
|}
== Split Episodes ==
Split-episodes are feature length episodes that were broadcast as two separate episodes. The Pilot episode can be a feature length episode for many TV Shows. These are re-combined on DVD releases as the original single episode. They are numbered by decimal sub parts eg S01E01.1, S01E01.2, S01E02 '''This is a common cause for failed scrapes of certain episodes'''. The entry must be checked at TVDB to ensure correct numbering has been applied. It is also 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.
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.
Using the patterns from the Single Episodes section, they have been extended to include Split episodes. The Order has been ommitted.
{| class="prettytable"
|-
! colspan="2" style="background-color:#a1f5e4;" | Single Episodes
! colspan="2" style="background-color:#a1f5e4;" | Multi Part Episodes
|+
! style="background-color:#f5f5a1;" | Order
! style="background-color:#f5f5a1; width:350px" | Example Name
! style="background-color:#f5f5a1;" | Order
! style="background-color:#f5f5a1; width:200px" | Example Name
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''s01e01.1'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|''name'' '''s01e01.1.s01e01.2'''.ext
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''s01e01a'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|''name'' '''1x01.1-x01.2'''.ext
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''1x01.1'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|''name'' '''ep01a-01b'''.ext
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''1x01a'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''ep01.1'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|
|-
|style="width:50px; text-align:center;"|
|style="width:300px; text-align:left;"|''name'' '''101.1'''.ext
|style="width:50px; text-align:center;"|
|style="width:150px; text-align:left;"|
|}
Each part will be added to the library just with its full episode number, the sub-part will not be displayed.
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. 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.
= Media Tags / Flags =
{{main|Media flags}}
[[File:480.png|50px]] [[File:1080.png|50px]] [[File:720.png|50px]] [[File:1080 n.png|50px]] [[File:480-1.png|50px]]
[[File:Divx.png|80px]] [[File:Xvid.png|80px]] [[File:H264.png|80px]] [[File:Bluray.png|80px]] [[File:Dvd.png|80px]] [[File:Avc1.png|80px]]
[[File:1.33.png|50px]] [[File:1.66.png|50px]] [[File:2.20.png|50px]] [[File:2.35.png|50px]]
Media flags are icons in Kodi that displays the meta-information from the media file of a movie, TV show or music title. They are skin specific, and what works in one skin, may not work in another skin. It is always best to check with the skin sub-forum which flags and tags are used.
'''It is important to note that the skin will display these flags even when these extensions are not used.''' The only difference being that without the extensions, the movie must be played first in order for {{kodi}} to read the audio and video codec data.
'''The actual audio and video codec data will override any extension used.''' This means that if you set the extension of, say, '''.ATMOS''' but the video file only has a stereo track, then the '''.ATMOS''' flag will be removed.
Example- note that movie folders are used, and the folder is simply named while the filename has been modified with extensions.
{| class="prettytable"
|-
! scope="row" ! style="width:400px; background-color:#a1f5e4; text-align:left;"| ...\Paul (2011)\Paul (2011).4K.HDR.Atmos.mkv
|}
== 3D Episodes ==
{{Main|3D}}
Some 3D episodes might need an additional file name extension to be identified by Kodi as 3D. See '''''[[3D]]''''' for details on that additional extension, and when it is needed.
= Custom Filenames =
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 using <code>action="prepend"</code>, or after using <code>action="append"</code>.  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_Episodes|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.
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
:{| class="prettytable" style="width:900px; background-color:#a1f5e4; text-align:left;"
|-
|
<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#]
:{| class="prettytable" style="width:900px; background-color:#a1f5e4; text-align:left;"
|-
|
<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
:{| class="prettytable" style="width:900px; background-color:#a1f5e4; text-align:left;"
|-
|
<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#]
:{| class="prettytable" style="width:900px; background-color:#a1f5e4; text-align:left;"
|-
|
<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
:{| class="prettytable" style="width:900px; background-color:#a1f5e4; text-align:left;"
|-
|
<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
:{| class="prettytable" style="width:900px; background-color:#a1f5e4; text-align:left;"
|-
|
<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
:{| class="prettytable" style="width:900px; background-color:#a1f5e4; text-align:left;"
|-
|
<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:
:{| class="prettytable" style="width:900px; background-color:#a1f5e4; text-align:left;"
|-
|
<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
:{| class="prettytable" style="width:900px; background-color:#a1f5e4; text-align:left;"
|-
|
<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.
= advancedsettings.xml =
{{main|advancedsettings.xml}}
The following settings allow user customisation for TV Show and Episode matching.
* [[advancedsettings.xml#tvshowmatching|<tvshowmatching>]]
* [[advancedsettings.xml#tvmultipartmatching|<tvmultipartmatching>]]
* [[advancedsettings.xml#excludetvshowsfromscan|<excludetvshowsfromscan>]]
* [[advancedsettings.xml#cleanstrings|<cleanstrings>]]
* [[advancedsettings.xml#videoextensions|<videoextensions>]]
* [[advancedsettings.xml#discstubextensions|<discstubextensions>]]
{{top}}
<div style="{{linear-gradient|left|#a1f5e4, #f5f5a1}}">{{next|[[Naming_video_files/Video_File_Tagging|'''Video File Tagging''']]}} </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]]

Revision as of 03:12, 14 January 2018

Retrieved from "https://kodi.wiki/index.php?title=User:Karellen/scratchpad&oldid=132371"