Skip to content

Graph Card Type

This card design was created by CollinHeist.

This card type features a circular progress bar or "graph" which can be used to indicate total series progress. The "progress" is parsed from the Episode Text, (from the Episode Text Format setting) which defaults to {episode_number} / {season_episode_max} to display the progress within each season. The graph displays as a circular ring with a fraction (numerator/denominator) shown inside, and the title text is positioned next to the graph.

Example Graph Card
Labeled Card Elements

Labeled Graph Card Elements

Episode Text

Unlike most other card types, this card does not feature separate season and episode text. Instead, the inside of the graph is only customized via the Episode Text Format card setting. This defaults to:

{episode_number} / {season_episode_max}

Which means that TCM will put the episode number on top (as the numerator), and the maximum episode number in that given season on the bottom (as the denominator).

Expected Format

As a format string, this setting offers a lot of flexibility for how text is displayed on the card. However, since the graph's filled percentage is also derived from this setting, TCM expects the text in a specific format - namely with some (top text) / (bottom text). If you provide text which is not in this format, TCM will "force" it into this format.

For example, typing 1 / 5 is completely valid and will result in the graph being drawn as one fifth full; but specifying 2 by itself will result in the text being displayed as - / 2, with TCM adding the - / part of the text.

Special Filled Formatting

When the text indicates that the "percentage" filled is 100% (typically on the last episode of the season), the coloring of both the numerator and denomitor is set.

Custom Fill Formatting

Font Size

By default, the size of the episode (graph) text is scaled dynamically with the Graph Radius extra. However, if you would like to adjust the size of this text separately, this can be adjusted with the Graph Text Font Size extra.

Example

Graph Customization

Background Color

The background color of the graph element can be customized with the Graph Background Color extra. This color supports transparency.

Example

Fill Color

The color of the filled portion of the graph can be adjusted with the Graph Color extra. Adjusting this extra also adjusts the color of the numerator (the top part of the Episode Text). This color also supports transparency.

Example

Fill Scale

How full the active part of the graph appears can be adjusted with the Fill Scale extra. This is a number between 0 and 1.0, where 0 means no fill will be drawn, and 1.0 means the entire width of the graph will be colored, and none of the background will be visible.

Example

Inset

How far inset from the edges of the image the graph element (and associated text) appear can be adjusted with the Graph Inset extra. This adjusts both the horizontal and vertical inset towards the center of the image.

Example

Radius

The radius (size) of the graph can be adjusted with the Graph Radius extra. Adjusting this value will also dynamically adjust the size of the contained Episode Text unless the Graph Text Font Size is explicity specified.

Example

Width

The width of the graph (i.e. how thick the circle part is) can be adjusted with the Graph Width extra. This value serves as the base width of the Fill Scale setting.

Example

Gradient Overlay

By default, TCM applies a subtle gradient overlay on top of the source image so that the (default) white text appears more legible. If you would like to remove this gradient overlay, set the Gradient Omission extra to True.

Example

Position

The position of the graph and all text elements on the card can be adjusted with the Text Position extra. Available options are:

  • lower left (default): Graph and text positioned in the lower left
  • lower right: Graph and text positioned in the lower right
  • upper left: Graph and text positioned in the upper left
  • upper right: Graph and text positioned in the upper right
  • left: Graph and text positioned on the left side (vertically centered)
  • right: Graph and text positioned on the right side (vertically centered)
Example

Mask Images

This card also natively supports mask images. Like all mask images, TCM will automatically search for alongside the input Source Image in the Series' source directory, and apply this atop all other Card effects.

...