homebridge-dummy 1.1.0-beta.0 → 1.1.0-beta.10

package/CHANGELOG.md

@@ -1,25 +1,35 @@
-## ‼️ WARNING - READ BEFORE CONTINUING ‼️
-
-If upgrading from v0.9.2 or earlier, automations and scenes using Homebridge Dummy accessories will need to be reconfigured.
-
-## ⚠️ IMPORTANT ⚠️
-
-After installing v1.0, you must **RESTART HOMEBRIDGE SERVICE & UI** (not just *RESTART HOMEBRIDGE*) before continuing or you will experience issues with Homebridge Dummy configuration.
+# Change Log
 
-Once you have restarted both Homebridge and the UI, you will need to open the Homebridge Dummy plugin settings to run the accessory migration helper.
+All notable changes to homebridge-dummy will be documented in this file.
 
-Full details [here](https://github.com/mpatfield/homebridge-dummy?tab=readme-ov-file#v10-migration).
+## 1.1.0 (2025-08-13)
 
-# Change Log
+### ‼️ WARNING — Read this if upgrading from v0.9.2 or earlier…
 
-All notable changes to homebridge-dummy will be documented in this file.
+Automations and scenes using Homebridge Dummy accessories will need to be reconfigured. After upgrading, you must **RESTART HOMEBRIDGE SERVICE & UI** (not just *RESTART HOMEBRIDGE*). After restarting, open the Homebridge Dummy plugin settings to run the accessory migration helper. Full details [here](https://github.com/mpatfield/homebridge-dummy?tab=readme-ov-file#v10-migration).
 
-## 1.1.0-beta.X (XXXX-XX-XX)
+---
 
 ### Added
+- Groups (Beta) - Items sharing the same group name can be grouped together in a single accessory in the Home.app UI ([#46](https://github.com/mpatfield/homebridge-dummy/issues/46))
+    - ⚠️ Adding/removing/changing the group name for an accessory will require you to reconfigure any HomeKit scenes or automations
+- "Schedule" feature to invoke accessory at a specified interval or times via cron ([#136](https://github.com/mpatfield/homebridge-dummy/issues/136))
+- Added "Activate Sensor on Auto-Reset" option ([#142](https://github.com/mpatfield/homebridge-dummy/issues/142))
+    - Instead of mirroring accessory, sensor will be activated only when accessory auto-resets
+- Millisecond unit option ([#149](https://github.com/mpatfield/homebridge-dummy/issues/149))
+- Rudimentary support for Thermostats ([#145](https://github.com/mpatfield/homebridge-dummy/issues/145))
+    - Manual control only, no scheduling or auto-reset functionality
+- Allow `sensor` to be attached to all accessory types (excluding Thermostat)
 
-- Groups (Beta) - Items sharing the same group name will be collected together in the Home app UI
-    - ⚠️ Adding/removing/changing the group name will require you to reconfigure any HomeKit scenes or automations
+### Changed
+- Reorganized plugin config UI and renamed "Timer" to "Auto-Reset Timer"
+- `sensor` is now an object rather than a primitive string (backwards compatible)
+- Updated dependencies
+
+### Fixed
+- Timer logging issues ([#143](https://github.com/mpatfield/homebridge-dummy/issues/143), [#148](https://github.com/mpatfield/homebridge-dummy/issues/148))
+- Better support for custom configuration with multiple plugin instances and child bridges ([#152](https://github.com/mpatfield/homebridge-dummy/issues/152))
+- Broken header image in config UI
 
 ## 1.0.0 (2025-07-23)
 

package/README.md

@@ -1,6 +1,6 @@
 
 <p align="center">
-<img src="https://github.com/mpatfield/homebridge-dummy/blob/latest/img/banner.png?raw=true" width="600">
+<img src="https://raw.githubusercontent.com/mpatfield/homebridge-dummy/refs/heads/latest/img/banner.png" width="600">
 </p>
 
 <span align="center">
@@ -70,9 +70,9 @@ The first thing the flow does is create a backup called `config.json.bak` in you
 
 ## About
 
-With this plugin, you can create any number of fake accessories that will do nothing when triggered. This can be very useful for advanced automation with HomeKit scenes.
+With this plugin, you can create any number of fake accessories which are useful for advanced automation with HomeKit scenes. Features include scheduling to trigger at a specific interval or times, resetting automatically after a delay, activating sensors such as motion or occupancy, running arbitrary commands such as cron, and more.
 
-Currently, only Lightbulbs, Locks, Outlets, and Switches are supported. If there is a particular device you'd like to see supported, please [create an issue](https://github.com/mpatfield/homebridge-dummy/issues/new?template=new-issue.md).
+Currently, Doors, Lightbulbs, Locks, Outlets, Switches, Thermostats, Windows, and Blinds are supported. If there is a particular device or feature you'd like to see, please [create an issue](https://github.com/mpatfield/homebridge-dummy/issues/new?template=new-issue.md).
 
 ## Configuration
 
@@ -85,22 +85,38 @@ Using the Homebridge Config UI is the easiest way to set up this plugin. However
         {
             "id": "string",
             "name": "string",
+            "type": "Door | Lightbulb | LockMechanism | Outlet | Switch | Thermostat | Window | WindoCovering",
             "groupName": "string",
-            "type": "Door | Lightbulb | LockMechanism | Outlet | Switch | Window | WindoCovering",
             "timer": {
                 "delay": number,
-                "units": "SECONDS | MINUTES | HOURS",
+                "units": "MILLISECONDS | SECONDS | MINUTES | HOURS",
                 "random": true | false
             },
-            "sensor": "CarbonDioxideSensor | CarbonMonoxideSensor | ContactSensor | LeakSensor | MotionSensor | OccupancySensor | SmokeSensor",
+            "schedule": {
+                "type": "INTERVAL" | "CRON",
+                "interval": number,
+                "units": "MILLISECONDS | SECONDS | MINUTES | HOURS",
+                "random": true | false,
+                "cron": "string"
+            },
+            "sensor": {
+                "type": "CarbonDioxideSensor | CarbonMonoxideSensor | ContactSensor | LeakSensor | MotionSensor | OccupancySensor | SmokeSensor",
+                "timerControlled": true | false
+            }
+            "temperatureUnits": "C" | "F",
             "defaultOn": true | false,
             "defaultBrightness": 0-100,
             "defaultLockState": "locked" | "unlocked",
             "defaultPosition": "open" | "closed",
-            "onCommand": "string",
-            "offCommand": "string",
-            "lockCommand": "string",
-            "unlockCommand": "string",
+            "defaultThermostatState": "auto" | "heat" | "cool" | "off",
+            "defaultTemperature": number,
+            "commandOn": "string",
+            "commandOff": "string",
+            "commandLock": "string",
+            "commandUnlock": "string",
+            "commandOpen": "string",
+            "commandClose": "string",
+            "commandTemperature": "string",
             "resetOnRestart": true | false,
             "disableLogging": true | false
         }
@@ -115,18 +131,27 @@ All fields are optional unless noted with an asterisk (*)
 - `id`* - A unique identifier for the accessory. Changing this value will create a new accessory.
 
 - `name`* - The display name for the accessory in HomeKit
-- `type`* - The type of accessory: `Door`, `Lightbulb`, `LockMechanism`, `Outlet`, `Switch`, `Window`, or `WindowCovering`
+- `type`* - The type of accessory: `Door`, `Lightbulb`, `LockMechanism`, `Outlet`, `Switch`, `Thermostat`, `Window`, or `WindowCovering`
 
 - `groupName` - (Beta) Items sharing the same group name will be collected together in the Home app UI
     - ⚠️ Adding/removing/changing the group name will require you to reconfigure any HomeKit scenes or automations
 
-- `timer.delay` — If defined, the switch will automatically toggle after this many seconds/minutes/hours
-- `timer.units` — The units to use for delay above (`SECONDS`, `MINUTES`, or `HOURS`). *Required if delay is set.
+- `timer.delay` — If defined, the switch will automatically toggle after this many milliseconds/seconds/minutes/hours
+- `timer.units` — The units to use for delay above (`MILLISECONDS`, `SECONDS`, `MINUTES`, or `HOURS`). *Required if delay is set.
 - `timer.random` — If true, the delay will be randomized with a maximum value of `timer.delay`
 
-- `sensor` - Optionally attach a sensor that mirrors the state of the parent accessory
-    - Only works with `Lightbulb`, `Outlet`, and `Switch`
+- `schedule.type` — Automatically set the accessory to it's non-default value
+- `schedule.interval` — Trigger the accessory after this many milliseconds/seconds/minutes/hours. *Required if `schedule.type` = `INTERVAL`
+- `schedule.units` — The units to use for the interval (`MILLISECONDS`, `SECONDS`, `MINUTES`, or `HOURS`) *Required if `schedule.type` = `INTERVAL`
+- `schedule.random` — If true, the interval will be randomized with a maximum value of `schedule.interval`
+- `schedule.cron` — The cron string for triggering the accessory.  *Required if `schedule.type` = `CRON`
+    - See [crontab.guru](http://crontab.guru) for help
+
+- `sensor.type` - Optionally attach a sensor that mirrors the state of the parent accessory
     - Valid values are `CarbonDioxideSensor`, `CarbonMonoxideSensor`, `ContactSensor`, `LeakSensor`, `MotionSensor`, `OccupancySensor`, or `SmokeSensor`
+- `sensor.timerControlled` - If true, sensor will be activated if accessory is reset by timer but not if it is reset manually
+
+- `temperatureUnits` - Units to use for thermostats, either 'C' or 'F'
 
 - `defaultOn` — Initial value. Default _ON_ = true, default _OFF_ = false
 
@@ -136,13 +161,19 @@ All fields are optional unless noted with an asterisk (*)
 
 - `defaultPosition` — Initial position for the door/window/blinds, "open" or "closed"
 
-- `onCommand` - Arbitraty command to execute when lightbulb/outlet/switch turns on
-- `offCommand` - Arbitraty command to execute when lightbulb/outlet/switch turns off
+- `defaultThermostatState` - The initial state for the thermostat, "auto", "heat", "cool", or "off"
+
+- `defaultTemperature` - The default temperature for the thermostat in `temperatureUnits` defined above
+
+- `onCommand` - Arbitraty command to execute when lightbulb/outlet/switch/thermostat turns on
+- `offCommand` - Arbitraty command to execute when lightbulb/outlet/switch/thermostat turns off
 
 - `lockCommand` - Arbitraty command to execute when lock mechanism is locked
 - `unlockCommand` - Arbitraty command to execute when lock mechanism is unlocked
 
-- `resetOnRestart` _ If true, all values return to defaults when Homebridge restarts. Ignored when timer is defined.
+- `commandTemperature` - Arbitrary command to execute when temperature changes
+
+- `resetOnRestart` _ If true, accessory will return to default state when Homebridge restarts
 
 - `disableLogging` — If true, state changes will not be logged
 
@@ -273,10 +304,44 @@ All fields are optional unless noted with an asterisk (*)
 }
 ```
 
+### Hourly Schedule Switch
+```json
+{
+    "name": "Hourly",
+    "type": "Switch",
+    "timer": {
+        "delay": 1,
+        "units": "SECONDS"
+    },
+    "schedule": {
+        "type": "INTERVAL",
+        "interval": 1,
+        "units": "HOURS"
+    }
+}
+```
+
+### Thermostat
+```json
+{
+    "name": "Thermostat",
+    "type": "Thermostat",
+    "temperatureUnits": "F",
+    "defaultThermostatState": "heat",
+    "defaultTemperature": 78
+}
+```
+
 ## Credits
 
-Special thanks to [@nfarina](https://github.com/nfarina) for creating the original version of this plugin and maintaining it for almost 10 (!!!) years
+Special thanks to [@nfarina](https://github.com/sponsors/nfarina) for creating the original version of this plugin and maintaining it for almost 10 (!!!) years
 
 [Keryan Belahcene](https://www.instagram.com/keryan.me) for creating the [Flume](https://github.com/homebridge-plugins/homebridge-flume) banner image which was adapted for use with this plugin
 
+Schedule feature inspired by [Homebridge Schedule](https://github.com/kbrashears5/typescript-homebridge-schedule) by [@kbrashears5](https://github.com/sponsors/kbrashears5)
+
+Sensor feature inspired by [Homebridge-Delay-Switch](https://github.com/nitaybz/homebridge-delay-switch#readme) by [@nitaybz](https://github.com/sponsors/nitaybz)
+
+Command feature inspired by [homebridge-cmdtrigger](https://github.com/hallos/homebridge-cmdtrigger) by [@hallos](https://github.com/sponsors/hallos)
+
 And to the amazing creators/contributors of [Homebridge](https://homebridge.io) who made this plugin possible!