adyanth / homebridge-plugin-command

This Homebridge plugin enables you to create virtual switches that can run any custom command when it is turned on or off.

homebridge-plugin-command

This Homebridge plugin enables you to create virtual switches that can run any custom command when it is turned on or off.

How to use

Under Plugins > Homebridge Plugin Command > Settings, add an accessory and fill in the form!

By default, check_status assumes turned on if the exit code of the command is 0. Set invert_status to true to flip it. check_status command is optional, and if not provided, it just alternates as you turn it on and off. You can enable polling the check status and automatically pushing the change by setting the poll_check to number of seconds or in this format 1d2h3m4s.

If you like a JSON config, see the sample below.

{
  "accessory": "Command Accessory",
  "name": "File switch",
  "turn_on": "touch /tmp/testFile",
  "turn_off": "rm /tmp/testFile",
  "check_status": "ls /tmp/testFile",
  "poll_check": "5",
  "invert_status": false
}

homebridge-plugin-command's Issues

Great!!!! Could it build a sensor, too?

It is great the idea and the way it is implemented, thanks!! Another way to trigger an action in homekit, perhaps even more subtle and more appropriate to simply tell HK something happened, could be a Sensor. A presence sensor, for example, so you wouldn't need to reset it after receiving and triggering something on HK

State does not sync with MBP

State of the switch does not sync with the macbook when triggered from the iPhone, but iPad and iPhone seems to do it just fine.

Originally posted by @rdouma in #1 (comment)

Button state not automatically updated in Home

If the button state gets changed from another device or an automation, the button state doesn't get updated in Apple Home without reloading that page. Once I switch pages and come back the button state is correct, but it seems there is no "push" of the button's status to Homekit once it's changed.

Characteristic 'On': SET handler returned write response value, though the characteristic doesn't support write response. See https://homebridge.io/w/JtMGR for more info.

Used to work perfectly and without changing anything in the config, automations stopped working.

Log:

| [6/15/2023, 5:53:53 PM] [Climate Automations] Setting Climate Automations switch state to:  false
homebridge    | [6/15/2023, 5:53:53 PM] [Climate Automations] Running: rm /tmp/climateAutomations 2> /dev/null
homebridge    | [6/15/2023, 5:53:53 PM] [Climate Automations] Returning: 0}
homebridge    | [6/15/2023, 5:53:53 PM] [homebridge-plugin-command-dev] Characteristic 'On': SET handler returned write response value, though the characteristic doesn't support write response. See https://homebridge.io/w/JtMGR for more info.
homebridge    | [6/15/2023, 5:53:53 PM] [homebridge-plugin-command-dev] Error: 
homebridge    |     at On.Characteristic.characteristicWarning (/homebridge/node_modules/homebridge/node_modules/hap-nodejs/src/lib/Characteristic.ts:3011:105)
homebridge    |     at On.<anonymous> (/homebridge/node_modules/homebridge/node_modules/hap-nodejs/src/lib/Characteristic.ts:2557:18)
homebridge    |     at step (/homebridge/node_modules/homebridge/node_modules/tslib/tslib.js:193:27)
homebridge    |     at Object.next (/homebridge/node_modules/homebridge/node_modules/tslib/tslib.js:174:57)
homebridge    |     at fulfilled (/homebridge/node_modules/homebridge/node_modules/tslib/tslib.js:164:62)
homebridge    |     at processTicksAndRejections (node:internal/process/task_queues:95:5)
homebridge    | [6/15/2023, 5:53:54 PM] [Climate Automations] Setting Climate Automations switch state to:  true
homebridge    | [6/15/2023, 5:53:54 PM] [Climate Automations] Running: touch /tmp/climateAutomations
homebridge    | [6/15/2023, 5:53:54 PM] [Climate Automations] Returning: 1}
homebridge    | [6/15/2023, 5:53:54 PM] [homebridge-plugin-command-dev] Characteristic 'On': SET handler returned write response value, though the characteristic doesn't support write response. See https://homebridge.io/w/JtMGR for more info.
homebridge    | [6/15/2023, 5:53:54 PM] [homebridge-plugin-command-dev] Error: 
homebridge    |     at On.Characteristic.characteristicWarning (/homebridge/node_modules/homebridge/node_modules/hap-nodejs/src/lib/Characteristic.ts:3011:105)
homebridge    |     at On.<anonymous> (/homebridge/node_modules/homebridge/node_modules/hap-nodejs/src/lib/Characteristic.ts:2557:18)
homebridge    |     at step (/homebridge/node_modules/homebridge/node_modules/tslib/tslib.js:193:27)
homebridge    |     at Object.next (/homebridge/node_modules/homebridge/node_modules/tslib/tslib.js:174:57)
homebridge    |     at fulfilled (/homebridge/node_modules/homebridge/node_modules/tslib/tslib.js:164:62)
homebridge    |     at processTicksAndRejections (node:internal/process/task_queues:95:5)