Skip to content

FadeTitleCard

Jump to bottom
Collin Heist edited this page Jan 25, 2023 · 2 revisions

Background

This style of title card is based off Yozora's initial concept of the card. It is a modification of the StandardTitleCard style (same fonts and text colors) that is intended to be used for 4:3 aspect-ratio source images.

Because the default title card aspect ratio is 16:9 (the ratio used within Plex), but many shows from before the 2000's were broadcast in 4:3, the top and bottom of source images will be cut off by all other card types. For example, the following 4:3 source image shows the bounds of the normal title cards, and content outside the red rectangle that would be cut out of other title cards:

This card type is used whenever card_type is specified as fade, or 4x3.

Example

Spoiler

Blurred

Valid extras

Below is a table of all valid series extras parsed by this card. These are described in greater detail below.

Label Default Value Description
logo - Path to a logo file to utilize for the card
episode_text_color rgb(163,163,163) Color to utilize for the episode text
separator • Character to separate the season and episode text

Customization

Adding a Logo

A logo file can optionally be added to the top left of the title cards. By default, no logo is added. This can be changed as a series extra, by specifying a file for the logo image, like so:

extras:
  logo: logo.png

This can be a filename by itself (as shown above), and TCM will look for a matching file of that name in the source directory for the series; or it can be a complete file path, like so:

extras:
  logo: ./source/Star Trek (1966)/logo.png

Episode Text Color

The color of the episode text (e.g. SEASON 1 • EPISODE 1) defaults to rgb(163,163,163), but can be adjusted via a series extra, like so:

extras:
  episode_text_color: skyblue

Separator Character

The character between the season and episode text (a.k.a. the separator) can also be customized. By default, a • character is used. This can be changed as a series extra, like so:

extras:
  separator: "-"

Title Characteristics

Maximum Line Width

This card begins splitting titles at 13 characters. This was selected using the default font, and leaves a small side margin.

Maximum Line Count

This card will split titles into at most 5 lines (unless manually specified). With the standard font, this takes up over half the image and looks quite messy, but is enough space for pretty long titles.

Title Style

This card will split titles bottom heavy, meaning titles will be split such that they're longer at the bottom than the top. For example:

The One Where
Rachel's Sister Babysits

Default Font

Font

The default font used for titles is Sequel-Neue, seen below:

NOTE: This font's upper and lowercase characters are identical.

Case

The default font case is upper.

Color

The default font color is white.

Replacements

The default font swaps the [] and () characters, and doesn't contain some commonly used title characters, so the following font replacements are used:

replacements:
  "[": (
  "]": )
  "(": [
  ")": ]
  "―": "-" # Weird Unicode dash
  "…": "..."
  "“": '"'
Clone this wiki locally