TVWizard

What it is

TVWizard turns any Claude-compatible AI chat into a universal remote. Pair your Android TV or Google TV once with a 6-digit code, and from that moment on you can say "put on Scrubs S2E5" or "turn the bedroom TV off" from your phone, your laptop, your car — anywhere you talk to Claude.

It works through the Model Context Protocol, the emerging standard for AI agents controlling real-world tools.

How it works

  ┌───────────┐       ┌─────────────────┐       ┌─────────────────────┐
  │  Claude   │──MCP─▶│  TVWizard Relay │──WS──▶│  TVWizard Bridge    │
  │  (any)    │       │ tv.djwizard.ai  │       │  (Android TV app)   │
  └───────────┘       └─────────────────┘       └─────────────────────┘
        ▲                                                  │
        └───────── pairing code (6 digits) ────────────────┘

The bridge connects outbound to the relay — no port forwarding, no VPN, no same-Wi-Fi requirement. Your TV at home obeys commands from your phone abroad.

Install (5 minutes)

1. Get the bridge APK from the latest release. Install on your Android TV or Google TV. (Sideload instructions in docs/install-bridge.md.)
2. Open the app, tap Pair. The TV shows a 6-digit code.
3. Go to tv.djwizard.ai/claim.html, type the code, pick a device name (e.g. living-room). Copy the bearer token + the Claude Desktop config snippet it generates.
4. Paste into Claude Desktop (see docs/claude-desktop.md). Restart the app.
5. Talk to your TV. Try: "What's on my living-room TV right now?" or "Put on Stranger Things season 1 episode 1."

MCP tools

Full reference with examples: docs/mcp-tools.md.

Supported providers

tv.play_title resolves titles via TMDB → JustWatch → a region-aware Android package map, with a 60-day cache. Streaming catalogs vary by country; Stremio (virtual, IMDB-keyed) fills gaps where JustWatch coverage is patchy.

Pricing

Early access is free. Pricing tiers are finalized at tv.djwizard.ai/pricing.html.

Privacy + trust

• Open-source bridge. Audit exactly what runs on your TV.
• Hosted in Frankfurt (EU), GDPR-compliant. Privacy policy.
• Your command content is not logged, not sold, not used to train anything.
• Fails loudly — if the TV is offline, your AI gets an immediate error, not a queued ghost command.

Status

• Relay: live at tv.djwizard.ai. Uptime: stats.uptimerobot.com.
• v0.3.0 (April 2026): six MCP tools, full title resolution chain, public claim UX. See CHANGELOG.md.
• v0.4 (next): Samsung Tizen bridge, user accounts for multi-household, Claude.ai-native connector registration.

Support

• Bug / issue: open an issue
• General: [email protected]
• Security: [email protected] (see SECURITY.md)
• Business / hotels: [email protected]

License

Documentation in this repo is under MIT. The bridge APK is Apache 2.0 (source: coming soon). The relay is source-available, non-commercial.