FileNaming

How to name the video files
Featured, Phase-Deploy

Updated Mar 13, 2011 by yves.blu...@gmail.com

Intro

The aim of the MovieJukebox file name parser is to extract as much information as possible from the video file names, which are commonly used. The idea is to process almost all of the usual naming conventions.

The intention is that you will not normally have to rename files.

If you find that MovieJukebox isn't recognising a video filename, then follow these guidelines and you should be able to eliminate the problem. However, in some cases, no amount of tweaking the filename will result in a correct match, in which case a NFO file should be used.

How does the file name parser work?

Dividers

To separate the different parts (called Tokens) of the filename MovieJukebox has a concept of "dividers". These are characters that are used to seperate parts of the filename so that YAMJ can process them. Characters that can be used to seperate the filename parts are:

[]
()
.
_
-

The Braces and brackets "()" are conceptually used to group items together and should not be used to group dissimilar parts of the filename or MovieJukebox may not be able to understand the Token.

Example of a wrong use

Blade Runner[1982_FRENCH_DVDRip].avi

MovieJukebox will try to interpret "[1982_FRENCH_DVDRip]" as a single phrase and will fail. A better naming would be any of the following:

Examples of correct use

Blade Runner.(1982).(FRENCH).(DVDRip).avi
Blade Runner[1982]_FRENCH_DVDRip.avi
Blade Runner_1982_FRENCH_DVDRip.avi

The "-" Character

The minus (-) character is a special character within MovieJukebox file names. It denotes the end of the scanable file name and the start of the file or episode title. Anything after the "-" will NOT be used in determining the video name or other attributes and only used as the title for the video.

Cleaning

As first step MovieJukebox "removes" all redundant parts from file name (the file is not renamed, MovieJukebox just works with name internally). The parts to be ignored are defined in the configuration file. See parameters: Skip Keywords and Version Keywords. Everything configured within these parameters is completely ignored by further processing.

All "removed" keywords are counted as a divider.

Name

Movie name should be at the first position in the file name. It can be divided by spaces, dots or underscores.

Example

Blade Runner.mkv

Year

Year must be in YYYY format (4 digits). Must be between 1919 - 2099. Must come right after movie name. Can be in square or round brackets.

Examples

Blade Runner 1982.avi     << Ok
Blade Runner (1982).mkv     << Best

Languages

Languages are used for displaying a national flag on the poster/thumbnails view of the jukebox. If more than one language is detected, then the flags will be combined to indicate this.

All languages from the file name are extracted and stored in the video XML. They are also removed from the possible video name for searching. See FilenameLanguage for more information.

Examples

Blade Runner (1982).FR.mkv
Blade Runner [1982] GER.mkv
Blade Runner (1982).SPANISH.mkv

Multi-Part Videos

See MultiPartVIdeos for information on how to name the videos with more than one part.

Episodes, Seasons

See TVSeriesNaming

Boxed Sets

See BoxedSets

Trailers and other extras

For trailers: See Trailers#Trailers_Naming.

Examples

Blade Runner (1982) [Bonus - Title of the bonus].mkv

Movie IDs

Starting with v2.1 you can now specify an ID in the filename (so you don't have to have a NFO file.

The format is similar to sets:

filename [ID <moviedb> <id>].avi

There MUST be a space between ID and <moviedb> and a space or '-' between that and the <id>.

For a list of the valid <moviedb> settings see the Plugins page.

Example

BR [ID IMDB tt0083658].avi

This will correctly identify the file as Blade Runner

Excluding a Directory

If you wish to exclude a specific directory from the scan, you can create a file named ".mjbignore" in the directory. This will stop MovieJukebox from scanning this directory and all sub-directories.

For windows you will have to create the file using the following command from a DOS / CMD window

echo >.mjbignore

Examples

File name	Video Name	Year
`My Best Movie.avi`	My Best Movie	-
`My.Best.Movie.avi`	My Best Movie	-
`My_Best_Movie_2000.avi`	My Best Movie	2000
`1984.DivX.avi`	1984	-
`2012.(2009).mkv`	2012	2009

Comment by kathy.ch...@gmail.com, Feb 12, 2010

Can you better explain this: "Anything after the "-" will be ignored and used as the title" how can it be ignored AND used? Is there delimiter that indicates text that can actually be ignored by YAMJ, like my own volume ID or DVD Profiler disk #?

Comment by okuty...@gmail.com, Feb 14, 2010

I guess you define a regular expression anyways, so it may be a better idea to publish it (or kind of BNF-based) here, since verbal explanation may result in inconsistencies and ambiguities.

Comment by project member Stuart.Boston, Feb 14, 2010

I've tried to clarify the "-" question

Comment by Squark.R...@gmail.com, Feb 16, 2010

Is there a way to get a List of all files where YAMJ didn't find informations on? The log file is a bit to big to find all these entries...

Comment by project member Stuart.Boston, Feb 16, 2010

You probably want to use the File listing plugin. You can then look for "UNKNOWN" http://code.google.com/p/moviejukebox/wiki/PropertiesConfiguration#Moviejukebox_Listing_Plugin Remeber to set mjb.listing.clear.UNKNOWN=false so you can see them

Comment by gia...@gmail.com, May 13, 2010

Hi, I have the same movie in different format, e.g. Avatar-1080-Low/Avatar.mkv (11G) Avatar-1080-High/Avatar.mkv (22G) Avatar-BD/Avatar.ISO (45GB) Is it possible to have 3 different box ? Thanks in advance

Comment by gia...@gmail.com, May 13, 2010

OPS, BoxSet? .... Thanks

Comment by spd...@gmail.com, Aug 25, 2010

Hello there,

I need to clean up my filenames before I can start using YAMJ. I have 3 questions befor I can begin.

This is how the filename of a movie has to be setup:

moviename.year.languange.videosource.avi

q1: What do I do when I don't know the year? Do I skip that part of filename? Must I type ie: Van Helsing.NL.videosource.avi

q2: What is the difference between videosource and the extension (avi in this case? I guess avi is the placeholder for the extension of the filetype, but what do you mean with videosource?

q3 Is there a list of possible videosources I can fill in?

Thanks in advance for the great software and documentation!

Patrick de Kruijf

Comment by project member Stuart.Boston, Aug 25, 2010

A1: Yes, if you don't know the year, you can exclude it. If you have two films of the same name, then the year can be used to differentiate them. For example "Oceans 11" or "The Italian Job" A2: The video source is where the video file came from, e.g. DVD, BluRay?, etc. A3: See VideoSources

Comment by spd...@gmail.com, Aug 27, 2010

Thanks for the quick reply, I have another question, hope you don't mind!

So the filename has to be like this: "moviename.year.language.videosource.avi (or other video extension)" and I can skip a part of the filename if I don't know what to fill in.

What do I put at the end of the filename if my video extension is a dvd(rip)? Video_TS or VOB?

Is there a list of video extensions just like the videosource list you showed me in your previous reply?

Thanks again!

Comment by mozart.d...@gmail.com, Nov 1, 2010

Hello,

How should I name a DVDRip of Blade Runner.avi with : Language = English Subtitles (hardcoded) = French

Blade Runner.(1982).(ENGLISH).(DVDRip).(SET SUBTITLE-FRENCH).avi ?

Thanks ! =)

Comment by project member Stuart.Boston, Nov 1, 2010

I think you can use "VOST" to indicate the presence of subtitles in the file if they are not picked up with MediaInfo? (which should pick them up as part of the normal scanning)

Comment by EmmaCart...@gmail.com, Mar 1, 2011

I've been trying to use SET? to have the actor with his/her movies ordered in the box set by year released that I have while still leaving the movie on it's own page. i.e. Gangs of New York.2003 Disc1? Leonardo DiCaprio Collection-01?Daniel Day-Lewis Collection-02?.DVD.iso Will this work as it appears my categories.xml got corrupted making these kinds of changes.?

Comment by project member Stuart.Boston, Mar 1, 2011

You would probably be better off using an XML Nfo file to do these sort of things

<movie>
  <sets>
    <set order="1">Leonardo DiCaprio Collection</set>
    <set order="2">Daniel Day-Lewis Collection</set>
  </sets>
</movie>

Comment by EmmaCart...@gmail.com, Mar 1, 2011

Thanks for your prompt comment. Being a newbie, what file would I go into to make this change your are recommending.Is it the same as creating an NFO file for pickup the the fanart from IMDB for instance.

Comment by project member Stuart.Boston, Mar 2, 2011

Yes, that's exactly the file you need to edit. If you already have the IMDB link in that file you will have to delete it and insert the following line (with the correct tt number) between "<movie>" and "<sets>" above

<id moviedb="imdb">tt123456</id>

Comment by EmmaCart...@gmail.com, Mar 2, 2011

Thanks for you help

Comment by ricktrue...@gmail.com, Apr 4, 2011

How do you override the movie name if it keeps coming back wrong?

Comment by project member Stuart.Boston, Apr 4, 2011

Use a NFO file

Comment by ricktrue...@gmail.com, Apr 4, 2011

what if there is no URL for it? Can i override the name somehow?

Comment by ricktrue...@gmail.com, Apr 4, 2011

Think I may have figured it out with the NFO file. thanks.

Comment by MrMist...@gmail.com, Aug 2, 2011

Newbie :-) Battling to get any movie info filename

7.Hours.(2010).mkv

also created NFO file

7.Hours.(2010).nfo

with content

http://www.imdb.com/title/tt1542344/

get errors on all lines Initializing... Scanning library directory F:\Movies\127.Hours.(2010) Jukebox output goes to F:\Movies\Y2M

Scanning directory #1, 2 files scanned

what am I missing ?? Help

Comment by MrMist...@gmail.com, Aug 2, 2011

should read 127.Hours

Comment by project member Stuart.Boston, Aug 3, 2011

Looks like you don't have an internet connection. Or your firewall is blocking Java/YAMJ

Comment by anth...@openweb.co.za, Apr 10, 2012

Guys, another noob here. I want to create sets for boxsets but I am not understanding what is required to be done exactly. This is my set up. >Network share -> Movie Collection Folder --> Aliens Collection ---> Alien (1979) folder ----> Alien (1979).avi ----> Alien (1979).nfo

To make it part of a set must I add the following info to the NFO file?

<movie>

<id moviedb="imdb">tt0078748</id> <sets>
<set order="1">Alien Collection</set>
</sets>

</movie>

Or where would that info go? And if it is in each movie's (collection) NFO file I then obviously add the same set to each NFO file.

Thanks

Comment by anth...@openweb.co.za, Apr 10, 2012

Another question. Is it possible to create sets for example genres or years. Say I want to view all Sci Fi movies, can I create a set that spans my entire collection? Can I then create another set that is by year that spans the same movie collection?

Comment by anth...@openweb.co.za, Apr 11, 2012

Hi guys, any feedback on my questions?

► Sign in to add a comment