Hikvision Doorbell Plugin (fork)

A fork of @vityevato/hikvision-doorbell 1.0.1 (by Roman Sokolov) for Scrypted, with a single change: the doorbell now answers (stops ringing) whenever two-way audio is opened, instead of only when an incoming ring was detected.

Compatibility

This fork targets Hikvision doorbells such as the DS-KV6113-WPE1(B) whose hardware no longer receives firmware updates. The upstream 2.x releases dropped support for these units, so the 1.x line is the last compatible one — this fork is based on 1.0.1 and is the version that still works on the (B) hardware.

Why

In ISAPI mode, opening two-way audio (for example, the Talk button in HomeKit) should tell the doorbell to answer — and therefore stop ringing — by sending:

PUT /ISAPI/VideoIntercom/callSignal?format=json   {"CallSignal":{"cmdType":"answer"}}
PUT /ISAPI/VideoIntercom/callSignal?format=json   {"CallSignal":{"cmdType":"hangUp"}}

In 1.0.1 this only happened when the plugin had already detected the ring (binaryState === true). That detection relies on empirically parsing the camera's binary event stream, which is firmware-dependent. On firmware where the detection fails, the answer is never sent and the doorbell keeps ringing when you try to answer.

The change

src/main.ts, private stopRinging() — the guard is removed:

if (!this.binaryState) return;   // removed in this fork

The answer/hangUp call signal is now always sent when two-way audio opens. The command is idempotent and safe even while the camera is idle.

SIP mode note: the sipManager.answer() path waits up to 5s for a TalkHangup event; without an active ring this adds ~5s of latency when opening the channel. The default ISAPI mode is unaffected.

Contents

dist/plugin.zip   prebuilt, patched Scrypted plugin bundle
src/              plugin source

Building

The source uses relative imports into the Scrypted monorepo (../../hikvision/src, etc.), so it only builds inside a github.com/koush/scrypted checkout. dist/plugin.zip is the upstream 1.0.1 bundle with the single change above applied.

Credit

Based on @vityevato/hikvision-doorbell 1.0.1. License: Apache-2.0.