Skip to content

Latest commit

 

History

History
48 lines (36 loc) · 2.05 KB

README.md

File metadata and controls

48 lines (36 loc) · 2.05 KB

HomeAssistant Plugin for Enabling/Disabling Unifi Protect Alarms

hacs_badge

This integration is heavily based on the work done on the official (unofficial) Unifi Protect Python library here: https://github.com/uilibs/uiprotect.

I wanted a quick solution for enabling and disabling alarms from HomeAssistant, and I didn't have the time at the moment to integrate it properly into the official library so I put this together.

Some key notes you should be aware of...

  • This integration simply exposes all Alarms as switches and you can enable/disable them.
  • This integration also doesn't automatically keep entities in sync with Unifi Protect. You'll have to manually set that up using the Refresh service exposed by this integration.
  • Will append (Disabled) to all Alarms it disables, so you can see in the UI Protect all.

Table of Contents

Installation

HACS (Recommended)

  1. Add this repository to HACS AS A CUSTOM REPOSITORY.
  2. Search for jeffsteinbok/hass-uiprotectalarms, and choose type Integration.
  3. Reboot Home Assistant and configure from the "Add Integration" flow.

Manually

Copy the uiprotectalarms directory into your /config/custom_components directory, then restart your HomeAssistant Core.

Debugging

Idealy, use the Diagnostics feature in HomeAssistant to get diagnostics from the integration. Sensitive info WILL NOT BE REDACTED so be careful.

This integration logs to two loggers as shown below. To get verbose logs, change the log level. Please have logs handy if you're reaching out for help.

logger:
    logs:
        uiprotectalarms: info
        pyuiprotectalarms: info

Future Ideas

  • Actually keep entities in sync
  • Figure out how to have the integration image work. I don't want to put it in the same domain as the real Unifi Protect integration.