Skip to content

Naming conventions for movies

Michell Bak edited this page Jul 15, 2014 · 6 revisions

Prefix

Mizuu uses the filename (and parent folder name) to identify and recognize your movies. Therefore it is important that your files are named correctly - preferably according to the conventions listed below.

The filename is the most important factor when identifying a movie - the parent folder name is only used if the filename identification is unsuccessful.

Naming conventions

Simple

Movie title as the filename.

Examples:

  • Avatar.mkv
  • Skyfall.mp4
  • The Great Gatsby.mov

With release year

Movie title and release year as the filename. This is recommended in cases where there are multiple versions of a movie.

Examples:

  • Footloose (2011).mp4
  • Les Miserables (2012).mkv
  • RoboCop (2014).mov

With IMDb ID

Optionally, you can use the IMDb ID of a movie as the filename or part of the filename. It is generally a good idea to keep the movie title in the filename as a fallback if the movie cannot be identified based on the IMDb ID, but it is not a requirement.

Examples:

  • tt1646971.mp4
  • How to Train Your Dragon 2 (tt1646971).mkv
  • How to Train Your Dragon 2 (2014) (tt1646971).mkv

Movie parts / stacking

Mizuu supports movies split into 2 or more parts (up to 9). It automatically merges such movies into a single entry in the library overview. The following two naming conventions are supported:

  • Avatar cd1.mkv / Avatar cd2.mkv
  • Avatar part1.mkv / Avatar part2.mkv

You can naturally use the aforementioned naming conventions in conjunction with this, for example:

  • Avatar (2009) (tt0499549) cd1.mkv

NOTE: In all cases the filenames MUST be identical and end with either cd# or part# in order for this to work.

Separators, meta data, etc.

It is recommended to use space as a separator, but Mizuu does include some logic to deal with other kinds of separators, i.e. hyphens (-), underscores (_) and dots (.).

Additionally, Mizuu includes logic to deal with various kinds of filename meta data and tags. It is important that such meta data comes after the release year in the filename.

Finally, you should avoid using special characters in your filenames (if possible).

If you experience any identification issues while using special separators, filename tags or special characters, please remove it and try again.