home-assistant.io/source/_integrations/yamaha.markdown

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_platforms	ha_integration_type
Yamaha Network Receivers	Instructions on how to integrate Yamaha Network Receivers into Home Assistant.	Media Player	0.16	Local Polling	yamaha	media_player	integration

The yamaha platform allows you to control Yamaha Network Receivers from Home Assistant.

Supported devices:

• HTR-4065
• RX-V473
• RX-V573
• RX-V585
• RX-V673
• RX-V685
• RX-V773
• RX-V3067
• And more

To add a Yamaha Network Receiver to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
media_player:
  - platform: yamaha

{% configuration %} name: description: Name of the device. This overrides the default name (often model number) that is returned by the device. required: false type: string host: description: IP address or hostname of the device. required: false type: string source_ignore: description: List of sources to hide in the front-end. required: false type: list source_names: description: Mapping of internal AVR source names to custom ones, allowing one to rename e.g., HDMI1 to ChromeCast. required: false type: list zone_ignore: description: List of zones to hide in the front-end. required: false type: list zone_names: description: Mapping of zone names to custom ones, allowing one to rename e.g., Main_Zone to Family Room. required: false type: list {% endconfiguration %}

Discovery notes

• If the discovery integration is enabled, all units on the network will be discovered using UPnP.
• For receivers that support more than one zone, Home Assistant will add one media player per zone supported by the player, named "$name Zone 2" and "$name Zone 3".
• If you specify host manually, you must enable network standby on your receiver, or else startup of Home Assistant will hang if you have your receiver switched off.
• In some cases, auto-discovery fails due to a known bug in the receiver's firmware. It is possible to manually specify the receiver's IP address or via its hostname (if it is discoverable by your DNS) then.

Supported operations

• Media players created by Yamaha support powering on/off, mute, volume control and source selection. Playback controls, for instance play and stop are available for sources that supports it.
• The play_media service is implemented for NET RADIO source only. The media_id is a > separated string of the menu path on the vtuner service. For instance Bookmarks>Internet>WAMC 90.3 FM.

Example configuration

A full configuration example will look like the sample below:

# Example configuration.yaml entry
media_player:
  - platform: yamaha
    host: 192.168.0.10
    source_ignore:
      - "AUX"
      - "HDMI6"
    source_names:
      HDMI1: "ChromeCast"
      AV4: "Vinyl"
    zone_ignore:
      - "Zone_2"
    zone_names:
      Main_Zone: "Family Room"

Example play_media script

The play_media function can be used in scripts easily to build media player presets. When done in scripts, the sequence will also allow you to set volume per source.

# Example play_media script
#
# This is for an environment where Zone 2 of the receiver named
# `Living Room Stereo` drives outdoor speakers on the porch.
script:
 rp_porch:
    alias: "Radio Paradise Porch"
    sequence:
      - service: media_player.turn_on
        target:
          entity_id: media_player.living_room_stereo_zone_2
      - service: media_player.volume_set
        target:
          entity_id: media_player.living_room_stereo_zone_2
        data:
          volume_level: 0.48
      - service: media_player.play_media
        target:
          entity_id: media_player.living_room_stereo_zone_2
        data:
          media_content_type: "NET RADIO"
          media_content_id: "Bookmarks>Internet>Radio Paradise"

Service enable_output

Enable or disable an output port (HDMI) on the receiver.

Service data attribute	Optional	Description
entity_id	yes	String or list of strings that point at entity_ids of Yamaha receivers.
port	no	Port to enable or disable, e.g., hdmi1.
enabled	no	To enable set true, otherwise set to false.

Service menu_cursor

Control the menu cursor.

Service data attribute	Optional	Description
entity_id	yes	String or list of strings that point at entity_ids of Yamaha receivers.
cursor	no	Name of the cursor key to press: up, down, left, right, select, return

Service select_scene

Select a scene on the receiver.

Service data attribute	Optional	Description
entity_id	yes	String or list of strings that point at entity_ids of Yamaha receivers.
scene	no	Scene to select, e.g., BD/DVD Movie Viewing, TV Viewing, NET Audio Listening or Radio Listening.