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

title	description	ha_category	ha_release	ha_iot_class	ha_domain	ha_platforms	ha_integration_type	related	ha_quality_scale
Monoprice Blackbird Matrix Switch	Instructions on how to integrate Monoprice Blackbird 4k 8x8 HDBaseT Matrix Switch into Home Assistant.	Media player	0.68	Local Polling	blackbird	media_player	integration	docs title /docs/configuration/ Configuration file	legacy

The blackbird platform allows you to control Monoprice Blackbird Matrix Switch (8x8) using a serial or IP connection, this integration does not support the 4x4 matrix switch.

To add a Blackbird 8x8 device to your installation, add the following to your {% term "configuration.yaml" %} file. {% include integrations/restart_ha_after_config_inclusion.md %}

# Example configuration.yaml entry
media_player:
  - platform: blackbird
    port: /dev/ttyUSB0
    zones:
      1:
        name: Living Room
    sources:
      3:
        name: BluRay

{% configuration %} port: description: The serial port to which Blackbird matrix switch is connected. port and host cannot be specified concurrently. required: exclusive type: string host: description: The IP address of the Blackbird matrix switch. port and host cannot be specified concurrently. required: exclusive type: string zones: description: This is the list of zones available. Valid zones are 1, 2, 3, 4, 5, 6, 7, 8. Each zone must have a name assigned to it. required: true type: map keys: ZONE_NUMBER: description: The name of the zone. type: string sources: description: The list of sources available. Valid source numbers are 1, 2, 3, 4, 5, 6, 7, 8. Each source number corresponds to the input number on the Blackbird matrix switch. Similar to zones, each source must have a name assigned to it. required: true type: map keys: ZONE_NUMBER: description: The name of the source. type: string {% endconfiguration %}

Action blackbird.set_all_zones

Set all zones to the same input source. This action allows you to immediately synchronize all the TVs in your home. Regardless of entity_id provided, all zones will be updated.

Data attribute	Optional	Description
entity_id	yes	String that points at an entity_id of a zone.
source	no	String of source name to activate.