For the complete documentation index, see llms.txt. This page is also available as Markdown.

Playing Card

Footer card showing active playback sessions, live progress, and metadata.

The Playing Card is a footer card that displays current playback sessions and their progress.

What it does

  • Shows the current movie or episode, including poster, year, media type, and episode number.

  • Shows whether playback is playing, paused, or buffering.

  • Shows watched percentage and estimated time remaining when duration data is available.

  • Updates displayed progress every second between source updates.

  • Shows the source media server, such as Plex, Emby, or Jellyfin.

  • Shows the configured provider instance when applicable.

  • Supports multiple simultaneous playback sessions, with controls to switch between them.

  • Adds an overview, rating, runtime, release information, genres, series information, and a TMDb link when metadata is available.

  • Hides itself when there are no active playback sessions.

  • Can be closed temporarily, or disabled in Settings → UI → Playing Card.

Prerequisites

  • Playing Card enabled in Settings → UI → Playing Card

  • A configured TMDb API key in Metadata

  • At least one playback event source:

The event source must provide current playback state and progress data.

Quick setup

1

Enable the card

  1. Open Settings → UI → Playing Card.

  2. Set the Playing Card to Show.

  3. Save the settings.

2

Configure metadata

  1. Open Settings → Metadata.

  2. Configure TMDb.

  3. Save the settings.

TMDb is required for the Playing Card to be displayed.

3

Configure a playback event source

Configure Watcher, or configure supported Webhooks.

For accurate live progress, the source should provide playback progress, duration, state, and update timestamps.

Troubleshooting

I do not see the Playing Card

  • Confirm that it is enabled in Settings → UI → Playing Card.

  • Confirm that a TMDb API key is configured in Settings → Metadata.

  • Confirm that a playback event source is enabled and receiving events.

  • Start playback on the connected media server.

  • Check that the session is reported as playing, paused, or buffering.

Summary

The Playing Card shows active playback sessions, progress, time remaining, source information, and TMDb metadata.

It requires TMDb configuration and a supported playback event source.

Watcher is suitable for monitored playback, while Webhooks can also provide playback events.

Last updated

Was this helpful?