Skip to content
Allow Google Assistant to control your Homebridge accessories.
TypeScript HTML JavaScript CSS
Branch: master
Clone or download
Latest commit c74d582 Dec 7, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github correct typos Dec 7, 2019
.vscode first commit Jul 23, 2019
portal ensure no other connections from the same client are listening before… Dec 6, 2019
scripts do not run hook on refresh token Nov 29, 2019
server disable blank issues Dec 7, 2019
src add ability to warn clients (in homebridge log) the server is going t… Dec 7, 2019
.gitignore updates Jul 23, 2019
.npmignore updates Jul 23, 2019
CONTRIBUTING.md correct typos Dec 7, 2019
LICENSE first commit Jul 23, 2019
README.md Add support for TV, Fanv2 and 2fa on locks Nov 25, 2019
config.schema.json
nodemon.json update ws-connect, issue templates, contributing Jul 27, 2019
package-lock.json update hap type gen script Nov 24, 2019
package.json Add support for TV, Fanv2 and 2fa on locks Nov 25, 2019
tsconfig.json first commit Jul 23, 2019
tslint.json update hap type gen script Nov 24, 2019

README.md


Homebridge to Google Smart Home

npm npm Donate

Control your supported Homebridge accessories from any Google Home speaker or the Google Home mobile app. Inspired by homebridge-alexa.

Supported Device Types

  • Switch
  • Outlet
  • Light Bulb
    • On / Off
    • Brightness
    • Color (Hue/Saturation)
  • Fan (On / Off)
  • Fan v2 (On / Off)
  • Window
  • Window Coverings
  • Door
  • Garage Door
  • Thermostat
  • Television (On / Off)
  • Lock Mechanism (2FA support)

Note: Google Smart Home does not currently support "sensor" devices such as Temperature Sensors, Motion Sensors, Occupancy Sensors etc.

Installation Instructions

Option 1: Install via Homebridge Config UI X:

Search for "Google Home" in homebridge-config-ui-x and install homebridge-gsh.

Option 2: Manually Install:

sudo npm install -g homebridge-gsh

Configuration

To configure homebridge-gsh you must also be running homebridge-config-ui-x.

  1. Navigate to the Plugins page in homebridge-config-ui-x.
  2. Click the Settings button for the Google Smart Home plugin.
  3. Click the Link Account button.
  4. Sign in with your Google or GitHub account.
  5. Your account is now linked.
  6. Restart Homebridge for the changes to take effect.
  7. Add the Homebridge Action using the Google Home mobile app. See Wiki for detailed instructions.

homebridge-gsh-signup

Enabling Accessory Control

Homebridge must be running in insecure mode to allow accessory control via this plugin. See Enabling Accessory Control for instructions.

Multiple Homebridge Instances

This plugin must only be configured on one Homebridge instance on your network as the plugin will discover all your other Homebridge instances and be able to control them. For this to work:

  • all instances must be running in insecure mode
  • all instances must have the same PIN defined in the config.json

Known Issues

  1. Only one Homebridge instance can be linked to an account (even across different local networks). You will experience unintended results if you try and link more than one instance to the same account.

Troubleshooting

1. Errors during installation

Make sure you installed the package with sudo flag. Most installation errors can be fixed by removing the plugin and reinstalling:

# cleanup
sudo npm uninstall -g homebridge-gsh

# reinstall
sudo npm install -g homebridge-gsh

2. Cannot control accessories

See Enabling Accessory Control and Multiple Homebridge Instances.

3. Ask on Slack

Slack Status

Join the Homebridge Slack chat and ask in the #hap-google-smart-home channel.

Contributing

Please see CONTRIBUTING.md.

Credits

License

Copyright (C) 2019 oznu

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Sponsors

JWT Auth for open source projects

You can’t perform that action at this time.