From 84ac47242cc353f4237a61764fcef856a0ded5ff Mon Sep 17 00:00:00 2001
From: peteS-UK <64092177+peteS-UK@users.noreply.github.com>
Date: Wed, 9 Apr 2025 17:07:15 +0100
Subject: [PATCH] Updates for Squeezebox integration doc for Gold Quality Scale
 (#38420)

* initial

* initial

* updates

* tiny tweaks

* tiny tweak

* Refactor updates

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
---
 source/_integrations/squeezebox.markdown | 105 ++++++++++++++++-------
 1 file changed, 74 insertions(+), 31 deletions(-)

diff --git a/source/_integrations/squeezebox.markdown b/source/_integrations/squeezebox.markdown
index 9e242d79181..5a69b18ad14 100644
--- a/source/_integrations/squeezebox.markdown
+++ b/source/_integrations/squeezebox.markdown
@@ -26,6 +26,10 @@ This integration connects to an existing <abbr title="Lyrion Music Server">LMS</
 
 The Squeezebox music player ecosystem, which can be controlled through this integration, includes hardware audio players from Logitech, including [Squeezebox 3rd Generation, Squeezebox Boom, Squeezebox Receiver, Transporter, Squeezebox2, Squeezebox and SLIMP3](https://lms-community.github.io/players-and-controllers/hardware-comparison/), and many software emulators like [Squeezelite, SqueezeSlave, SoftSqueeze and SqueezePlay](https://sourceforge.net/projects/lmsclients/files/).
 
+## Supported devices
+
+The integration supports any [Squeezebox compatible hardware or software players](https://lyrion.org/players-and-controllers/) and both Lyrion Music Servers and Logitech Media Servers.
+
 ## Prerequisites
 
 1. One or more [Squeezebox compatible hardware or software players](https://lyrion.org/players-and-controllers/).
@@ -33,10 +37,6 @@ The Squeezebox music player ecosystem, which can be controlled through this inte
 
 {% include integrations/config_flow.md %}
 
-{% note %}
-This platform uses the web interface of the Lyrion Music Server (LMS) to send commands. The default port of the web interface is 9000. It is the same port that you use to access the LMS through your web browser.
-{% endnote %}
-
 {% note %}
 A single configuration entry for the integration adds all Squeezebox devices connected to one LMS to Home Assistant.
 {% endnote %}
@@ -56,6 +56,7 @@ Connect over HTTPS:
   description: "The integration now supports Lyrion Music Servers behind an HTTPS reverse proxy. Please note that Lyrion Music Server natively only supports HTTP traffic. Unless you have configured a reverse proxy, do not select the \"Connect over HTTPS\" option. If you have configured a reverse proxy, remember to update the port number."
 {% endconfiguration_basic %}
 
+
 The Logitech Transporter which have two digital inputs can be activated using a script. The following example turns on the Transporter and activates the toslink input interface:
 
 ```yaml
@@ -82,12 +83,6 @@ Volume step:
  description: Amount to adjust the volume when turning volume up or down.  
 {% endconfiguration_basic %}
 
-## Removing the integration
-
-This integration follows standard integration removal. No extra steps are required.
-
-{% include integrations/remove_device_service.md %}
-
 ## Announce
 
 The Squeezebox media player entity supports the "announce" parameter in the `media_player.play_media` action. When media is played with announce:true, the current state of the media player is saved, the media is then played, and when playing is finished, the original state is restored. For example, if the media player is on and playing a track, once the announcement is finished, the track will resume playing at the same point it was paused by the announcement. If the media player was off, it will be turned off again after playing the announcement.
@@ -167,34 +162,68 @@ data:
     announce_timeout: 60
 ```
 
-## Entities
+## Supported functionality
 
-### Binary sensors
+### Entities
 
-- **Needs restart**: Server Service needs to be restarted (typically, this is needed to apply updates).
-- **Library rescan**: The music library is currently being scanned by LMS (depending on the type of scan, some content may be unavailable).
+The integration provides the following entities.
 
-### Buttons
+#### Binary sensors
 
-- **Preset 1 ... Preset 6**: Play media stored in Preset 1 to Preset 6 on Squeezebox.
-- **Brightness Up, Brightness Down**: Adjust the brightness on Logitech Squeezebox players with built-in screen, such as Radio and Boom.
-- **Bass Up, Bass Down**: Adjust the bass on Logitech Squeezebox players, such as Radio and Boom.
-- **Treble Up, Treble Down**: Adjust the treble on Logitech Squeezebox players, such as Radio and Boom.
+- **Needs restart**
+  - **Description**: Server Service needs to be restarted (typically, this is needed to apply updates).
 
-### Sensors
+- **Library rescan**
+  - **Description**: The music library is currently being scanned by LMS (depending on the type of scan, some content may be unavailable).
 
-- **Last scan**: Date of the last library scan.
-- **Player count**: Number of players on the service.
-- **Player count off service**: Number of players not on this service.
-- **Total albums**: Total number of albums currently available in the service.
-- **Total artists**: Total number of artists currently available in the service.
-- **Total duration**: Duration of all tracks in service (HHHH:MM:SS).
-- **Total genres**: Total number of genres used in current service.
-- **Total songs**: Total number of music files currently in service.
+#### Buttons
 
-## Actions
+- **Preset 1 ... Preset 6**
+  - **Description**: Play media stored in Preset 1 to Preset 6 on Squeezebox.
 
-### Action `call_method`
+- **Brightness up, Brightness down**
+  - **Description**: Adjust the brightness on Logitech Squeezebox players
+  - **Available on**: Logitech hardware players with built-in screen, such as Radio and Boom.
+  
+- **Bass up, Bass down**
+  - **Description**: Adjust the bass on Logitech Squeezebox players, such as Radio and Boom.
+  - **Available on**: Logitech hardware players such as Radio, Duet and Boom.
+
+- **Treble up, Treble down**
+  - **Description**: Adjust the treble on Logitech Squeezebox players, such as Radio and Boom.
+  - **Available on**: Logitech hardware players such as Radio, Duet, and Boom.
+
+#### Sensors
+
+- **Last scan**
+  - **Description**: Date of the last library scan.
+
+- **Player count**
+  - **Description**: Number of players on the service.
+
+- **Player count off service**
+  - **Description**: Number of players not on this service.
+
+- **Total albums**
+  - **Description**: Total number of albums currently available on the service.
+
+- **Total artists**
+  - **Description**: Total number of artists currently available on the service.
+
+- **Total duration**
+  - **Description**: Duration of all tracks in service (HHHH:MM:SS).
+
+- **Total genres**
+  - **Description**: Total number of genres used in current service.
+
+- **Total songs**
+  - **Description**: Total number of music files currently in service.
+
+### Actions
+
+The integration provides the following actions.
+
+#### Action `call_method`
 
 Call a custom Squeezebox JSON-RPC API.
 
@@ -260,7 +289,7 @@ data:
     - '+5'
 ```
 
-### Action `call_query`
+#### Action `call_query`
 
 Call a custom Squeezebox JSON-RPC API. The result of the query will be stored in the 'query_result' attribute of the player.
 
@@ -276,3 +305,17 @@ This action can be used to integrate a Squeezebox query into an automation. For
 `hass.services.call("squeezebox", "call_query", { "entity_id": "media_player.kitchen", "command": "albums", "parameters": ["0", "20", "search:beatles", "tags:al"] })`
 To work with the results:
 `result = hass.states.get("media_player.kitchen").attributes['query_result']`
+
+## Data updates
+
+The integration uses {% term polling %} to receive updates from the Lyrion Music Server (LMS). It uses the web interface of the LMS to send commands. The default port of the web interface is 9000. It is the same port that you use to access the LMS through your web browser.
+
+## Known limitations
+
+The LMS API, which is used by this integration, does not currently provide the ability to override or control fade-in & crossfade settings. This means that if you have enabled **Play or Resume fade-in duration** within the player's audio settings, this fade-in will be applied to any announcement played.  This could potentially lead to the start of an announcement being missed as it fades in.  You should, therefore, consider a short **Play or Resume fade-in duration** or preferably disabling this feature if you make use of announcements.
+
+## Removing the integration
+
+This integration follows standard integration removal. No extra steps are required.
+
+{% include integrations/remove_device_service.md %}