
<p align="center">
<img src="https://raw.githubusercontent.com/mpatfield/homebridge-dummy/refs/heads/latest/img/banner.png" width="600">
</p>

<span align="center">

# Homebridge Dummy

Homebridge plugin to create fake accessories for assisting with advanced Apple HomeKit automations

[![verified-by-homebridge](https://img.shields.io/badge/homebridge-verified-blueviolet?color=%23491F59&style=flat)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)
[![Discord](https://img.shields.io/discord/432663330281226270?color=728ED5&logo=discord&label=discord)](https://discord.gg/K26ceHy9hx)\
[![npm](https://img.shields.io/npm/dw/homebridge-dummy)](https://www.npmjs.com/package/homebridge-dummy)
[![npm](https://img.shields.io/npm/dt/homebridge-dummy)](https://www.npmjs.com/package/homebridge-dummy)

</span>

<h3 align="center">‼️ WARNING ‼️<br>If upgrading from v0.9.2 or earlier<br><a href="https://github.com/mpatfield/homebridge-dummy/wiki/Migration">READ THIS FIRST</a></h3>

<h4 align="center">⚠️ HOOBS Users ⚠️<br><a href="https://github.com/mpatfield/homebridge-dummy/wiki/HOOBS">Read This</a></h4>

## Disclaimer

Any issues or damage resulting from use of this plugin are not the fault of the developer. Use at your own risk.

## About

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, triggering when certain conditions are met, and more.

Visit the [Wiki](https://github.com/mpatfield/homebridge-dummy/wiki) to learn more about available features.

## Credits

[@jotzet79](https://github.com/sponsors/jotzet79) for German translations

[@loveisfoss](https://github.com/sponsors/loveisfoss) for Greek translations

[@Silverdragon122](https://github.com/sponsors/Silverdragon122) for Russian translations

[@dcompane](https://github.com/sponsors/dcompane) for Spanish translations

[@khanhnd88](https://github.com/sponsors/khanhnd88) for Vietnamese translations

[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

Push Notifications feature uses [Notify!](https://notify.pingie.com/) by [@simplytoast1](https://github.com/sponsors/simplytoast1)

[fakegato-history](https://github.com/simont77/fakegato-history) by [@simont77](https://github.com/sponsors/simont77) *Copyright © 2017*

Schedule feature inspired by [Homebridge Schedule](https://github.com/kbrashears5/typescript-homebridge-schedule) by [@kbrashears5](https://github.com/sponsors/kbrashears5)

Scheduling based on sun times (sunrise, sunset, etc.) and reachability (ping) conditions inspired by [Homebridge Virtual Accessories](https://github.com/justjam2013/homebridge-virtual-accessories) by [@justjam2013](https://github.com/sponsors/justjam2013)

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 [Cmd Trigger Plugin](https://github.com/hallos/homebridge-cmdtrigger) by [@hallos](https://github.com/sponsors/hallos)

Log watch trigger feature inspired by [Homebridge Virtual Switches](https://github.com/Plankske/hb-virtual-switch/) by [@Plankske](https://github.com/sponsors/Plankske)

Network presence condition inspired by [homebridge-network-presence](https://github.com/nitaybz/homebridge-network-presence) by [nitaybz](https://github.com/sponsors/nitaybz)

Egg timer feature inspired by [homebridge-eggtimer-plugin](https://github.com/teh-hippo/homebridge-eggtimer-plugin) by [teh-hippo](https://github.com/sponsors/teh-hippo)

Special thanks to [@nfarina](https://github.com/sponsors/nfarina) for creating the original version of this plugin and maintaining it for almost 10 (!!!) years

And to the amazing creators/contributors of [Homebridge](https://homebridge.io) who made this plugin possible!
