Naming video files/TV shows

From Official Kodi Wiki
Jump to navigation Jump to search

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

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

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:

Custom Directory Structure & File Names

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

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 season 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/