Ring (HKSV)
homebridge-ring-hksv · v15.0.2
Adds Ring doorbells, cameras, alarm, smart lighting and other Ring devices to HomeKit with HomeKit Secure Video.
What it says it supports
Brands
- Ring
Devices it names
- Ring doorbells
- Ring cameras
- Ring Alarm
- Ring Smart Lighting
- Ring Beams
Shows up in Apple Home as from its README
Sensor readings in its code
What people report
Adds HomeKit Secure Video for Ring cameras; Intercom Video added in v15. Battery cameras have HKSV off by default.
- Works1
- Partly works2
| Device | Status | What they said | Source |
|---|---|---|---|
| Ring Intercom Video | Works | Support merged into v15 pipelineSaved copy@trinityhades This is the Ring Intercom Video support from #3, ported onto the v15 media pipeline. You can pick whichever fits your plans: #3 (based on v14) or this one (v15). Once one is merged, I'll close the other. What it does Exposes `intercom_handset_video` as a HomeKit video doorbell with live view and HKSV recording, using a `RingCamera`-compatible proxy around `RingIntercom` Doorbell events in HomeKit, with an active-dings poll as a fallback, because intercom video dings don't always arrive through `onDing` Starts the camera connection as soon as a ding is detected, so HKSV … Excerpt saved from GitHub on 2026-10-22. | PR #12 · 2026-10 |
| Ring Alarm Front Door lock | Partly works | Control works; Jammed/Unknown states now mapped to Secured in v14.3.5Saved copyPlugin version: 14.3.4 Homebridge: 2.0.2 HAP-NodeJS: 2.1.6 (via `@homebridge/hap-nodejs` re-export) Node: 24.15.0 Symptom After pairing my Ring alarm + Front Door lock, the Homebridge log fills with this warning every ~5 seconds: [code] …alternating between `number 2` and `number 3`. It produces ~3.5K spam lines per day per lock. Lock control still works; this is purely a log-noise / HAP-validation bug. Root cause In `lib/lock.js`: [code] When `this.targetState` is `undefined` (the steady state, the lock isn't mid-transition), `getTargetState` falls back to `getCurrentState(data)`, which … Excerpt saved from GitHub on 2026-10-22. | Issue #4 · 2026-05 |
| Ring battery cameras | Partly works | HKSV disabled by default on battery cams; 4 of 6 cameras recorded after fresh setupSaved copy… up a completely new instance, with a new Apple Home (so would recommend this to anyone having unexplained issues). I am now getting HKSV from 4 of my 6 cameras, (2 of those 4 are battery but are permanently plugged in). Not completely sure they are capturing all motion, but for sure it's much better than in the past. The 2 cameras that are not capturing any HKSV are "Spotlight Cam Battery", but are permanently plugged in being charged. HKSV is not disabled for battery cameras in the config. Will run it for a week or so and see how it goes. Awesome plug in though - thank you for your efforts!! Excerpt saved from GitHub on 2026-10-22. | Issue #5 · 2026-05 |
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
Cloud
Ring cloud API
You’ll need
- Ring account
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | >=1.4.0 || ^2.0.0-beta.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20 || ^22 || ^24 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | Homebridge Ring HKSV |
| License | MIT |
Community signals
| Downloads a week | 62 |
|---|---|
| Downloads a month | 211 |
| GitHub stars | 3 |
| Open issues | 4 |
| Closed issues | 2 |
| Last code push | 2026-10-13 |
| Latest version | 15.0.2 (2026-10-13) |
| First published | 2026-03-06 |
| Releases | 26 |
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.
Caveats from the README
- README is minimal; scope inferred from keywords and code
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Battery
- CameraOperatingMode
- CameraRTPStreamManagement
- CameraRecordingManagement
- ContactSensor
- DataStreamTransportManagement
- Doorbell
- Fan
- LeakSensor
- Lightbulb
- LockMechanism
- Microphone
- MotionSensor
- Outlet
- SecuritySystem
- Speaker
- StatelessProgrammableSwitch
- Switch
- Thermostat