scrypted_onvif_hardened

A hardened fork of the official @scrypted/onvif plugin, published independently on npm for easy installation without manual source builds.

What this is

This is a drop-in replacement for the built-in Scrypted ONVIF plugin. It includes the upstream plugin in full, plus targeted patches that address real-world issues not yet merged into the official release.

Upstream: koush/scrypted — branch fix/onvif-rtsp-url-override

Changes from upstream

1. RTSP URL Override — opt-in per camera

Problem: OnvifCamera.showRtspUrlOverride() was hardcoded to return false, which permanently hid the RTSP Stream URL Override input field in the Scrypted UI and silently discarded any stored override URLs at runtime. There was no way to manually specify RTSP stream URLs for an ONVIF camera, even when the camera's auto-discovered URLs were unreachable or unstable.

Fix: Added an opt-in boolean setting RTSP URL Override under the camera's Advanced subgroup. When toggled on, the camera uses the manually specified RTSP URL(s) instead of those discovered via ONVIF.

Why this matters:
Some cameras (e.g. those running Boa/0.94.14rc21 firmware) have a hard limit on simultaneous TCP connections. When Scrypted, NVR prebuffering, and HomeKit all open their own RTSP sessions, the camera drops connections. Routing streams through a relay proxy like go2rtc solves this — but only if you can point the RTSP URL to the proxy. This setting makes that possible.

Setting key: enableRtspUrlOverride (intentionally distinct from the legacy rtspUrlOverride key to avoid conflicts with the migration path in RtspSmartCamera.getUrlSettings()).

Installation

Install from the Scrypted plugin UI by entering the npm package name:

scrypted_onvif_hardened

Or via environment variable:

SCRYPTED_INSTALL_PLUGIN=scrypted_onvif_hardened

Compatibility

• Requires Scrypted with ONVIF-T profile cameras for motion events
• ONVIF NVRs: add the NVR once per camera channel (same as upstream)
• All upstream ONVIF features are preserved

License

Apache 2.0 — same as the upstream Scrypted project.