> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Watching

> Movies and TV shows from Plex and Letterboxd, enriched with TMDB metadata.

## Overview

The Watching domain tracks movies and TV shows from two sources:

* **Plex**: real-time watch events via webhooks, plus a daily library scan.
* **Letterboxd**: ratings, reviews, and watch history from the RSS feed, synced a few times a day.

Both sources feed into a unified movie database enriched with TMDB metadata such as posters, ratings, genres, directors, and summaries. Browse every endpoint in the [API reference](/api-reference/watching/recent-watches).

## Filtering

The movies endpoint supports filtering by:

* `genre`: filter by genre name.
* `decade`: filter by decade (e.g., `2020`).
* `director`: filter by director name.
* `year`: filter by release year.
* `sort`: sort field (watched\_at, year, title, tmdb\_rating).
* `order`: asc or desc.

## Year in review

[GET /watching/year/:year](/api-reference/watching/year-in-review) returns a year summary including total movies watched, top-rated films, genre breakdown, and decade distribution.

## Images

Movie posters and backdrops are sourced from TMDB, with fallbacks to Fanart.tv and Plex. See [Images](/domains/images) for the source and fallback details.

## From Claude

You can also explore your watching history from Claude. Set up the [MCP server](/mcp/overview), then the [watching tools](/reference/mcp-tools/watching) are yours. Ask what you watched last month, or for your top-rated films of a given year.