What is watchwhere?

ethsmaa/watchwhere — explained in plain English

Analysis updated 2026-06-24

★ 16TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((watchwhere))
    What it does
      Search by title
      Shows streaming availability
      Filters by your subscriptions
    Setup
      Install via Bun
      Set region and subscriptions
      Optional TMDB token
    Commands
      Search
      Update subscriptions
      Change region
      Switch language
    Tech stack
      TypeScript
      Bun runtime
      TMDB API

mindmap root((watchwhere)) What it does Search by title Shows streaming availability Filters by your subscriptions Setup Install via Bun Set region and subscriptions Optional TMDB token Commands Search Update subscriptions Change region Switch language Tech stack TypeScript Bun runtime TMDB API

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Search your streaming subscriptions from the terminal to find which service has a movie or show in your country.

USE CASE 2

Set up a personal streaming availability checker without signing up for any external accounts, using the built-in proxy.

USE CASE 3

Self-host the proxy component to avoid relying on the author's hosted service.

What is it built with?

TypeScriptBun

How does it compare?

	ethsmaa/watchwhere	dabao-yi/model-flux	denjino/horizon-view
Stars	16	16	16
Language	TypeScript	TypeScript	TypeScript
Setup difficulty	easy	moderate	moderate
Complexity	2/5	3/5	2/5
Audience	general	developer	general

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Bun runtime to be installed, no API key needed by default thanks to the built-in hosted proxy.

MIT license, use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Watchwhere is a command-line tool that tells you which of your streaming subscriptions currently has a particular movie or show available in your country. The author built it because they kept forgetting which service had what, and opening a browser to check a streaming aggregator site felt like extra friction. This tool brings that lookup to the terminal. Setup takes three commands: install the tool globally using Bun (a JavaScript runtime), run an init command that asks for your region and which subscriptions you have, then search by title. By default, it routes data requests through a hosted proxy so you do not need to create an account or obtain an API token from the movie database it relies on. If you prefer not to use the hosted proxy, you can get a free access token from The Movie Database website and run in direct mode instead, or self-host the included proxy code. The tool supports a handful of commands beyond searching: you can update your subscription list, change your region, switch the interface language between English and Turkish, and view your current configuration. All settings are stored in a single JSON file in your home directory. Watchwhere uses TMDB's streaming availability data but is not affiliated with or endorsed by TMDB. The license is MIT.

Copy-paste prompts

Prompt 1

Using the watchwhere CLI tool, how do I search for a specific movie and see which of my streaming subscriptions has it? Show me the exact command.

Prompt 2

How do I configure watchwhere with my list of streaming subscriptions and my country region using the init command?

Prompt 3

How do I switch watchwhere from using the hosted proxy to direct mode with my own TMDB API token?

Prompt 4

How do I add or remove streaming services from my watchwhere subscription list after initial setup?

Frequently asked questions