gitwtfhub

wtf is watchwhere?

ethsmaa/watchwhere — explained in plain English

Analysis updated 2026-05-18

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

TL;DR

A command-line tool that tells you which of your streaming subscriptions has a specific movie or show available in your country, without opening a browser.

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

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

What's in the stack?

TypeScriptBun

How it stacks up

ethsmaa/watchwhereacoyfellow/tuiportdabao-yi/model-flux
Stars161616
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity2/54/53/5
Audiencegeneraldeveloperdeveloper

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

How do you spin it up?

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.

Wtf does this do

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.

Yoink these 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

wtf is watchwhere?

A command-line tool that tells you which of your streaming subscriptions has a specific movie or show available in your country, without opening a browser.

What language is watchwhere written in?

Mainly TypeScript. The stack also includes TypeScript, Bun.

What license does watchwhere use?

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

How hard is watchwhere to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is watchwhere for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane