Send HomeKit messages with HomeBridge (Pushover / IFTTT / Email)
MIT License
Homebridge plugin which allow users to send messages from HomeKit.
The plugin supports the following technologies:
Option 1: Install via Homebridge Config UI X:
Search for "messenger" in homebridge-config-ui-x and install homebridge-messenger
.
Option 2: Manually Install:
sudo npm install -g homebridge-messenger
The plugin adds to HomeKit a main switch and switches for each configured message.
The accessory name is used to specify the name of the main switch. If this main switch if turned OFF, no message will be sent by the plugin.
Message switches are stateless: they are turned OFF after being turned ON, once the message is sent.
There are two levels of configuration:
All switches can be used in scenes and automation.
Homebridge Config UI X is the easiest way to configure this plugin :
"accessories": [
{
"accessory": "HomebridgeMessenger",
"name": "Messenger",
"services": {
"pushover": {
"user": "your_user",
"token": "your_token"
}
},
"messages": [
{
"type": "pushover",
"name": "Pushover message",
"text": "This is a test",
"sound": "pushover",
"device" : "iphone",
"priority": 0
},
{
"type": "pushover",
"name": "Critical message",
"text": "This is important",
"sound": "magic",
"priority": 2
}
]
}
]
pushover
.pushover
sound will be used. For no sound, use silent
. The Pushover API contains the list of all available sounds.-2
, -1
, 0
, 1
or 2
. You may refer to the Pushover API for more details. Critical messages (2
), are sent with the following parameters :
"accessories": [
{
"accessory": "HomebridgeMessenger",
"name": "Messenger",
"services": {
"ifttt": {
"key": "your_key"
},
},
"messages": [
{
"type": "ifttt",
"name": "Test IFTTT",
"event": "my_webhook",
"value1": "hello world",
"value2": "foo bar",
"value3": "chewbacca"
}
]
}
]
ifttt
."accessories": [
{
"accessory": "HomebridgeMessenger",
"name": "Messenger",
"services": {
"email": {
"recipient": "[email protected]",
"smtpServer": "smtp.domain.com",
"smtpPort": 465,
"smtpSecure": true,
"smtpUsername": "your_username",
"smtpPassword": "your_password"
}
},
"messages": [
{
"type": "email",
"name": "Test email",
"text": "This is a test",
"recipients": "[email protected], [email protected]"
}
]
}
]
25
).true
if SMTP supports TLS. (Default value is false
).email
.An example featuring all technologies is available here.
Available here
The homebridge-messenger plugin is released under the MIT license.