/homebridge-smtp-motion

Converts SMTP messages into HTTP motion alerts that homebridge-camera-ffmpeg understands

Primary LanguageTypeScriptBSD 2-Clause "Simplified" LicenseBSD-2-Clause

homebridge-smtp-motion

npm npm verified-by-homebridge

This plugin converts SMTP messages into HTTP motion alerts homebridge-camera-ffmpeg understands.

Note that this plugin itself does not expose any devices to HomeKit.

Installation

  1. Install Homebridge using the official instructions.
  2. Install homebridge-camera-ffmpeg using sudo npm install -g homebridge-camera-ffmpeg --unsafe-perm.
  3. Install this plugin using sudo npm install -g homebridge-smtp-motion.
  4. Update your configuration file. See configuration sample below.

Configuration

Edit your config.json accordingly. Configuration sample:

"platforms": [
   {
       "platform": "smtpMotion",
       "smtp_port": 2525
   }
]
  • platform: (Required) Must always be smtpMotion.
  • smtp_port: The port to run the SMTP server on. (Default: 2525)
  • override_http: If you need to override the HTTP port, or are not running homebridge-camera-ffmpeg.
  • space_replace: The character to replace a space with in the camera name portion of the email address. (Default: +)
  • log_emails: Write to the Homebridge log when an email is received. (Default: false)

Camera Configuration

To use this plugin, you'll need to configure the SMTP settings on your camera as listed below. Your camera may use slightly different terms for some of these options.

  • Server Address: The host name or IP address of the computer running Homebridge
  • Port: The value you used for smtp_port in the plugin configuration.
  • Username and Password: Any value can currently be used, as authentication is not currently supported in this plugin. That will likely be added in future versions.
  • From Address: Any value can be used, this is not checked.
  • To Address: This needs to be your camera's name, exactly as configured in homebridge-camera-ffmpeg but with + instead of space, followed by an @ and any domain you want. Example: Camera+Name@example.com

Running on Port 25 on Linux

If you have a camera that refuses to connect to an SMTP server on a port other than 25, it is still possible to use this plugin:

  • Grant Node permissions to use low ports: sudo setcap 'cap_net_bind_service=+ep' /usr/bin/node
  • Set smtp_port to 25.
  • Restart Homebridge.