Music Card Type
This card design was created by CollinHeist, and is inspired by a music player (Spotify in particular).
These cards feature a fully adjustable music timeline, media control buttons, and artwork. This is one of the more complex card types, featuring more than twenty available extra customizations.
Labeled Card Elements
Adjusting the Player Style
Above the title text, various kinds of "album art" can be added to the Card by
adjusting the Player Style extra. This can be basic, artwork, logo, or
poster.
Automatically Downloading Artwork
If the style is set to artwork, backdrops will not be automatically
downloaded. You will need to download these manually for the Series.
Example
Controls
Enabling
Stylized music control icons / buttons can be added to the Card, if desired, by
setting the Control Toggle extra as True.
Examples
Coloring
If the music controls are enabled, then each individual control icon can be recolored (or omitted completely) with the Control Colors extra.
This must be a set of five space-separated colors, where each color will be used on the controls in order.
Colors with Spaces
All specified colors cannot have spaces. For example, write
rgb(1, 1, 1) as rgb(1,1,1).
If a color is given as transparent or none, that control icon will be
removed.
Examples
Pause or Play Icon
The middle icon on the controls can be toggled between a pause and play icon
with the Pause or Play Icon extra. If set to watched, then the icon (and
Card) will update any time the watched status of the Episode changes.
Example
Heart Icon
A small heart / like icon can also be added to the top right of the player. This icon can be toggled and recolored with extras.
Icon Overlap
TCM does not implement any logic to prevent the heart icon from overlapping album artwork or title text.
Enabling
The heart icon is disabled by default, but can be enabled by setting the Heart
Toggle extra as True.
Example
Coloring
The heart icon can be recolored in two ways. The edge / stroke of the icon with the Heart Stroke Color extra, and the inside / fill of the icon with the Heart Fill Color extra. These are separated so that the heart can be visible while not appearing "selected."
Examples
The following shows an adjustment to the Heart Stroke Color.
The following shows an adjustment to the Heart Stroke Color and Heart Fill Color extras.
Timeline
Coloring
The color of the filled portion of the timeline can be adjusted with the Timeline Color extra. This only applies to the filled portion - e.g. the percentage - and the "bubble".
Example
Filled Percentage
The filled logic for the timeline is customizable with the Timeline Fill Percentage extra.
If this is set to an explicit number - such as 0.3 - then the timeline will
always be that percent filled. The number will be interpreted as a percentage.
If this is specified as random (or left as the default) then each Card will
utilize a random fill percentage.
Finally, this can also be given as a Format String
in which case TCM will calculate the percentage for each Card. For example, by
setting this extra to {episode_number / season_episode_max}, the timeline
percentage will be "filled" from 0% to 100% for each season.
Common Uses
Some common specifications for this percentage are:
{episode_number / season_episode_max}- progress the timeline for each season. Meaning the first Episode of the season would start near 0% filled, and the last Episode would be 100%.{absolute_number / series_absolute_max}- progress the timeline for the entire Series. Meaning the first Episode of the Series would start near 0% filled, and the last Episode of the Series would be 100%. This will only work for Series with absolute numbering from Sonarr.
Warning About Format Strings
Be careful when specifying a self-calculating format string for the filled percentage for currently airing Series/seasons. If the format specified changes every time a new Episode aires, then all Cards affected by this change will be remade and reloaded for each new Episode.
Player Positioning
Overall Position
The position of the player can be adjusted by setting Player Position to
either left, middle or right.
Example
Player Inset
The Player Inset extra allows more fine-tuned control of how far from the edge of the image to place the player. This is applied to both the horizontal and vertical spacing.
Example
Player Width
The width of the player can also be adjusted with the Player Width extra. All elements within the player - notably the timeline and any album artwork - are dynamically resized with the specified width.
Example
Player Color
The background color of the player can be adjusted with the Player Background Color extra.
Example
Subtitle Text
The text below the title is referred to as the subtitle. This text can be edited via the Album Subtitle extra.
This can be set to a Format String to dynamically
adjust the text to your liking. Setting it to {""} will remove the subtitle
completely. See the full list of available variables
here.
Common Uses
Some common specifications for this are:
{series_name}to put the Series name (the default){series_full_name}to put the Series name and year{series_name}, Season {season_number}to put the Series name and the season number
Example
Album Image Corner Rounding
To add to the "album art" aesthetic, the corners of images are rounded when the
Player Style is set to artwork or poster.
This can be disabled by setting the Round Album Corners Toggle extra to
False.
Example
Title Line Truncation
Because the player design does not lend itself very well to extremely long
titles, this card automatically truncates titles (with ...) which are longer
than a set number of lines. This behavior can be modified (or disabled) with the
Long Line Truncation extra.
Setting this to some number will cut off text after that many lines; and setting
this to False will stop truncation altogether.
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.
Example
