1.0.1 • Published 2 years ago
google-home-notifications v1.0.1
GOOGLE HOME NOTIFICATIONS
This project allow to send vocals notifications through a REST API.
Requirements
You need to have a server on your local network to execute this software (NodeJS or Docker)
How to start
Installation
Two options are available.
- Use the docker image (recommended)
docker run -p 3000:3000 GHN_PORT=3000 --name google-home-notifications -d rtrompier/google-home-notifications:latest
- Use the npm package
$ sudo npm install -g google-home-notifications
Or update to latest version when already installed:
$ sudo npm update -g google-home-notifications
How to start (for NPM only)
$ google-home-notifications
You can pass the following params by environment variables :
- GHN_PORT The port used by the google-home-notifications server
How to use
A REST Api is available to send your vocal notification.
- Your notification can be send by HTTP Call to
GET http://YOUR_SERVER_IP:3000/notify
- Text and targeted device, must be passed in query param. Eg :
GET http://YOUR_SERVER_IP:3000/speech?destination=192.168.1.10&text=Hello World
Parameter | Description |
---|---|
destination | IP of your Google Home device (Eg : 192.168.1.10) |
text | Content of your notification (Eg: Hello world) |
lang | Language of your content (Eg: 'en', 'fr', 'es', ...) |