Skip to content

Latest commit

 

History

History
68 lines (59 loc) · 3.73 KB

README.md

File metadata and controls

68 lines (59 loc) · 3.73 KB
Raw

Onair

Command line utility that calls an IFTTT webhook when any webcam turns on or off.

See it in action in this video. I'm using an eMylo smart relay inside an On Air light. The eMylo smart relay is compatible with the Brilliant Smart App that in turn integrates with IFTTT

Background

I built this utility to toggle an "On Air" sign outside my home office when I'm on video conference calls. The utility will monitor every camera connected and will trigger configured IFTTT webhook events when any camera turns on, or when all turn off.

Since I use a laptop that I travel with, this utility supports taking optional --local-url and --local-string parameters that enable checking if you're on a local network or not. In my case, the HTML from my local router contains a reference to my local WiFi SSID, which tells me I'm home.

Usage

USAGE: onair --on <event> --off <event> --key <key> [--local-url <url>] [--local-string <string>]

OPTIONS:
  --key            IFTTT Webhook key
  --local-string   (optional) String to look for to see if local
  --local-url      (optional) URL to call to see if local
  --ignore         (optional) Comma-separated list of cameras to ignore
  --off            IFTTT Webhook event to call when a camera turns off
  --on             IFTTT Webhook event to call when a camera turns on
  --debug          Enable additional debugging
  --help           Display available options

Build

$ swift build -c release
$ cp .build/release/onair ~/bin

Setup

  • Create two IFTTT applets that trigger on a Webhook; one that you want to trigger when any webcam turns on and one that you want to trigger when all webcams are off. The event names for both webhooks will be used as --on and --off parameter values.
  • Look up your webhook key at Webhook --> Documentation. Use this as the --key parameter value.
  • In case you want to enable checking if you're on a local network or not, use the --local-url parameter to specify a local url you'd like to check (e.g. your router) and use --local-string to specify what string you want to check for to determine if you're on a local network or not.
  • In case you happen to have a camera that is not detected correctly, use --ignore to ignore that specific camera.

Example launchd configuration

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>nl.evenflow.onair</string>
  <key>OnDemand</key>
  <false/>
  <key>Program</key>
  <string>/Users/wouterdebie/bin/onair</string>
  <key>ProgramArguments</key>
  <array>
      <string>/Users/wouterdebie/bin/onair</string>
      <string>--on</string>
      <string>on_air</string>
      <string>--off</string>
      <string>off_air</string>
      <string>--key</string>
      <string>MY_SECRET_IFTTT_KEY</string>
      <string>--local-url</string>
      <string>http://192.168.0.1/</string>
      <string>--local-string</string>
      <string>MY_SSID</string>
  </array>
</dict>
</plist>

Place the file in ~/Library/LaunchAgents/nl.evenflow.onair.plist and run launchctl load ~/Library/LaunchAgents/nl.evenflow.onair.plist.