@deckyard/tmdb

A typed Jennifer client for The Movie Database. One Client reaches both API generations: the v3 catalogue (search, discovery, films, series, people, images, watch providers) and v4 user authentication, accounts and custom lists. Replies are folded into structs, arguments are checked before the request, and every failure is Error{kind: "tmdb"}.

Install

jvc add @deckyard/tmdb

Or unpack src/ from a release archive (deckyard-tmdb-<version>.tar.gz) into vendor/deckyard/tmdb/.

Requires Jennifer 0.25.0 or newer and the default jennifer binary: the deck declares the net capability, which jennifer-tiny lacks.

Example

use io;
import "@deckyard/tmdb/" as tmdb;

# TMDB_ACCESS_TOKEN=eyJ... jennifer run app.j
def c as tmdb.Client init tmdb.clientFromEnv();
def hits as tmdb.MoviePage init tmdb.searchMovies($c, "blade runner", 1);

for (def m in $hits.results) {
    io.printf("%s (%s)  %.1f\n", $m.title, tmdb.year($m.releaseDate), $m.voteAverage);
}

def film as tmdb.MovieBundle init tmdb.movieBundle($c, $hits.results[0].id);
io.printf("%d min, directed by %s\n", $film.movie.runtime, tmdb.directorOf($film.credits));

The token is the long eyJ... API Read Access Token from https://www.themoviedb.org/settings/api, not the 32-character API key; see Getting started.

Documentation

deckyard.github.io/deck-tmdb, with every export in the cheatsheet. Runnable programs are in examples/. tools/check-all.sh runs the CI gate.

Licence

LGPL-3.0-only, see LICENSE. Copyright (C) 2026 mplx <[email protected]>.

This product uses the TMDB API but is not endorsed or certified by TMDB. Using the API means agreeing to its terms of use, which require attribution in any application built on it. The watch-provider data is JustWatch's and carries its own attribution requirement.