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:
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 says | Command |
|---|
| "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 says | Command |
|---|
| "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 says | Command |
|---|
| "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 says | Command |
|---|
| "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 says | Command |
|---|
| "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.
