Adding cameras

once the account is prepared with api keys and smtp credentials in getting started docid\ cy5w0lcchhv9zjwuw4zda you're ready to add cameras configure cameras to send alarms once keys and credentials are set up you will use them when configuring cameras and other devices to send alarms below, we'll outline the general steps to configure a security camera to trigger alerts on motion the exact procedures will differ between different brands and models, but the process is often fairly similar for specific instructions, please refer to the sections to the right is your brand missing? please submit a support request docid\ zssod06nxrxfyqicc15ka and we'll create one together! overview the below steps are generally required to set up a security camera to send alarms to the irisity alarm filter configure the detection set up the alarm filter as a recipient configure video motion events to trigger alarm sending test it, and done! 1\ configure the detection the first step is to configure the detection for simpler cameras this is often a rudimentary vma, video motion analysis, triggering an alarm on anything that moves for more advanced cameras and ai enabled cameras, it is often possible to get better results by using a more capable source typically you need to login as an administrator in the camera's web ui and go into the setup or settings section from there, look for event , scenarios , alarm , or trigger settings then look for video detection , motion detection , or other more capable use an irisity or third party app in the camera some more advanced cameras support functionality like detections as "apps" some, like axis and mobotix, have support for third party apps these apps will often give you the best detection results we highly recommend trying out the irisity intrusion detection app for mobotix cameras as the source for the alarm filter or our axis edge™ installation guide you can also use third party apps, such as the axis perimeter defender app https //help axis com/en us/axis perimeter defender which will provide highly sensitive detections, but also typically a fair bit of false alarms that the alarm filter platform will remove use black masking and region of interest if supported when configuring the detection, we always recommend masking out (black masking) irrelevant areas from the view this will remove any irrelevant activity from alarms sent for validation and filtering, meaning human activity in the background will not be classified as a true alarm some analytics additionally support setting a specific region of interest (roi) to only trigger alarms on motion inside that zone below is an example of a scene where roi has been used to define activity zones in both examples to the right, we see an improved version where a black mask has been added to remove any irrelevant movement region of interest (both) and black mask (right) used in a motion detection setup if roi is not supported in your camera, and/or you cannot mask out irrelevant parts of the image for some reason, it is possible to add precise free form polygon alarm zones in the irisity alarm filter as well the irisity alarm filter supports free form polygon roi to define the alarming zone in the irisity alarm filter supports free form polygon roi to define the alarming zone in precisely false alarms will consume bandwidth while the alarm filter will filter out nuisance alarms and activity outside the defined alarm zone, sending such alarms will consume additional bandwidth and resources we recommend ensuring each camera is set up to mask unimportant areas to minimize bandwidth consumption activate alarm sending for some devices, you have the option to set output parameters already when configuring the detection look for terms like send email , send alarms to destination , or activate alarm sending activate image or video attachments the alarm filter should optimally receive three images spaced 1 second apart, where the middle one is the detection frame alternatively, you can send a short video clip (around 2 seconds long with 0 5 1 seconds pre recording and 1 5 1 seconds post recording) please disable audio if possible look for settings like send clip , send snapshots , or send recording if only a single frame can be sent this is also supported, but not recommended it will not be possible to assess what objects are moving and therefore relevant using only one image always send three frames when possible while single image alarms are supported by the alarm filter you will get much better results and more high quality validation and filtering performance when sending three frames or a short video clip with each alarm 2\ set up irisity alarm filter endpoint or recipient some camera manufacturers separate alarm recipients from alarm configuration in these cases, look for the configuration of endpoints , recipients, or receivers , or look for settings like network => http and network => smtp use https when possible when possible, configure the alarms to be sent using https input the following http details https endpoint settings url https //in alarmfilter irisity io port 443 api key \<use api key from getting started docid\ cy5w0lcchhv9zjwuw4zda > https camera identification when making the request, add query parameters to identify the camera an example of this could be post https //in alarmfilter irisity io/?c=unique camera id 123 https send images or the clip in the body encode the body of the request as multipart/form data https //datatracker ietf org/doc/html/rfc2388 and send the images or clip camera identification for https when we parse incoming https alarms we try to identify the camera based on the incoming request smtp/email is also supported if https is not supported or you prefer to use smtp, use the following configuration for the smtp server settings email server (smtp) s alarmfilter irisity io username \<use smtp credentials from getting started docid\ cy5w0lcchhv9zjwuw4zda > password \<use smtp credentials from getting started docid\ cy5w0lcchhv9zjwuw4zda > port 587 encryption tls smtp recipient settings to unique camera id 123456\@alarmfilter irisity io from \<any valid email> 3\ configure video motion alarms to be sent to irisity if not already set up in one of the steps below, make sure that events generated in (1) are sent to the recipient/endpoint configured in (2) this is typically done in sections called scenarios , rules , or triggers 4\ test it! now it's time to test the setup! many cameras offer a "test alarm" button or "test alarm sending" button typically, test alarms will reach the alarm filter platform and show up in the list of alarms, allowing you to verify that alarm sending works they may, however, be flagged as errors due to the camera not sending any video clip or images with the test alarm so, the best way to test the setup is often to have an actual motion alarm triggered by the camera congratulations! you successfully configured a camera to send alarms to the irisity alarm filter!