HC-SR501 Motion
homebridge-hc-sr501 · v2.0.0
Adds PIR motion sensors such as the HC-SR501 on a Raspberry Pi GPIO pin as HomeKit motion sensors.
What it says it supports
Brands
- Raspberry Pi
Devices it names
- HC-SR501 PIR sensor
- Raspberry Pi 5
- GPIO motion sensors
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Raspberry Pi GPIO motion sensor plugin; works once the correct pin is used.
- Works1
| Device | Status | What they said | Source |
|---|---|---|---|
| HC-SR501 PIR motion sensor | Works | Works on Raspberry Pi GPIO; wiring to the correct pin neededSaved copyI'm not sure what I'm doing wrong. I installed the plugin and connected up my HC-SR501 to PWR, GND & GPIO24 but I'm getting no motion detection in the Home app. Excerpt saved from GitHub on 2026-10-22. | Issue #2 · 2017-03 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
GPIO via libgpiod on the Raspberry Pi
You’ll need
- Raspberry Pi GPIO wiring
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | ^1.6.0 || ^2.0.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^22.12.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | HcSr501Platform |
| License | GPL-3.0 |
Community signals
| Downloads a week | 187 |
|---|---|
| Downloads a month | 199 |
| GitHub stars | 10 |
| Open issues | 3 |
| Closed issues | 9 |
| Last code push | 2026-10-12 |
| Latest version | 2.0.0 (2026-10-12) |
| First published | 2017-03-10 |
| Releases | 9 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- MotionSensor