> For the complete documentation index, see [llms.txt](https://captivatehelp.newbluelive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://captivatehelp.newbluelive.com/control-your-show/chapter-index-2/media-tracker-live.md).

# Use Media Tracker

**Media Tracker** is a dedicated workflow panel that **observes** what Captivate plays during your show — it reads from Captivate’s playback history database and logs every media item that goes on-air, with timestamps, durations, and an optional Account assignment. It is **not** a take-control panel; it does not drive playback or queue graphics for air. Pair it with [Media Manager](/control-your-show/chapter-index-2/media-manager-live.md) when you need both observation and control.

{% hint style="info" %}
Media Tracker is registered in the **Workflows** submenu and shares its icon with the **People** panel referenced in some product material. Despite the shared icon, the two are not the same surface — Media Tracker is observation-only.
{% endhint %}

## What Media Tracker shows

The panel is a **Data Log** of media playback events with columns for **Account**, **Project**, **Title**, **Type**, **Started**, **Finished**, and **Duration**. Each row is one media item that Captivate played. Empty state strings: **No log entries yet…** (no rows) and **Nothing currently active…** (no item is currently on-air).

The log is project-aware: the **Project** column lets you distinguish events across projects, and the panel uses Captivate’s playback history database (`PlaybackHistoryDb`) so the log survives a restart.

## Open Media Tracker

1. Click **Add new item** at the bottom of the Project panel and choose **Workflow** > **Media Tracker** (the entry uses the same icon as the People workflow).
2. The Media Tracker panel opens with the **Data Log Tools** header and the playback log beneath it.

## Read the table

Each row is one media playback session:

* **Account** — the operator account, if assigned. Click **assign** in a row to attach an account.
* **Project** — the Captivate project that played the item.
* **Title** — the on-air row’s display name from the Project List.
* **Type** — the media type (Captivate categorizes graphic, media, and live-video sessions).
* **Started** — when the item went on-air.
* **Finished** — when the item came off air. Blank while a session is still active.
* **Duration** — how long the item played.

Rows that are currently on-air show no **Finished** time and remain in the **Nothing currently active…** state once they end.

## Assign an Account to a row

Click **assign** in the **Account** column to attach an Account Name. The assignment is **remembered globally by filename** — if another row plays the same file later, that account assignment is applied automatically. This is convenient for crediting talent or partners across multiple shows; the caveat is that two unrelated media items with the same filename will share an account assignment until you remove it.

## Export the log

Use **Export CSV** in the **Data Log Tools** header to copy the current Data Log to your clipboard and save it as a CSV file. Captivate also prompts you with a **Save Data Log** dialog so you can pick a location.

The export captures the columns visible in the panel: Account, Project, Title, Type, Started, Finished, Duration.

## Clear the log

Use **Delete All** in the **Data Log Tools** header to clear every row in the log. Under the hood the panel sends the `playtracker_clear_all` command to the scheduler; the log is emptied immediately.

{% hint style="info" %}
**Delete All** removes the visible log rows. Account-name assignments are stored separately and are not cleared by this action.
{% endhint %}

## How Media Tracker relates to Media Manager

The two workflows operate on different sides of the same playout:

* **Media Manager** drives clips on-air — schedules, takes, sequences, and the BLACKOUT panic stop.
* **Media Tracker** observes what played — a read-only log fed by Captivate’s playback database.

A typical show uses Media Manager to take items on-air and Media Tracker (off in the wings) to log what was played for review, billing, or post-show reporting.

## State and persistence

Media Tracker reads from Captivate’s `PlaybackHistoryDb`. Closing and reopening the panel mid-show preserves the log, the column layout, and the account assignments — they are stored project-side, not in panel-local state.

## Related

* [Dedicated Workflows](/control-your-show/chapter-index-2.md)
* [Use Media Manager live](/control-your-show/chapter-index-2/media-manager-live.md)
* [Play graphic layers in a specific sequence](/control-your-show/chapter-index/cue-and-take-graphics.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://captivatehelp.newbluelive.com/control-your-show/chapter-index-2/media-tracker-live.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
