James Babcock dc1d4d30a9 Wear app UI refinements
<details>
<summary>Prompts Used</summary>

Thanks. Next up, let's make soem refinements to the watch app UI.
We'll remove the glasses-battery indicator from the watch UI (it's already on the glasses screen so not needed there).
We'll merge the connection status into the current-app display; rather than one line saying "Connected" and one line saying "Display off" or an app name like "Launcher", we'll merge these into one indicator (in the second line's position), which is "Screen off" or an app name if connected, or a connection status otherwise.
We'll make rotating the crown scroll/select in the same way that swiping up/down on the ring or glasses touchpad does. Apps that want to pay attention to the exact source and details of an input should be able to, but apps that don't pay attention should get sensible behavior by default. (There might already be some code attempting to do this, but currently in my testing the crown has no effect)

> All three refinements are in, and the wear app builds cleanly. Here's what changed:
>
> **Battery indicator removed.** The glasses-battery readout is gone from both places it appeared: the touchpad's status line and the Status screen's connection chip (which now says just "Connected", with "· charging" kept since that signals glasses-in-the-case rather than battery level). The watch-side `PhoneState.battery` field was dropped too since nothing reads it now — the phone still publishes it in the state item (documented in PROTOCOL.md), so nothing changes on the wire.
>
> **Merged status/current-app indicator.** The touchpad's separate top `StatusRow` ("● Connected · 78%") is removed, and `statusLine`/`focusLine` in Common.kt are merged into one `padLine()` used in the centre position: when connected it shows "Screen off", "Locked", "Listening…", or the foreground app name ("Launcher" when nothing's open); otherwise it shows the connection state ("No phone", "Open Faceclaw on phone", "Connecting…", "Glasses disconnected", …). The old status dot's color coding survives as the text color — app names render in the normal text color, problem/busy/off states in the red/amber/gray tones — so the at-a-glance signal isn't lost.
>
> **Crown scrolling.** The pipeline you suspected does exist and the phone side of it is already exactly what you described: crown steps arrive as `scroll-up`/`scroll-down` carrying `source: "watch"`, so apps that inspect the source can, and apps that just switch on the event type get the same behavior as a ring/touchpad swipe. I traced that path end-to-end and found no phone-side gap. The break is on the watch: rotary events are only delivered to a *focused* Compose node, and RemoteScreen requested focus once via `LaunchedEffect(Unit)` with a plain `FocusRequester` — fragile against the nav host and never re-run after anything steals focus (the keyboard activity round-trip, ambient mode, screen off/on). It now uses `rememberActiveFocusRequester()` (Google's documented rotary pattern, present in the bundled wear-compose 1.4.1, with the required `@OptIn(ExperimentalWearFoundationApi)`), plus a lifecycle observer that re-requests focus on every `ON_RESUME`. The accumulator/sensitivity logic is unchanged.
>
> One caveat on the crown: since I can't reproduce the failure off-hardware, this fix targets the most likely cause (focus never landing or being lost). Worth a quick on-device check — and if the crown *still* does nothing, the useful datapoint would be whether `adb logcat` on the phone shows `sys-event .../SCROLL_*` lines when you turn it, which would split watch-side from phone-side cleanly.
</details>
2026-08-25 01:16:31 -07:00
2026-04-26 23:07:54 -07:00
2026-08-25 00:09:47 -07:00
2026-08-25 00:09:47 -07:00
2026-08-02 19:33:48 -07:00
2026-08-25 01:16:31 -07:00
2026-04-26 23:07:54 -07:00
2026-08-24 13:17:09 -07:00
2026-04-26 23:07:54 -07:00
2026-04-26 23:07:54 -07:00
2026-04-26 23:07:54 -07:00

Faceclaw - An unofficial user interface for the Even Realities G2 smart glasses

This is an unofficial user interface for the Even Realities G2 smart glasses. It is entirely unofficial, and comes with no support or warranty from Even Realities or from anyone.

This app runs on Android, and requires installing custom firmware on the glasses. The Android app itself can install and uninstall the custom firmware; it downloads the stock firmware from Even and applies patches generated from https://github.com/jimrandomh/g2flash.

Screenshots

App launcher Music player Assistant settings Display settings

Installation

To compile, you will need an Android SDK environment with SDK version 35 installed and licenses accepted, and the ANDROID_HOME pointing to the install. You will need Nativescript installed, and a JDK environment (v21), with the JAVA_HOME environment variable pointed at it. You will also need a reasonably up to date npm and nodejs installed.

To install a version that you compiled, you will need adb connected. Go to Settings>About phone and tap the "Build number" field seven times. Then plug the phone's USB-C port into your computer, authorize access on the phone, then run `nativescript run android

The compile, run 'npm run build' To install, run nativescript run android --juslaunch

Features

  • A voice assistant that wakes up when you say "Hey Even", transcribes text with an on-device model, OpenAI Whisper, ElevenLabs, or Soniox API, and responds to queries and commands using an onboard model (Qwen3 4B, slow) or with an Anthropic or OpenAI model (requires an API key), or using your own long-running OpenClaw agent (see "Connecting an external agent" below).
  • Multitasking, with an app-switcher sidebar and app launcher
  • Mostly-compatible with EvenHub apps
  • A lock screen; glasses lock automatically when you take them off and unlock when you unlock your phone
  • Full-screen apps can use the full 640x480 display area (rather than the 576x288 that EvenHub apps can use)
  • Integration with Android notifications: A top-bar that shows the same icons your phone does, popups when notifications arrive, and menu items to dismiss or use Android-app-provided custom actions like mark as read or quick reply.
  • Mirror terminal apps such as Claude Code or Codex CLI with g2mirror (https://github.com/jimrandomh/g2mirror), view them on the glasses, and send them inputs with the voice assistant
  • Media player controls including playlist and media library navigation, compatible with most Android media players
  • Turn-by-turn directions (requires a Mapbox API token)
  • Nightscout, an app for viewing blood-glucose data (requires a cloud server and API token)
  • Power management: the glasses go to sleep properly when the screen is off, and wake when you double-tap the ring or speak the wakeword, allowing battery life similar to the stock Even app.
  • Connection management with auto-reconnect, and autodetection of conflict with the official Even Realities app
  • A Wear OS watch app that replaces (and outdoes) the R1 ring: tap, swipe, hold and crown gestures, side buttons, app launching and window switching, voice or keyboard queries to the assistant with the reply on your wrist, typing into apps, and glasses status/lock/display control (see "Watch remote" below)
  • On-phone screen mirroring with touch control: tap what you see on the mirror (sidebar icons, launcher cells), or use the phone's own touchpad, d-pad and Back/Menu buttons — the same spatial scheme as the watch — plus a compact ring simulator. A display-mode picker (576×288 band, 576×480 tall, or the full 640×480 panel with an auto-hiding sidebar) and a brightness slider with an Auto toggle sit beside the mirror.
  • Bluetooth pairing that scans for nearby glasses and identifies each pair before connecting: model, frame shape, and colour decoded from the advertised serial (with product photos), left and right arms matched to each other by that serial, an estimated distance so the pair in your hand sorts first, and the optional R1 ring
  • Dual-language NativeScript architecture with Java for the multithreaded Android API and bluetooth stack bits, Typescript for the bits you want to hack on

Watch remote (Wear OS)

The wear/ directory holds a companion app for Wear OS 3+ watches that turns the watch into a remote for the glasses. The whole watch face is a touchpad that mirrors the ring (tap, double-tap, hold, swipe, crown scrolling, side buttons), and beyond the ring it can launch apps, switch and close windows, wake/sleep/lock the display, send spoken or typed queries straight to the assistant (using the watch's own microphone) and show the reply on the wrist, and type text into apps such as the terminal. Its swipes are a spatial control scheme the ring never had, with no mode to enter first: the launcher highlights one app and moves it by rows and columns, right goes into things (sidebar → window, settings section → items, next track in Music), left backs out, tap selects, hold opens the context menu, double-tap or a two-finger tap is back everywhere, and two wrist twists go back; up/down scroll and right/left select/back everywhere else. The ring's own scheme is unchanged — watch input is tagged as a separate source. Faceclaw's Settings > Watch section has the phone-side switches. See wear/README.md for building and installing it; it is a separate Gradle build, sideloaded over adb, and needs no Play Store. The phone side requires Google Play services.

Connecting an external agent (OpenClaw)

Instead of calling an LLM API directly from the phone, the voice assistant can route queries to your own long-running agent, which also gets access to the glasses' tools (show alerts, read notifications, control media, type into apps including terminals) both during conversations and proactively. This works through the faceclaw-agent-bridge OpenClaw plugin (https://github.com/jimrandomh/faceclaw-agent-bridge): the phone dials out to it over a websocket (typically across a tailnet).

Setup lives in the faceclaw-agent-bridge repository's README. It covers both the OpenClaw-host side (plugin install and configuration) and the phone side, which can be configured either by hand in Settings > Assistant on the glasses, or over adb using scripts/pull_config.sh and scripts/push_config.sh from this repo; the instructions are written so an OpenClaw agent with the phone plugged into its host can perform the whole setup itself. Note that a pulled settings file contains your API keys, so treat it as a secret (the default output path is gitignored here).

EvenHub App Notes

Faceclaw is mostly compatible with EvenHub apps. If you are developing an app or using an open source app, you can package it into an EHPK file, send it to your phone, and open it in the file browser to install. Or, you can log into EvenHub and download apps there.

Faceclaw runs EvenHub apps through an emulation layer; you may run into bugs and differences in behavior. If you run into bugs, please try tunning them in the stock Android app before you report them to the app's creator. If you're developing your own app and plan to submit it to the Hub, be sure to test it in the stock Android app before submitting.

Additional Caveats

Some permissions are used, but may not reliably prompted for. Go to Android Settings > Apps > Faceclaw to ensure permissions are available or things may not work.

Being a background app on a locked Android phone is fraught, and there may be issues with manufacturer-psecific battery optimization software that lead to it getting paused, throttled to low CPU usage, etc.

Contributing

Be bold. Modify Faceclaw into the app that you want it to be for yourself, without worrying about whether other people will like your version. Then if you think your changes might be useful to others, make a pull request at https://github.com/jimrandomh/faceclaw.

The Typescript and Java code in this repository runs on your phone, not on the glasses themselves, and (with the narrow exception of the firmware-updating tool), can't hurt your hardware. For changes to the glasses firmware, refer to g2flash; changes there require more caution.

Faceclaw is Free Software (GPLv3). Please only contribute code that you wrote (or prompted an agent to write), hold the copyright to, and have tested on physical hardware under real-world conditions. If you make any changes that involve integration with a third party's API or services, modify PRIVACY to mention them and link to that provider's privacy policy. For services that involve a user-provided API key, we assume that the user agreed to any terms associated with that service when they generated the key. For services that don't involve API keys, more caution may be required.

S
Description
No description provided
Readme GPL-3.0
49 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 51.1%
Kotlin 23.2%
JavaScript 12.9%
C 6.6%
Objective-C 2.2%
Other 4%