SMS Notifications
These instructions are to assist with email or text message setup.
For SMS, You setup email to point to a text gateway. Setup a filter that monitors the cameras for alarms, and when an alarm is set off you have it send an email to the text gateway (or email address). Simple.
You can get images from the alarm embedded in the text (covered in install steps).
The following is tested for 1.30, and 1.34.
Installation
Follow How to get ssmtp working with Zoneminder.
There are two ways to send emails in options - email. One is sending a short email, and one is designed for longer messages. In the code (as of 1.30 lines 818 and 918), in zmfilter.pl these are correspondingly sub SendEmail and sub SendMessage. They are distinct functions. SSMTP/MSMTP support is in SendEmail but not in SendMessage.
Testing the email
First test via terminal outside of ZM. Confirm it is working there. Example configurations and calls can be found at: https://wiki.debian.org/msmtp and https://wiki.archlinux.org/index.php/MSMTP (for msmtp).
Then, run a filter in the background (see tips below) or execute. Second, Enable logging on /var/log/zm folder. Third, tail the ZMFilter log and syslog. Fourth, to initiate an alarm (if alarms are used to test emails), use 'force alarm' on the monitor screen. That is, view a camera, and click force alarm.
You should see SSMTP send an email on the syslog (or try) and the zmfilter log will report the trigger.
Tips
- Free email services limit how many emails you are allowed to send through SMTP. It helps to disable cron emails.
- Always make filters for 1 (or low number) results. If you fail to do this, you could try to send dozens of emails.
- When you make the filter you want the 'current' alarms. You don't want old events. This is accomplished with a Date/Time greater than or equal to -1 minute.
- If when testing the filter execute, the 'execute' button becomes unclickable, uncheck then recheck the email option.
#watch "tail -n 30000 /var/log/syslog | grep sSMTP | tail"
- When testing use a background filter, and watch the logs. Filters run every 60 seconds by default.
- If you send email as someone other than root, make sure he is in /etc/ssmtp/revaliases
- test emails with
cat file | mail -s "subject" destination@email.com OR echo "some text" | mail -s "subject destination@email.com FOR ATTACHMENTS: echo hello | mail -A /dir/to/attachment.log -s "email with file" destination@email.com OR Also try mutt (slightly different) mutt -a /dir/to/attachment.log -s "email with file" -- destination@email.com
- make sure email is checked off in filters. It gets unchecked easily.
- service zoneminder restart after changes (NOTE: this wasn't required for just setting email settings in ZM options 07/2020).
- test setting off alarms by clicking 'force alarm' in the monitor view, then unclick to remove alarm.
- make one dedicated email alert account if you want multiple users to receive alerts. There is a patch in the forums to add multiple recipients.
- It's tough to use Motion detection for alerts with IR active.. You might be best off using a device with ZMTrigger, or the cameras built in motion detection if night IR is used... False alerts appear when a camera switches from Day lens to IR.
- Always double check the filters are right, AFTER you save them.
- Once an email has been sent for an event, that event is marked and an email for it won't be sent again[1].
SSMTP Specific Tips
- ssmtp.conf has issues with special characters in AuthPass. Do not use special characters for your password.
- Add DEBUG=yes to ssmtp.conf to see full email logs in syslog
- If SSMTP is unable to connect, there may be a two minute timeout before it reports unable to connect. If it seems like ssmtp has frozen, wait before closing out of it, if you want its logs.
- Don't forget to change revaliases as needed. it should match ssmtp.conf
- Expert: Manually test email server connections with something like
openssl s_client -debug -starttls smtp -crlf -connect smtp.emailprovider.com:465 then continue with EHLO hostname AUTH etc...
- ssmtp supports only auth login, and cram-md5. If you have digest-md5 or auth plain at your email server it will likely not work. Test manually using the commands above to verify this.
- Test ssmtp manually with $ssmtp -vvvvv email@address.com < msg.txt (example message) (though DEBUG=yes has more information)
Example Filter
For monitoring on the weekend you might have
date/time greater than or equal to -1 minute AND alarm frames greather than or equal to 1 AND Weekday equal to Saturday OR Weekday equal to Sunday AND alarm frames greater than or equal to 1 AND date/time greater than or equal to -1 minute
Notice that you must include all parameters for each group/set individually when there is an OR.
Send email if only on a certain runstate (Filter on Run States)
Notifications are easy if you want alarms emailed between a static time, for example between 12AM and 6AM. If you have a situation where you may not want the alarms to send you text messages on occasion, you can filter on run states.
Starting from more recent Zoneminder releases (ZM > 1.30.4) you can set filters based on run states, which means you can change the run state at any desired time (using Cron, or manually), and only if a runstate matches the filter will SMS be sent.
Note that in the author's opinion, run states can become unwieldy for large installations. It's best used with smaller setups only.
