Sony Bravia TV Control#

You control a Sony Bravia TV on the user's home network via a Python script that talks to the TV's REST API and IRCC remote interface.

How It Works#

All commands go through one script: {baseDir}/scripts/tv_control.py

Run it with uv run:

text

uv run {baseDir}/scripts/tv_control.py --action <action> [--value <n>] [--app <name>] [--buttons <buttons>]

Command Mapping#

When the user says something like the phrases below, run the corresponding command.

Power#

User saysCommand"turn on the TV" / "switch on TV" / "power on"--action power_on"turn off the TV" / "switch off" / "power off" / "shut down TV"--action power_off

Volume#

User saysCommand"volume up" / "louder" / "increase volume"--action volume_up"volume down" / "quieter" / "decrease volume" / "lower volume"--action volume_down"set volume to 30" / "volume 30" / "make it 30"--action volume_set --value 30"mute" / "unmute" / "toggle mute"--action mute

Volume range is 0-100. Values outside this range will be rejected.

Apps#

User saysCommand"open Netflix" / "play Netflix" / "launch Netflix"--action open_app --app netflix"open YouTube" / "put on YouTube"--action open_app --app youtube"open Hotstar" / "open JioCinema"--action open_app --app hotstar"open Prime Video" / "open Amazon Prime"--action open_app --app prime"open [any app name]"--action open_app --app "<name>""what apps are installed?" / "list apps"--action list_apps

Note: Hotstar and JioCinema use the same app (JioCinema absorbed Disney+ Hotstar in India). Both hotstar and jiocinema keys work.

Remote Control / Navigation#

User saysCommand"press OK" / "select" / "confirm"--action remote --buttons "ok""go up" / "navigate up"--action remote --buttons "up""go down" / "navigate down"--action remote --buttons "down""go left" / "go right"--action remote --buttons "left" or "right""go back" / "press back"--action remote --buttons "back""go home" / "press home"--action remote --buttons "home""play" / "resume"--action remote --buttons "play""pause"--action remote --buttons "pause""fast forward"--action remote --buttons "forward""rewind"--action remote --buttons "rewind""switch to HDMI 1" / "HDMI 2"--action remote --buttons "hdmi1" or "hdmi2""press subtitle" / "subtitles"--action remote --buttons "subtitle""scroll down 3 times and select"--action remote --buttons "down*3,ok""what buttons are available?"--action list_buttons

You can chain multiple buttons with commas: --buttons "down,down,ok". Use name*N for repeats: --buttons "down*5,ok".

Status#

User saysCommand"TV status" / "is the TV on?" / "what's playing?" / "what volume?"--action status

Response Guidelines#

• After running a command, report the script output to the user in a brief, natural way.
• If the script prints an error (connection timeout, missing env var), tell the user what went wrong and suggest a fix (check if TV is on, check network, etc.).
• If the user asks to open an app not in the known list, the script will search installed apps automatically — just pass the name.
• For "volume up/down" repeated requests like "louder louder louder", run volume_up multiple times.
• If the TV is off and the user asks for anything other than power on, suggest turning it on first.
• For navigation sequences, chain buttons in a single remote command rather than running multiple commands.

Not Supported#

• Keyboard / text input — the TV API does not support typing text into search fields.
• Screen mirroring — cannot start or manage Miracast/screen mirroring sessions.
• Casting — cannot initiate Chromecast sessions (use your phone for that).

Compatibility#

• Android TV (2015+): Full support — REST API + IRCC + WoL.
• Google TV: Works with caveats — some newer models may require re-pairing the PSK after firmware updates.
• Pre-2015 (non-Android): Not supported — these models use a different API.

Notes#

• Power ON uses Wake-on-LAN — it sends a magic packet, so the TV must have Remote Start enabled and SONY_TV_MAC must be set.
• All other commands use the REST API — requires SONY_TV_IP and SONY_TV_PSK.
• The TV must be on the same network as the machine running this script.