OpenGarage Garage door

Homebridge plugin for OpenGarage.

Installation

This plugin only works with OpenGarage Firmware 1.0.8 or later.

You must have Node.js v18.0.0 or later installed (required for native fetch support). Check your node version:

node --version

You need Homebridge installed and configured. This plugin requires Homebridge 1.8.0 or later.

npm install -g homebridge

Install this plugin from npm:

npm install -g homebridge-og

Or directly from GitHub:

npm install -g github:OpenGarage/homebridge-og

Or from source:

git clone https://github.com/OpenGarage/homebridge-og.git
cd homebridge-og
npm pack
sudo npm install -g homebridge-og-$(node -e "console.log(require('./package.json').version)").tgz

Configuration

Update your config.json configuration file. See the example below.

• ip - The host name or IP address of your OpenGarage device
• key - The password to control your OpenGarage device
• openCloseDurationSecs - The amount of time within which an open/close transition should reliably complete (and OpenGarage will sense the new door state), including the OpenGarage warning beeps.
• pollFrequencySecs - How often to poll OpenGarage for state changes. This will enable state updates for the garage door when not controlled via this homebridge plugin.
• logFrequencySecs - (Optional) How often to log a routine status message. Defaults to 60. A status line is always logged immediately when the door or vehicle state changes regardless of this setting.

Sample config.json

    {
        "accessories":
        [
            {
                "accessory": "OpenGarage",
                "name": "Garage",
                "ip": "192.168.0.4",
                "key": "YourPassword",
                "openCloseDurationSecs": 22,
                "pollFrequencySecs": 60,
                "logFrequencySecs": 60
            }
        ]
    }

NOTES

1. Change the IP in the example to the IP or hostname of your OpenGarage.
2. Be sure to change the "YourPassword" part to the password used for your OpenGarage.
3. Measure how long it takes for your garage door to close after triggering the state change using OpenGarage, including the warning beeps if applicable. Add a few seconds and set the value openCloseDurationSecs accordingly.
4. Enjoy telling Siri to open and close your Garage as well as receiving push notifications on state change.