# Playing Card

The Playing Card is a small footer widget that shows what’s playing right now. It displays poster, title, progress, and time left.

{% hint style="warning" %}
Save changes often. Most settings do nothing until you click the **red floating Save button**.
{% endhint %}

### What it does

* Shows the current movie or episode (poster, year, SxxExx for episodes).
* Shows progress percent and time left.
* Shows the source provider (Plex/Emby/Jellyfin).
* Adds overview and links (TMDb/IMDb) when metadata is available.
* Hides itself when nothing is playing.

You can hide it temporarily, or disable it in **Settings → UI → Playing Card**.

<figure><img src="/files/cw3qLe2OBT77CGXfCgTD" alt=""><figcaption></figcaption></figure>

### Prerequisites

* **Playing Card enabled** in **Settings → UI → Playing Card**
* A connected media server in **Settings → Authentication**
* A configured metadata provider in **Settings → Metadata**
* One real-time source:
  * [Watcher](/crosswatch/scrobble/watcher.md) (recommended), or
  * Jellyfin [Webhooks](/crosswatch/scrobble/webhooks.md) with **Playback Progress** enabled

{% hint style="info" %}
Ticking real-time progress requires Watcher or Jellyfin Playback Progress.
{% endhint %}

### Quick setup

{% stepper %}
{% step %}

### Enable the card

1. Open **Settings → UI → Playing Card**.
2. Set it to **Show**.
3. Click the **red Save button**.
   {% endstep %}

{% step %}

### Add metadata (recommended)

1. Open **Settings → Metadata**.
2. Configure TMDb.
3. Click the **red Save button**.
   {% endstep %}

{% step %}

### Enable a real-time progress source

Use one of these:

* [Watcher](/crosswatch/scrobble/watcher.md) (recommended)
* Jellyfin [Webhooks](/crosswatch/scrobble/webhooks.md) with **Playback Progress**
  {% endstep %}
  {% endstepper %}

### Troubleshooting

#### FAQ

**Q: I see no Playing Card?**

* Enable it in **Settings → UI → Playing Card**.
* Configure a metadata provider in **Settings → Metadata**.
* Start playback on your media server.

**The bar doesn’t “tick”**

* Plex/Emby webhooks don’t send live progress.
* Use [Watcher](/crosswatch/scrobble/watcher.md) for real-time progress.

### Related topics

* Real-time progress source: [Watcher](/crosswatch/scrobble/watcher.md)
* Better posters and ID links: [Metadata](/crosswatch/providers/metadata.md)
* UI settings overview: [Settings](/crosswatch/navigation/settings.md)

### Summary

Playing Card shows the current item, progress, and time left.

It needs a real-time source. Watcher is the best option.

TMDb improves posters and external links in the card.

### Next steps

* Enable Watcher for live progress: [Watcher](/crosswatch/scrobble/watcher.md)
* Improve posters and ID links: [Metadata](/crosswatch/providers/metadata.md)
* Toggle the footer widget in UI settings: [Settings](/crosswatch/navigation/settings.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.crosswatch.app/crosswatch/scrobble/playing-card.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.