maciej-or / hikvision_next

Home Assistant integration for Hikvision NVRs and IP cameras
89 stars 15 forks source link
hikvision homeassistant

Hikvision Next

GitHub release (latest by date) hacs_badge

The Home Assistant integration for Hikvision NVRs and IP cameras. Receives and switches detection of alarm events.

Features

Supported events

NOTE Events must be set to alert the surveillance center in Linkage Action for HA to be notified. An attribute on the event switch shows if this is set.

Preview

Integration card IP Camera NVR

The scope supported features depends on device model, setup and firmware version.

Installation

With HACS

  1. This integration you will find in the default HACS store. Search for Hikvision NVR / IP Camera on HACS / Integrations page and press Download button
  2. on Settings / Devices & Services page press + Add Integration
  3. Search for Hikvision NVR / IP Camera and add your Hikvision device using config dialog, repeat the last 2 steps for more devices

Manual

  1. copy custom_components/hikvision_next folder into conifg/custom_components
  2. restart Home Assistant
  3. on Settings / Devices & Services page press + Add Integration
  4. search for Hikvision NVR / IP Camera and add your Hikvision device using config dialog, repeat the last 2 steps for more devices

Hikvision device setup checklist

Reporting issues

There are a lot of Hikvision devices with different firmwares in the world. In most cases logs are crucial to solve your problem, so please attach them to the report. Keep in mind that logs include MAC addresses, serial numbers and local IP addresses of your devices. Consider using pastebin.com or similar services for sharing logs.

You can also download a diagnostic output to provide essential information about your device. This redacts all sensitive data and can be provided in the github issue.

Setup log level to debug in configuration.yaml

logger:
  logs:
    custom_components.hikvision_next: debug

Restart Home Assistant

Download logs from Settings / System / Logs

Tested models

NVR

DVR

IP Camera