yolo/arr
3
0
Fork 0
Code Issues 12 Pull Requests Actions Packages Projects Releases Wiki Activity

Trailer resolution endpoint keyed on a TMDB id #144

New Issue
Closed
opened 2026-08-23 19:40:42 +01:00 by naps62-yolo · 0 comments
naps62-yolo commented 2026-08-23 19:40:42 +01:00
Owner
Copy Link
Copy Source

Depends on: #143

§9.6 resolves a trailer on click rather than up front, because TMDB's search
responses carry no videos and prefetching one detail call per rendered row
would put ~20 requests behind a search-as-you-type box.

That needs an endpoint keyed on a TMDB id, not a local id — the chip appears
on TMDB rows for titles that are not in the library and have no local row to
address.

GET /api/trailer?kind=movie|tv&tmdb_id=693134
  200 { "youtube_key": "...", "name": "Official Trailer" }
  404 { "error": "no trailer" }
  • Reads movie_videos / series_videos from #143, so the selection rule lives
    in one place and this handler does not re-implement it.
  • Served through arr-meta's 24h cache: the second click on the same title, by
    anyone, costs nothing upstream.
  • No TMDB key configured behaves exactly like the existing tmdb_client() path
    in arr-api/src/search.rs — 503, same error body shape.
  • A title TMDB knows but has no video for is a 404, not a 500. It is an ordinary
    outcome and the browser renders it as "no trailer", so it must be
    distinguishable from an upstream failure.

Annotate for OpenAPI like the handlers around it.

Do not start until blitz/tv-tracking is on main — it rewrites
arr-api/src/search.rs, which this sits next to.

Depends on: #143 §9.6 resolves a trailer on click rather than up front, because TMDB's search responses carry no videos and prefetching one detail call per rendered row would put ~20 requests behind a search-as-you-type box. That needs an endpoint keyed on a **TMDB id, not a local id** — the chip appears on TMDB rows for titles that are not in the library and have no local row to address. ``` GET /api/trailer?kind=movie|tv&tmdb_id=693134 200 { "youtube_key": "...", "name": "Official Trailer" } 404 { "error": "no trailer" } ``` - Reads `movie_videos` / `series_videos` from #143, so the selection rule lives in one place and this handler does not re-implement it. - Served through arr-meta's 24h cache: the second click on the same title, by anyone, costs nothing upstream. - No TMDB key configured behaves exactly like the existing `tmdb_client()` path in `arr-api/src/search.rs` — 503, same error body shape. - A title TMDB knows but has no video for is a 404, not a 500. It is an ordinary outcome and the browser renders it as "no trailer", so it must be distinguishable from an upstream failure. Annotate for OpenAPI like the handlers around it. **Do not start until `blitz/tv-tracking` is on main** — it rewrites `arr-api/src/search.rs`, which this sits next to.
naps62-yolo added this to the Rich metadata milestone 2026-08-23 19:40:42 +01:00
naps62-yolo added the area/apidifficulty/easyphase/6-tvtype/feature labels 2026-08-23 19:40:42 +01:00
naps62-yolo added a new dependency 2026-08-23 19:42:42 +01:00
#148 Search results: poster, rating, overview and trailer chip
naps62-yolo added a new dependency 2026-08-23 19:42:42 +01:00
#149 Movie detail page at /movies/{id}
naps62-yolo added a new dependency 2026-08-23 19:42:42 +01:00
#150 Series detail page: metadata header, cast and trailer
naps62-yolo added phase/5-ui and removed phase/6-tv labels 2026-08-23 19:42:55 +01:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/api
arr-api
 area/ci
CI and test harness
 area/compat
arr-compat
 area/core
arr-core
 area/daemon
arr-daemon
 area/db
arr-db
 area/dl
arr-dl
 area/indexer
arr-indexer
 area/infra
workspace and tooling
 area/meta
arr-meta
 area/parse
arr-parse
 area/probe
arr-probe
 area/subs
arr-subs crate: providers, extraction, translation, sync
 area/web
web/
 difficulty/easy
bounded, obvious approach, few files
 difficulty/hard
subtle correctness or cross-cutting
 difficulty/moderate
multiple files, judgement, an interface to design
 difficulty/trivial
one file, mechanical, no design decisions
 phase/1-skeleton
workspace, CI, config, database, empty API and SPA
 phase/2-logic
parsing and policy engine, pure, no network
 phase/3-sourcing
TMDB and Prowlarr, read-only
 phase/4-movies
movies end to end
 phase/5-ui
search, buckets, library views, queues
 phase/6-tv
seasons, episodes, tracking, derived status
 phase/7-people
owner tags and notifications
 phase/8-compat
Jellyseerr shim
 phase/9-subtitles
build order: subtitles, DESIGN.md §15
 type/bug
type/chore
type/feature
type/test
No labels area/api difficulty/easy phase/5-ui type/feature
Milestone
No items
No Milestone Rich metadata
Projects
Clear projects
No projects
Assignees
Clear assignees
hermes (Hermes (agent)) naps62 (Miguel Palhas) naps62-yolo (naps62-yolo (agent))
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Blocks
#148 Search results: poster, rating, overview and trailer chip
yolo/arr
#149 Movie detail page at /movies/{id}
yolo/arr
#150 Series detail page: metadata header, cast and trailer
yolo/arr
Depends on
#143 arr-meta: title detail with credits, videos and external ids
yolo/arr
Reference: yolo/arr#144