Support to force alarm command

README.md

@@ -33,17 +33,23 @@ from zoneminder.zm import ZoneMinder
 SERVER_HOST = "{{host}}:{{port}}"
 USER = "{{user}}"
 PASS = "{{pass}}"
-SERVER_PATH = "{{path}}"
+SERVER_PATH = "{{path}}"         # example: /zm/
+SERVER_ZMS_PATH = "{{zms_path}}" # example: /zm/cgi-bin/nph-zms
 
 zm_client = ZoneMinder(
-    server_host=SERVER_HOST, server_path=SERVER_PATH, username=USER, password=PASS, verify_ssl=False
+    server_host=SERVER_HOST,
+    server_path=SERVER_PATH,
+    zms_path=SERVER_ZMS_PATH,
+    username=USER,
+    password=PASS,
+    verify_ssl=False
 )
 
-#Zoneminder authentication
+# Zoneminder authentication
 zm_client.login()
 
 
-#Get all monitors
+# Get all monitors
 monitors = zm_client.get_monitors()
 
 for monitor in monitors:
@@ -52,7 +58,7 @@ for monitor in monitors:
 >>> Monitor(id='monitor_id', name='monitor_name', controllable='is_controllable')
 
 
-#Move camera down
+# Move camera down
 controllable_monitors = [m for m in monitors if m.controllable]
 
 for monitor in controllable_monitors:

zoneminder/monitor.py

@@ -150,12 +150,16 @@ def still_image_url(self) -> str:
         """Get the still jpeg image url of this Monitor."""
         return self._still_image_url
 
+    def __alarm_control_command(self, command) -> dict:
+        """Send alarm command to monitor."""
+        return self._client.get_state("api/monitors/alarm/id:{mid}/command:{command}.json".format(
+            mid=self._monitor_id, command=command)
+        )
+
     @property
     def is_recording(self) -> Optional[bool]:
         """Indicate if this Monitor is currently recording."""
-        status_response = self._client.get_state(
-            "api/monitors/alarm/id:{}/command:status.json".format(self._monitor_id)
-        )
+        status_response = self.__alarm_control_command("status")
 
         if not status_response:
             _LOGGER.warning("Could not get status for monitor %s.", self._monitor_id)
@@ -168,6 +172,13 @@ def is_recording(self) -> Optional[bool]:
             return False
         return int(status) == STATE_ALARM
 
+    def set_force_alarm_state(self, state):
+        """Set the monitor force alarm state."""
+        status_response = self.__alarm_control_command("on" if state is True else "off")
+
+        if not status_response:
+            _LOGGER.warning("Could not get status for monitor %s.", self._monitor_id)
+
     @property
     def is_available(self) -> bool:
         """Indicate if this Monitor is currently available."""