Source: https://dinakar-rewind.docs.pageloop.ai/domains/watching

# Watching

## Overview

The Watching domain tracks movies and TV shows from three 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.
- **Trakt**: movie and TV episode watch history, so scrobbles from outside Plex still land here.

All sources feed into a unified database enriched with TMDB metadata such as posters, ratings, genres, directors, and summaries. Every watch carries a `source` (`plex`, `letterboxd`, `trakt`, or `manual`) so you can tell where it came from. Browse every endpoint in the [API reference](/api-reference/watching/getwatchingrecent).

## 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/getwatchingyearinreview) 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) and ask in natural language, like what you watched last month or for your top-rated films of a given year. The [`get_recent_watches` tool](/reference/mcp-tools/watching) renders an interactive poster grid, and Claude answers everything else by querying the [database directly with SQL](/mcp/overview).