Naming video files/Movies
| The basic steps for adding|
videos to the library:
|Video library||Management||Naming video files||Movies|
In order for the media scrapers to pick up the correct information your file names must follow a certain format:
1 Naming conventions
In order to be scanned correctly, movie file names should only have the title and the year (optional) followed by the file extension. Media source flags can also be added via file names to indicate source/quality of the movie (see link for more info).
To improve matching add the year within parenthesis to the end of the file or foldername, depending on your scanning method and folder structure (before the extension, if filename), this naming standard seems to yield the best results.
\Movies\Pulp Fiction (1994).avi \Movies\Reservoir Dogs (1992).avi \Movies\The Usual Suspects (1995).avi
\Movies\Avatar (2009)-cd1.mkv \Movies\Avatar (2009)-cd2.mkv
\Movies\Avatar (2009)\somefilename.mkv \Movies\The Usual Suspects (1995)\somefilename.avi
\Movies\The Usual Suspects (1995)\somefilename-cd1.avi \Movies\The Usual Suspects (1995)\somefilename-cd2.avi \Movies\Avatar (2009)\Avatar (2009)-cd1.mkv \Movies\Avatar (2009)\Avatar (2009)-cd2.mkv
\Movies\Alien (1979)\VIDEO_TS.IFO \Movies\Léon (1994)\VIDEO_TS.IFO \Movies\Scarface (1983)\VIDEO_TS.IFO Alternatively: \Movies\Alien (1979)\VIDEO_TS\VIDEO_TS.IFO \Movies\Léon (1994)\VIDEO_TS\VIDEO_TS.IFO \Movies\Scarface (1983)\VIDEO_TS\VIDEO_TS.IFO
2 3D movies
Some 3D movies might need an additional file name extension to be identified by XBMC as a 3D movie. See 3D for details on that additional extension, and when it is needed.
Depending on the interface skin you are using, you can add additional media source information to a movie entry in XBMC. 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
4 Split video files (file stacking)
By using the following naming extensions and enabling, you can enable "file stacking" for split video files. File stacking allows multiple video files to appear and play as if it were one movie file.
4.1 Name extensions for stacking
The following are default stacking extensions that can be added to file names
# can be 1 through 9 or A through D. No spaces between the "part" and number.
You can also use:
where # can be A through D.
- Stacking is currently only applied to filenames, not the full path.
- The default expressions will NOT stack files which use only a number as the volume token (eg movie1.avi, movie2.avi). This is intentional due to false positives which can occur with sequels in a flat directory layout. Some solutions to this problem (in order of best to worst) follow...
- Use a dir-per-movie directory layout, see the append example of the moviestacking advanced setting.
- Rename offending files to match one of the more specific volume tokens (ie. cd1, part1, etc).
- Create special-case regular expressions for those files that fail to stack (see #Advanced stacking options).
Avatar part2.mkvin the same folder will appear as a single "Avatar" entry in both library and file views.
4.3 Advanced stacking options
File stacking can be tuned by the user to match obscure cases using the moviestacking advancedsettings.xml setting:
As of XBMC/Kodi v9.11, video stacking regular expressions must contain exactly four (4) capture expressions. Old ones and three capture expressions are dropped (see log). More information on how the algorithm works is available here.
<!-- <cd/dvd/part/pt/disk/disc/d> <0-N> -->
<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck]|d)[ _.-]*[0-9]+)(.*?)(\.[^.]+)$</regexp>
<!-- <cd/dvd/part/pt/disk/disc/d> <a-d> -->
<regexp>(.*?)([ _.-]*(?:cd|dvd|p(?:ar)?t|dis[ck]|d)[ _.-]*[a-d])(.*?)(\.[^.]+)$</regexp>
<!-- movienamea-xvid.avi, movienameb-xvid.avi -->
If the argument action="append" or append="yes" is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the end.
<!-- This expression will match movename1-xvid.avi, moviename2-xvid.avi.
Be warned that it will likely stack sequels in a flat directory layout,
so it is only recommend in a dir-per-video layout. -->
If the argument action="prepend" is supplied, the default moviestacking regular expressions will remain intact and the user specified ones will be added to the beginning.
If no argument is supplied, or the argument append="no" is supplied, the default moviestacking regular expressions are overwritten by the user specified ones.