2025.3.4
首页 ▸ Integrations ▸

ZoneMinder

The zoneminder integration sets up Home Assistant with your ZoneMinder instance.

There is currently support for the following device types within Home Assistant:

Configuration

To add the integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] to your installation, add it to the configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file. 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# Example configuration.yaml entry
zoneminder:
  - host: ZM_HOST

Configuration Variables

Looking for your configuration file?
host string Required

Your ZoneMinder server’s host (and optional port), not including the scheme.

path string (Optional, default: /zm/)

Path to your ZoneMinder install.

path_zms string (Optional)

Path to the CGI script for streaming. This should match PATH_ZMS in ZM’s “Paths” settings.

Default:

/zm/cgi-bin/nph-zms

ssl boolean (Optional, default: false)

Set to true if your ZoneMinder installation is using SSL.

verify_ssl boolean (Optional, default: true)

Verify the certification of the endpoint.

username string (Optional)

Your ZoneMinder username.

password string (Optional)

Your ZoneMinder password. Required if OPT_USE_AUTH is enabled in ZM.

Full configuration 

# Example configuration.yaml entry
zoneminder:
  - host: ZM_HOST
    path: ZM_PATH
    path_zms: ZM_PATH_ZMS
    ssl: true
    verify_ssl: true
    username: YOUR_USERNAME
    password: YOUR_PASSWORD

Action

Once loaded, the zoneminder platform will expose an action (set_run_state) that can be used to change the current run state of ZoneMinder.

Data attribute Optional Description
id no Host of the ZoneMinder instance.
name no Name of the new run state to set.

For example, if your ZoneMinder instance was configured with a run state called “Home”, you could write an automation that changes ZoneMinder to the “Home” run state by including the following action:

actions:
 action: zoneminder.set_run_state
 data:
   id: ZM_HOST
   name: Home

Binary sensor

The zoneminder binary sensor platform lets you monitor the availability of your ZoneMinder install.

Each binary_sensor created will be named after the hostname used when configuring the ZoneMinder integration.

Camera

The zoneminder camera platform lets you monitor the current stream of your ZoneMinder cameras.

Configuration

To set it up, add the following information to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file:

# Example configuration.yaml entry
camera:
  - platform: zoneminder

Sensor

The zoneminder sensor platform lets you monitor the current state of your ZoneMinder install including the number of events, the current state of the cameras and ZoneMinder’s current run state.

To set it up, add the following information to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file:

# Example configuration.yaml entry
sensor:
  - platform: zoneminder
    include_archived: false

Configuration Variables

Looking for your configuration file?
include_archived boolean (Optional, default: false)

Whether to include archived ZoneMinder events in event counts.

monitored_conditions list (Optional)

Event count sensors to display in the frontend.

all

All events.

month

Events in the last month.

week

Events in the last week.

day

Events in the last day.

hour

Events in the last hour.

Switch

The zoneminder switch platform allows you to toggle the current function of all cameras attached to your ZoneMinder instance.

Important

You must have the ZoneMinder integration configured to use this and if ZoneMinder authentication is enabled the account specified in the integration configuration must have “Edit” permission for “System”.

To enable this switch, add the following lines to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file:

# Example configuration.yaml entry
switch:
  - platform: zoneminder
    command_on: Modect
    command_off: Monitor

Configuration Variables

Looking for your configuration file?
command_on string Required

The function you want the camera to run when turned on.

command_off string Required

The function you want the camera to run when turned off.

Note

The default functions installed by ZoneMinder are: None, Monitor, Modect, Record, Mocord, Nodect.

相关主题