ethsmaa/watchwhere

★ 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

Things people build with this

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.

Tech stack

TypeScriptBun

Getting 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.

In plain English

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?

Open on GitHub → Explain another repo

← ethsmaa on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.