« Sapphire File Type Support
Sapphire Installation Instructions (1.0b3.1) »

Sapphire Supported TV Show File Naming Conventions

There are three naming conventions Sapphire currently supports for TV Shows:

1.    Show.Name.S##E##.<anything>.ext

  • Ex: The.Sopranos.S03E11.avi
  • The.Sopranos.S01E02.randomstuff.avi
  • REGex representation is [\. -]?S[0-9]+E[S0-9]+

2.    Show.Name.#x##.<anything>.ext

  • Dexter-1×15.avi
  • Dexter-2×02-random-stuff.avi
  • REGex representation is [\. -]?[0-9]+x[S0-9]+

3.    Show.Name.###.<anything>.ext

  • Dead.Like.Me.203.avi
  • Dead_Like_Me.111.random_stuff.avi
  • REGex representation is [\. -][0-9]{1,3}[S0-9]{2}[\. -]

Any separator inside a file name (dot, dash, space) are interchangeable and indifferent to Sapphire.

You can place the above REGex representations into this REGex Tester to see how Sapphire will react to specific file names you might have.

This entry was posted on Monday, July 23rd, 2007 at 3:11 pm and is filed under File Formats & Types. You can follow any responses to this entry through the RSS 2.0 feed. Both comments and pings are currently closed.

8 Responses to “Sapphire Supported TV Show File Naming Conventions”

  1. Matthew Says:
    November 12th, 2007 at 3:52 pm

    How hard would it be to allow us to define our own format? I have literally thousands of TV show files that are the format:

    Heroes/Season 1/[1×05] Hiros.avi

    So if there was a config file where we could define data placeholders for our own schemes inside a root path…

    %show name%/%season%/%title%.%extension%

    That would be the final thing to make me use this great looking software. I’m not renaming thousands of files to fit one of your pre-chosen schemes. Can this be done?

  2. Matthew Says:
    November 12th, 2007 at 3:54 pm

    Or I guess my above data string would be more accurate to my schema if it was this:

    %show name%/Season %season%/[%season%x%episode%] %title%.%extension%

  3. george Says:
    December 6th, 2007 at 9:28 am

    There are some really good automator actions around for renaming files sequentially..
    don’t have any on hand that i can give but i know they’re out there.

  4. Steve Says:
    December 11th, 2007 at 12:14 pm

    Sapphire appears to be one of the best program ever made or at least it will be. I have a specific question about naming TV shows. I have tried all the naming conventions you list both here and on the manual page (for specials) but I can not get the Battlestar Galactica Miniseries to show up on the TV show list.

    On Rage it is listed as episode 100 or S01E?? or 1×00. I’ve tried these plus about 30 other episode numbering names and the result is one of three.

    1) Sapphire scans through as if it has identified it correctly. Then does not show it when you check the TV show folder.

    2) Gives the only option of This is Not a Movie.

    3) Askes you to pick from Battlestar Galactica Movies. Which is how I have it set now but would be nice to have it with other episodes.

    I had no problems with other TV shows or even specials ie Razor.

    Any help would be appreciated as I can’t find any info anywhere else.

  5. gbooker Says:
    December 11th, 2007 at 5:12 pm

    Steve, try following the steps for a series special for the miniseries, that might work:
    How do I Identify Series Specials?
    Also, the Razor ep is explicitly mentioned there.

  6. Steve Says:
    December 13th, 2007 at 7:44 am

    Thanks for replying gbooker.

    Unfortunately that site is not helpful in this instance, I checked out that link previously and that is how I figured out the other specials I have. Razor was obviously no problem.

    I think the problem is that the title is listed as “01x?? - Miniseries”.
    It has no number in front of it to tell Sapphire what number in the season the show is.
    Most are listed in this format “2 :01×02 - Water”
    This is probably why it isn’t being displayed as a regular episode.

    I think either the ?? or the numbers in front of the title “Miniseries” are preventing it from being displayed as a special.

    here is the web address with the season one info.
    http://www.tvrage.com/Battlestar_Galactica/episode_guide/1

  7. gbooker Says:
    December 15th, 2007 at 7:24 pm

    Sorry I didn’t reply. Handling of “01x?? Miniseries” has been fixed in the source. It will be in the next release.

  8. rcrh Says:
    June 14th, 2008 at 6:18 am

    I agree with Matthew; it would be great if we could write our on REGEX to support different naming convensions.

    I don’t leave the series name in each of my files. Why duplicate HEROES in each file if they are all in a folder called HEROES?

    So, my files are like this.

    Heroes/season 1\s01e01 - name of episode.avi

    I have a REGEX expression that works for this. I know ’cause its been running on XBMC for a couple of years.

    So, why not give us an option to use your defaults or add a custom expression?

    Thanks in advance.