Skip to content

Filename rules

Mike Schwörer edited this page Jul 30, 2016 · 3 revisions

jClipCorn automatically generates correct formatted file names in the check database dialog.
Here are the formal naming conventions:

name space film series in roman literals space+hyphen+space sub-title space [language] space (Part %d) dot file extension


Name, sub-title, etc contain only Upper/Lowercase letters and Numbers (no special chars like brackets, etc)

If possible write numbers as their respective words

The film series number is an integer and counts strictly in the order of the release dates.
There are now number "zero", "3.5" or "3 1/3".
This means for some series the film series number can differ from the "official" counting. In such cases you can append the official number on the movie name

The language is only given if it is not German. The shortcuts for different languages are:

  • [GER] German
  • [ENG] English
  • [MUT] Silent film
  • [FR] France

###Examples:

Stirb Langsam IV (Part 2).avi
Spongebob - Lost in Time.mpg
Terminator II - Tag der Abrechnung (Part 1).avi
X-Men I.avi
X-Men Origins - Wolverine.avi
X-Men III.avi
Shadowless Sword (Part1).avi
Forrest Gump [Eng].mpg
Terminator II - Tag der Abrechnung [Ger] (Part 1).avi

###Second Sub-title

If a movie has a second subtitle you separate them by a colon in jClipCorn

Example: "XMen - Origins - Wolverine"

Film Series: "X-Men"
Film Series Number: 4
Title: "Origins: Wolverine" (Colon instead of hyphen)

Because file name can't have colons in them, the colon will be replaced with another hyphen:

X-Men IV - Origins - Wolverine.mkv

###Groups

If the element has any groups assigned they appear in double brackets after the title (but before language and parts)

###EBNF Syntax

FILENAME    = [ZYKLUS CONNECTOR] TITLE [SPACE GROUPS] [SPACE LANGUAGE] [SPACE PART] EXTENSION
ZYKLUS      = ZYKLUSNAME SPACE ROMANNUMBER
LANGUAGE    = "[" ("ENG"|"GER"|"MUT"|"FR") "]"
GROUPS      = GROUP [SPACE GROUPS]
GROUP       = "[[" GROUPNAME "]]"
PART        = "(Part " PARTNUMBER ")"
TITLE       = STRING
ZYKLUSNAME  = STRING
GROUPNAME   = STRING
PARTNUMBER  = NUMBER
ROMANNUMBER = { "I" | "V" | "X" }
EXTENSION   = "." CHAR CHAR {CHAR}
CONNECTOR   = SPACE "-" SPACE
SPACE       = " "