PosterTitleCard - CollinHeist/TitleCardMaker GitHub Wiki

Background

The default title card style based off Reddit user /u/battleoflight's style. This is not a very customizable card. Since this card is not designed for 16:9 source images, source images should be manually specified - these can be for the entire series, individual seasons, or episodes - this is described here. TMDb typically has good selections of posters for a series.

NOTE: If custom source images are not manually gathered and specified, you will get an error about source images not existing.

This card type is used whenever card_type is specified as poster, or gundam.

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 place on the card

How to use

Specification

This card is designed for poster source images (hence the name). So manual source specification must be used to prevent the card from using the normal 4:3 source images (which will look very weird on this card). This is detailed here, and whose general format is shown below:

seasons:
  1:
    source: poster-season1.jpg
  2:
    source: poster-season2.jpg
  # ...

This card also optionally uses series extras to specify a logo file. This is shown in the example.

Example

The below example showcases how to specify some logo file and an image called season1.jpg and season2.jpg (in this show's source folder) for Season 1 and 2 respectively.

series:
  Mobile Suit Gundam:
    year: 1979
    card_type: poster
    seasons:
      1:
        source: season1.jpg
      2:
        source: season2.jpg
    extras:
      logo: ./source/Mobile Suit Gundam (1979)/logo.png

This card can also use a "variable" logo - i.e. one that is different for a given season/episode - if the logo filepath is specified as a "format", like so:

series:
  Mobile Suit Gundam:
    year: 1979
    card_type: poster
    seasons:
      1:
        source: season1.jpg
      2:
        source: season2.jpg
    extras:
      logo: ./source/Mobile Suit Gundam (1979)/logo_season{season_number}.png

This will use logo_season1.png, logo_season2.png, etc. depending on the episode's given season. You can also use {episode_number}.

Title Characteristics

Maximum Line Width

This card begins splitting titles at 16 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 top 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 Amuro, 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 #FFFFFF.

Replacements

The default font does not use any font replacements.

⚠️ **GitHub.com Fallback** ⚠️