Cinema artwork thumbnails
The cinema_artwork_thumbnails job finds the artwork for your movies, shows, seasons and episodes, and renders it into the sizes Cardinal Cinema displays.
Five kinds of artwork are handled:
| Kind | Shape | Used for |
|---|---|---|
| Poster | Portrait | Movie, show and season tiles |
| Backdrop | Landscape | The large image behind a movie or show |
| Still | Landscape | A single episode |
| Logo | Transparent | A movie's or show's title, drawn over a backdrop |
| Clearart | Transparent | Characters or a scene cut out, drawn over a backdrop |
Sources
The job looks in three places, in this order, and stops at the first one that produces an image.
1. The file system
Images sitting next to your video files are the first choice, and the easiest to control: to change a poster, replace a file.
| Owner | Looks for |
|---|---|
| Movie | poster.*, backdrop.*, logo.* and clearart.* in the movie's folder |
| Show | poster.*, backdrop.*, logo.* and clearart.* in the show's folder |
| Season | poster.* in the season folder |
| Episode | <episode file name>.jpg or <episode file name>-thumb.* beside the episode |
Two older naming conventions are accepted as well, so libraries organized by other software work without being renamed:
| File | Treated as |
|---|---|
folder.*, cover.* | Poster |
fanart.* | Backdrop |
clearlogo.* | Logo |
A movie's artwork can also be named after its video file, the way Kodi and tinyMediaManager save it. These are read when the folder names above find nothing:
| File | Treated as |
|---|---|
<movie file name>-poster.*, <movie file name>.* | Poster |
<movie file name>-fanart.*, <movie file name>.fanart.* | Backdrop |
<movie file name>-logo.*, <movie file name>-clearlogo.* | Logo |
<movie file name>-clearart.* | Clearart |
Folder artwork is only taken when the folder holds exactly one movie. A folder holding two movies is a grouping folder, and its poster.jpg belongs to neither of them. Artwork named after a movie's file belongs to that movie wherever it sits, even at the library root.
2. Embedded in the video file
When the folder has no poster, backdrop or still, the job reads the cover art stored inside the video file itself: the cover atom in an mp4, m4v or mov, or an attached image in an mkv. Where a Matroska file carries both of the conventional attachments, the portrait cover.jpg is preferred over the landscape cover_land.jpg for a poster. Only movies and episodes have a video file to read; a show or a season never borrows an episode's cover, so their artwork comes from the folder or not at all.
3. Online artwork
When online artwork is turned on, the cinema online artwork job runs after this one and fills the posters and backdrops it found nothing for. A file you add later still wins: this job replaces online artwork with the file on its next run.
4. Nothing
An item with no artwork anywhere is finished and recorded as completed, not as an error. It simply displays without a poster. Generating one from a frame of the video needs FFmpeg, and arrives in the next release.
Picked artwork
Artwork someone picked in Cardinal Cinema is kept as picked. This job leaves that kind alone, even when a file for it appears on disk, until the pick is reset to automatic.
Prioritization
As with album art, the file system beats what is embedded in the media file. This makes replacing a poster a matter of dropping a file into a folder rather than re-tagging a 40 GB video.
File types
Supported image file types are .jpg, .jpeg, .png and .webp.
The job checks what an image really is before using it, whatever its extension. An empty file, a file that is not an image, or an image in a format the server cannot read (such as BMP) is passed over for the next source. When nothing usable is left, the item is completed without artwork, and the task's result names each file that was passed over and why.
Rendered sizes
Every image keeps its aspect ratio and is never cropped or enlarged. Posters, backdrops and stills are capped by height; logos and clearart, which vary in height, are capped by width.
| Kind | Extra small | Small | Medium | Large | Extra large |
|---|---|---|---|---|---|
| Poster | 120 px | 240 px | 600 px | 1200 px | |
| Backdrop | 135 px | 270 px | 720 px | 1440 px | 2160 px |
| Still | 135 px | 270 px | 720 px | 1440 px | |
| Logo, clearart | 200 px | 400 px | 800 px | 1600 px |
The job renders the small and medium sizes. The others are rendered the first time an app asks for one, from the original image where it is a file, so a 4K backdrop only exists for the titles someone has opened on a 4K screen.
Posters, backdrops and stills are saved as JPEG. Logos and clearart are saved as WebP, which keeps their transparency.
Rendered images go into the same thumbnail cache your photo and album art thumbnails use. No extra directory is created, and nothing is written next to your video files — your media folders are never modified.
When it runs
The job starts on its own at the end of any indexing run that indexed movies or TV. It can also be started by hand from the Jobs page of your Media Server's Admin Dashboard.
Each run only looks at items that are still missing artwork, so repeat runs are cheap. An item proven to have no artwork is skipped for the rest of that run, and checked again on the next one — which is what makes adding a poster.jpg later work: drop the file in, run the job, and the poster appears. Re-indexing is not required.
Was this article helpful?