scrypted-kasa 1.3.6 → 1.6.0

package/README.md

@@ -26,11 +26,23 @@ In Scrypted:
 - Exposes the camera's spotlight (when present, e.g. KC420WS) as an `OnOff` child light
   device in the same room as the camera. Driven by the LINKIE2 control protocol on port
   10443.
-- Exposes the camera's siren (when present) as an `OnOff` child switch device, also in
-  the camera's room. Triggering it turns the siren on; the camera auto-stops after the
+- Exposes the camera's siren (when present) as an `OnOff` child siren device, also in
+  the camera's room. HomeKit shows it as a switch inside the camera accessory. Triggering it turns the siren on; the camera auto-stops after the
   duration configured in the Kasa app (default 30 s).
+- Exposes the camera's own on/off ("camera off" in the Kasa app) as a **Privacy Mode**
+  child switch. On turns the camera off, which stops video for every client, not just
+  HomeKit, so it suits home/away automations. While the camera is off, stream attempts fail
+  with a short "turned off" message instead of an error, and video resumes on its own when
+  it's turned back on.
 - Exposes the camera's **status LED** as the camera's own `OnOff` interface, so HomeKit's
   per-camera "Link Status Indicator" toggle drives the LED.
+- Exposes **pan/tilt** (when present, e.g. KC410S) as the camera's own `PanTiltZoom`
+  interface: step moves in the Scrypted and NVR camera views, plus the viewpoints saved in
+  the Kasa app as presets. HomeKit has no pan/tilt support, so this is not visible there.
+- Adds a **Reboot camera** button to the camera's Settings tab
+  (`smartlife.cam.ipcamera.system.set_reboot` over LINKIE2). Useful when the video stream
+  stops — connection refused on port 19443 while the control port still answers — which
+  otherwise needs a power cycle. The camera is back after about 30 s.
 
 ## Plugs / Switches / Dimmers / Bulbs (legacy IOT protocol)
 
@@ -129,18 +141,28 @@ setup below.
   features. Wire format: HTTPS POST `/data/LINKIE2.json`, body `application/x-www-form-
   urlencoded` with a single `content=<base64(xor_ab(json))>` field. The XOR-AB autokey
   cipher is the same one used by Kasa's UDP/9999 discovery protocol.
-- On adoption (and whenever credentials change) the plugin probes three LINKIE2 endpoints
+- On adoption (and whenever credentials change) the plugin probes these LINKIE2 endpoints
   serially:
   - `smartlife.cam.ipcamera.dayNight.get_force_lamp_state` — if it returns `on`/`off`, a
     child `OnOff` light device named "<camera> Spotlight" is registered in the camera's
     room.
   - `smartlife.cam.ipcamera.siren.get_state` — same pattern; produces a "<camera> Siren"
     switch child device.
+  - `smartlife.cam.ipcamera.switch.get_is_enable` — produces a "<camera> Privacy Mode"
+    switch child device, inverted: on means `set_is_enable` `off`. A turned-off camera
+    keeps its stream port open but answers HTTP 503.
   - `smartlife.cam.ipcamera.led.get_status` — drives the camera's own `OnOff` so HomeKit
     can bind its `CameraOperatingModeIndicator` (a.k.a. "Status Light") characteristic to
     it. Enable **Link Status Indicator** in the HomeKit plugin's per-camera settings to
     activate the binding.
 - Toggling any of the three calls the matching `set_*` method with `{"value": "on"|"off"}`.
+- `smartlife.cam.ipcamera.ptz.get_capability` — if it succeeds, `PanTiltZoom` is added to
+  the camera and `get_all_preset` populates its presets. Fixed-lens models answer with
+  `-10008` and are left alone. Moves use `set_move` with `{"direction":
+  "left"|"right"|"top"|"bottom", "speed": 1-10}`, where speed is the step size of a single
+  discrete step (Scrypted's -1..1 magnitude maps to `ceil(|v| * 10)`); presets use
+  `set_run_to_preset` with `{"index": n}`. There is no absolute-position, home, or zoom
+  command, so those PTZ movements are rejected.
 
 ## Notes / limitations
 
@@ -152,6 +174,11 @@ setup below.
   header on the very first request — the camera silently drops requests that don't look
   enough like the official app.
 - The camera presents a self-signed TLS certificate; certificate verification is disabled.
+- **One stream connection per camera.** The camera serves a single client on the stream
+  port (19443); a second connection opens at the TCP level but stalls in the TLS handshake
+  until it times out. Scrypted's rebroadcast (prebuffer) plugin holds that one connection
+  and fans it out to HomeKit, the NVR and other clients, so keep it enabled. Another local
+  client (a second NVR, a manual `curl`) can't connect to the stream while Scrypted holds it.
 - Auto-discovery sweeps the local /24 only. Larger subnets (e.g. /23) are skipped to
   avoid flooding.
 

package/package.json

@@ -1,6 +1,6 @@
 {
    "name": "scrypted-kasa",
-   "version": "1.3.6",
+   "version": "1.6.0",
    "description": "TP-Link Kasa plugin for Scrypted — cameras (video, two-way audio, spotlight, siren, status LED), plugs/outlets, wall switches, dimmers, and smart bulbs (on/off, brightness, color, color temperature).",
    "author": "Sergey Vilgelm <sergey@vilgelm.com>",
    "license": "MIT",
@@ -78,12 +78,13 @@
       "typescript-eslint": "^8.59.1"
    },
    "overrides": {
-      "serialize-javascript": "^7.0.5",
-      "adm-zip": "^0.6.0",
+      "serialize-javascript": "^7.1.3",
+      "adm-zip": "^0.6.1",
       "@babel/core": "^7.29.7",
       "webpack-bundle-analyzer": {
          "ws": "^7.5.13"
-      }
+      },
+      "minimatch": "^11.0.1"
    },
    "engines": {
       "node": ">=20"