> For the complete documentation index, see [llms.txt](https://wiki.crosswatch.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.crosswatch.app/crosswatch/scrobble/recent-activity.md).

# Recent Activity

Recent Activity is a local CrossWatch activity log.

It shows recently scrobbled movies and episodes on the **Main** dashboard.

It answers a simple question:

> What did CrossWatch just scrobble, where did it come from, and where did it go?

{% hint style="info" %}
Recent Activity is local to CrossWatch.

It does not replace provider-side watch history.

It is an audit trail for what CrossWatch processed.
{% endhint %}

### What each entry shows

Each item in the widget or history view can include:

* title
* season and episode number for episodes
* source provider and source profile
* target provider and target profile
* media type (`movie` or `episode`)
* scrobble progress percent
* relative time, such as `just now`, `5m ago`, or `2h ago`
* method, such as **Watcher** or **Webhook**
* failed status when the activity entry was recorded as failed

Only movies and episodes appear in Recent Activity.

### When activity is recorded

CrossWatch records activity when a movie or episode is scrobbled.

#### Watcher

Activity is recorded when playback reaches the configured scrobble or complete threshold and CrossWatch successfully sends the stop scrobble to the target provider.

#### Webhooks

Activity is recorded when CrossWatch receives a valid stop or scrobble event and processes it successfully.

Ignored, suppressed, debounced, or duplicate webhook events are not added.

### Dashboard widget

The **Main** dashboard includes a **Recent Activity** block in the statistics area.

It gives you a quick view of the latest local scrobble events without opening logs or provider dashboards.

<figure><img src="/files/0OtLnpwbBhlDCuHRxJUx" alt="Recent Activity widget on the Main dashboard"><figcaption><p>Recent Activity on the Main dashboard.</p></figcaption></figure>

Each row shows the activity flow:

```
Source provider/profile -> Target provider/profile
```

Example:

```
Plex / Default -> Trakt / Default
```

This is useful when you run multiple source or target profiles.

### View all activity

Click **View all** to open the full **Scrobble Activity** history.

<figure><img src="/files/icx1BjFifoVWUemmROBz" alt="Scrobble Activity full history view"><figcaption><p>The full Scrobble Activity history view.</p></figcaption></figure>

The full history view includes:

* search
* media type filter
* status filter
* load-more pagination

Search can match fields such as:

* title
* source provider or target provider
* source profile or target profile
* account or profile text
* method

The media filter supports:

* **All media**
* **Movies**
* **Episodes**

The status filter supports:

* **All statuses**
* **Scrobbled**
* **Failed**

Pagination keeps larger activity logs easy to review.

### UI settings

Use **Settings → UI settings → User interface** to control the widget.

#### Recent activity

Show or hide the **Recent Activity** dashboard widget.

Options:

* **Show**
* **Hide**

Default:

```
Show
```

When hidden, CrossWatch can still keep local activity records.

Only the dashboard widget is hidden.

#### Recent activity display

Choose how many items the dashboard shows.

Options:

* **Last 3 items**
* **Last 4 items**
* **Last 5 items**
* **Last 24 hours, max 5**
* **Last 48 hours, max 5**
* **Last 72 hours, max 5**

Default:

```
Last 3 items
```

Time-window modes show only items inside the selected range.

Example: **Last 24 hours, max 5** shows up to five items from the last day.

### Storage and privacy

Recent Activity is stored locally in:

```
.cw_state/activity_history.json
```

On Docker-style `/config` deployments, that becomes:

```
/config/.cw_state/activity_history.json
```

The log stays on your CrossWatch instance.

It is not sent to CrossWatch servers.

CrossWatch keeps a capped local history so the file does not grow forever.

The default cap is `1000` activity entries.

### Clearing Recent Activity

Use **Settings → Maintenance → Clear activity log** to remove the local history.

This clears only CrossWatch’s local Recent Activity list.

It does not remove watch history from Plex, Jellyfin, Emby, Trakt, SIMKL, MDBList, or any other provider.

The **Clean Everything** maintenance action also clears the local activity log.

### Related topics

* Scrobble overview: [Scrobble](/crosswatch/scrobble.md)
* Recommended real-time path: [Watcher](/crosswatch/scrobble/watcher.md)
* Footer now-playing widget: [Playing Card](/crosswatch/scrobble/playing-card.md)
* UI controls: [User interface](/crosswatch/navigation/ui-settings/user-interface.md)
* Cleanup tools: [Maintenance](/crosswatch/maintenance.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://wiki.crosswatch.app/crosswatch/scrobble/recent-activity.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.
