watchwhere

CLI to check which of your streaming subs has a movie, in your region.

why

I have a handful of streaming subs and I always forget which one has what. Got tired of opening JustWatch every time — or clicking through each app one by one to search. Terminal version of that lookup.

quick start

Needs Bun (≥ 1.1).

bun install -g watchwhere
ww init       # asks for region + subscriptions
ww matrix     # search a movie

That's it. No TMDB token, no signup — calls go through a hosted proxy by default.

with your own TMDB token

Don't want to use the hosted proxy? Get a free v4 Read Access Token from themoviedb.org/settings/api (the v4 Read Access Token, not the v3 API key), then:

WATCHWHERE_PROXY=off ww init   # asks for token, region, subs
ww matrix

Or point at your own self-hosted proxy:

export WATCHWHERE_PROXY=https://your-proxy.example.com
ww init

commands

ww <title>       search a movie, show, or person
ww init          set up region, subscriptions (and token, if not using proxy)
ww subs          edit subscriptions
ww lang          change UI language (en / tr)
ww region        change region
ww config        show current config
ww --help
ww --version

search by people

sometimes you don't have a title in mind, you have a person. type a name:

ww paul thomas anderson   # films he directed
ww daniel day-lewis       # films he's in

pick the person from the list and you get their films that are on your subs, in your region, first. one lookup, no clicking through each app. hit "see full filmography" to browse everything they did.

directors get the films they directed, actors get the ones they acted in.

notes

• config lives in ~/.watchwhere/config.json
• ui defaults to english, turkish available via ww lang
• self-host your own proxy from proxy/ if you'd rather not use the hosted one

attribution

this product uses the TMDB API but is not endorsed or certified by TMDB.

license

MIT