Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Drakulix/googlehome
Google Home Integration for Home-Assistant
https://github.com/Drakulix/googlehome
Last synced: 7 days ago
JSON representation
Google Home Integration for Home-Assistant
- Host: GitHub
- URL: https://github.com/Drakulix/googlehome
- Owner: Drakulix
- License: apache-2.0
- Created: 2019-09-04T14:58:32.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-10-29T19:52:22.000Z (about 3 years ago)
- Last Synced: 2024-02-14T21:40:10.438Z (9 months ago)
- Language: Python
- Size: 154 KB
- Stars: 28
- Watchers: 7
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Deprecated - development of this component will not continue.
## As an alternative consider using [ha-google-home](https://github.com/leikoilja/ha-google-home) instead.
ha-google-home has a cleaner codebase and is build by a set of talented developers.
Despite being a rather new project, it has gained a lot of traction very quickly, providing a more polished experience.
It is currently lacking a bluetooth scanner feature, but that is being worked on and the one included in this repository has major issues anyway.
This code will likely remain working in the forseeable future. If you insist on using it until feature parity has been established, I am happy to merge any fixes, but want to encourage you to drive ha-google-home forward instead.
----
# Original README
## Google Home Integration for [Home-Assistant](https://home-assistant.io)
### Fork of the original component before the [deprecation](https://github.com/home-assistant/home-assistant/pull/26035) with a workaround.
This is a custom component that allows tracking alarms/timers of google/nest home devices and/or use their buildin bluetooth chips for presence detection.
*Warning*: Version 0.4 changed the way the alarm/timer sensors work, you will need to adjust your automations accordingly.
## Installation
1. Setup this repository as a custom repository in HACS.
2. Search under Integrations for "Googlehome" and hit install.
3. Restart HA
4. Go to Integrations and setup the Googlehome integration. You will need to sign in with a google account linked to your google home devices.
5. (Alternatively setup the integration via a google master token, see [#14](https://github.com/Drakulix/googlehome/issues/14))
## Usage
- Enable the features you want to use in the Integrations tab. 
- When bluetooth monitoring is enabled devices will popup as device_tracker entries. You can use `ghname` to match which google home device discovered your bluetooth device and `rssi` to track the distance. 
- When monitoring alarms/timers is enabled two sensors will be added to your home-assistant instance per google home device. The `pending` attribute contains a sorted list of pending alarms/timers for more advanced automations using templates. 
- The state alternates between `none` (if none are set), `waiting` (if any alarms/timers are set) and `ringing`.
For a quick automation when an alarm is dismissed (and no new / snooze alarm has been set) you may use an automation like:
```yaml
alias: Alarm
description: ''
trigger:
- platform: state
entity_id: sensor.schlafzimmer_alarm
from: ringing
to: none
condition: []
action:
- service: scene.turn_on
data: {}
entity_id: scene.test
mode: single
```
## License
The Project is Licensed under the Apache License just like the original home-assistant code.
The included fork of the googledevices python lib is licensed under the MIT License just like the original.
I do only own the copyright on the patches to the original code, everything else is not mine.