homeassistant 2025.8.3__py3-none-any.whl → 2025.9.0b1__py3-none-any.whl

homeassistant/components/smarla/translations/el.json

@@ -24,6 +24,21 @@
                 "name": "\u0395\u03bd\u03c4\u03b1\u03c3\u03b7"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "\u0394\u03c1\u03b1\u03c3\u03c4\u03b7\u03c1\u03b9\u03cc\u03c4\u03b7\u03c4\u03b1"
+            },
+            "amplitude": {
+                "name": "\u0395\u03cd\u03c1\u03bf\u03c2"
+            },
+            "period": {
+                "name": "\u03a0\u03b5\u03c1\u03af\u03bf\u03b4\u03bf\u03c2"
+            },
+            "swing_count": {
+                "name": "\u0391\u03c1\u03b9\u03b8\u03bc\u03cc\u03c2 \u03ba\u03b9\u03bd\u03ae\u03c3\u03b5\u03c9\u03bd",
+                "unit_of_measurement": "\u03ba\u03b9\u03bd\u03ae\u03c3\u03b5\u03b9\u03c2"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "\u0395\u03be\u03c5\u03c0\u03bd\u03b7 \u03bb\u03b5\u03b9\u03c4\u03bf\u03c5\u03c1\u03b3\u03af\u03b1"

homeassistant/components/smarla/translations/en-GB.json

@@ -24,6 +24,21 @@
                 "name": "Intensity"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "Activity"
+            },
+            "amplitude": {
+                "name": "Amplitude"
+            },
+            "period": {
+                "name": "Period"
+            },
+            "swing_count": {
+                "name": "Swing count",
+                "unit_of_measurement": "swings"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "Smart Mode"

homeassistant/components/smarla/translations/en.json

@@ -24,6 +24,21 @@
                 "name": "Intensity"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "Activity"
+            },
+            "amplitude": {
+                "name": "Amplitude"
+            },
+            "period": {
+                "name": "Period"
+            },
+            "swing_count": {
+                "name": "Swing count",
+                "unit_of_measurement": "swings"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "Smart Mode"

homeassistant/components/smarla/translations/et.json

@@ -24,6 +24,21 @@
                 "name": "Intensiivsus"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "Tegevus"
+            },
+            "amplitude": {
+                "name": "Amplituud"
+            },
+            "period": {
+                "name": "Ajavahemik"
+            },
+            "swing_count": {
+                "name": "Kiikumiste arv",
+                "unit_of_measurement": "kiikumisi"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "Nutikas re\u017eiim"

homeassistant/components/smarla/translations/fr.json

@@ -19,6 +19,17 @@
         }
     },
     "entity": {
+        "sensor": {
+            "activity": {
+                "name": "Activit\u00e9"
+            },
+            "amplitude": {
+                "name": "Amplitude"
+            },
+            "period": {
+                "name": "P\u00e9riode"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "Mode intelligent"

homeassistant/components/smarla/translations/ga.json

@@ -24,6 +24,21 @@
                 "name": "D\u00e9ine"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "Gn\u00edomha\u00edocht"
+            },
+            "amplitude": {
+                "name": "Aimpliti\u00faid"
+            },
+            "period": {
+                "name": "Tr\u00e9imhse"
+            },
+            "swing_count": {
+                "name": "L\u00edon na luasc\u00e1n",
+                "unit_of_measurement": "luasc\u00e1in"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "M\u00f3d Cliste"

homeassistant/components/smarla/translations/lt.json

@@ -24,6 +24,21 @@
                 "name": "Intensyvumas"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "Veikla"
+            },
+            "amplitude": {
+                "name": "Amplitud\u0117"
+            },
+            "period": {
+                "name": "Laikotarpis"
+            },
+            "swing_count": {
+                "name": "S\u016bpyni\u0173 skai\u010dius",
+                "unit_of_measurement": "s\u016bpyn\u0117s"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "I\u0161manusis re\u017eimas"

homeassistant/components/smarla/translations/pt.json

@@ -24,6 +24,21 @@
                 "name": "Intensidade"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "Atividade"
+            },
+            "amplitude": {
+                "name": "Amplitude"
+            },
+            "period": {
+                "name": "Per\u00edodo"
+            },
+            "swing_count": {
+                "name": "Contagem de oscila\u00e7\u00f5es",
+                "unit_of_measurement": "oscila\u00e7\u00f5es"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "Modo Inteligente"

homeassistant/components/smarla/translations/sk.json

@@ -24,6 +24,21 @@
                 "name": "Intenzita"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "Aktivita"
+            },
+            "amplitude": {
+                "name": "Amplit\u00fada"
+            },
+            "period": {
+                "name": "Peri\u00f3da"
+            },
+            "swing_count": {
+                "name": "Po\u010det v\u00fdkyvov",
+                "unit_of_measurement": "v\u00fdkyvy"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "Inteligentn\u00fd re\u017eim"

homeassistant/components/smarla/translations/zh-Hans.json

@@ -24,6 +24,21 @@
                 "name": "\u5f3a\u5ea6"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "\u6d3b\u52a8"
+            },
+            "amplitude": {
+                "name": "\u632f\u5e45"
+            },
+            "period": {
+                "name": "\u5468\u671f"
+            },
+            "swing_count": {
+                "name": "\u6446\u52a8\u6b21\u6570",
+                "unit_of_measurement": "\u6446\u52a8"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "\u667a\u80fd\u6a21\u5f0f"

homeassistant/components/smarla/translations/zh-Hant.json

@@ -24,6 +24,21 @@
                 "name": "\u5f37\u5ea6"
             }
         },
+        "sensor": {
+            "activity": {
+                "name": "\u6d3b\u52d5"
+            },
+            "amplitude": {
+                "name": "\u632f\u5e45"
+            },
+            "period": {
+                "name": "\u9031\u671f"
+            },
+            "swing_count": {
+                "name": "\u64fa\u52d5\u6b21\u6578",
+                "unit_of_measurement": "\u64fa\u52d5"
+            }
+        },
         "switch": {
             "smart_mode": {
                 "name": "\u667a\u6167\u6a21\u5f0f"

homeassistant/components/smartthings/sensor.py

@@ -476,6 +476,16 @@ CAPABILITY_TO_SENSORS: dict[
             )
         ]
     },
+    Capability.FINE_DUST_SENSOR: {
+        Attribute.FINE_DUST_LEVEL: [
+            SmartThingsSensorEntityDescription(
+                key=Attribute.FINE_DUST_LEVEL,
+                native_unit_of_measurement=CONCENTRATION_MICROGRAMS_PER_CUBIC_METER,
+                state_class=SensorStateClass.MEASUREMENT,
+                device_class=SensorDeviceClass.PM25,
+            )
+        ]
+    },
     # Haven't seen at devices yet
     Capability.FORMALDEHYDE_MEASUREMENT: {
         Attribute.FORMALDEHYDE_LEVEL: [

homeassistant/components/smartthings/translations/ga.json

@@ -45,6 +45,9 @@
             "cool_select_plus_door": {
                 "name": "Doras CoolSelect+"
             },
+            "door": {
+                "name": "Doras"
+            },
             "dryer_wrinkle_prevent_active": {
                 "name": "Cosc roic gn\u00edomhach"
             },

homeassistant/components/smlight/manifest.json

@@ -12,7 +12,7 @@
   "integration_type": "device",
   "iot_class": "local_push",
   "quality_scale": "silver",
-  "requirements": ["pysmlight==0.2.7"],
+  "requirements": ["pysmlight==0.2.8"],
   "zeroconf": [
     {
       "type": "_slzb-06._tcp.local."

homeassistant/components/smtp/translations/it.json

@@ -1,4 +1,9 @@
 {
+    "exceptions": {
+        "remote_path_not_allowed": {
+            "message": "Impossibile inviare e-mail con allegato \"{file_name}\" dalla cartella \"{file_path}\" da cui non \u00e8 sicuro caricare i dati. Solo le cartelle aggiunte a `{allow_list}` sono accessibili. Vedere {url} per maggiori informazioni."
+        }
+    },
     "services": {
         "reload": {
             "description": "Ricarica i servizi di notifica SMTP.",

homeassistant/components/snapcast/coordinator.py

@@ -39,6 +39,8 @@ class SnapcastUpdateCoordinator(DataUpdateCoordinator[None]):
         self._server.set_on_connect_callback(self._on_connect)
         self._server.set_on_disconnect_callback(self._on_disconnect)
 
+        self._host_id = f"{host}:{port}"
+
     def _on_update(self) -> None:
         """Snapserver on_update callback."""
         # Assume availability if an update is received.
@@ -77,3 +79,8 @@ class SnapcastUpdateCoordinator(DataUpdateCoordinator[None]):
     def server(self) -> Snapserver:
         """Get the Snapserver object."""
         return self._server
+
+    @property
+    def host_id(self) -> str:
+        """Get the host ID."""
+        return self._host_id

homeassistant/components/snapcast/media_player.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from collections.abc import Mapping
+from collections.abc import Callable, Mapping
 import logging
 from typing import Any
 
@@ -19,13 +19,13 @@ from homeassistant.components.media_player import (
     MediaType,
 )
 from homeassistant.config_entries import ConfigEntry
-from homeassistant.const import CONF_HOST, CONF_PORT
 from homeassistant.core import HomeAssistant, callback
 from homeassistant.exceptions import ServiceValidationError
 from homeassistant.helpers import (
     config_validation as cv,
     entity_platform,
     entity_registry as er,
+    issue_registry as ir,
 )
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
 
@@ -52,6 +52,12 @@ STREAM_STATUS = {
     "unknown": None,
 }
 
+_SUPPORTED_FEATURES = (
+    MediaPlayerEntityFeature.VOLUME_MUTE
+    | MediaPlayerEntityFeature.VOLUME_SET
+    | MediaPlayerEntityFeature.SELECT_SOURCE
+)
+
 _LOGGER = logging.getLogger(__name__)
 
 
@@ -82,106 +88,91 @@ async def async_setup_entry(
     # Fetch coordinator from global data
     coordinator: SnapcastUpdateCoordinator = hass.data[DOMAIN][config_entry.entry_id]
 
-    # Create an ID for the Snapserver
-    host = config_entry.data[CONF_HOST]
-    port = config_entry.data[CONF_PORT]
-    host_id = f"{host}:{port}"
-
     register_services()
 
     _known_group_ids: set[str] = set()
     _known_client_ids: set[str] = set()
 
     @callback
-    def _check_entities() -> None:
-        nonlocal _known_group_ids, _known_client_ids
-
-        def _update_known_ids(known_ids, ids) -> tuple[set[str], set[str]]:
-            ids_to_add = ids - known_ids
-            ids_to_remove = known_ids - ids
-
-            # Update known IDs
-            known_ids.difference_update(ids_to_remove)
-            known_ids.update(ids_to_add)
-
-            return ids_to_add, ids_to_remove
+    def _update_entities(
+        entity_class: type[SnapcastClientDevice | SnapcastGroupDevice],
+        known_ids: set[str],
+        get_device: Callable[[str], Snapclient | Snapgroup],
+        get_devices: Callable[[], list[Snapclient] | list[Snapgroup]],
+    ) -> None:
+        # Get IDs of current devices on server
+        snapcast_ids = {d.identifier for d in get_devices()}
 
-        group_ids = {g.identifier for g in coordinator.server.groups}
-        groups_to_add, groups_to_remove = _update_known_ids(_known_group_ids, group_ids)
+        # Update known IDs
+        ids_to_add = snapcast_ids - known_ids
+        ids_to_remove = known_ids - snapcast_ids
 
-        client_ids = {c.identifier for c in coordinator.server.clients}
-        clients_to_add, clients_to_remove = _update_known_ids(
-            _known_client_ids, client_ids
-        )
+        known_ids.difference_update(ids_to_remove)
+        known_ids.update(ids_to_add)
 
         # Exit early if no changes
-        if not (groups_to_add | groups_to_remove | clients_to_add | clients_to_remove):
+        if not (ids_to_add | ids_to_remove):
             return
 
         _LOGGER.debug(
-            "New clients: %s",
-            str([coordinator.server.client(c).friendly_name for c in clients_to_add]),
+            "New %s: %s",
+            entity_class,
+            str([get_device(d).friendly_name for d in ids_to_add]),
         )
         _LOGGER.debug(
-            "New groups: %s",
-            str([coordinator.server.group(g).friendly_name for g in groups_to_add]),
-        )
-        _LOGGER.debug(
-            "Remove client IDs: %s",
-            str([list(clients_to_remove)]),
-        )
-        _LOGGER.debug(
-            "Remove group IDs: %s",
-            str(list(groups_to_remove)),
+            "Remove %s IDs: %s",
+            entity_class,
+            str([list(ids_to_remove)]),
         )
 
         # Add new entities
         async_add_entities(
             [
-                SnapcastGroupDevice(
-                    coordinator, coordinator.server.group(group_id), host_id
-                )
-                for group_id in groups_to_add
-            ]
-            + [
-                SnapcastClientDevice(
-                    coordinator, coordinator.server.client(client_id), host_id
-                )
-                for client_id in clients_to_add
+                entity_class(coordinator, get_device(snapcast_id))
+                for snapcast_id in ids_to_add
             ]
         )
 
         # Remove stale entities
         entity_registry = er.async_get(hass)
-        for group_id in groups_to_remove:
+        for snapcast_id in ids_to_remove:
             if entity_id := entity_registry.async_get_entity_id(
                 MEDIA_PLAYER_DOMAIN,
                 DOMAIN,
-                SnapcastGroupDevice.get_unique_id(host_id, group_id),
+                entity_class.get_unique_id(coordinator.host_id, snapcast_id),
             ):
                 entity_registry.async_remove(entity_id)
 
-        for client_id in clients_to_remove:
-            if entity_id := entity_registry.async_get_entity_id(
-                MEDIA_PLAYER_DOMAIN,
-                DOMAIN,
-                SnapcastClientDevice.get_unique_id(host_id, client_id),
-            ):
-                entity_registry.async_remove(entity_id)
+    def _update_clients() -> None:
+        _update_entities(
+            SnapcastClientDevice,
+            _known_client_ids,
+            coordinator.server.client,
+            lambda: coordinator.server.clients,
+        )
 
-    coordinator.async_add_listener(_check_entities)
-    _check_entities()
+    # Create client entities and add listener to update clients on server update
+    _update_clients()
+    coordinator.async_add_listener(_update_clients)
+
+    def _update_groups() -> None:
+        _update_entities(
+            SnapcastGroupDevice,
+            _known_group_ids,
+            coordinator.server.group,
+            lambda: coordinator.server.groups,
+        )
+
+    # Create group entities and add listener to update groups on server update
+    _update_groups()
+    coordinator.async_add_listener(_update_groups)
 
 
 class SnapcastBaseDevice(SnapcastCoordinatorEntity, MediaPlayerEntity):
     """Base class representing a Snapcast device."""
 
     _attr_should_poll = False
-    _attr_supported_features = (
-        MediaPlayerEntityFeature.VOLUME_MUTE
-        | MediaPlayerEntityFeature.VOLUME_SET
-        | MediaPlayerEntityFeature.SELECT_SOURCE
-    )
+    _attr_supported_features = _SUPPORTED_FEATURES
     _attr_media_content_type = MediaType.MUSIC
     _attr_device_class = MediaPlayerDeviceClass.SPEAKER
 
@@ -189,13 +180,14 @@ class SnapcastBaseDevice(SnapcastCoordinatorEntity, MediaPlayerEntity):
         self,
         coordinator: SnapcastUpdateCoordinator,
         device: Snapgroup | Snapclient,
-        host_id: str,
     ) -> None:
         """Initialize the base device."""
         super().__init__(coordinator)
 
         self._device = device
-        self._attr_unique_id = self.get_unique_id(host_id, device.identifier)
+        self._attr_unique_id = self.get_unique_id(
+            coordinator.host_id, device.identifier
+        )
 
     @classmethod
     def get_unique_id(cls, host, id) -> str:
@@ -279,6 +271,19 @@ class SnapcastBaseDevice(SnapcastCoordinatorEntity, MediaPlayerEntity):
         """Handle the unjoin service."""
         raise NotImplementedError
 
+    def _async_create_grouping_deprecation_issue(self) -> None:
+        """Create an issue for deprecated grouping actions."""
+        ir.async_create_issue(
+            self.hass,
+            DOMAIN,
+            "deprecated_grouping_actions",
+            breaks_in_ha_version="2026.2.0",
+            is_fixable=False,
+            is_persistent=False,
+            severity=ir.IssueSeverity.WARNING,
+            translation_key="deprecated_grouping_actions",
+        )
+
     @property
     def metadata(self) -> Mapping[str, Any]:
         """Get metadata from the current stream."""
@@ -389,11 +394,62 @@ class SnapcastGroupDevice(SnapcastBaseDevice):
         """Handle the unjoin service."""
         raise ServiceValidationError("Entity is not a client. Can only unjoin clients.")
 
+    def _async_create_group_deprecation_issue(self) -> None:
+        """Create an issue for deprecated group entities."""
+        ir.async_create_issue(
+            self.hass,
+            DOMAIN,
+            "deprecated_group_entities",
+            breaks_in_ha_version="2026.2.0",
+            is_fixable=False,
+            is_persistent=False,
+            severity=ir.IssueSeverity.WARNING,
+            translation_key="deprecated_group_entities",
+        )
+
+    async def async_select_source(self, source: str) -> None:
+        """Set input source."""
+        # Groups are deprecated, create an issue when used
+        self._async_create_group_deprecation_issue()
+
+        await super().async_select_source(source)
+
+    async def async_mute_volume(self, mute: bool) -> None:
+        """Send the mute command."""
+        # Groups are deprecated, create an issue when used
+        self._async_create_group_deprecation_issue()
+
+        await super().async_mute_volume(mute)
+
+    async def async_set_volume_level(self, volume: float) -> None:
+        """Set the volume level."""
+        # Groups are deprecated, create an issue when used
+        self._async_create_group_deprecation_issue()
+
+        await super().async_set_volume_level(volume)
+
+    def snapshot(self) -> None:
+        """Snapshot the group state."""
+        # Groups are deprecated, create an issue when used
+        self._async_create_group_deprecation_issue()
+
+        super().snapshot()
+
+    async def async_restore(self) -> None:
+        """Restore the group state."""
+        # Groups are deprecated, create an issue when used
+        self._async_create_group_deprecation_issue()
+
+        await super().async_restore()
+
 
 class SnapcastClientDevice(SnapcastBaseDevice):
     """Representation of a Snapcast client device."""
 
     _device: Snapclient
+    _attr_supported_features = (
+        _SUPPORTED_FEATURES | MediaPlayerEntityFeature.GROUPING
+    )  # Clients support grouping
 
     @classmethod
     def get_unique_id(cls, host, id) -> str:
@@ -439,6 +495,9 @@ class SnapcastClientDevice(SnapcastBaseDevice):
 
     async def async_join(self, master) -> None:
         """Join the group of the master player."""
+        # Action is deprecated, create an issue
+        self._async_create_grouping_deprecation_issue()
+
         entity_registry = er.async_get(self.hass)
         master_entity = entity_registry.async_get(master)
         if master_entity is None:
@@ -463,5 +522,53 @@ class SnapcastClientDevice(SnapcastBaseDevice):
 
     async def async_unjoin(self) -> None:
         """Unjoin the group the player is currently in."""
+        # Action is deprecated, create an issue
+        self._async_create_grouping_deprecation_issue()
+
+        await self._current_group.remove_client(self._device.identifier)
+        self.async_write_ha_state()
+
+    @property
+    def group_members(self) -> list[str] | None:
+        """List of player entities which are currently grouped together for synchronous playback."""
+        entity_registry = er.async_get(self.hass)
+        return [
+            entity_id
+            for client_id in self._current_group.clients
+            if (
+                entity_id := entity_registry.async_get_entity_id(
+                    MEDIA_PLAYER_DOMAIN,
+                    DOMAIN,
+                    self.get_unique_id(self.coordinator.host_id, client_id),
+                )
+            )
+        ]
+
+    async def async_join_players(self, group_members: list[str]) -> None:
+        """Add `group_members` to this client's current group."""
+        # Get the client entity for each group member excluding self
+        entity_registry = er.async_get(self.hass)
+        clients = [
+            entity
+            for entity_id in group_members
+            if (entity := entity_registry.async_get(entity_id))
+            and entity.unique_id != self.unique_id
+        ]
+
+        for client in clients:
+            # Valid entity is a snapcast client
+            if not client.unique_id.startswith(CLIENT_PREFIX):
+                raise ServiceValidationError(
+                    f"Entity '{client.entity_id}' is not a Snapcast client device."
+                )
+
+            # Extract client ID and join it to the current group
+            identifier = client.unique_id.split("_")[-1]
+            await self._current_group.add_client(identifier)
+
+        self.async_write_ha_state()
+
+    async def async_unjoin_player(self) -> None:
+        """Remove this client from it's current group."""
         await self._current_group.remove_client(self._device.identifier)
         self.async_write_ha_state()