Naming video files/TV shows: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Danomoseley
>Sho
No edit summary
Line 1: Line 1:
The TV show lookup relies on the following conventions in order to work as advertised.
{{incomplete}}
{{incomplete}}
== Directory Structure & File Names ==
Since build 8044, date: 2007-03-08 XBMC has had the ability to lookup and present information on TV Shows in the [[Video Library]].
TV show support is through new [[How To use Scrapers|scrapers]] and requires a connection to the internet.
 
The the information gathered is cached locally so that it is later available when you are offline. In order to get the most out of your video library, you need to scan your TV shows and retrieve the information about them from sites like [http://www.tv.com tv.com].
 
== TV show filenaming conventions ==
The TV show lookup relies on the following naming conventions in order to work as intended.
 
=== Directory Structure & File Names ===
The directory structure and filenames for tvshows have to be matched by the regular expressions set in [[AdvancedSettings.xml#.3Ctvshowmatching.3E|tvshowmatching]].  
The directory structure and filenames for tvshows have to be matched by the regular expressions set in [[AdvancedSettings.xml#.3Ctvshowmatching.3E|tvshowmatching]].  


The defaults will match the following structures/filenames:
The defaults will match the following structures/filenames:


== Custom Directory Structure & File Names ==
'''Examples needed?'''
The directory structure and filenames for tvshows have to be matched by the regular expressions set in [[AdvancedSettings.xml#.3Ctvshowmatching.3E|tvshowmatching]].


=== Custom Directory Structure & File Names ===
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.
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.
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) :
'''\Season #\##''' (Season# is at very end of directory name, and filename starts with episode name, neither have to be a specific number of digits) :

Revision as of 13:09, 8 April 2007

Incomplete.png INCOMPLETE:
This page or section is incomplete. Please add information or correct uncertain data which is marked with a ?

Since build 8044, date: 2007-03-08 XBMC has had the ability to lookup and present information on TV Shows in the Video Library. TV show support is through new scrapers and requires a connection to the internet.

The the information gathered is cached locally so that it is later available when you are offline. In order to get the most out of your video library, you need to scan your TV shows and retrieve the information about them from sites like tv.com.

TV show filenaming conventions

The TV show lookup relies on the following naming conventions in order to work as intended.

Directory Structure & File Names

The directory structure and filenames for tvshows have to be matched by the regular expressions set in tvshowmatching.

The defaults will match the following structures/filenames:

Examples needed?

Custom Directory Structure & File Names

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) : <xml> <tvshowmatching> 

   <regexp>Season[\._ ]([0-9]+)[\\/]([0-9]+)[^\\/]*</regexp>

</tvshowmatching> </xml>

  • works in BUILD SVN 8339 and greater *

Example : \Battlestar Galactica\Season 3\01 - Occupation.avi (Season 3, Episode 1)


### ([season#][episode#] with nothing in between all in filename, assumes episode number is always 2 digits) : <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)
Example 2 : \Lost\Season 1\Lost - 101.avi (Season 1, Episode 1)
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)


  • Tested with SVN dated March 25th 2007.

See Also

http://www.xboxmediacenter.com/forum/showthread.php?t=25349

http://en.wikipedia.org/wiki/Regular_expressions


Regular Expression Testing: http://www.regextester.com/

Retrieved from "https://kodi.wiki/index.php?title=Naming_video_files/TV_shows&oldid=11809"