Naming video files/TV shows

From MrMC Wiki
Jump to navigation Jump to search

MrMC requires each TV show to be in its own folder, and for each file to contain a pattern from which MrMC can determine the season and episode number (e.g. "S01E01").

Folder name = Show title
File name = Season/Episode number

The folder name will be 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 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. Note also the caution below regarding file names with periods.

Note: Flat structures with files for different shows in a single directory are not supported.


You must set the content to TV Shows on the directory directly above the individual show folders. To ensure accurate matches for your TV shows, the folder names should match the title displayed on the site being scraped. For the default TVDB scraper this may mean including the year of release, e.g. Castle (2009) (in cases of duplicate titles), or the country of origin, e.g. Being Human (US) (in cases of foreign remakes).

Below the show folder, the files may be organized how you wish, e.g. into separate season folders, or by year. These folders will be ignored.


Typically, you will add the top-level directory as a source and set the content to TV shows when you add it.

TV Shows                  <<Source folder, Content: TV shows>>
   |----TV Show 1
   |       |----Season #
   |            |--Files
   |----TV Show 2 (year)
   |       |--Files
   |----TV Show 3
   |       |----2008
   |            |--Files


Note: This is generally discouraged as it's really easy for the sub-folders to be mistakenly picked up as false TV show matches. While it's still possible to work through such false-matches, it's a pain in the butt if you need to update the library on those same folders, as the false TV show might get re-added each time.

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.

TV Shows                  <<Source folder, Content: None>>
   |----A-M               <<Content: TV shows>>
   |      |----TV Show 1
   |              |--Files
   |----N-Z               <<Content: TV shows>>
   |      |----TV Show 2
   |              |--Files

It's 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.

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

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.


MrMC uses a series of regular expressions to determine the season and episode numbers from the file name. These are checked in order with the first match being the one used. Anything else included in the file name is ignored.

There are 7 default patterns, plus a separate multi-episode pattern. Use of any other numbering scheme will require you to edit your advancedsettings.xml (see below).

Note: In the examples we will mostly use the format:
where name is the title of the show, and .ext is a recognized video file extension, but any format will work, so long as the pattern is included somewhere in it. name is optional and could just as easily be after the pattern, or excluded entirely.

Single episode

Most of the time you will only have a single episode per file.

The order in which the patterns are checked for by MrMC is included in brackets after each example below (most patterns allow some variation, hence the duplicate numbers). If your file name contains more than one pattern, only the first one checked for will be used.

All the examples will be read as season 1, episode 2.

With season
The most common scenario.
anything_s01e02.ext (1)
anything_s1e2.ext (1)
anything_s01.e02.ext (1)
anything_s01_e02.ext (1)
anything_1x02.ext (5)
anything_102.ext (6)
Template:Future note
Without 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.
anything_ep02.ext (2)
anything_ep_02.ext (2)
You may also use Roman numerals (I, IV, XI, etc.), often used for mini-series or short documentary series.
anything_part.II.ext (7)
anything_pt.II.ext (7)
anything_pt_II.ext (7)
By date
Common for long-running daily shows, you can also use the date the episode aired.
anything_1996.11.14.ext (3)
anything_1996-11-14.ext (3)
anything_14.11.1996.ext (4)


Note: When you use a single video file for multiple episodes you can now tell MrMC when each episode starts using episode bookmarks.

In cases where your file contains more than one episode, you can specify all the episodes included. Everything after the first found pattern match will be checked for further matches to the same pattern.

anything.s01e01 1x02.ext (mixed patterns do not work)

The remainder will also be checked against a shorter form multi-episode pattern.


The ex-_ are fully interchangeable and stackable, e.g. name.1x01e02_03-x-04.ext is perfectly valid (if somewhat odd).

Note: Only the episodes in the file name will be added, e.g. name.s01e01-03.ext will not include episode 2.


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.

anything.1x01.1x01.2.ext (note this is (1x01.1)x(01.2) not (1x01).(1x01.2))

Each part will be added to the library just with its full episode number, the sub-part will not be displayed.

Note: 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, e.g.
anything.1x01.1x02.ext (i.e. (1x01.1) x (02) )

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.

anything.1x01 1x02.ext (i.e. (1x01) (1x02) )

Special episodes

Special episodes, if supported by your scraper, should be marked as being season 0. You should check the site being scraped to see what episode number to use, as they can be fairly arbitrary. For example, BlackAdder's Christmas Carol should have a file name that matches season 0 episode 3, e.g.:

BlackAdder.s00e03.BlackAdder's Christmas Carol.mkv

The TVDB scraper

The default TV show scraper uses The TVDB to scan your TV shows into the library. You should search on the site before adding a new show to ensure you're using the right title. Caution should be taken over using aliases or alternative titles, although these will work in a website search, they don't work in the API the scraper uses.

The TVDB scraper has three possible settings for determining episode order: Aired order, DVD order, and Absolute order. These will affect how you name your files, or vice versa, how you name your files will affect which setting you should use.

Aired order
The default, episodes are ordered by season and numbered as they were originally broadcast. For split-episodes, each part is given its own distinct episode number.
Visible when you click on any season link on the show page.
DVD order
Episodes are ordered by season and numbered as they appeared on DVD release. Split-episodes are numbered by episode and sub-part.
Visible when you click the "DVD Order" link on any season page for the show.
Absolute order
Episodes are ordered as a single season and numbered sequentially from start to finish. Split episodes have distinct episode numbers. Commonly used for anime.
Visible when you click the "Absolute Order" link on the All seasons page for the show.

Media source tags

Depending on the interface skin you are using, you can add additional media source information to a movie entry in MrMC. For example, in the default skin "Confluence" you can label when a file was ripped from a bluray disc by including BLURAY, BRRIP, BD25, or BD50 in the file name after the title. The exact options are different for each interface skin, but a list for the default Confluence skin can be seen on Media flags#Media source.

Back to the Future (1985).bluray.mkv

Advanced usage

Changing scraper settings for one show

A very common situation, when you have one or more shows that require different scraper settings (particularly episode order) to the other shows in your folder, it is possible to change the settings for individual shows. Just navigate to the show's folder in file view and select Change content from the context menu and then alter the settings from there. If the files have already been incorrectly added to the library, you will need to refresh the folder (e.g. from the info screen).

The classic example is Firefly, whose aired order differs greatly from its DVD order:

TV Shows                         <<Source folder, Content: TV shows, Scraper: TVDB - default settings>>
   |----TV Show 1
   |       |----Season 1
   |            |--Files
   |----TV Show 2
   |       |--Files
   |----Firefly                  <<Scraper: TVDB - DVD order>>
   |       |----1x01.Serenity.ext
   |       |----1x02.The Train Job.ext