Skip to content

ryanadiaz/simple-hud

Repository files navigation

Simple HUD for Even Realities G2

Clock, weather, and mic level — always in view on your G2 glasses.


Star this repo    Follow @mrryandiaz


License: MIT   React 19   TypeScript   Even Hub


A minimalistic heads-up display for your G2 glasses with a very simple always on view. Built with even-toolkit.

Quick Start  |  Features  |  How It Works  |  Contributing

Why This Exists

Even Hub ships with generic widgets. Simple HUD puts the three most useful data points — clock, weather, and mic level — in a clean layout on the right side of your field of view. The rest of your visual field stays completely clear.

Double-click the touchpad to blank the display in one gesture. Double-click again to bring it back.

Features

Feature Details
Clock 12-hour time, on by default every session
Weather Temp, condition, feels-like. User's location persists between sessions.
Microphone Live decibel readout from the G2 mic, with browser fallback.
Hidden mode Double-click the touchpad to hide everything. Double-click to restore.
Persistent settings Every toggle remembers its state when you close and reopen the app
Simulator support Fully testable without physical glasses

Display Layout

Glasses Settings

For Local Development

1. Clone and install

git clone https://github.com/ryanadiaz/simple-hud.git
cd simple-hud
npm install

2. Start the dev server

npm run dev

3. Test in the simulator

npx @evenrealities/evenhub-simulator@latest http://localhost:5173

4. Test on your glasses

evenhub qr -u http://<your-local-ip>:5173 --http

How It Works

Simple HUD builds a custom page using GlassesSdk directly, placing text containers at exact pixel positions on the 576×288 display. Each container updates independently via updateWithEvenHubSdk() — only the changed element gets rewritten.

Weather data comes from Open-Meteo — no API key required. Your location is saved to localStorage and restored next session.

The mic uses the G2's built-in microphone via audioControl(). If glasses aren't connected, it falls back to your browser mic automatically.

When the phone screen locks or the app moves to the background, the display recovers automatically when you bring it back — no manual refresh needed.

Touchpad Controls

Gesture Action
Double-click Toggle display hidden / visible

Settings

Each feature has its own toggle in the companion Settings app. Settings are saved to localStorage and restored on every open.

Contributing

Open an issue first for anything larger than a bug fix. PRs are welcome.

git clone https://github.com/ryanadiaz/simple-hud.git
cd simple-hud
npm install
npm run dev

See CONTRIBUTING.md for details.

License

MIT — see LICENSE.


Built by Ryan Diaz | ryanadiaz.com


If this saves you time:

Star this repo    Follow @mrryanadiaz