motifini

README

Motifini

This application allows you to send messages via iMessage using Messages.app with an API call. It also integrates with ffmpeg to capture videos from IP cameras, and SecuritySpy to capture still images (or.. videos).

This code is still very crude, under construction and lacking full documentation.

Usage

1. Make sure Messages has an iMessage account configured.
2. Send a message. Like this:

curl "http://127.0.0.1:8765/api/v1.0/send/imessage/msg/user@email1.com,user@email2.com&msg=Office%20Window%20Closed"

Example Config File

The only requirement in the config file is an allowed_to list. Be sure to add your iMessage handle here or you cannot send yourself messages. Only addresses added to the config can have messages sent to them.

• Location: /usr/local/etc/motifini.conf
• Example: examples/motifini.conf.example

Setting clear_messages to true will delete every conversation in Messages.app.

Endpoints

• /api/v1.0/send/imessage/video/{to}/{camera} Uses FFMPEG to capture a video from an IP camera (or other URL).

  • to (csv), list of message recipients
  • cam (string), camera name
  • width (int), frame size, default: 1280
  • height (int), frame size, default: 720
  • quality (int), h264 quality setting, default: 20
  • time (int), max video duration in seconds, default 15
  • rate (int), output frame rate, default 5
  • size (int), max file size, default: 2500000 (~2.5MB)

• /api/v1.0/send/imessage/picture/{to}/{camera} This method requires SecuritySpy be running.

  • to (csv), list of message recipients
  • cam (string), camera name

• /api/v1.0/send/imessage/msg/{to}?msg={msg} Just sends a plain-ol' message with iMessage.

  • to (csv), list of message recipients
  • msg (string), text to send

Indigo

Create two variables in Indigo. Name one variable Subscribers and the other SendMessage Create a trigger when SendMessage changes to run an Action.

Run this Action; replace the variable IDs with your own:

import urllib
import urllib2
import socket
timeout = 1
socket.setdefaulttimeout(timeout)

subs = urllib.quote(indigo.variables[1891888064].value, "")
msg = urllib.quote(indigo.variables[1023892794].value, "")
url = "http://127.0.0.1:8765/api/v1.0/send/imessage/msg/"+subs+"?msg="+msg

try:
    urllib2.urlopen(url)
    indigo.server.log(u"Dropped off message with Motifini!")
except Exception as err:
    indigo.server.log(u"Error with Motifini: {}".format(err))

SecuritySpy

You can use the following simple script to send yourself a picture any time motion is detected.

-- Change Gate to a real camera name to test this in Script Editor
property TestCam : "Gate"
property Subscriber : "user@email.tld"

on run arg
	if (count of arg) is not 2 then set arg to {0, TestCam}
	set Camera to item 2 of arg -- item 1 is the cam number.
  do shell script ("curl 'http://127.0.0.1:8765/api/v1.0/send/imessage/picture/" & Subscriber & "/" & Camera & "'")
end run

If you're going for the full subscription integration, use this script instead, and only recipients subscribed to the camera will be notified.

-- Change Porch to a real camera name to test this in Script Editor
property TestCam : "Porch"

on run arg
	if (count of arg) is not 2 then set arg to {0, TestCam}
	set Camera to item 2 of arg -- item 1 is the cam number.
	do shell script ("curl -s -X POST -A SecuritySpy 'http://127.0.0.1:8765/api/v1.0/event/notify/" & Camera & "'")
end run

The above script is installed into ~/SecuritySpy/Scripts when you use make install.

TODO

• Better Usage/Install Documentation
• Hard define between cameras or securityspy.
  • tie in securityspy eventstream.
• Some reasonable way to add and control events, and how they fire.
  • For instance if you want a motion detector to fire a camera, or two, or a text message, how do you define and action that?
  • Or any combination of "event -> take some cool action (ie. send a specific type of notification)"
  • notifications currently supported: text, video, picture. (imessage only)
• Add support for notifications via other providers. pushover, skype, others? what supports video?! srsly, nothing out there yet.
• Add more info to expvar data: events, cameras, subscribers.