Google Home Notification Gateway (GHNG) is an administrable API allowing your Google devices to receive voice notifications from anything able to send very basics HTTP requests.
It works pretty well with IFTTT. You can create small automations (applets) that triggers voice notifications on your devices.
Here a simple example of IFTTT and GHNG working together:
IF My favorite Twitch streamer is going live THEN Send a HTTP request to GHDG to say "Your favorite Twitch streamer is going live" on all your devices.
If you have some coding skills, it's very easy to send notification to GHNG from any scripting language, you just need to be able to send HTTP Request.
IMPORTANT: Currently, the app works fine on MacOSX but there is a lot of dependencies issues that I have to fix on Windows and Linux.
- Receive voice notifications to a single device, or all your devices.
- Support multiple voice languages that can be specified in the request.
- API key protected.
- Embedded localtunnel option to test the application without port forwarding configuration.
- A "How to use" section explaining how to create the notification request.
Below a diagram showing how GHNG works. The application must be hosted somewhere on your local network (NodeJS must be supported by the host machine).
As show above, GHNG can receive HTTP requests that trigger voice notifications on your devices. If you want GHND to receives HTTP request from outside your local network (E.g. IFTTT), you need to configure a NAT rule on your router/box.
- Docker
- Nodejs (v8.6.0 or higher) - To run the app
- NPM (v5.6.0 or higher) - To install NodeJS dependencies
- Git - To clone the repository
- Build tools - To build native modules (see how to install build tools for your plateform here https://github.com/nodejs/node-gyp)
I've created a Docker Hub repository here: https://hub.docker.com/r/marlburrow/ghng/
Pull the image marlburrow/ghng on your favorite Docker host.
- Private port to map on your host:
3000
- Install on OSX
- Install on Windows (Work in progress)
- Install on Linux (Work in progress)
Now the script is running. You need to configure some little thing from the GHND administration panel.
Go to the administration UI (by default: http://localhost:3000 if the host is your machine).
On the login screen, type the default password !adminpassword!and press enter.
Now the first thing to do is to change the admin password, go to the Settings section and type a new password in the field Admin password, and click on Save.
To send notifications to your devices, GHND must know how to reach your devices and how to identify them.
Go to the Devices section and click on the plus icon in the top right of the screen. Just type the IP address of one of your google devices. If you don't know it you can view the IP from the Google Home app on Android or iOS.
If the IP is right and your device is reachable, the name and the identifier should be autofilled, but you can change them if you need.
Repeat this step for each of your devices.
To Accept notifications, GHND must receive a valid API key in each notification request.
ideally, you should create an API key for each source of notification. Let's create one for IFTTT first.
Go to the API Key section and click on the plus button in the top right of the screen. Type the name of your API Key (E.g. IFTTT Applets), and click on Create
Now, GHNG is ready to receive notification from IFTTT.
If you want to send a request from a IFTTT Applet to GHNG, you must use the Webhooks service.
To know how compose the request, go to the section How to use in the GHNG Administration panel.
You probably want GHND to be able to receive notifications from outside your local network. For this you need to:
- Configure a NAT rule on your router/box pointing on the local machine hosting GHND (on the port 3000 if you have not changed it).
- A static WAN IP address or a DDNS.
If you are not able to be in the previous configuration, I added a localtunnel feature. Basically it exposes the notification API to internet without any configuration needed on your router.
In the current version, the localtunnel is not stable over time. However, it's very helpful if you only want to test GHNG without configure NAT on your router.
Coming soon
MIT © MarlburroW