Skip to content
Homebridge TestFlight
Ring

Ring (HKSV)

homebridge-ring-hksv · v15.0.2

CloudHomebridge 2.0

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
DeviceStatusWhat they saidSource
Ring Intercom VideoWorksSupport merged into v15 pipeline
Saved 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 lockPartly worksControl works; Jammed/Unknown states now mapped to Secured in v14.3.5
Saved copy
Plugin 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 camerasPartly worksHKSV disabled by default on battery cams; 4 of 6 cameras recorded after fresh setup
Saved 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 HomebridgeNo
Homebridge versions>=1.4.0 || ^2.0.0-beta.0
Homebridge 2.0Yes
Node.js^20 || ^22 || ^24
Settings in Homebridge UIYes
MatterNo
Platform nameHomebridge Ring HKSV
LicenseMIT

Community signals

Downloads a week62
Downloads a month211
GitHub stars3
Open issues4
Closed issues2
Last code push2026-10-13
Latest version15.0.2 (2026-10-13)
First published2026-03-06
Releases26

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