arkits / onhub-web

The missing Web UI for Google OnHub and Google Wifi Devices

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

onhub-web

About

onhub-web (ohw) is the missing web client for interacting with and monitoring Google OnHub and Google Wifi devices.

onhub-web talks to the Google Foyer APIs to retrieve metrics regarding your Google OnHub / Google Home devices. These metrics are then accessible through various avenues including a web UI and Prometheus / Grafana dashboard.

onhub-web's web UI

Getting Started

Config file

To get started, create a config.yaml based on sample config.

Running Locally

# Download the Node.js dependencies
~/Dev/onhub-web/web ❯ yarn

# Build the frontend client
~/Dev/onhub-web/web ❯ yarn build

# Download Go dependencies
~/Dev/onhub-web ❯ go mod download

# Run the server
~/Dev/onhub-web ❯ go run main.go

Building

# Build a stand-alone binary (includes web UI)
~/Dev/onhub-web/scripts ❯ ./make.sh

# Build a stand-alone binary (includes web UI) for Raspberry Pi 4
~/Dev/onhub-web/scripts ❯ ./make_pi.sh

Grafana

onhub-web also exposes the metrics through a Prometheus metrics endpoint and a compatible Grafana dashboard is also available.

onhub-web's Grafana Dashboard

About

The missing Web UI for Google OnHub and Google Wifi Devices

License:MIT License


Languages

Language:Go 49.1%Language:JavaScript 42.7%Language:HTML 4.0%Language:Shell 2.7%Language:HCL 0.6%Language:CSS 0.5%Language:Dockerfile 0.4%