gh-connector's Introduction

GH-Connector

Connector for Google Home Devices with SmartThings

Features

Google Home TTS

Music Player with File URL or MP3 File of NAS

Web UI

Sample

Install

Preparing

You need a Raspbery pi or Synology Nas to install GH Connector API Server(Default port: 30010)

Install API Server

Raspberry pi

You must install docker first.

sudo mkdir /docker
sudo mkdir /docker/gh-connector
sudo chown -R pi:pi /docker
docker pull fison67/gh-connector-rasp:0.0.2
docker run -d --restart=always -v /docker/gh-connector:/config -v /yourMp3Folder:/music1 --name=gh-connector-rasp --net=host fison67/gh-connector-rasp:0.0.2

Synology nas

You must install docker first.

make folder /docker/gh-connector
Run Docker
-> Registery 
-> Search fison67/gh-connector (0.0.2 version)
-> Advanced Settings
-> Volume tab -> folder -> Select gh-connector & Mount path '/config'
-> Volume tab -> folder -> Select MP3 Folder & Mount path '/music1'
-> Network tab -> Check 'use same network as Docker Host'
-> Complete

Install DTH

Install Smartapps

You must enable OAuth.

API

TTS
address : /googleHome/api/:googleHomeID/tts (GET, POST)
param
a. message
b. lang
c. volume
d. speed

ex) docker address(192.168.0.100), googleHomeID(xxxxxxxxxxxxxxx)
http://192.168.0.100:30010/googleHome/api/xxxxxxxxxxxxxxx/tts?message=test&lang=ko&volume=20

Play MP3
address : /googleHome/api/:googleHomeID/play/:mp3Name (GET)
param
a. volume

ex) docker address(192.168.0.100), googleHomeID(xxxxxxxxxxxxxxx), mp3(test.mp3)
http://192.168.0.100:30010/googleHome/api/xxxxxxxxxxxxxxx/play/test&volume=20

Recommend Projects