tmdb-cli — Movie & TV Discovery from the Terminal

Search movies and TV shows by keyword, discover by genre/certification/rating/date, check trending and upcoming releases, browse genre lists, and view US certification ratings — all from TMDb's v3 API.

Setup

1. Get a free API key or access token at themoviedb.org/settings/api
2. Set one of these environment variables:

export TMDB_ACCESS_TOKEN="your-tmdb-access-token"   # preferred
# OR
export TMDB_API_KEY="your-tmdb-api-key"

--help and --dry-run work without credentials (lazy auth).

Essential Commands