From 08ae9d76b3727f1d32c77d035fe15b7a63792ebd Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 12 Jul 2026 21:33:48 +0000 Subject: [PATCH 1/5] Document kiosk sensors including the new screensaver sensor Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_014bZsB3ashxLB2dgBSnobAt --- docs/integrations/ios-kiosk-mode.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/integrations/ios-kiosk-mode.md b/docs/integrations/ios-kiosk-mode.md index 49b9f4da1f2..421edc08539 100644 --- a/docs/integrations/ios-kiosk-mode.md +++ b/docs/integrations/ios-kiosk-mode.md @@ -87,6 +87,19 @@ When **Mode** is set to **Clock**, you can also adjust: Use the **Preview** button to see the screensaver full-screen with your current settings. Tap anywhere to return to the settings. +## Sensors + +Kiosk mode adds sensors so automations can react to the state of the kiosk device. They appear in the app's sensor settings and in the **Sensors** screen inside the kiosk settings. All are iOS-only. + +| Sensor | Type | Description | +| ------ | ---- | ----------- | +| **Kiosk Mode** | `binary_sensor` | `on` while the app is running in kiosk mode, `off` otherwise. | +| **Kiosk Brightness** | `sensor` (%) | The current screen brightness, as a percentage. | +| **Kiosk Volume** | `sensor` (%) | The current device output volume, as a percentage. | +| **Kiosk Screensaver** | `binary_sensor` | `on` while the screensaver is visible on screen, `off` when it is not. | + +The **Kiosk Brightness**, **Kiosk Volume**, and **Kiosk Screensaver** sensors are only active while kiosk mode is enabled — they are turned on and off automatically as you enable or disable kiosk mode. The **Kiosk Mode** sensor is always available so you can tell whether a device is currently acting as a kiosk. + ## Remote commands While kiosk mode is running, you can control it from Home Assistant by sending a notification whose `message` is a kiosk command. This is useful for automations — for example, showing the screensaver at night, or bringing a camera up on a wall panel when motion is detected. From f70a05dcefddc1b8c257e6d387734acc079758af Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 13 Jul 2026 21:25:02 +0000 Subject: [PATCH 2/5] List kiosk sensors in the main sensors overview Add the iOS Kiosk mode sensors to the general sensors page so it stays a complete overview, with a cross-link to the Kiosk mode documentation. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_014bZsB3ashxLB2dgBSnobAt --- docs/core/sensors.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/core/sensors.md b/docs/core/sensors.md index 172f8aea133..2c445b5bb7e 100644 --- a/docs/core/sensors.md +++ b/docs/core/sensors.md @@ -53,6 +53,7 @@ Not all ![iOS](/assets/iOS.svg) sensors are enabled by default. If you don't see | `sensor.distance` | None | The estimated distance walked by the user since midnight local time. Units: meters, m | | `sensor.floors_ascended` | None | The approximate number of floors ascended by walking since midnight local time. | | `sensor.floors_descended` | None | The approximate number of floors descended by walking. Since | +| [Kiosk Sensors](#kiosk-sensors) | None | Sensors exposed by [Kiosk mode](../integrations/ios-kiosk-mode.md), reflecting the state of the kiosk device. | | `sensor.location_permission` | None | The current location permission that was selected by the user. The permission can be set via the location permission popup or modified in the iOS settings. | | `sensor.sim_1` | [See Below](#cellular-provider-sensor) | Name of your cellular provider. | | `sensor.sim_2` | [See Below](#cellular-provider-sensor) | Name of your cellular provider. | @@ -557,6 +558,17 @@ Using the [History Stats Integration](https://www.home-assistant.io/integrations These sensors will reflect various states from the [Keyguard Manager](https://developer.android.com/reference/android/app/KeyguardManager). You will be able to determine if the device is actively locked, has a password setup or even if the device requires a password to unlock. These sensors will update with the periodic sensor interval. +## Kiosk sensors +![iOS](/assets/iOS.svg)
+[Kiosk mode](../integrations/ios-kiosk-mode.md) adds sensors so automations can react to the state of the kiosk device. The **Kiosk Brightness**, **Kiosk Volume**, and **Kiosk Screensaver** sensors are only active while kiosk mode is enabled and turn on and off automatically as you enable or disable it. The **Kiosk Mode** sensor is always available so you can tell whether a device is currently acting as a kiosk. See [Kiosk mode](../integrations/ios-kiosk-mode.md#sensors) for the full description. + +| Sensor | Type | Description | +| ------ | ---- | ----------- | +| **Kiosk Mode** | `binary_sensor` | `on` while the app is running in kiosk mode, `off` otherwise. | +| **Kiosk Brightness** | `sensor` (%) | The current screen brightness, as a percentage. | +| **Kiosk Volume** | `sensor` (%) | The current device output volume, as a percentage. | +| **Kiosk Screensaver** | `binary_sensor` | `on` while the screensaver is visible on screen, `off` when it is not. | + ## Last reboot sensor ![Android](/assets/android.svg)
This sensors state will be the date and time of the last reboot from the device in UTC format. The sensor will update during the normal sensor update interval. The state will be `unavailable` if the timestamp cannot be determined. This sensor uses the [SystemClock](https://developer.android.com/reference/android/os/SystemClock?hl=en) and current [System](https://developer.android.com/reference/java/lang/System?hl=en) time to calculate the timestamp. This sensor offers a deadband setting, that defaults to 1 minute, to account for time calculation issues seen over certain carriers. From 72460a57039ecd8c4d88fdc4b471c486b1f30c82 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 13 Jul 2026 21:34:54 +0000 Subject: [PATCH 3/5] Use entity IDs for kiosk sensors instead of display names Reference the kiosk sensors by their entity IDs (binary_sensor.kiosk_mode, sensor.kiosk_brightness, sensor.kiosk_volume, binary_sensor.kiosk_screensaver) to match the convention used throughout the sensors documentation. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_014bZsB3ashxLB2dgBSnobAt --- docs/core/sensors.md | 16 ++++++++-------- docs/integrations/ios-kiosk-mode.md | 16 ++++++++-------- 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/core/sensors.md b/docs/core/sensors.md index 2c445b5bb7e..c4f99cfc51c 100644 --- a/docs/core/sensors.md +++ b/docs/core/sensors.md @@ -560,14 +560,14 @@ These sensors will reflect various states from the [Keyguard Manager](https://de ## Kiosk sensors ![iOS](/assets/iOS.svg)
-[Kiosk mode](../integrations/ios-kiosk-mode.md) adds sensors so automations can react to the state of the kiosk device. The **Kiosk Brightness**, **Kiosk Volume**, and **Kiosk Screensaver** sensors are only active while kiosk mode is enabled and turn on and off automatically as you enable or disable it. The **Kiosk Mode** sensor is always available so you can tell whether a device is currently acting as a kiosk. See [Kiosk mode](../integrations/ios-kiosk-mode.md#sensors) for the full description. - -| Sensor | Type | Description | -| ------ | ---- | ----------- | -| **Kiosk Mode** | `binary_sensor` | `on` while the app is running in kiosk mode, `off` otherwise. | -| **Kiosk Brightness** | `sensor` (%) | The current screen brightness, as a percentage. | -| **Kiosk Volume** | `sensor` (%) | The current device output volume, as a percentage. | -| **Kiosk Screensaver** | `binary_sensor` | `on` while the screensaver is visible on screen, `off` when it is not. | +[Kiosk mode](../integrations/ios-kiosk-mode.md) adds sensors so automations can react to the state of the kiosk device. The `sensor.kiosk_brightness`, `sensor.kiosk_volume`, and `binary_sensor.kiosk_screensaver` sensors are only active while kiosk mode is enabled and turn on and off automatically as you enable or disable it. The `binary_sensor.kiosk_mode` sensor is always available so you can tell whether a device is currently acting as a kiosk. See [Kiosk mode](../integrations/ios-kiosk-mode.md#sensors) for the full description. + +| Sensor | Description | +| ------ | ----------- | +| `binary_sensor.kiosk_mode` | `on` while the app is running in kiosk mode, `off` otherwise. | +| `sensor.kiosk_brightness` | The current screen brightness, as a percentage. | +| `sensor.kiosk_volume` | The current device output volume, as a percentage. | +| `binary_sensor.kiosk_screensaver` | `on` while the screensaver is visible on screen, `off` when it is not. | ## Last reboot sensor ![Android](/assets/android.svg)
diff --git a/docs/integrations/ios-kiosk-mode.md b/docs/integrations/ios-kiosk-mode.md index 421edc08539..6f0c320d601 100644 --- a/docs/integrations/ios-kiosk-mode.md +++ b/docs/integrations/ios-kiosk-mode.md @@ -91,14 +91,14 @@ Use the **Preview** button to see the screensaver full-screen with your current Kiosk mode adds sensors so automations can react to the state of the kiosk device. They appear in the app's sensor settings and in the **Sensors** screen inside the kiosk settings. All are iOS-only. -| Sensor | Type | Description | -| ------ | ---- | ----------- | -| **Kiosk Mode** | `binary_sensor` | `on` while the app is running in kiosk mode, `off` otherwise. | -| **Kiosk Brightness** | `sensor` (%) | The current screen brightness, as a percentage. | -| **Kiosk Volume** | `sensor` (%) | The current device output volume, as a percentage. | -| **Kiosk Screensaver** | `binary_sensor` | `on` while the screensaver is visible on screen, `off` when it is not. | - -The **Kiosk Brightness**, **Kiosk Volume**, and **Kiosk Screensaver** sensors are only active while kiosk mode is enabled — they are turned on and off automatically as you enable or disable kiosk mode. The **Kiosk Mode** sensor is always available so you can tell whether a device is currently acting as a kiosk. +| Sensor | Description | +| ------ | ----------- | +| `binary_sensor.kiosk_mode` | `on` while the app is running in kiosk mode, `off` otherwise. | +| `sensor.kiosk_brightness` | The current screen brightness, as a percentage. | +| `sensor.kiosk_volume` | The current device output volume, as a percentage. | +| `binary_sensor.kiosk_screensaver` | `on` while the screensaver is visible on screen, `off` when it is not. | + +The `sensor.kiosk_brightness`, `sensor.kiosk_volume`, and `binary_sensor.kiosk_screensaver` sensors are only active while kiosk mode is enabled — they are turned on and off automatically as you enable or disable kiosk mode. The `binary_sensor.kiosk_mode` sensor is always available so you can tell whether a device is currently acting as a kiosk. ## Remote commands From bdba002976b959354fe07078836aa4ff52cb79b8 Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 22 Jul 2026 16:45:33 +0000 Subject: [PATCH 4/5] Restructure kiosk sensors on the main sensors page per review Break out binary_sensor.kiosk_mode into its own always-available note and list the remaining kiosk sensors in a table ordered alphabetically, keeping the full list on the main sensors page for discoverability. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_014bZsB3ashxLB2dgBSnobAt --- docs/core/sensors.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/core/sensors.md b/docs/core/sensors.md index c4f99cfc51c..85e45b167be 100644 --- a/docs/core/sensors.md +++ b/docs/core/sensors.md @@ -560,14 +560,17 @@ These sensors will reflect various states from the [Keyguard Manager](https://de ## Kiosk sensors ![iOS](/assets/iOS.svg)
-[Kiosk mode](../integrations/ios-kiosk-mode.md) adds sensors so automations can react to the state of the kiosk device. The `sensor.kiosk_brightness`, `sensor.kiosk_volume`, and `binary_sensor.kiosk_screensaver` sensors are only active while kiosk mode is enabled and turn on and off automatically as you enable or disable it. The `binary_sensor.kiosk_mode` sensor is always available so you can tell whether a device is currently acting as a kiosk. See [Kiosk mode](../integrations/ios-kiosk-mode.md#sensors) for the full description. +[Kiosk mode](../integrations/ios-kiosk-mode.md) adds sensors so automations can react to the state of the kiosk device. + +The `binary_sensor.kiosk_mode` sensor is always available so you can tell whether a device is currently acting as a kiosk (`on`) or running the app normally (`off`). + +While kiosk mode is on, additional sensors provide details about the device in kiosk mode: | Sensor | Description | | ------ | ----------- | -| `binary_sensor.kiosk_mode` | `on` while the app is running in kiosk mode, `off` otherwise. | | `sensor.kiosk_brightness` | The current screen brightness, as a percentage. | -| `sensor.kiosk_volume` | The current device output volume, as a percentage. | | `binary_sensor.kiosk_screensaver` | `on` while the screensaver is visible on screen, `off` when it is not. | +| `sensor.kiosk_volume` | The current device output volume, as a percentage. | ## Last reboot sensor ![Android](/assets/android.svg)
From ef9392e7fdd5ce7a08fb9986739d86548375aecf Mon Sep 17 00:00:00 2001 From: Claude Date: Wed, 22 Jul 2026 16:53:34 +0000 Subject: [PATCH 5/5] Link kiosk mode page to sensors list instead of duplicating it Remove the duplicated kiosk sensor table from the kiosk mode page and link to the Kiosk sensors section on the sensors page, keeping a single source of truth to avoid the two pages drifting out of sync. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_014bZsB3ashxLB2dgBSnobAt --- docs/integrations/ios-kiosk-mode.md | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/docs/integrations/ios-kiosk-mode.md b/docs/integrations/ios-kiosk-mode.md index 6f0c320d601..3423b1e1d3a 100644 --- a/docs/integrations/ios-kiosk-mode.md +++ b/docs/integrations/ios-kiosk-mode.md @@ -91,14 +91,7 @@ Use the **Preview** button to see the screensaver full-screen with your current Kiosk mode adds sensors so automations can react to the state of the kiosk device. They appear in the app's sensor settings and in the **Sensors** screen inside the kiosk settings. All are iOS-only. -| Sensor | Description | -| ------ | ----------- | -| `binary_sensor.kiosk_mode` | `on` while the app is running in kiosk mode, `off` otherwise. | -| `sensor.kiosk_brightness` | The current screen brightness, as a percentage. | -| `sensor.kiosk_volume` | The current device output volume, as a percentage. | -| `binary_sensor.kiosk_screensaver` | `on` while the screensaver is visible on screen, `off` when it is not. | - -The `sensor.kiosk_brightness`, `sensor.kiosk_volume`, and `binary_sensor.kiosk_screensaver` sensors are only active while kiosk mode is enabled — they are turned on and off automatically as you enable or disable kiosk mode. The `binary_sensor.kiosk_mode` sensor is always available so you can tell whether a device is currently acting as a kiosk. +For the full list of these sensors and what each one reports, see [Kiosk sensors](../core/sensors.md#kiosk-sensors) on the sensors page. ## Remote commands