Sony Bravia TV

The Sony Bravia TV integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control a Sony Bravia TV from Home Assistant. You can turn the TV on and off, change the volume and the input source, open apps, switch TV channels, and send remote control commands, for example from a dashboard or an automationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more].

Supported devices

The following devices are known to be supported by the integration:

• Almost all Sony Bravia TV models from 2013 and newer

Unsupported devices

The following devices are not supported by the integration:

• Sony Bravia TV models older than 2013. You can control these TVs with the HDMI-CEC, Broadlink, or Kodi integrations instead.

Prerequisites

The integration connects to your TV over your local network. Before you add the integration, allow remote control on the TV and choose how Home Assistant authenticates with it.

1. Turn on your TV and connect it to the same network as Home Assistant.
2. On your TV, go to Settings > Network > Remote device settings and enable Control remotely.
3. Choose one of the two authentication methods:
   • Pre-shared key (PSK): A secret key that you define on your TV. This method is recommended because it is more reliable and stable. To set it up, go to Settings > Network > Home Network Setup > IP Control, set Authentication to Normal and Pre-Shared Key or Pre-Shared Key, and enter a key of your choice.
   • PIN code: The TV shows a PIN code on the screen during setup. This method does not require additional settings on the TV.

Menu titles may differ slightly between models. If needed, refer to your model’s manual. For more information about the authentication methods, see IP Control Authentication in the Sony documentation.

Configuration

To add the Sony Bravia TV device to your Home Assistant instance, use this My button:

Sony Bravia TV can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Supported functionality

The Sony Bravia TV integration provides the following entities.

Media player

The media player entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] shows whether the TV is on or off, the current input source, the volume level, and the TV channel that is currently playing. You can use it to:

• Turn the TV on and off.
• Set the volume, change it step by step, and mute or unmute the TV.
• Select the input source, such as an HDMI input.
• Play, pause, and stop playback.
• Go to the next or previous track. When you watch TV, this switches to the next or previous channel.
• Open an app or switch to a TV channel. For details, refer to Opening apps and channels in automations.
• Browse the installed apps and TV channels. For details, refer to Media browser.

Media browser

Using the media browser, you can view a list of all installed applications and TV channels and launch them. You can access the media browser from the Media section in the Home Assistant side menu or by selecting the Browse media button on the media player card.

Opening apps and channels in automations

To open an app or switch to a TV channel from an automation or a script, use the Play specified media action and select your Bravia TV media player as the target.

The TV selects the best matching application or channel according to the media content ID. Matches can use a channel number, exact app or channel name, part of an app or channel name, or a URI string.

Remote

The remote entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] lets you turn the TV on and off and send remote control commands to it, like pressing the buttons on the TV remote. Use the Send remote command action to send commands.

Sending a remote command from an automation

To send a Bravia remote command from an automation or a script:

1. Go to Settings > Automations & scenes.
2. Open an existing automation or script, or select Create automation > Create new automation.
3. If you’re setting up a new automation, add a trigger in the When section. Scripts don’t need a trigger. They run when something else calls them.
4. In the Then do section, select Add action.
5. Select what you want to control. Under By target, select the Bravia TV remote.
6. From the actions shown for that target, select Send remote command.
7. Enter the command to send.
8. Select Save.

The available commands depend on your TV model. To see the commands your TV supports, send an unsupported command, such as Test, and then check Settings > System > Logs. The log message lists all available commands. You can also find them in the diagnosticsThe diagnostics integration provides a way to download diagnostic data from a device or integration for sharing in issue reports. Sharing diagnostics data when reporting an issue allows developers to diagnose and fix your reported problem quicker. [Learn more] data, which you can download from the device page under Settings > Devices & services > Sony Bravia TV.

Some commonly used commands are:

• Up
• Down
• Left
• Right
• Confirm
• Return
• Home
• Exit
• Rewind
• Forward
• ActionMenu
• SyncMenu
• Num0
• Num1
• Num2
• Num3
• Num4
• Num5
• Num6
• Num7
• Num8
• Num9

Buttons

• Restart
  • Description: Restarts the TV.
• Terminate apps
  • Description: Closes all applications that are running on the TV.

Using with Google Cast

The Sony Bravia TV integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides information about the power status of the device, current source, and volume. It gives you the ability to control playback, run applications, and send remote control commands. Due to limitations of the Bravia REST API, it does not provide information about the currently playing content in applications (app name, media title, duration, play/pause state, and more). In turn, the Google Cast integration does not provide reliable information about the power status of the device (for example, on Home Screen) and does not allow you to control playback in Android apps without MediaSession support. However, it can display full information about the content being played in supported apps.

If your TV runs on Android or Google TV, you can use the Google Cast integration together with the Sony Bravia TV integration. For convenience, you can combine the two media players into one using the Universal Media Player integration. The universal media player automatically selects the appropriate active media player entity.

media_player:
  - platform: universal
    name: Sony TV
    unique_id: sony_tv_combined
    device_class: tv
    children:
      - media_player.sony_tv_native
      - media_player.sony_tv_cast
    active_child_template: >
      {% if state_attr('media_player.sony_tv_native', 'media_content_id') %}
         media_player.sony_tv_native
      {% endif %}
    attributes:
      source: media_player.sony_tv_native|source
      source_list: media_player.sony_tv_native|source_list
    browse_media_entity: media_player.sony_tv_native
    commands:
      turn_off:
        action: media_player.turn_off
        data:
          entity_id: media_player.sony_tv_native
      turn_on:
        action: media_player.turn_on
        data:
          entity_id: media_player.sony_tv_native
      select_source:
        action: media_player.select_source
        data:
          entity_id: media_player.sony_tv_native
          source: "{{ source }}"
      media_play:
        action: media_player.media_play
        target:
          entity_id: media_player.sony_tv_native
      media_pause:
        action: media_player.media_pause
        target:
          entity_id: media_player.sony_tv_native
      media_play_pause:
        action: media_player.media_play_pause
        target:
          entity_id: media_player.sony_tv_native
      media_previous_track:
        action: media_player.media_previous_track
        target:
          entity_id: media_player.sony_tv_native
      media_next_track:
        action: media_player.media_next_track
        target:
          entity_id: media_player.sony_tv_native

Sony Bravia TV automation examples

These examples show how to open apps, switch channels, and send remote commands from automations.

Automation: open YouTube at a set time

This automation opens the YouTube app on the Bravia TV every evening.

• Trigger: Time: 19:00
• Action: Play specified media
  • Target: Bravia TV media player
  • Media content ID: YouTube
  • Media content type: app

alias: "Open YouTube on the Bravia TV in the evening"
triggers:
  - trigger: time
    at: "19:00:00"
actions:
  - action: media_player.play_media
    target:
      entity_id: media_player.bravia_tv
    data:
      media_content_id: "YouTube"
      media_content_type: app

Automation: switch to a TV channel in the morning

This automation switches the Bravia TV to channel 11 on weekday mornings.

• Trigger: Time: 07:00
• Condition: Time: Monday through Friday
• Action: Play specified media
  • Target: Bravia TV media player
  • Media content ID: 11
  • Media content type: channel

alias: "Switch the Bravia TV to channel 11 on weekday mornings"
triggers:
  - trigger: time
    at: "07:00:00"
conditions:
  - condition: time
    weekday:
      - mon
      - tue
      - wed
      - thu
      - fri
actions:
  - action: media_player.play_media
    target:
      entity_id: media_player.bravia_tv
    data:
      media_content_id: "11"
      media_content_type: channel

Automation: move down in the TV menu after opening the home screen

This automation opens the Bravia TV home screen, waits briefly, and then sends the Down command.

• Trigger: Time: 20:00
• Action: Send remote command
  • Target: Bravia TV remote
  • Command: Home
• Action: Wait for time to pass (delay)
  • Duration: 00:00:02
• Action: Send remote command
  • Target: Bravia TV remote
  • Command: Down

alias: "Move down in the Bravia TV menu after opening home"
triggers:
  - trigger: time
    at: "20:00:00"
actions:
  - action: remote.send_command
    target:
      entity_id: remote.bravia_tv
    data:
      command: "Home"
  - delay: "00:00:02"
  - action: remote.send_command
    target:
      entity_id: remote.bravia_tv
    data:
      command: "Down"

Data updates

The Sony Bravia TV integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] the TV over your local network. When the TV is on, the integration polls it every 10 seconds. When the TV is in standby, the integration polls it every 2 minutes. The integration also refreshes the data when the TV announces itself on the network, for example right after you turn it on.

Known limitations

• The Bravia REST API does not provide information about the content playing in apps, such as the app name, media title, duration, or play/pause state. While an app is running, the media player shows Smart TV as the media title. To get this information, use the integration together with Google Cast.
• The available remote commands depend on your TV model.
• Because the integration polls the TV, the TV keeps its network interface active while in standby. This can increase the standby power consumption of the TV to about 15 W. Some applications installed on the TV cause the same behavior. If this matters to you, you can disable polling in the System options of the integration and define a custom polling interval with an automation. The TV state then only updates when that automation runs.

Troubleshooting

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

1. Go to Settings > Devices & services and select the integration card.
2. Next to the entry you want to remove, select the three dots menu. Then, select Delete.
   • Depending on the integration, the entries are listed under one of the following headings:
     • Devices
     • Hubs
     • Services
     • Integration entries
3. To confirm, select Delete.
   • Home Assistant also deletes the devices and entities of the entry.
4. If Home Assistant asks you to restart, restart Home Assistant.
5. If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.
   • If you keep them, Home Assistant uses them automatically when you add the integration again.
   • To delete them later, refer to Deleting application credentials.

If you set up the integration with PIN code authentication, Home Assistant stays registered on your TV after you remove the integration. To remove the registration, on your TV, go to Settings > Network > Remote device settings > Deregister remote device and remove the Home Assistant entry. If you set up the integration with a pre-shared key (PSK), there is nothing else to clean up on the TV.