Naming video files/Episodes: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Created page with "{{VideoLibraryCreate}} {{mininav| Video library |Create Video Library }} __TOC__ = Introduction = Be aware of the following: * The only...")
 
(TVDB Flexible Orders)
(8 intermediate revisions by 2 users not shown)
Line 12: Line 12:
* Contrary to advice from 3rd party internet guides, you cannot set season and episode numbering through NFO Files.
* Contrary to advice from 3rd party internet guides, you cannot set season and episode numbering through NFO Files.


'''Check the site of the information provider to confirm your episode files are in the correct order as listed at the scraper site.'''
'''Do not refer to IMDB for episode orders. There is no IMDB Scraper.'''<br>
'''If you are using the default scraper then the site to check is [https://www.themoviedb.org/ TMDB]. If you have changed to [https://www.thetvdb.com/ TVDB] or [https://www.tvmaze.com/ TV Maze], check the appropriate site.'''




Line 43: Line 44:
{|class="{{{1|prettytable}}}" style="margin: 0.5em 2.0em 0.5em 0em; font-size: 0.80em; {{border-radius|5px}}; float: top; clear: top;" width="500"
{|class="{{{1|prettytable}}}" style="margin: 0.5em 2.0em 0.5em 0em; font-size: 0.80em; {{border-radius|5px}}; float: top; clear: top;" width="500"
|-
|-
! colspan="2" style="background-color:#a1f5e4;" | With Season
! colspan="2" style="background-color:#;" | With Season
! colspan="2" style="background-color:#a1f5e4;" | No Season
! colspan="2" style="background-color:#;" | No Season
! colspan="2" style="background-color:#a1f5e4;" | By Date
! colspan="2" style="background-color:#;" | By Date
! colspan="2" style="background-color:#;" | By Title
|+
|+
! style="background-color:#f5f5a1;" | Order
! style="background-color:#;" | Order
! style="background-color:#f5f5a1; width:200px" | Episode Naming
! style="background-color:#; width:200px" | Episode Naming
! style="background-color:#f5f5a1;" | Order
! style="background-color:#;" | Order
! style="background-color:#f5f5a1; width:200px" | Episode Naming
! style="background-color:#; width:200px" | Episode Naming
! style="background-color:#f5f5a1;" | Order
! style="background-color:#;" | Order
! style="background-color:#f5f5a1; width:200px" | Episode Naming
! style="background-color:#; width:200px" | Episode Naming
! style="background-color:#;" | Order
! style="background-color:#; width:200px" | Episode Naming
|-
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:center;"|1
Line 60: Line 64:
|style="width:50px; text-align:center;"|3
|style="width:50px; text-align:center;"|3
|style="width:50px; text-align:left;"|''Name'' '''yyyy.mm.dd'''.ext
|style="width:50px; text-align:left;"|''Name'' '''yyyy.mm.dd'''.ext
|style="width:50px; text-align:center;"|7
|style="width:50px; text-align:left;"|'''Name'''.''special''.ext
|-
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:center;"|1
Line 67: Line 73:
|style="width:50px; text-align:center;"|3
|style="width:50px; text-align:center;"|3
|style="width:50px; text-align:left;"|''Name'' '''yyyy-mm-dd'''.ext
|style="width:50px; text-align:left;"|''Name'' '''yyyy-mm-dd'''.ext
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|-
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:center;"|1
Line 74: Line 82:
|style="width:50px; text-align:center;"|4
|style="width:50px; text-align:center;"|4
|style="width:50px; text-align:left;"|''Name'' '''dd.mm.yyyy'''.ext
|style="width:50px; text-align:left;"|''Name'' '''dd.mm.yyyy'''.ext
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|-
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:center;"|1
Line 80: Line 90:
|style="width:50px; text-align:left;"|''Name'' '''pt.II'''.ext
|style="width:50px; text-align:left;"|''Name'' '''pt.II'''.ext
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|-
|-
Line 87: Line 99:
|style="width:50px; text-align:left;"|''Name'' '''pt_II'''.ext
|style="width:50px; text-align:left;"|''Name'' '''pt_II'''.ext
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|-
|-
Line 94: Line 108:
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:center;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
|-
|-
|style="width:50px; text-align:center;"|6
|style="width:50px; text-align:center;"|6
|style="width:50px; text-align:left;"|''Name'' '''102'''.ext
|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;"|
|style="width:50px; text-align:left;"|
|style="width:50px; text-align:left;"|
Line 110: Line 128:
;By date
;By date
:Used for long-running daily shows. Check the scraper site for numbering method used.
:Used for long-running daily shows. Check the scraper site for numbering method used.
;By title (added in v.20 "Nexus")
:Used for special episodes in case if a data provider does not support "zero season" convention for specials, e.g. TVmaze. It allows to match special episodes by their titles.
|}
|}


Line 115: Line 135:


= Multi-Episode Files =
= Multi-Episode Files =
If you video files contain two or more episodes, then the following naming is required to scan multiple episodes from a single file.
{| class="prettytable"
|-
| scope="row" colspan="2" style="text-align:center; background-color:#a1f5e4;" | '''Minimum required episode name:''' || ! scope="row" colspan="1"  style="width:10px; background-color:#d3d3d5; text-align:center;"|  || scope="row" colspan="2" style="text-align:center; background-color:#a1f5e4;" | '''Recommended episode name:'''
|-
! scope="row" colspan="2"  style="width:400px; background-color:#f5f5a1; text-align:center;"|''S01E01E02E04.mkv''
! scope="row" colspan="1"  style="width:10px; background-color:#d3d3d5; text-align:center;"|
! scope="row" colspan="2"  style="width:400px; background-color:#f5f5a1; text-align:center;"| ''Angel (1999) S01E01E02E04.mkv''
|-
|Where:
|'''''S01E01E02E04''''' = Season 1, Episode 1, 2 & 4 || ! scope="row" colspan="1"  style="width:10px; background-color:#d3d3d5; text-align:center;"| ||Where: ||'''''Angel (1999)''''' = TV Show name
|-
|
| ''Note that Episode 3 is not included'' || ! scope="row" colspan="1"  style="width:10px; background-color:#d3d3d5; text-align:center;"|  || || '''''S01E01E02E04''''' = Season 1, Episode 1, 2 & 4
|}


{|
{|
Line 121: Line 157:
{|class="{{{1|prettytable}}}" style="margin: 0.5em 2.0em 0.5em 0em; font-size: 0.80em; {{border-radius|5px}}; float: top; clear: top;" width="500"
{|class="{{{1|prettytable}}}" style="margin: 0.5em 2.0em 0.5em 0em; font-size: 0.80em; {{border-radius|5px}}; float: top; clear: top;" width="500"
|-
|-
! colspan="2" style="background-color:#a1f5e4;" | Complex Pattern
! colspan="2" style="background-color:#;" | Complex Pattern
! colspan="2" style="background-color:#a1f5e4;" | Short Pattern
! colspan="2" style="background-color:#;" | Short Pattern
|+
|+
! style="background-color:#f5f5a1;" | Order
! style="background-color:#;" | Order
! style="background-color:#f5f5a1; width:350px" | Example Name
! style="background-color:#; width:350px" | Example Name
! style="background-color:#f5f5a1;" | Order
! style="background-color:#;" | Order
! style="background-color:#f5f5a1; width:200px" | Example Name
! style="background-color:#; width:200px" | Example Name
|-
|-
|style="width:50px; text-align:center;"|1
|style="width:50px; text-align:center;"|1
Line 170: Line 206:
= Episode Groups =
= Episode Groups =
Episode Groups or Orders are listings with alternate episode orders. Some TV Shows are broadcast in one order but the DVD/Bluray release may have a different screening order. A well known example is the TV Show ''Firefly'' where the Studio opted to broadcast high action episodes for ratings first, while the Producer wanted a different order to correctly unfold the storyline.
Episode Groups or Orders are listings with alternate episode orders. Some TV Shows are broadcast in one order but the DVD/Bluray release may have a different screening order. A well known example is the TV Show ''Firefly'' where the Studio opted to broadcast high action episodes for ratings first, while the Producer wanted a different order to correctly unfold the storyline.
Each Information Provider uses a different method to make alternate orders available. Check which scraper you are using and select the correct method below.




== TheMovieDB-TV Shows ==
== TheMovieDB-TV Shows ==
TheMovieDB uses Episode Groups for additional episode orders.
See... '''[[Add-on:TMDb_TV_Shows#Episode_Orders|TheMovieDB Episode Groups]]'''


To use one of the orders for scraping, follow the images below. Paste the address into a '''''[[NFO_files#Parsing_nfo|Parsing NFO file]]''''' then scrape. The Parsing NFO File will point the scraper to the listing. <ref>https://forum.kodi.tv/showthread.php?tid=338467&pid=2801494#pid2801494</ref>
Only available when using the python scraper ''TMDB TV Shows.''


<gallery mode="traditional" widths="500px" heights="283px">
File:EpisodeGroups01.jpg|Image 1- Accessing Episode Groups
File:EpisodeGroups02.jpg|Image 2- Available Episode Groups
File:EpisodeGroups03.jpg|Image 3- Select a Group, then copy the address for use in a Parsing NFO file.
</gallery>




== The TVDB ==
See... '''[[Add-on:The_TVDB_v4#Flexible_Orders|TheTVDB Flexible Orders]]


== The TVDB ==
Only available when using TheTVDB v4 python scraper by TVDB Team.
{{editor note|TVDB will shortly be updating to v4 API with major changes to episode orders. This is expected to occur April 2021.}}
 
 
== TVmaze ==
See... '''[[Add-on:TVmaze#Episode_Orders|TVmaze Episode Orders]]'''





Revision as of 00:54, 25 May 2022

Create Video Libraries
1. The Basics
2. Source Folder
3. Movie Setup
4a. TV Show Setup
4b. Seasons Setup
4c. Episodes Setup
5. Music Videos Setup
6. Add Source & Scrape
7. Scraping Problems
Home icon grey.png   ▶ Video library ▶ Create Video Library ▶ Episodes

Introduction

Be aware of the following:

  • The only item in the episode file name that the Kodi scanner searches for is the Season and Episode numbering (SxxEyy). Everything else is irrelevant.
  • It is this SxxEyy that is used to match and scrape the episode metadata and artwork.
  • To reduce the risk of the scanner becoming confused by complicated naming, ensure your episode filenames are clean and simple as described below.
  • Contrary to advice from 3rd party internet guides, you cannot set season and episode numbering through NFO Files.

Do not refer to IMDB for episode orders. There is no IMDB Scraper.
If you are using the default scraper then the site to check is TMDB. If you have changed to TVDB or TV Maze, check the appropriate site.


Single Episode Files

Episode files are assumed to contain a single episode. If you have files that contain two or more episodes, then read the Multi-Episodes section below.

The following table details the Minimum and Recommended naming for episodes files.

Minimum required episode name: Recommended episode name:
S01E01.mkv Angel (1999) S01E01.mkv
Where: S01E01 = Season 1, Episode 1 - no spaces Where: Angel (1999) = TV Show name
S01E01 = Season 1, Episode 1 - no spaces

The Pattern S01E01 is the most accurate available. Other Patterns are available in the table below with the most accurate at the top and accuracy decreasing down the list.

With Season No Season By Date By Title
Order Episode Naming Order Episode Naming Order Episode Naming Order Episode Naming
1 Name S01E02.ext 2 Name ep02.ext 3 Name yyyy.mm.dd.ext 7 Name.special.ext
1 Name S1E2.ext 2 Name ep_02.ext 3 Name yyyy-mm-dd.ext
1 Name S01.E02.ext 7 Name part.II.ext 4 Name dd.mm.yyyy.ext
1 Name S01_E02.ext 7 Name pt.II.ext
1 Name S01xE02.ext 7 Name pt_II.ext
5 Name 1x02.ext
6 Name 102.ext
With Season
The most commonly used for nearly all TV Shows.
No Season
Normally used for Anime or single season TV Shows. Not commonly used.
By date
Used for long-running daily shows. Check the scraper site for numbering method used.
By title (added in v.20 "Nexus")
Used for special episodes in case if a data provider does not support "zero season" convention for specials, e.g. TVmaze. It allows to match special episodes by their titles.


Multi-Episode Files

If you video files contain two or more episodes, then the following naming is required to scan multiple episodes from a single file.

Minimum required episode name: Recommended episode name:
S01E01E02E04.mkv Angel (1999) S01E01E02E04.mkv
Where: S01E01E02E04 = Season 1, Episode 1, 2 & 4 Where: Angel (1999) = TV Show name
Note that Episode 3 is not included S01E01E02E04 = Season 1, Episode 1, 2 & 4
Complex Pattern Short Pattern
Order Example Name Order Example Name
1 name s01e01-s01e02.ext 1 name s01e01e02.ext
1 name s01e01-episode1.title-s01e02-episode2.title.ext 1 name s01e01-02-03.ext
1 name s01e01-s01e02-s01e03.ext 5 name 1x01x02.ext
5 name 1x01-1x02.ext 2 name ep01-02.ext
2 name ep01-ep02.ext

It is recommended that multi-episode files be split into Single Episode files.

In cases where the video file contains more than one episode, you must nominate each episode in the filename.

  • The patterns are the same as Single Episode numbering, but extended to include multiple episodes.
  • Only the episodes in the file name will be added, e.g. Angel (1999) S01E01E04.mkv will scrape episodes 1 and 4 but not include episodes 2 and 3.
  • When using a single video file for multiple episodes it is possible to tell set episode bookmarks for each episode in the file. See: Episode Bookmarks
See also: Multi-Episode Matching to create additional pattern matches


Episode Groups

Episode Groups or Orders are listings with alternate episode orders. Some TV Shows are broadcast in one order but the DVD/Bluray release may have a different screening order. A well known example is the TV Show Firefly where the Studio opted to broadcast high action episodes for ratings first, while the Producer wanted a different order to correctly unfold the storyline.

Each Information Provider uses a different method to make alternate orders available. Check which scraper you are using and select the correct method below.


TheMovieDB-TV Shows

See... TheMovieDB Episode Groups

Only available when using the python scraper TMDB TV Shows.


The TVDB

See... TheTVDB Flexible Orders

Only available when using TheTVDB v4 python scraper by TVDB Team.


TVmaze

See... TVmaze Episode Orders


References



Mergefrom.gif Previous step Next step Merge-arrow.gif
Seasons Setup Add Source & Scrape



Return to top