1.0.1 • Published 1 year ago

google-home-notifications v1.0.1

Weekly downloads
-
License
MIT
Repository
-
Last release
1 year ago

GOOGLE HOME NOTIFICATIONS

npm Download License

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.

  1. Use the docker image (recommended)
docker run -p 3000:3000 GHN_PORT=3000 --name google-home-notifications -d rtrompier/google-home-notifications:latest
  1. 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.

  1. Your notification can be send by HTTP Call to GET http://YOUR_SERVER_IP:3000/notify
  2. 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
ParameterDescription
destinationIP of your Google Home device (Eg : 192.168.1.10)
textContent of your notification (Eg: Hello world)
langLanguage of your content (Eg: 'en', 'fr', 'es', ...)