Find content by name and play it on TV.

This is the primary tool. Resolves the content ID automatically, then deep-links into the app on your TV.

Cast a Netflix/YouTube/Spotify URL to the TV.

Paste any streaming URL. stv parses the platform and content ID automatically.

Play the next episode. Continues from watch history.

Show trending content on Netflix and/or YouTube.

Get personalized recommendations based on watch history + trending.

Turn TV on or off.

Get or set volume, step up/down, or toggle mute. All in one tool.

• No args: returns current volume + mute status

• level=25: set volume to 25

• direction="up"/"down": step volume

• mute=True/False/None: mute, unmute, or toggle

Get TV status: current app, volume, mute, model, firmware.

Get unified live TV state: playback, volume, input, power.

Returns a single snapshot for agent branching. Fields the target driver cannot supply are returned as None.

Stream tv_state snapshots via progress notifications.

Emits count progress updates spaced interval seconds apart, then returns the final snapshot. Default is 1 minute of watching.

Turn screen on or off (audio continues when off).

Launch an app, optionally with a deep link.

Use tv_play instead if you have a content name (not ID). Use this when you already have the exact content ID.

Show a toast notification on the TV screen.

Manage the play queue. Actions: add, show, play, skip, clear.

Show recent play history.

Resolve a content name to its platform ID without playing.

Run or list scene presets. Built-in: movie-night, kids, sleep, music.

List all configured TVs with name, platform, IP, and default status.

Play content on multiple TVs simultaneously (party mode).

Resolves once, launches on all targets via asyncio.gather.

List all TV groups and their members.

Get viewing insights, screen time, or subscription value analysis.

Turn the TV into a display — show dashboards, messages, clocks, or any URL.

The TV becomes a smart display. HTML is generated and served locally, then opened in the TV's browser.

Multi-room audio mode — play music with screens off.

Actions: play, stop, volume.