Skip to content

Flexible Pan/Tilt/Zoom commands for ONVIF-compatible cameras in Home Assistant

License

Notifications You must be signed in to change notification settings

rbtying/hass-onvif-ptz

Repository files navigation

ONVIF PTZ

GitHub Release GitHub Activity

hacs

Integration to integrate with ONVIF cameras that support pan/tilt/zoom controls

This integration is intended to extend the existing core ONVIF integration with the ability to correctly call various camera's PTZ commands.

This integration will set up the following platforms.

Platform Description
button Each camera profile which supports PTZ will create a fake button entity which supports PTZ commands.
Services Description
ptz_relative ONVIF RelativeMove command, moves the camera relative to the current position
ptz_absolute ONVIF AbsoluteMove command, moves the camera to a specified position
ptz_continuous ONVIF ContinuousMove command, moves the camera at a specified velocity
ptz_stop Stops camera movement
ptz_set_home_position Sets the home position
ptz_goto_home_position Goes to the home position
ptz_set_preset Sets a preset
ptz_goto_preset Goes to a preset

Installation

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called onvif_ptz.
  4. Download all the files from the custom_components/onvif_ptz/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "ONVIF PTZ"

Configuration is done in the UI

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines