node-red-contrib-hikvision-ultimate

<img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-hikvision-ultimate/master/img/logo.png' width="40%"> [![Donate via PayPal](https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square)](https://www.paypal.me/techtoday) Version 1.2.22 March 2026 - AX Pro node: added `msg.armAwayAllAreas` and `msg.armStayAllAreas` to arm all partitions in a single batch command, reducing duplicate Hik-Connect notifications. - AX Pro docs: documented the new batch arming commands in the node help and README. Version 1.2.21 March 2026 - NEW: Intelligent Alarm Node. - PTZ Node: added option to wait until the camera really reached the position. Version 1.2.20 March 2026 - Alarm (Camera Event): added support for Temperature Measurement Alarm events (`eventType: TMA`) and exposes `msg.tma` details when provided by the device. - PTZ node: ignore unrelated alert stream events on PIN 1 and clarify that `payload: true` means the goto command was accepted, not that the preset has already been reached. - PTZ node: added optional Wait for camera position reached mode, which polls the PTZ absolute position and emits PIN 1 only after the camera movement settles. Version 1.2.18 December 2025 - You can now use DNS name in the camera's IP address field. Version 1.2.16 December 2025 - All config and runtime nodes: ensured all recurring setTimeout/setInterval timers are cleared on node close, preventing RAM growth on every Node-RED deploy. Version 1.2.15 December 2025 - Access Control Terminal: avoid crashes on devices that omit the eventDescription property by synthesizing a fallback description. Version 1.2.14 December 2025 - Runtime nodes: added optional debug logs (alarms, ANPR, PTZ, picture, AX Pro, doorbell, speaker, text, XML) when debug level is enabled. - All config nodes: added Debug level option aligned with Hikvision-config. - ANPR config: added detailed debug logs (request picName, HTTP status, body length, parsed plate count) and safer parsing warnings. - Hikvision/AXPro config: cleaned debug log for image parts to avoid undefined variable warnings. Version 1.2.12 November 2025 - Hikvision config: configurable connection timeout and improved stream heartbeat handling to prevent socket hangups. - AXPro config: aligned multipart parsing and heartbeat logic with the Hikvision fixes. - Hikvision config editor: documented timeout behaviour and discourages using "No Timeout". Version 1.2.11 October 2025 - Fixed this: https://github.com/Supergiovane/node-red-contrib-hikvision-ultimate/issues/89#issuecomment-3379715396 Version 1.2.10 May 2025 - Fixed this: https://github.com/Supergiovane/node-red-contrib-hikvision-ultimate/issues/84#event-17587603634 Version 1.2.8 May 2025 - Housekeeping. - Optimized hikvision stream for some devices. Version 1.2.6 January 2025 - AX Pro: fixed msg.clearAllAlarmAreas input property, that was clearing only the area number 1. - AX Pro: fixed msg.disarmAllAreas input property, that was disarming only the area number 1. Version 1.2.5 December 2024 - Doorbell: Disabled some XML parser error logs. Version 1.2.4 December 2024 - Doorbell: fixed an issue introduced with 1.2.3, preventing the door to be open. Version 1.2.1 September 2024 - AX Pro: fixed an issue where occasionally, when malformed multipart data is sent from the AX Pro, there would be no NAK. Version 1.2.0 September 2024 - RAW Event Node: on the third pin, outputs the IMAGE related to the event (if any). The node will now filter the heartbeat signals. - Event Node: on the third pin, outputs the IMAGE related to the event (if any). Version 1.1.22 August 2024 - IP Speaker node: added help. Version 1.1.21 August 2024 - NEW: IP Speaker node: play preloaded audio files from an IP Speaker. Version 1.1.20 Mai 2024 - AX Pro node: added msg.disarmAllAreas, msg.clearAlarmArea and msg.clearAllAlarmAreas. See the help tab in node-red for fuhrter infos Version 1.1.19 April 2024 - ANPR: fixed an issue it the plate's list parser in cameras having ISAPI protocol 1.0. Version 1.1.17 April 2024 - ANPR: fixed an issue it the plate's list parser. Thanks @jpgnz. - Fixed the node icons not showing up. Version 1.1.16 April 2024 - Fixed somme try-catch functions. Version 1.1.15 April 2024 - Doorbel node: fixed a crash if you send msg.hangUp = true, when the doorbell cannot be reached. Version 1.1.14 January 2024 - Fixed sintax errors in some dropdown list. Thanks to @pmattia90 Version 1.1.13 October 2023 - Refined some function and start to write the help TAB of Node-Red. - Added the debug level option. Version 1.1.12 October 2023 - Silenced the log error, while error occurs fetching the http socket. Version 1.1.11 August 2023 - Bump Jimp. Version 1.1.9 April 2023 - FIX: Access Control Node: workarounded bug in some hik firmwares, not correctly sorting the events received. Version 1.1.8 March 2023 - Access Control Node: added eventdescription in the payload message. Version 1.1.6 March 2023 - Optimization/bugfix to Access Control Terminal, node event handling after NTP time set. Version 1.1.5 March 2023 - NEW: Added the Access Control Terminal node. Version 1.1.2 January 2023 - FIX: trying to fix the "reject" and "hangUp" function, sent to Door Station using the new V2 protocol. Version 1.1.1 January 2023 - NEW: added an online device list in the camera/nvr configuration node, to visually help the user. Version 1.1.0 January 2023 - Removed xml2js package and replaced it with fast-xml-parser. - Fixed other memory issues when there are a lot of cameras in the flow. Version 1.0.71 January 2023 - FIX: fixed error MaxEventListener, occurring in case of sudden Camera LAN disconnection. This was due to the xml2js function. - AX Pro node is out of the beta phase and has been released. Version 1.0.70 December 2022 - NEW: AX Pro node: you can now filter by Alarm events, Zone status changes, or have both as output. - Begin standardizing help in the "help" panel of node-red, starting with AX Pro node. Version 1.0.69 December 2022 - Some bugfixes. Version 1.0.67 December 2022 - NEW: AX Pro node now outputs alarm events and also zone status (even if the alarm is disarmed). - Updated Ajax Pro Wiki. Version 1.0.66 December 2022 - NEW: new AX Pro and AX Pro Hybrid node. These panels require a totally different authentication and handling, so i made another node just for that. You can receive events and also control your security system - EDIT: changed the node name from "Alarm" and "RAW Alarm" to "Event" and "RAW Event" to avoid confusion with the new AX Pro node. - Fixed stability issue with the new AX Pro node. Version 1.0.64 September 2022 - Not all Hikvision door intercom does have the proper APIs to connect to. Added warning. - Add: The Picture Node now passes through the input message, in the property msg.previousInputMessage Version 1.0.63 August 2022 - Maintenance release. Optimized the scope of some variables. - Aded a Warning on the README page. Version 1.0.62 Juni 2022 - Maintenance release. Fixed an issue with node-fetch v3 incompatibility. Version 1.0.61 April 2022 - Maintenance release. Bumped required depencencies. Version 1.0.60 January 2022 - Maintenance release. Removed the device compatiblility list from the bottom of the readme page, because with the new Doorbell Hik devices (that i haven't and i cannot test with), this list isn't realistic anymore. Version 1.0.59 January 2022 - FIX for some couple NVR/firmware, not behaving standard with the heartbeat. Version 1.0.58 December 2021 - FIX a possible error in wrong XML returned by the node, if node-red runs under IOBroker, having an old XML parser version. Version 1.0.57 November 2021 - NEW: PTZ Node: you can now pass the channelID and PTZ preset number by msg.payload. Version 1.0.56 November 2021 - Workaround for an issue in a js library used by hikvision-ultimate. Version 1.0.54 October 2021 - NEW: the XML Node can now emit a message containing the response from the camera. You can now ask a camera for anything (for example if the motion detect is enabled) and get the response in JSON format. See the gitHub README on how to do that. Version 1.0.53 September 2021 - FIX: Doorbell node now correctly emits error on the second PIN instead of the first output PIN. Version 1.0.52 September 2021 - NEW: Doorbell node (you can be notified on ringing, on call and even open the door). Thanks @ur5zeb for help in testing. Version 1.0.51 August 2021 - FIX: XML Node do not retain the XML text. Version 1.0.50 Juli 2021 - You can now connect to devices using HTTPS with a self signed certificate. Preiouusly, the node was given an SSL warning and refuse to connect. Version 1.0.49 Juli 2021 - NVR: fixed an issue causing the node not detecting the channel ID on some NVR type "NX..". Version 1.0.48 June 2021 - Minor fix. Version 1.0.47 April 2021 - Alarm node: fixed an issue where the camera won't emit the intrusion detection event start, but only the end. Workaround for that. Version 1.0.43 April 2021 - ANPR: Fixed the authentication type (digest/basic) not retained. - ANPR: Fixed the error message visible if you have one and only ANPR camera in your flow. Version 1.0.42 April 2021 - Server node: the port config was totally ignored. Fixed, now you can set the port as well and it works. Thanks to @Mateiuc. Version 1.0.41 April 2021 - Picture Image: Better handling of automatic URLs selection. - Picture Image: fixed a false status whenever an alarm node receives an alarm. Version 1.0.38 April 2021 - Fidex a syntax error checking an url. Version 1.0.37 April 2021 - Fidex an issue in the new function of picture node. Version 1.0.35 April 2021 - PICTURE node is now compatible with hybrid NVR both for analog and for IP cameras. Thanks to smcgann99 for raising the issue. Version 1.0.33 February 2021 - Filter null payloads in picture node, in case the device you're connecting to, is an hybrid DVR/NVR. - Fixed some glitches it the sample code on the README page. Version 1.0.31 February 2021 - FIX: sometime, the IMAGE node fails to show the text overlay. - NEW: the IMAGE outputs a pure base64 image format as well as image buffer ready to be attached to an email. Version 1.0.30 January 2021 - Nasty ANPR camera fix: it has happened to me, that the cam's plate list had some odd item order. This caused me some problem. The ANPR node has been changed to overcome any sort of oddness in the camera plate list returnet by the camera itself. - NEW: XML Node. You can now send what you want to your device. See the README in gitHub. Version 1.0.29 January 2021 - Text overlay node: you can now use it with NVR. Channel selection is also avaiable now. Version 1.0.28 January 2021 - BREAKING CHANGE: the Radar node is now part of the Alarm node. The Radar node has been deleted. - NEW: the Alarm node can now filter for channels and zones as well. SOME ADJUSTMENT TO YOUR FLOW MAY BE NEEDED. - NEW: Text overlay node: you can set the camera's 4 rows overlay text. Version 1.0.27 January 2021 - NEW: Text overlay in the picture node. You can also set the position and font. The text can be set with msg.textoverlay as well. Version 1.0.26 January 2021 - Fixed an unwanted LOG in case you have a picture node asking for an image to an unconnected camera. Version 1.0.25 January 2021 - Minor fixes in alarm filter. Version 1.0.24 January 2021 - FIX: all nodes won't emit a topic property. Has been fixed. - NEW: you can now filter false alarms in the radar node. Version 1.0.22 December 2020 - NEW: you can now choose how much times the node server should try to reconnect to the Hik device, before emitting the connection error on PIN 2. This is useful in case of problematic LANs, like VPN or very slow Wireless 3G connections. Version 1.0.20 December 2020 - NEW: you can now choose to tell Supergiovane (the developer) that your camera model works with the node. You'll help other users. The list will be shown here https://github.com/Supergiovane/node-red-contrib-hikvision-ultimate/blob/master/TESTEDWITH.md Version 1.0.18 December 2020 - FIX: node topic wasn't retent on all nodes. Version 1.0.16 December 2020 - CHANGE: the node should now work with node version below 10.0.0, but it's recommended anyway to update. - FIX: on some setups, the alarm stream wasn't received. Thanks @oliveres for signalling this issue. Version 1.0.15 December 2020 - FIX: getting rid of promise rejection error log in the hikconfig-node, whenever a conneciton error occurs. Version 1.0.14 December 2020 - Picture Node: support for NVR with max 32 channels. - Radar Node: support for max 16 alarm zones. - FIX: the "connect" button in the config node doesn't work if this is the first node ever. A message will show, to tell you to save, deploy and re-enter the config node again. Version 1.0.12 December 2020 - NEW: You can now get info from the camera by pressing CONNECT button in the config window, even if the server node is new and it hasn't been saved. - CHANGE: The Picture Node has now a button to reload the image, so you can view the changes in size etc.. just in time. Version 1.0.10 December 2020 - NEW: You can now get info from the camera by pressing CONNECT button in the config window. Version 1.0.9 December 2020 - NEW: Picture node, you can now CROP the image, to obtain a zoomed portion, for example, of a door or things like this. - NEW: Picture node, the config window shows the actual picture you see, including all image manipulation you've done through settings. Version 1.0.7 December 2020 - NEW: Picture node, you can now set the output quality, from 10 to 100. Version 1.0.6 December 2020 - Increased timeout for situation where the connection is via VPN or very slow. Thanks @Georg for suggesting this thing. Version 1.0.5 December 2020 - NEW: Picture node. This node get a picture from camera, ready to be shown in the dashboard UI. The image can be rotated and resized. Version 1.0.4 December 2020 - Getting rid of old debug logs. Thanks @oliveres for advice. Version 1.0.3 December 2020 - NEW: Added help links to the config windows. Version 1.0.2 December 2020 - NEW: PTZ preset recall node, for PTZ cameras. Just pass payload TRUE to the node to recall the preset. Version 1.0.1 December 2020 - NEW: added more events to the alarm node. - Changed icon of alarm node. Version 1.0.0 FIRST OFFICIAL VERSION December 2020 - NEW: added Generic Alarm node. - NEW: added warning in the node-red log, specify that the node requires Node V.10.0.0 or newer. Version 0.0.25 GA VERSION WITH STABLE BEHAVOUR December 2020 - Fine tuning some msg handlers. - Debug mode avaiable. Just type banana after the server ip, for example 192.168.1.5banana Version 0.0.24 GA VERSION WITH STABLE BEHAVOUR December 2020 - Better handling of malformed alert messages. Version 0.0.23 GA VERSION WITH STABLE BEHAVOUR December 2020 - NEW: added "http" and "https" protocol selection. Version 0.0.22 GA VERSION WITH STABLE BEHAVOUR December 2020 - NEW: added "basic" authentication as well. Version 0.0.21 GA VERSION WITH STABLE BEHAVOUR December 2020 - Changed timeout in hearthbeat. More relaxed, to avoid false disconnections messages. Version 0.0.20 GA VERSION WITH STABLE BEHAVOUR December 2020 - NEW: added the PIN 2 for signalling errors. Version 0.0.19 LAST BETA BEFORE STABLE RELEASE December 2020 - Better handling of status messages. Version 0.0.18 BETA December 2020 - BUGFIX: fixed a vaccata in handling boundary of stream pipeline. - BUGFIX: fixed a minchiata in ANPR node, where if the alarmed zone was 0, the node outputs "unknown zone". - Fixed Radar alarm zone. Zone number in ISAPI is base 0, while in the UI is base 1. - BUGFIX: ANPR - fixed array handling when returning a single plate. Version 0.0.16 BETA December 2020 - NEW: added Radar Node for trapping radar zone's alarms. - Radar Node allow for alarm filter (all zone or specific zone) Version 0.0.15 BETA December 2020 - Moved RAW node code into async functions. - Fixed BUG in ANPR module, where the last plate was sent every second.. - Added icons. Version 0.0.14 BETA December 2020 - Moved ANPR code into async functions, do help very slow PC's to correctly handle the data. Version 0.0.13 BETA December 2020 - Moved ANPR code into async functions, do help very slow PC's to correctly handle the data. Version 0.0.12 BETA November 2020 - Added support for devices sending XML as well as for devices sending JSON. Version 0.0.11 BETA November 2020 - Added an option to the ANPR node, to filter repeating plates in a timeframe. Version 0.0.9 BETA November 2020 - Replaced the node urllib with node-fetch. - Alert node now filters heartbeath without sending unuseful payloads. Version 0.0.8 BETA November 2020 - ANPR node now emits connect and disconnect messages. - Fixes and improvements. Version 0.0.7 BETA November 2020 - ANPR node now works and correclty handles the plates queue by disregarding old plates. - Fixes and improvements. Version 0.0.6 BETA November 2020 - Automatic reconnection and error handling. Resilency is done. Version 0.0.4 BETA November 2020 - Added ANPR License Plate Node. Version 0.0.3 BETA November 2020 - Added connection checks and reconnection. Version 0.0.1 BETA November 2020 - First BETA