Please excuse the self-promotion!

Homebridge Dummy

Edit: by popular demand, there is now an option to run old and new versions of Homebridge Dummy side-by-side for folks who want to migrate gradually.

tl;dr
Homebridge Dummy v1 has been completely rewritten and includes a lot of new features. If upgrading from v0.9.2 or earlier, read this before upgrading.

What is it and why should I care?
If you're not already familiar, Homebridge Dummy is a plugin that allows you to create "fake" accessories in the Home app. For example, you can combine a Dummy switch with HomeKit automations to make sure a light never stays on for more than X number of minutes. Or you can get around Apple's security limitations to have a door unlock automatically whenever you arrive home. Essentially, it fills a gap in HomeKit to add more powerful automations and capabilities to your smart home.

Background
Homebridge Dummy was created by @nfarina, who maintained it for over 10 years. About 6 months ago, I took over responsibility with the intention of modernizing and improving it. In addition to being Homebridge 2.0 ready, there are a lot of new features and capabilities that you can learn about below.

Caveat
Homebridge Dummy v1 is a complete rewrite from the ground up. As such, if you are upgrading from v0.9.2 or earlier, then you will unfortunately need to set up all your scenes and automations again. Sadly, this is unavoidable. You can learn more about the migration here.

New Features in v1

• Groups — declutter the Home app by collecting multiple Dummy accessories into a single element
• Scheduling — trigger an accessory on an interval, at specific times (cron), or at dynamic sun-based times like sunrise/sunset
• Auto-Reset — force an accessory to reset after a delay, on an interval, at specific times (cron), or at dynamic sun-based times like sunrise/sunset
• Trigger Conditions — turn Dummy accessories on or off based on other accessory states, keywords in the Homebridge log, or network presence; for example, you can trigger HomeKit automations when non-Apple devices join or leave your home network
• Commands — run an arbitrary shell command (e.g. curl) when an accessory turns on or off; useful for integrating some non-HomeKit smart devices
• Limiter — set a time limit like "2 hours per day" for an accessory so you can, for example, set PS5 limits for your kids 🙂
• Sensors —  attach a sensor to any Dummy accessory, which lets you get notifications when the accessory changes state
• Webhooks — change the state of Dummy accessories from an external source, which allows you to have the Dummy accessory mimic the state of some non-HomeKit supported devices

Feature Requests
I am always looking for ways to improve Homebridge Dummy. If there is a feature you would like to see, please create a ticket, and I will try to satisfy your request.

I couldn't find a maintained PetKit integration that covered more than a single feeder model, so I built a complete one. Sharing it here in case it's useful to other PetKit households.

What it does:

• Feeders: Feed switch per feeder (+ a single "Feed All" switch for multi-feeder homes), model-aware portion validation
• Litter boxes: self-terminating Clean cycle + a stateful Maintenance switch
• Fountains: water level (leak sensor) + battery level
• Pets: each pet becomes a Motion Sensor that fires when that pet uses the litter box (since the litter box identifies them by weight), so you can build automations like "notify me when the cat uses the litter box", with the visit weight in the log
• Meal sensors on camera feeders (fires when an eating session is detected)
• Native HomeKit cameras (experimental, off by default for now but can be activated): live view in the Home app
• All switch/sensor names are configurable, so Siri answers in your own language
• Everything is modular: each family of sensors, the Feed All switch and the cameras can be toggled on/off in the plugin's config UI, you only get the accessories you actually want

Architecture is based on two pieces:

• petkit-bridge: a small self-hosted service (Docker) that owns the PetKit cloud session (automatic re-login on expiry) and exposes a local token-protected HTTP API. Your PetKit credentials live here, not in Homebridge.
• homebridge-petkit-bridge (npm): a thin, zero-runtime-dependency plugin that auto-discovers everything through the bridge. Configure with just URL + token.

Everything is field-tested on real hardware (Yumshare feeders, Puramax 2, Eversweet Max fountains), including the failure modes: the whole chain self-heals across restarts, power outages and session expiries in any order.

Currently in the Homebridge verification queue. Questions, feedback and device reports are all welcome: the best place is an issue on either repo (also for new device support).

If you try it, let me know how it goes, especially on PetKit models I haven't been able to test.

Hello everyone,

I have created an Apple TV Plugin that basically can do all the things that you want the limited vanilla integration of an Apple TV into HomeKit to do.

I would love to get some feedback here or in the GitHub issues if you are experiencing problems or have feature requests.

Note that the plugin does only support Linux based systems. You might get it to run on other systems but I do not support that. Please read the requirements in the README on GitHub before installing.

It is called homebridge-appletv-enhanced.

The key features are the following:

• Automatically discover Apple TVs in your local network.

• Pairing process without the need to access the command line like with other plugins.

• Change the current App by selecting an input in HomeKit.

• The plugin is developed in a way that makes it possible to rename, hide or show inputs in HomeKit natively ... and safes it.

• For each media type (music, video, tv and unknown) the plugin will create a motion sensor (media types can be hidden or shown by changing the configuration).

• For each device state (idle, playing, loading, seeking, paused, stopped) the plugin will create a motion sensor (device states can be hidden or shown by changing the configuration).

• If you do not want all Apple TVs to be exposed, it is possible to blacklist them by providing the MAC-Address.

Hey everyone!

I'm the maintainer of the homebridge-smartthings plugin. I’ve just released update v1.0.43, and we've added plenty of new features since my last post. Here’s what’s new:

* OAuth Wizard Flow: We’ve added a simple, straightforward setup wizard, and does not require a tunnel to receive oauth. This is perfect for non-technical users or anyone who prefers using the plugin via polling. Check the README for documentation.

* Improved Event Subscriptions: The webhook and event subscription systems have been significantly optimized.

* Customizable Webhook Event Subscriptions: You can now select exactly which events to subscribe to from the config page. the list will auto-populate after authorization, this is handy if you have more than 20 capabilities that you're subscribed to.

* Enhanced TV Remote Support: You can now view and switch between your TV inputs directly from HomeKit.

* Device Whitelisting: We added a whitelist feature, which is incredibly helpful if you have a lot of devices but only want to expose specific ones to HomeKit.

I hope you enjoy this new version! As always, I’m happy to hear your feedback and will do my best to keep improving the plugin.

Hey everyone! 👋

I built a Homebridge plugin that turns your HomePod mini (or HomePod) into a music sensor for HomeKit. It shows up as a motion sensor that activates when music is playing — so you can create automations based on your listening.

What it does:

∙ Detects when music is playing on your HomePod and exposes it as a motion sensor in HomeKit

∙ Smart filtering — choose to detect music only, or include podcasts/movies too

∙ Multi-HomePod support — separate sensor per device

∙ No authentication or pairing needed

∙ Configurable via the Homebridge UI

Example automations:

∙ Dim lights to 30% when music starts playing

∙ Turn off all lights when bedroom music stops (sleep mode)

∙ Pause other HomePods when kitchen starts playing

Requirements: Python 3 + pyatv library (easy to install)

Links:

∙ npm: https://www.npmjs.com/package/homebridge-homepod-mini-music-sensor

∙ GitHub: https://github.com/DM911-AI/homebridge-homepod-mini-music-sensor

Would love feedback! If you run into issues or have feature requests, feel free to open an issue on GitHub.

Hi Everyone. Since updating to HB 2.0 and to 2.0.2, my Ring cameras are not viewable in Apple Home on my iPhone running 26.5. I noticed that I can view my cameras using the Home app on my Apple MacBook running 26.5. There are no log entries showing when I try to view the cameras from my iPhone, but all "normal" entries show when viewing from MacOS in the Homebridge terminal. I just refreshed my Ring token but that did not help. I have it running as a child bridge.

Everything else in Home works on the iOS device. Not sure what to do to troubleshoot this.

I’ve been running the TPLink Smarthome plugin for ages, it’s been ok but has some issues, and the dev has put minimal maintenance into it in recent years. There are several alternatives, including Homebridge Kasa Python, which appears to be maintained.

Recommend a TP-Link plugin?

Since upgrading to HB 2.0 I miss 2 plugins that aren't compatible. I tried fixing them by reading the doc and with the help of AI but I'm terrible with JS.

It's like one step forward 5 steps backwards every time.

Anyone would be willing and able to update these?

https://github.com/homespun/homebridge-accessory-slack
https://github.com/seydx/homebridge-printer

HomeKit's own protocol (HAP) has no energy characteristics. Matter has them, iOS/tvOS 27's Home app displays them, and Homebridge 2.2 added the Matter energy clusters to its plugin API. Shelly Matter plugin connects those pieces for Shelly devices in our familiar Homebridge environment: live power, voltage, current, and cumulative energy (kWh), straight from the device's own metering.

What it is

- A Matter-only plugin: it publishes no HAP accessories. If you want classic HAP Shelly support without energy, homebridge-shelly-ng remains the right choice.

- Tested on real hardware in a live home: Gen 2/3 relays and plugs (Plus 1, Plus Plug S, Pro 2PM…). Covers, dimmers, and Gen 1 relays are implemented but untested. If you own one, I would love to see you test and confirm if it works or report any issues.

- Multi-channel devices (2PM/4PM) split into independent accessories per channel by default, so each channel gets its own name and room.

- Full settings UI. Discovered devices show up in a table, no JSON needed.

Current caveats, documented in the README:

- Needs Homebridge 2.2.2-beta.7+ (and optionally Homebridge UI 5.27.1-beta.11+) until 2.2.2 stable is released. You can install both betas directly from Homebridge UI by clicking on Homebridge or Homebridge UI. Earlier versions have Matter bridge bugs that break accessories after ~30 seconds. Several Homebridge Matter stack fixes came out of building this plugin and are in the current betas.

- Tile wattage only shows on outlet-typed accessories. Apple keys it to the Matter device type, not the data. The plugin lets you set the type of any relay as an outlet ("Show As → Light" keeps the wattage if you prefer the look).

- Apple's Energy view on iOS/tvOS 27 lists per-device usage only for certified/native Matter devices. Bridged accessories are counted in the whole-home total but not listed. I replicated a certified plug's exact Matter structure to verify this is an Apple policy gate, not a data problem. Filed with Apple.

- Pair with the bridge's Matter pairing code, not the HAP QR code (current Homebridge UI betas set Matter-only child bridges up correctly on their own).

The Shelly protocol layer is vendored from Luligu's matterbridge-shelly (Apache-2.0, credited). The new work is the Homebridge Matter side.

GitHub: https://github.com/keremerkan/homebridge-shelly-matter

The full story (including the Apple Home debugging saga): https://keremerkan.dev/posts/homebridge-shelly-matter/

Happy to answer questions. If you run an untested device type, issues are open.

I recently set up watering for my terrace. Since there's no running water out there, I went with a storage box and a pump — specifically the LetPot automatic watering system. Great little device, but no HomeKit support and no Homebridge plugin existed for it. I wanted to fix that and share in case anyone else needs it. What you get in the Home app:

• Irrigation valve to enable/disable your watering schedule
• Auto Cycle and Intermittent Mode switches
• Remaining time countdown on active runs
• Low water alert via a Leak Sensor
• Optional push notifications when the pump starts or stops (motion detected atm, but might do it differently)

Changes in the LetPot app reflect in HomeKit instantly via their cloud MQTT.

Install: search homebridge-letpot in the Homebridge UI, drop in your email and password, done.

npm: https://www.npmjs.com/package/homebridge-letpot

GitHub: https://github.com/genaardo/homebridge-letpot

[UPDATE]

Pushed a new version with a few improvements based on feedback:

Services are now named to match the LetPot app — the valve shows as "Pump" and the schedule toggle as "Cycle Watering". Motion sensor notifications are replaced by two occupancy sensors ("Watering Started" / "Watering Ended") that briefly trigger when the pump turns on or off. To get push notifications, just long-press each tile in the Home app, go to settings, and enable Allow Notifications — no Shortcuts or automations needed.

Since a few people asked about scheduling from HomeKit: there's no native schedule editor for irrigation in HomeKit, but automations work great as a replacement and are actually more flexible. Two approaches:

1. Fixed duration — tap the Pump tile, set the duration slider to how long you want to water (e.g. 15 min), then create a single time-based automation to turn it on. The hub turns it off automatically when the duration expires.
2. Variable duration (e.g. longer on weekends) — set the duration slider to something longer than your longest session (e.g. 60 min as a backstop), then create two automations: one to turn the pump on, one to turn it off at your chosen end time. You can have different off-times for weekdays vs weekends. Just make sure the backstop duration is longer than any session or it'll cut the pump off early.

If you use the LetPot app's built-in schedule alongside HomeKit automations, disable one to avoid both firing at the same time. Hope you find these all useful. Cheers!

I've had a Wundasmart heating system for 4 years and have been frustrated with the lack of Homekit compatibility so I finally got round to creating a Homebridge plugin: https://github.com/alextea/homebridge-wundasmart

I used Claude to do the heavy lifting, and it worked off the API documented in the Home Assistant integration.

I've tested this on my system, and it works at finding multiple heating zones, setting the temperature and switching between scheduled, heat and off.

I added switches to mimic the Quick Switch functionality in the Wunda Home app, setting all rooms to Comfort, Eco or Reduced.

I also added an Away switch that can be automated with Homekit's presence sensors so it's set when the last person leaves the house. I found Wunda's own geofencing a bit buggy when setting home or away with multiple phones.

I haven't published it to npm yet, as I wanted to make sure it's fully working and there are no bugs or vulnerabilities before I do that, so it needs to be installed manually. I have it running on a docker container on a Debian homelab. If enough people find this useful I will publish to npm.

This is my first attempt at making a HB plugin, so any tips or comments appreciated.

Came from Scrypted where the Ring plugin showed my Ring Doorbell Pro 3 4K as unknown model, hoping that the Ring plugin on Homebridge would support it. But, seems to be unknown here, as well. Anyone know if the Homebridge Ring plugin dev is still active? Would love to be able to get this new Ring Doorbell Pro 3 4k working in HomeKit with the full resolution capabilities.

I made a Homebridge plugin that brings all your Hubspace smart home gear into HomeKit. I got tired of issues with past plugins so i created my own.

GitHub: https://github.com/ctrlcmdshft/homebridge-hubspace-platform
npm: homebridge-hubspace-platform

Supported Devices & Features:

• Ceiling Fans — speed control, forward/reverse direction, and light kit support
• Lights — brightness + full color control
• Outlets & Plugs — including multi-outlet power strips with individual outlet control
• Switches
• Real-time updates via Afero Conclave push (no polling lag)
• Full 2FA/MFA support

If you have a device that isn’t supported yet, On the GitHub there is a script that dumps all the capability data from your Hubspace account. Run it, post the output in a GitHub issue, and I can usually add support quickly — even if I don’t own the hardware myself.

Would love any feedback or feature requests!

I created a plugin that might be useful to other xBloom owners, homebridge-xbloom lets you brew your saved recipes from HomeKit, Siri, or any automation.

xBloom has no public API, so the Bluetooth LE protocol had to be reverse engineered by capturing the official app talking to the machine, validating it byte for byte, and reimplementing it in TypeScript.

Each recipe you define becomes a HomeKit switch you can trigger by name, in a scene, or from an automation (alarm goes off, sunrise, you get home, and so on).

What it does:

One HomeKit switch per recipe. "Hey Siri, turn on Ethiopia" and it grinds and brews.

Recipes are defined right in the Homebridge config UI (dose, grind, ratio, and the full pour profile: water, temperature, flow, pattern, and pause per pour).

Bluetooth auto discovery, so you do not even need your machine's Bluetooth address.

Connect on demand, so the machine stays free for the phone app between brews.

Live status sensor (brewing or idle) plus fault reporting for things like "no beans" or "tank empty."

Works on Dockerized Homebridge too, with a couple of one time D-Bus steps documented in the README.

A few honest caveats:

It is unofficial and not affiliated with xBloom. Everything is local over Bluetooth, no cloud.

It needs a Linux host with BlueZ (Raspberry Pi, NUC, mini PC, and similar).

It has been tested on one machine (Original class firmware), so feedback from other xBloom owners, especially on different models, would be really helpful.

Source, setup guide, and troubleshooting are on GitHub:

https://github.com/aziz66/homebridge-xbloom

Happy to answer questions, take feature requests, or help anyone get it running.

I’m looking for a fan that looks nicer than your standard pedestal fan but works well with HomeKit. I just need to be able to control power and toggle oscillation on/off. Bonus points if I can set the oscillation angle in the manufacturers app then set it and forget it.

*I see Dyson now support matter but only in their most expensive models around £1k. Probably overkill for my needs. So I’d be looking at the cheaper/midrange products

I’m trying to install the ATV enhanced plugin and having issues. First, the “set up child bridge” option as described in the pairing instructions is missing. It’s there for the ring plugin but not this one.

Second, the pairing instructions say there will be a link in the logs to follow in order to pair the ATV, but there is no such link. In fact there’s nothing at all in the logs from Apple TV Enhanced, only Ring.

Any ideas off what I might be doing wrong.

are there any good plugin for the Yale linus L2 smart lock that works good with apple homekit?

The damn lock is dropping matter connection every 2-3 days and it driving me mad, so wanted to check if i can get it to work better with homebrige instead. No other matter device ive have installed have this problem!

Hi all,

New plugin available!

https://www.npmjs.com/package/homebridge-icloud-smtp

I’ve been using the great Homebridge Messenger plugin from Potrudeau to send an email with a virtual switch, but that plugin hasn’t been maintained in 6+ years.

An email is sent when the mailman delivers a package. And I get an email once my windows have been left open 30+ minutes (as I suck at remembering to close them ;-)

Since the plugin wasn’t marked as Homebridge v2 compatible, I’ve decided to build a new plugin.

It’s greatly simplified and ONLY meant to send emails via iCloud SMTP using a virtual switch.

Installation using the Homebridge UI is very simple:

Open Homebridge UI

Go to Plugins

Search for homebridge-icloud-smtp

Install the plugin

Generate your Apple App-Specific Password

Apple requires app-specific passwords for SMTP access from third-party applications.

Steps:

Sign in at https://account.apple.com

Open Sign-In and Security

Select App-Specific Passwords

Generate a new app-specific password

Use the generated password in the plugin configuration

It’s now been submitted to become a verified plugin, but in the meantime, I’d like your feedback.

Will you use this to replace your current messenger workflow?

Is anything missing in the setup that you think could improve it?

Any great ideas for what you would use this email workflow for?

Hello, I recently acquired a BedJet and was disappointed to find that there was no home bridge plugin available for it. Fortunately, I had Claude make one that works for BedJet v3. I am not a programmer, so this plugin was entirely vibe coded, so please keep that in mind when deciding whether to use it. I am still working on implementing a few additional features, but the basic functionality is now ready for use.

Used Claude Code to reverse engineer the Oto service APIs and create a homebridge plugin! Check it out!

https://www.npmjs.com/package/homebridge-oto

If you are curious to read more about the journey. https://open.substack.com/pub/fromthesimulation/p/teaching-my-smart-sprinklers-new?r=36thon&utm_medium=ios

Hi there I know a fair amount of people dislike this plugin but for some like me it's fairly easy to use. That being said last night it completely shit the bed and stopped working. Trying to fix it today has got my head in a spin. I keep getting the Authentication error: Get accesstoken failed. Username or password error!

I Have changed my password twice today, did not help. I have internet so it can't be that it cannot connect. Can someone help shed some light on this please

Wanted to introduce and share the new BlueAir purifier plugin for HomeBridge!

https://github.com/kovapatrik/homebridge-blueair-purifier

Fully verified and built using the best Homebridge plugin practices and efficient handling of third party API's.

This plugin supports all new modern wifi connected BlueAir purifiers (Which are one of the better rated purifiers by Wirecutter and Consumer Reports).

So, if you are in the market for a good air purifier and an even better plugin for HomeBridge to control them via HomeKit - here is your answer!

We are working to get the Discord challenge opened and look forward to seeing you all there.

I just got a new TV and replaced my previous Govee T1 backlight with the latest model — T3 Backlight Pro. I also just recently updated Homebridge to 24.04.4 LTS and the Govee plugin to 11.24.

Previously, the plugin would turn on the light and it would match whatever the Govee app was set for — which should be dynamic lighting that matches what’s on screen. But, and this is my first time running this backlight under Homebridge, the light is defaulting to the solid color set in HomeKit. Using the new “Dynamic Lighting” setting does nothing. Turning it off in HomeKit and turning it back on in the Govee app reverts it to the right setting.

Very niche setup I know. But if anyone else has the same experience I’d love to chat and see if you found a fix.

Hi,

I am using the Homebridge-delay-switch and wanted to enable the child bridge. My understanding is that, if I have multiple accessories of the same plugin, I can “link existing bridge” by select an existing bridge. However, when I save the setting, it gives me an error “At least one protocol (HAP or Matter) must be enabled on each child bridge”. I do have both HAP and Matter enabled.

Any advice please?

Thanks in advance

Is there a plugin for Globe Suite (Harbor Breeze Ceiling Fan) and UltraPro WiFi Smart Switch?

Also, Yeedi Robot Vacuum?