• Stars
    star
    394
  • Rank 106,773 (Top 3 %)
  • Language
    TypeScript
  • License
    GNU General Publi...
  • Created almost 5 years ago
  • Updated about 2 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Allow Google Assistant to control your Homebridge accessories.


Homebridge to Google Smart Home

npm npm Discord verified-by-homebridge 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 (2FA required)
  • Thermostat / Heater Cooler
  • Television (On / Off)
  • Lock Mechanism (2FA required)
  • Security System (2FA required)
  • Temperature Sensor
  • Humidity Sensor

Note: Google Smart Home does not currently support all "sensor" devices such as Motion Sensors or 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 Discord

Join the Official Homebridge Discord community and ask in the #homebridge-gsh 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

More Repositories

1

docker-cloudflare-ddns

A small amd64/ARM/ARM64 Docker image that allows you to use CloudFlare as a DDNS / DynDNS Provider.
Shell
1,039
star
2

docker-guacamole

A self-contained guacamole docker container for x64 and ARM. Remotely connect over SSH, RDP or VNC using HTML5.
Dockerfile
526
star
3

dns-zone-blacklist

This project generates dnsmasq, bind and unbound zone files to be used in DNS based AD Blockers.
JavaScript
170
star
4

docker-unms

This image is no longer maintained: https://github.com/oznu/docker-unms/issues/53
Dockerfile
143
star
5

docker-dns-ad-blocker

A lightweight dnsmasq DNS server to block traffic to known ad servers with optional DNSCrypt support. Supports x86_64 and Raspberry Pi (armhf).
Dockerfile
80
star
6

homebridge-unifi-occupancy-sensor

An occupancy sensor for Homebridge and UniFi
JavaScript
69
star
7

unifi-events

A Node.js module to listen for events from a UniFi Controller.
JavaScript
53
star
8

docker-onedrive-sync

A docker container to sync data between a mounted volume and OneDrive Personal/Business.
Shell
42
star
9

homebridge-daikin-esp8266

An Arduino Sketch and Homebridge Plugin to control my Daikin AC using an ESP8266 micro controller.
TypeScript
33
star
10

docker-s6-alpine

Alpine Linux + S6 Overlay
Dockerfile
30
star
11

alpine-node

Node.js binaries for Alpine Linux on x86_64, armhf and aarch64.
Dockerfile
20
star
12

pycpanel

A python module for the cPanel API
Python
18
star
13

docker-cloud9

Work in progress
JavaScript
8
star
14

mdns-resolver

A node.js module to resolve zeroconf .local domains using pure JavaScript.
TypeScript
7
star
15

pyHyperV

Simple client for calling the HyperV orchestrator runbooks in python. Not maintained.
Python
6
star
16

ws-connect

WebSocket client for Node.js that transparently reconnects lost or disconnected connections.
TypeScript
6
star
17

homekit-daikin-ir-thermostat

No longer used. Replaced with Daikin ESP8266 Arduino Project
JavaScript
6
star
18

homebridge-esp8266-fan

A Homebridge plugin and ESP8266 Arduino sketch to control a 3 speed fan using a 4 channel relay.
C++
6
star
19

esp-irrigation-controller

An ESP32 powered irrigation system controller with HomeKit support powered by Homebridge.
TypeScript
6
star
20

docker-s6-alpine-node

Alpine/Ubuntu Linux + S6 Overlay + Node
Dockerfile
5
star
21

paAPI

A python client for the Parallels Operations Automation and Parallels Business Automation Enterprise APIs.
Python
4
star
22

homebridge-esp8266-garage-door

An esp8266 powered garage door controller with HomeKit support powered by Homebridge.
C++
3
star
23

homebridge-esp-pir

A Homebridge plugin and ESP8266 Arduino sketch for a PIR sensor.
TypeScript
3
star
24

gh-wiki-edit-discord-notification

GitHub Action to notify a Discord channel when someone edits the project wiki.
JavaScript
2
star
25

homebridge-esp8266-outlet

C++
1
star
26

recently-closed-tabs-crx

Recently Closed Tabs extension for Google Chrome
JavaScript
1
star
27

docker-s6-debian

Debian Slim + S6 Overlay
1
star