hc

homebridge-cmdaccessory

Command plugin for HomeBridge to appear as different accessories (Switch, Lock, Window Blinds, Lights, etc)

Showing:

Popularity

Downloads/wk

3

GitHub Stars

12

Maintenance

Last Commit

5yrs ago

Contributors

1

Package

Dependencies

0

Size (min+gzip)

3.1KB

License

ISC

Type Definitions

Tree-Shakeable

No?

Categories

Readme

homebridge-cmdaccessory npm version

CMD Plugin for HomeBridge (API 2.0)

Based off of: homebridge-cmdswitch2

Special Thanks

Special thanks to @luisiam for cmdswitch2. It's great. This is 95% that plugin, but I met a friend who wanted certain "switches" to appear as different types of accessories.

What this plugin does

This plugin works much like [homebridge-cmdswitch2], it allows you to run Command Line Interface (CLI) commands via HomeKit. This means you can run a simple commands such as ping, shutdown, or wakeonlan just by telling Siri to do so. An example usage for this plugin would be to turn on your PS4 or HTPC, check if it’s on, and even shut it down when finished.

This plugin also adds a type property for the config.json to support a few different HAP types. At this time, the following types are supports:

  • Switch
  • Lightbulb
  • Outlet
  • LockMechanism

How this plugin works

  1. on_cmd: This is the command issued when the accessory is set to "ON" (or Locked, etc).
  2. off_cmd: This is the command issued when the accessory is turned OFF (or Unlocked, etc).
  3. state_cmd: This is the command issued when HomeBridge checks the state of the accessory.
  4. If there is no error, HomeBridge is notified that the accessory is ON (or Locked, etc).
  5. If there is an error, HomeBridge is notified that the accessory is OFF (or Unlocked, etc).

Things to know about this plugin

This plugin can only run CLI commands the same as you typing them yourself. In order to test if your on_cmd, off_cmd, or state_cmd are valid commands you need to run them from your CLI. Please keep in mind you will want to run these commands from the same user that runs (or owns) the HomeBridge service if different than your root user.

Installation

  1. Install homebridge using npm install -g homebridge.
  2. Install this plugin using npm install -g homebridge-cmdaccessory.
  3. Update your configuration file. See configuration sample below.

Configuration

Edit your config.json accordingly. Configuration sample:

"platforms": [{
   "platform": "cmdAccessory"
}]

Advanced Configuration (Optional)

This step is not required. HomeBridge with API 2.0 can handle configurations in the HomeKit app.

"platforms": [{
            "platform": "cmdAccessory",
            "name": "CMD Accessory",
            "switches": [{
                    "name": "iTunes Switch Test",
                    "on_cmd": "start /B c:/start_itunes.cmd",
                    "off_cmd": "Taskkill /IM itunes.exe /F",
                    "state_cmd": "c:/itunes.cmd",
                    "polling": true,
                    "interval": 3,
                    "manufacturer": "Apple",
                    "type" : "Switch"
                },{
                    "name": "Test Outlet",
                    "on_cmd": "start /B c:/start_itunes.cmd",
                    "off_cmd": "Taskkill /IM itunes.exe /F",
                    "state_cmd": "c:/itunes.cmd",
                    "polling": true,
                    "interval": 3,
                    "manufacturer": "Apple",
                    "type" : "Outlet"
                },{
                    "name": "Test Lock 2",
                    "on_cmd": "start /B c:/start_itunes.cmd",
                    "off_cmd": "Taskkill /IM itunes.exe /F",
                    "state_cmd": "c:/itunes.cmd",
                    "polling": true,
                    "interval": 3,
                    "manufacturer": "Apple",
                    "type" : "LockMechanism"
                },{
                    "name": "Test Bulb 3",
                    "on_cmd": "start /B c:/start_itunes.cmd",
                    "off_cmd": "Taskkill /IM itunes.exe /F",
                    "state_cmd": "c:/itunes.cmd",
                    "polling": true,
                    "interval": 3,
                    "manufacturer": "Apple",
                    "type" : "Lightbulb"
                }
            ]
        }
    ]
FieldsDescriptionRequired
platformMust always be cmdSwitch2.Yes
nameFor logging purposes.No
switchesArray of switch config (multiple accesories supported).Yes
|- name*Name of your device.Yes
|- type*Type of accessory.Yes
|- on_cmdCommand to turn on your device.No
|- off_cmdCommand to turn off your device.No
|- state_cmdCommand to detect an ON state of your device.No
|- pollingState polling (Default false).No
|- intervalPolling interval in s (Default 1s).No
|- manufacturerManufacturer of your device.No
|- modelModel of your device.No
|- serialSerial number of your device.No

*Changing the switch name in config.json will create a new switch instead of renaming the existing one in HomeKit. It's strongly recommended that you rename the switch using a HomeKit app only.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial