-
Notifications
You must be signed in to change notification settings - Fork 191
Custom movie data
Mizuu supports both custom cover art and movie information, including the title, plot, tagline, rating, runtime, and trailer link. You can manually change most data for movies in Mizuu.
In order to make Mizuu use custom movie data, you need to go to Settings -> Identification & search, and disable the Ignore custom movie data files setting. If this setting is enabled, none of the functionality described here will work.
You can use your own cover art image for movies in Mizuu. This works with any movie - including movies that are automatically identified by Mizuu.
Simply place your your custom cover image in the same folder as the video file and name it using one of the following conventions:
-
cover.ext
,folder.ext
orposter.ext
-
{movie_filename}-cover.ext
,{movie_filename}-folder.ext
or{movie_filename}-poster.ext
{movie_filename}.ext
In the above examples, .ext
means the file extension and {movie_filename}
means the file name of the video file without the extension. Mizuu currently supports the following three file extensions for custom cover images:
- .jpg
- .jpeg
- .tbn
Custom cover images should have a width / height ratio of 2:3 and the resolution should fit the device.
If you are unsure about the resolution, you can use Mizuu's settings as inspiration. Mizuu currently downloads cover images in the following three resolutions:
- 185 x 278 pixels
- 300 x 450 pixels
- 500 x 750 pixels
Custom cover images are loaded from the source every time they are needed on screen - including from network sources. This may mean that images load slower, so please be aware of that.
You can use your own backdrop image for movies in Mizuu. This works with any movie - including movies that are automatically identified by Mizuu.
Simply place your your custom backdrop image in the same folder as the video file and name it using one of the following conventions:
-
backdrop.ext
,banner.ext
orfanart.ext
-
{movie_filename}-backdrop.ext
,{movie_filename}-banner.ext
or{movie_filename}-fanart.ext
In the above examples, .ext
means the file extension and {movie_filename}
means the file name of the video file without the extension. Mizuu currently supports the following three file extensions for custom backdrop images:
- .jpg
- .jpeg
- .tbn
Backdrop images should have a width / height ratio of 16:9 and the resolution should fit the device.
If you are unsure about the resolution, you can use Mizuu's settings as inspiration. Mizuu currently downloads backdrop images in the following three resolutions:
- 780 x 439 pixels (low-end tablets and phones)
- 1280 x 720 pixels (tablets and high resolution phones)
- 1920 x 1080 pixels (this is only used for high resolution tablets)
Custom backdrop images are loaded from the source every time they are needed on screen - including from network sources. This may mean that images load slower, so please be aware of that.
If you want to use your own movie information, you can create a .nfo file with the contents below.
This file has to be placed in the same folder as the movie file, and make sure that the files have identical names. This means that the .nfo file should be called “Avatar.nfo”, if the movie in question is called “Avatar.mp4″.
Example of a .nfo file (with alternative fields and comments in parentheses):
<movie>
<title>Real Steel</title> (full title, excluding year)
<originaltitle>Real Steel</originaltitle> (original title)
<set>Real Steel Collection</set> (name of movie collection, if any)
<rating>7.6</rating> (i.e. 5.8)
<plot>A gritty, white-knuckle, action ride set in the near-future [...].</plot> (movie plot)
<runtime>127</runtime> (movie runtime in minutes)
<premiered>2011-10-07</premiered> (or <releasedate> in yyyy-mm-dd format or <year> if nothing else is available)
<id>tt0433035</id> (IMDb ID including "tt")
<tmdbid>39254</tmdbid> (TheMovieDB.org TMDb ID - needed to do cover art / backdrop searches)
<genre>Action, Science Fiction, Sport, Drama</genre> (movie genres, separated by comma)
<tagline>If you get one shot, make it real.</tagline> (or <outline>) (movie tagline)
<certification>PG-13</certification> (or <mpaa>) (movie certification, i.e. PG-13)
<trailer>http://www.youtube.com/watch?v=YuuTm1aCkGE</trailer> (YouTube movie trailer link)
<actor> (for each actor)
<name>Hugh Jackman</name>
</actor>
<actor>
<name>Dakota Goyo</name>
</actor>
</movie>
You do not need to include fields without data, i.e. if the movie is not part of a set / collection, there is no need to include the <set>
field in the .nfo file.
If you make any changes to your .nfo files and wanted the changes reflected in Mizuu, you will have to remove the movie from the library and re-scan the library.
You can also edit any existing movie data if you want.
This is particularly useful if you want to change the rating, certification, run time or perhaps fix an error in the title.
Press the Overflow menu icon [three dots] and select Edit movie from the drop-down menu. You will be taken to an edit screen with fields for all the movie information.
Please note that any changes you make will be lost if you manually re-identify the movie or clear the library and run a library update.