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:

  • Watcher
  • Webhooks

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.

Related topics

• Watcher
• Webhooks
• Metadata
• User interface

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.