c0ffeeca7 8c7ef7a2c0
s-t integrations: apply sentence-style caps to categories (#29906)
* s-t integrations: apply sentence-style caps to categories

* Apply suggestions from code review

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>

* Apply suggestions from code review

Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com>

---------

Co-authored-by: Joakim Sørensen <joasoe@gmail.com>
Co-authored-by: Joost Lekkerkerker <joostlek@outlook.com>
2023-11-19 13:23:59 +01:00

2.4 KiB

title, description, ha_category, ha_iot_class, ha_release, ha_config_flow, ha_quality_scale, ha_codeowners, ha_domain, ha_ssdp, ha_platforms, ha_integration_type
title description ha_category ha_iot_class ha_release ha_config_flow ha_quality_scale ha_codeowners ha_domain ha_ssdp ha_platforms ha_integration_type
Sony Songpal Instructions on how to integrate Sony Songpal devices into Home Assistant.
Media player
Local Push 0.65 true gold
@rytilahti
@shenxn
songpal true
media_player
integration

The songpal platform allows you to control Sony's Songpal ("Audio Control API") compatible devices such as soundbars, AV receivers and wireless speakers from Home Assistant.

Even when the API officially supports only a few devices (HT-ST5000, HT-MT500, HT-CT800, SRS-ZR5 and STR-DN1080), it has also been confirmed to work on others. The list of supported devices from Sony's Songpal website lists devices which are likely to be compatible with this platform.

If the platform works with your non-listed device, or you encounter bugs, please feel free to report them upstream.

A few notes:

  • The quick start-up mode has to be enabled in order to turn the device on.
  • Supports currently only one output terminal, i.e., the volume control works only on the first volume controller as reported by the backend library.
  • Some devices, e.g., HT-XT3, do not support decreasing the volume step-by-step correctly.
  • Feel free to improve the available services!

{% include integrations/config_flow.md %}

See python-songpal's documentation how to get your API endpoint.

Services

In addition to the general media player services, the following services are provided:

Service songpal/set_sound_setting

For a list of available settings and their values use songpal sound command.

Service data attribute Optional Description
entity_id yes Target entity. To target all songpal devices, use all
name no Configuration variable, e.g., nightmode
value no New configuration value, e.g., on