From f858f10ce25ae95024ccb9baa175490c3da78050 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 28 Aug 2026 10:28:37 -0700 Subject: [PATCH 01/10] Wear watchface design MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Makes the button-row appear and disappear with a slide-in/out gesture. Rearranges the other UI elements for a more watchface-like view.
Prompts used In faceclaw/wear, we have an Android Wear watch app which can be used as a glasses controller. Currently, its UI is a bit chaotic: we have a bottom row of buttons, the time, a foreground-window title, some help text, and a ring of indicators. The core interaction is tapping, double tapping, long tapping, and swiping (which have the same effect as on the R1 ring), which aren't location sensitive except that they can't hit the row of buttons. There is also a crown, which can be rotated as a prev/next input. First, let's make a crown-direction setting (in the Watch section of the on-glasses Settings app), which is a toggle that can swap which crown-rotation direction is considered next vs prev. The default will be off, which will be opposite the direction that is currently default. Next, we will make it so that the row of buttons is hidden by default. They will slide in from the bottom when the user swipes up from off-screen (distinguished from a swipe-up gesture sent to the glasses by the starting position of the swipe). They will slide out with a swipe down starting from anywhere below the top of the buttons (distinguishing from a swipe-down gesture sent to the glasses by the starting position of the swipe). Next, we will remove the circle and four arrows; change the time from being small, curved and at the top of the screen to being larger, straight and vertically centered. We'll delete the gesture current hint ("● select ●● back"), and take the current foreground-window display (which is currently either "Disconnected", "Screen off", or an app title) and place it below the time. When the current state is "Screen off", it will display as "●● Wake". We'll then make it so that when the glasses screen is off, all gestures except for double tap (which wakes the screen) are ignored. gpt-5.6-Sol: > Implemented the Wear controller redesign. > > - Added on-glasses Settings → Watch toggle: “Clockwise crown = next.” Default off maps clockwise to previous, opposite the former default. > - Replaced the obsolete “Watch input wakes display” setting. > - Bottom buttons are hidden initially, slide up from a bottom-edge swipe, and dismiss with a downward swipe anywhere in the tray. > - Removed the ring, arrows, and gesture hint. > - Added a large centered straight clock with foreground status beneath it; screen-off status is now “●● Wake.” > - While the glasses display is off, non-double-tap gestures are ignored locally and defensively on the phone. > - Updated faceclaw/wear/README.md and faceclaw/wear/PROTOCOL.md. > > Verification: > > - TypeScript type-check passed. > - All 59 tests passed. > - git diff --check passed. > - Wear Gradle compilation could not start because the sandbox blocks Gradle’s local lock socket/cache access.
--- app/g2/dashboard-controller.ts | 28 +- app/g2/wear-remote.ts | 12 +- app/ui/dashboard-settings.ts | 12 +- app/ui/dashboard/settings-menus.ts | 4 +- wear/PROTOCOL.md | 9 +- wear/README.md | 12 +- wear/app/build.gradle.kts | 8 + .../kotlin/com/faceclaw/wear/MainActivity.kt | 24 +- .../main/kotlin/com/faceclaw/wear/Protocol.kt | 3 + .../kotlin/com/faceclaw/wear/WatchPrefs.kt | 2 +- .../kotlin/com/faceclaw/wear/ui/Common.kt | 2 +- .../com/faceclaw/wear/ui/RemoteScreen.kt | 247 +++++++++--------- .../com/faceclaw/wear/ui/TouchpadGestures.kt | 30 ++- 13 files changed, 220 insertions(+), 173 deletions(-) diff --git a/app/g2/dashboard-controller.ts b/app/g2/dashboard-controller.ts index 705dda29..2ce9de76 100644 --- a/app/g2/dashboard-controller.ts +++ b/app/g2/dashboard-controller.ts @@ -58,7 +58,7 @@ import { type InProcessAppOptions, type InProcessWindow } from "../ui/shell/in-p import { loadPersistedOpenApps, savePersistedOpenApps } from "../ui/shell/open-apps-persistence"; import { appViewportRect, SIDEBAR_WIDTH, sidebarStripVisible, type WindowHeightMode } from "../ui/shell/geometry"; import { type LayerActions } from "../ui/layers"; -import { assistantAllowProactiveSetting, assistantBackendSetting, assistantBridgeHostSetting, assistantBridgePortSetting, assistantBridgeTokenSetting, brightnessSetting, brightnessSettingToLevel, displayModeSetting, watchWakesDisplaySetting, elevenLabsApiKeySetting, getStringSettingById, openAiApiKeySetting, nightscoutApiTokenSetting, firmwareDebugFlagsSetting, lockScreenEnabledSetting, nightscoutSiteUrlSetting, onAnySettingChanged, previewColorSetting, saveVoiceRecordingsSetting, sonioxApiKeySetting, screenTimeoutSetting, screenTimeoutSettingToMs, suspendEvenHubWhenScreenOffSetting, verticalPositionSetting, voiceProviderSetting, wakeWordActionSetting, type ConfigSettingString } from "../ui/dashboard-settings"; +import { assistantAllowProactiveSetting, assistantBackendSetting, assistantBridgeHostSetting, assistantBridgePortSetting, assistantBridgeTokenSetting, brightnessSetting, brightnessSettingToLevel, displayModeSetting, elevenLabsApiKeySetting, getStringSettingById, openAiApiKeySetting, nightscoutApiTokenSetting, firmwareDebugFlagsSetting, lockScreenEnabledSetting, nightscoutSiteUrlSetting, onAnySettingChanged, previewColorSetting, saveVoiceRecordingsSetting, sonioxApiKeySetting, screenTimeoutSetting, screenTimeoutSettingToMs, suspendEvenHubWhenScreenOffSetting, verticalPositionSetting, voiceProviderSetting, wakeWordActionSetting, type ConfigSettingString } from "../ui/dashboard-settings"; import { isIgnoringBatteryOptimizations, requestIgnoreBatteryOptimizations } from "../native/battery-optimization"; import { getInstalledEvenHubAppById, @@ -1409,22 +1409,17 @@ class DashboardController { * finger-down/finger-up (the watch) hold for as long as the user does. */ async injectSyntheticRingInput(kind: WearRemoteInputKind, origin: SyntheticInputOrigin = "ring"): Promise { - // Watch-scheme input (the Wear app, the phone's pad/d-pad, mirror touches) - // wakes a dark display and then lands normally, resuming the previous - // focus. The ring's own scheme keeps its double-tap-only wake. + // Match the ring while the display is dark: only a double-click wakes it, + // and that wake is handled by Shell.receiveInput. This check also protects + // against a watch acting on a stale state snapshot. if ( origin === "watch" && !shell.isScreenOn() && - !this.glassesLocked && - (this.phase === "connected" || this.phase === "charging") && - watchWakesDisplaySetting.get() && kind !== "double-click" && - kind !== "wakeword" && kind !== "long-press-release" ) { - shell.wake(shell.getFocus()); - this.requestShellRender(); - this.appendLog(`${kind} (watch scheme) woke the display`); + this.appendLog(`${kind} (watch scheme) ignored while display is off`); + return; } if (kind === "long-press") { // Hardware delivers a press event and then a release when the finger @@ -1452,15 +1447,8 @@ class DashboardController { return; } if (!shell.isScreenOn()) { - // The same wake policy as the rest of the watch scheme: honour the - // "input wakes display" setting; with it off, only a double-tap (a - // normal double-click) reaches the dark display. - if (!watchWakesDisplaySetting.get()) { - if (kind === "double-tap") await this.injectSyntheticRingInput("double-click", "watch"); - return; - } - shell.wake(shell.getFocus()); - this.requestShellRender(); + if (kind === "double-tap") await this.injectSyntheticRingInput("double-click", "watch"); + return; } if (kind !== "tap") { await this.injectSyntheticRingInput(MIRROR_TOUCH_GESTURES[kind], "watch"); diff --git a/app/g2/wear-remote.ts b/app/g2/wear-remote.ts index bfc69543..99af5c67 100644 --- a/app/g2/wear-remote.ts +++ b/app/g2/wear-remote.ts @@ -25,6 +25,7 @@ import { displayModeSetting, onAnySettingChanged, watchCanUnlockSetting, + watchCrownClockwiseNextSetting, watchMirrorAssistantSetting, watchRemoteEnabledSetting, } from "../ui/dashboard-settings"; @@ -209,6 +210,7 @@ export class WearRemote { apps: this.listApps(), displayMode: displayModeSetting.get(), remoteEnabled: watchRemoteEnabledSetting.get(), + crownClockwiseNext: watchCrownClockwiseNextSetting.get(), canUnlock: watchCanUnlockSetting.get(), mirrorAssistant: watchMirrorAssistantSetting.get(), assistantAvailable: shell.isAssistantAvailable(), @@ -294,10 +296,8 @@ export class WearRemote { ack(false, "The glasses are not connected."); return; } - // The lock only yields to a double-click, exactly as the ring's does - // (handled inside the controller); a dark display wakes on any watch- - // scheme gesture (injectSyntheticRingInput, shared with the phone's own - // pad and d-pad). + // The lock and a dark display only yield to a double-click, exactly as + // the ring does (handled inside the controller). const repeatable = kind === "scroll-up" || kind === "scroll-down" || kind === "swipe-up" || kind === "swipe-down"; const steps = repeatable ? Math.min(MAX_SCROLL_STEPS, Math.max(1, Math.round(readNumber(payload.steps, 1)))) : 1; for (let i = 0; i < steps; i++) { @@ -339,6 +339,10 @@ export class WearRemote { ack(false, "The glasses are not connected."); return; } + if (payload.source === "gesture" && !shell.isScreenOn()) { + ack(true); + return; + } if (state.glassesLocked && command !== "unlock" && command !== "lock") { ack(false, "The glasses are locked."); return; diff --git a/app/ui/dashboard-settings.ts b/app/ui/dashboard-settings.ts index 55f1094f..6a723296 100644 --- a/app/ui/dashboard-settings.ts +++ b/app/ui/dashboard-settings.ts @@ -328,13 +328,13 @@ export const watchCanUnlockSetting = new ConfigSettingBoolean({ "Let the watch unlock the glasses' lock screen (which otherwise waits for the phone to be unlocked). Your watch is on your wrist; turn this off if you would rather it stay a phone-only unlock.", }); -export const watchWakesDisplaySetting = new ConfigSettingBoolean({ - id: "watch-wakes-display", - label: "Watch input wakes display", - storageKey: "watch.wakesDisplay", - defaultValue: true, +export const watchCrownClockwiseNextSetting = new ConfigSettingBoolean({ + id: "watch-crown-clockwise-next", + label: "Clockwise crown = next", + storageKey: "watch.crownClockwiseNext", + defaultValue: false, description: - "Any gesture from the watch turns the glasses display on (the ring only wakes it with a double-tap). Off: watch input is ignored while the display is off, as ring input is.", + "Choose which crown direction moves to the next item. Off: clockwise moves to the previous item. On: clockwise moves to the next item.", }); export const watchMirrorAssistantSetting = new ConfigSettingBoolean({ diff --git a/app/ui/dashboard/settings-menus.ts b/app/ui/dashboard/settings-menus.ts index 59988a2a..45464c61 100644 --- a/app/ui/dashboard/settings-menus.ts +++ b/app/ui/dashboard/settings-menus.ts @@ -60,9 +60,9 @@ import { screenTimeoutSetting, wakeWordActionSetting, watchCanUnlockSetting, + watchCrownClockwiseNextSetting, watchMirrorAssistantSetting, watchRemoteEnabledSetting, - watchWakesDisplaySetting, } from "../dashboard-settings"; import { wearBridge } from "../../native/wear-bridge"; import { SettingsPanelLayer, type SettingsSection } from "./settings-panel"; @@ -167,7 +167,7 @@ function settingsSections(): SettingsSection[] { // a watch running the companion app is currently reachable. items: [ toggleSettingMenuItem(watchRemoteEnabledSetting), - toggleSettingMenuItem(watchWakesDisplaySetting), + toggleSettingMenuItem(watchCrownClockwiseNextSetting), toggleSettingMenuItem(watchCanUnlockSetting), toggleSettingMenuItem(watchMirrorAssistantSetting), ], diff --git a/wear/PROTOCOL.md b/wear/PROTOCOL.md index b3bc0b46..485c5c9b 100644 --- a/wear/PROTOCOL.md +++ b/wear/PROTOCOL.md @@ -18,7 +18,7 @@ answered on `/faceclaw/ack`. | Path | Payload | Effect | | --- | --- | --- | -| `/faceclaw/input` | `{gesture, steps?}` | A ring gesture through the same path as the phone UI's test buttons. `gesture` ∈ `click`, `double-click`, `scroll-up`, `scroll-down`, `long-press` (complete short hold), `long-press-start`, `long-press-release`, `wakeword` ("Hey Even"), `swipe-up`, `swipe-down`, `swipe-left`, `swipe-right` (spatial input only a watch can produce: delivered to the glasses UI as `swipe-*` events for components that navigate spatially — launcher grid, settings columns, sidebar, Music — with a scroll / click / double-click fallback elsewhere). `steps` (1–12) repeats a scroll. Refused while the glasses are disconnected. The lock screen is honoured exactly as for the ring (only a double-click reaches it, toggling the locked display). | +| `/faceclaw/input` | `{gesture, steps?}` | A ring gesture through the same path as the phone UI's test buttons. `gesture` ∈ `click`, `double-click`, `scroll-up`, `scroll-down`, `long-press` (complete short hold), `long-press-start`, `long-press-release`, `wakeword` ("Hey Even"), `swipe-up`, `swipe-down`, `swipe-left`, `swipe-right` (spatial input only a watch can produce: delivered to the glasses UI as `swipe-*` events for components that navigate spatially — launcher grid, settings columns, sidebar, Music — with a scroll / click / double-click fallback elsewhere). `steps` (1–12) repeats a scroll. Refused while the glasses are disconnected. The lock screen is honoured exactly as for the ring. While the display is off, only a double-click is accepted and it wakes the display. | | `/faceclaw/command` | `{command, …}` | `launch-app {appId}`, `focus-window {windowId}`, `close-window {windowId}`, `sidebar`, `wake`, `sleep`, `lock`, `unlock`, `connect`, `disconnect`, `close-assistant`, `display-mode {value}` (`value` ∈ `576x288`, `576x480`, `640x480`; sets the phone's Display > Display mode). Everything but connect/disconnect needs a connection; everything but lock/unlock is refused while locked; `unlock` also needs the phone's "Watch can unlock glasses" setting. | | `/faceclaw/assistant` | `{text}` | Send a query to the assistant (`shell.sendToAssistant`) — the reply shows on the glasses and streams back to the watch as events. | | `/faceclaw/text` | `{text}` | Type text into the foreground window (`receiveTextInput`, e.g. the terminal). Refused when the window doesn't take text. | @@ -54,14 +54,17 @@ dashboard state, re-sent whenever it changes (and at least every 30 s): "windows": [{"windowId": "…", "title": "…", "appId": "…", "focused": true, "closeable": true, "acceptsText": false}], "apps": [{"appId": "timer", "title": "Timer"}], "displayMode": "576x288", - "remoteEnabled": true, "canUnlock": true, "mirrorAssistant": true, + "remoteEnabled": true, "crownClockwiseNext": false, + "canUnlock": true, "mirrorAssistant": true, "assistantAvailable": true } ``` `protocol` is reserved for incompatible revisions of this format (nothing checks it yet); `displayMode` mirrors the phone's Display > Display mode and -is what the `display-mode` command changes. +is what the `display-mode` command changes. `crownClockwiseNext` mirrors the +on-glasses Settings > Watch toggle; when false (the default), clockwise crown +rotation sends previous/up, and when true it sends next/down. `apps` is the launcher grid plus installed EvenHub packages, i.e. exactly what the assistant's `apps.launch` tool accepts. diff --git a/wear/README.md b/wear/README.md index e525dea4..04697424 100644 --- a/wear/README.md +++ b/wear/README.md @@ -15,7 +15,7 @@ the phone it only tells you to install it. | double-tap, or a two-finger tap | **back**, everywhere: closes menus, leaves a settings column, leaves a folder or the launcher grid, returns to the sidebar (and from the sidebar turns the display off, as the ring does) | | press and hold | the app's context menu (a long press, held until you lift your finger) | | swipe ↑ ↓ ← → | **spatial navigation, with no mode to enter first**: the launcher highlights one app and the swipe moves it by a row or a column; the settings panel moves between its columns and down its lists; the sidebar moves up and down; Music skips to the previous / next track. Right goes *into* things (sidebar → window, section → items) and left comes back *out* (first column → sidebar). Anywhere without a spatial meaning, up/down scroll, right selects and left goes back. One step per swipe (long swipes used to repeat, which overshot lists whenever the display lagged); use repeated flicks, the crown, or a two-finger page swipe to cover distance. "Natural swipe" flips the vertical sense; left/right can be remapped in settings. | -| rotate the crown | up / down (one step per detent-ish, sensitivity adjustable) — in the launcher that is rows, elsewhere scrolling | +| rotate the crown | previous / next (one step per detent-ish, sensitivity adjustable) — clockwise is previous by default; reverse it in the on-glasses Settings > Watch section | | two-finger swipe up / down | scroll a page (3 steps) | | **twist the wrist twice** (two brisk flicks, either direction) | back — from the gyroscope; on by default, sensitivity adjustable | | **tip taps** — tap your index finger against your thumb | select; two quick taps = back. From the accelerometer; **off by default** (experimental): on a wrist, ordinary hand movement produced phantom selects in testing. Turn on in Watch settings; needs ~¼ s of stillness before a tap counts, and both motion gestures are ignored while the watch is off the wrist or buzzing. | @@ -31,7 +31,9 @@ ever seeing a difference. long press; button 2 = back; button 3 = "Hey Even". You can also set the watch's button shortcut to open Faceclaw. -**Bottom row buttons**: Assistant, Type into app, Apps, Status. +**Bottom row buttons**: Assistant, Type into app, Apps, Status. They are hidden +by default; swipe up beginning at the bottom edge to slide them in, then swipe +down beginning in the button tray to hide them. - **Assistant** — ask the assistant using the *watch's* microphone (system speech recognition) or the Wear keyboard, and read the reply on the watch as @@ -53,9 +55,9 @@ wrist dropping and freezes the app, so the remote would need a wake-up tap before every gesture. Phone-side switches live in Faceclaw's Settings > Watch: turn watch control -off entirely, decide whether watch input wakes a dark display (on by default — -the ring only wakes it with a double-tap), forbid unlocking from the watch, -or stop mirroring assistant replies. +off entirely, reverse the crown direction, forbid unlocking from the watch, +or stop mirroring assistant replies. While the glasses display is off, every +watch gesture except a double-tap is ignored; double-tap wakes it. The watch buzzes differently when the phone refuses or doesn't answer a gesture (glasses disconnected, locked, watch control off); the pill at the diff --git a/wear/app/build.gradle.kts b/wear/app/build.gradle.kts index b75b32e9..71cd6049 100644 --- a/wear/app/build.gradle.kts +++ b/wear/app/build.gradle.kts @@ -32,6 +32,14 @@ android { buildConfig = true } + lint { + // androidx.lifecycle 2.9.x ships a NullSafeMutableLiveData lint check + // that crashes under this AGP's lint (Kotlin analysis API mismatch: + // "Found class KaCallableMemberCall, but interface was expected"). + // We don't use LiveData, so nothing is lost by disabling it. + disable += "NullSafeMutableLiveData" + } + compileOptions { sourceCompatibility = JavaVersion.VERSION_17 targetCompatibility = JavaVersion.VERSION_17 diff --git a/wear/app/src/main/kotlin/com/faceclaw/wear/MainActivity.kt b/wear/app/src/main/kotlin/com/faceclaw/wear/MainActivity.kt index d1697802..b5c1e6b9 100644 --- a/wear/app/src/main/kotlin/com/faceclaw/wear/MainActivity.kt +++ b/wear/app/src/main/kotlin/com/faceclaw/wear/MainActivity.kt @@ -20,6 +20,7 @@ class MainActivity : ComponentActivity() { private val stemHandler = Handler(Looper.getMainLooper()) private var stemHoldRunnable: Runnable? = null private var stemHoldSent = false + private var stemOneIgnored = false override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) @@ -67,10 +68,16 @@ class MainActivity : ComponentActivity() { if (event.repeatCount == 0) { cancelStemHold() stemHoldSent = false + stemOneIgnored = glassesScreenIsOff() + if (stemOneIgnored) return true val runnable = Runnable { - stemHoldSent = true - haptics.heavy() - link.sendGesture(Gesture.LONG_PRESS_START) + if (glassesScreenIsOff()) { + stemOneIgnored = true + } else { + stemHoldSent = true + haptics.heavy() + link.sendGesture(Gesture.LONG_PRESS_START) + } } stemHoldRunnable = runnable stemHandler.postDelayed(runnable, STEM_HOLD_MS) @@ -85,7 +92,7 @@ class MainActivity : ComponentActivity() { return true } KeyEvent.KEYCODE_STEM_3 -> { - if (event.repeatCount == 0) { + if (event.repeatCount == 0 && !glassesScreenIsOff()) { haptics.click() link.sendGesture(Gesture.WAKEWORD) } @@ -98,11 +105,15 @@ class MainActivity : ComponentActivity() { override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean { if (keyCode == KeyEvent.KEYCODE_STEM_1) { cancelStemHold() + if (stemOneIgnored) { + stemOneIgnored = false + return true + } if (stemHoldSent) { stemHoldSent = false haptics.click() link.sendGesture(Gesture.LONG_PRESS_RELEASE) - } else { + } else if (!glassesScreenIsOff()) { haptics.click() link.sendGesture(Gesture.CLICK) } @@ -117,6 +128,9 @@ class MainActivity : ComponentActivity() { stemHoldRunnable = null } + private fun glassesScreenIsOff(): Boolean = + link.state.value?.let { it.connected && !it.screenOn } == true + private companion object { const val STEM_HOLD_MS = 450L } diff --git a/wear/app/src/main/kotlin/com/faceclaw/wear/Protocol.kt b/wear/app/src/main/kotlin/com/faceclaw/wear/Protocol.kt index 35c6dc3a..7221a2ab 100644 --- a/wear/app/src/main/kotlin/com/faceclaw/wear/Protocol.kt +++ b/wear/app/src/main/kotlin/com/faceclaw/wear/Protocol.kt @@ -107,6 +107,8 @@ data class PhoneState( val windows: List, val apps: List, val remoteEnabled: Boolean, + /** False by default: clockwise moves to the previous item. */ + val crownClockwiseNext: Boolean, val canUnlock: Boolean, val mirrorAssistant: Boolean, val assistantAvailable: Boolean, @@ -151,6 +153,7 @@ data class PhoneState( } } ?: emptyList(), remoteEnabled = o.optBoolean("remoteEnabled", true), + crownClockwiseNext = o.optBoolean("crownClockwiseNext", false), canUnlock = o.optBoolean("canUnlock", true), mirrorAssistant = o.optBoolean("mirrorAssistant", true), assistantAvailable = o.optBoolean("assistantAvailable", false), diff --git a/wear/app/src/main/kotlin/com/faceclaw/wear/WatchPrefs.kt b/wear/app/src/main/kotlin/com/faceclaw/wear/WatchPrefs.kt index 734efb13..2cb19e25 100644 --- a/wear/app/src/main/kotlin/com/faceclaw/wear/WatchPrefs.kt +++ b/wear/app/src/main/kotlin/com/faceclaw/wear/WatchPrefs.kt @@ -37,7 +37,7 @@ data class Prefs( * exactly when a remote wants to stay ready. */ val keepScreenOn: Boolean = true, - /** Swipe/crown direction follows the content (touch-scroll style) instead of the ring. */ + /** Swipe direction follows the content (touch-scroll style) instead of the ring. */ val naturalScroll: Boolean = false, /** Tap the top/bottom of the pad to scroll instead of swiping. */ val tapZones: Boolean = false, diff --git a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/Common.kt b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/Common.kt index 975f24f7..8dc7b6c9 100644 --- a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/Common.kt +++ b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/Common.kt @@ -64,7 +64,7 @@ fun padLine(state: PhoneState?, link: LinkStatus): StatusLine = when { state.remoteEnabled == false -> StatusLine("Watch control off", StatusTone.PROBLEM) state.connected -> when { state.locked -> StatusLine("Locked", StatusTone.OFF) - !state.screenOn -> StatusLine("Screen off", StatusTone.OFF) + !state.screenOn -> StatusLine("●● Wake", StatusTone.OFF) state.listening -> StatusLine("Listening…", StatusTone.BUSY) else -> StatusLine(state.foreground?.title ?: "Launcher", StatusTone.GOOD) } diff --git a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/RemoteScreen.kt b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/RemoteScreen.kt index 66a709e2..f836832f 100644 --- a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/RemoteScreen.kt +++ b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/RemoteScreen.kt @@ -1,15 +1,18 @@ package com.faceclaw.wear.ui -import androidx.compose.foundation.Canvas +import android.text.format.DateFormat +import androidx.compose.animation.AnimatedVisibility +import androidx.compose.animation.fadeIn +import androidx.compose.animation.fadeOut +import androidx.compose.animation.slideInVertically +import androidx.compose.animation.slideOutVertically import androidx.compose.foundation.layout.Arrangement import androidx.compose.foundation.layout.Box -import androidx.compose.foundation.layout.BoxWithConstraints -import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.Row -import androidx.compose.foundation.layout.Spacer import androidx.compose.foundation.layout.fillMaxSize import androidx.compose.foundation.layout.fillMaxWidth import androidx.compose.foundation.layout.height +import androidx.compose.foundation.layout.offset import androidx.compose.foundation.layout.padding import androidx.compose.foundation.layout.size import androidx.compose.foundation.focusable @@ -24,18 +27,18 @@ import androidx.compose.runtime.setValue import androidx.compose.ui.Alignment import androidx.compose.ui.Modifier import androidx.compose.ui.focus.focusRequester -import androidx.compose.ui.geometry.Offset -import androidx.compose.ui.graphics.Color -import androidx.compose.ui.graphics.drawscope.Stroke import androidx.compose.ui.input.pointer.pointerInput import androidx.compose.ui.input.rotary.onRotaryScrollEvent import androidx.compose.ui.layout.onSizeChanged +import androidx.compose.ui.platform.LocalContext +import androidx.compose.ui.platform.LocalDensity import androidx.compose.ui.platform.LocalView import androidx.compose.ui.res.painterResource import androidx.compose.ui.res.stringResource import androidx.compose.ui.text.style.TextAlign import androidx.compose.ui.text.style.TextOverflow import androidx.compose.ui.unit.dp +import androidx.compose.ui.unit.sp import androidx.lifecycle.Lifecycle import androidx.lifecycle.LifecycleEventObserver import androidx.lifecycle.compose.LocalLifecycleOwner @@ -47,7 +50,6 @@ import androidx.wear.compose.material.ButtonDefaults import androidx.wear.compose.material.Icon import androidx.wear.compose.material.MaterialTheme import androidx.wear.compose.material.Text -import androidx.wear.compose.material.TimeText import com.faceclaw.wear.Command import com.faceclaw.wear.FingerTapDetector import com.faceclaw.wear.Gesture @@ -59,20 +61,15 @@ import com.faceclaw.wear.R import com.faceclaw.wear.SwipeAction import com.faceclaw.wear.WristTwistDetector import kotlinx.coroutines.delay +import java.text.SimpleDateFormat +import java.util.Date +import java.util.Locale import kotlin.math.abs -private const val MAX_SWIPE_STEPS = 4 /** A two-finger swipe scrolls this many steps: a "page". */ private const val TWO_FINGER_SWIPE_STEPS = 3 -private const val FLASH_MS = 160L -private const val ARROW_LIT_MS = 220L -private const val RING_RADIUS_FRACTION = 0.33f -private const val RING_CENTER_Y_FRACTION = 0.47f -private val ARROW_INSET = 6.dp -private val ARROW_SIZE = 18.dp - -/** The d-pad directions, for lighting the arrow that was just swiped. */ -enum class Arrow { UP, DOWN, LEFT, RIGHT } +private val EDGE_REVEAL_ZONE = 24.dp +private val BUTTON_TRAY_HEIGHT = 62.dp /** * The touchpad. The whole screen is the pad: tap = select, double-tap = @@ -80,8 +77,8 @@ enum class Arrow { UP, DOWN, LEFT, RIGHT } * the hold menu ("right click"), swipes in four directions = spatial * navigation (crown and two-finger vertical swipes = plain scrolling, a page * at a time for the latter). Fingertip pinch-taps from the motion sensors - * select / go back, and two quick wrist twists go back. The small buttons at - * the bottom reach the rest. + * select / go back, and two quick wrist twists go back. An upward swipe that + * begins at the bottom edge reveals the otherwise-hidden action buttons. */ // rememberActiveFocusRequester (rotary focus) is still experimental in Wear Compose 1.4. @OptIn(ExperimentalWearFoundationApi::class) @@ -98,14 +95,13 @@ fun RemoteScreen( val linkStatus by link.link.collectAsStateWithLifecycle() val notice by link.notice.collectAsStateWithLifecycle() val currentPrefs by rememberUpdatedState(prefs) + val currentState by rememberUpdatedState(state) val view = LocalView.current - var holding by remember { mutableStateOf(false) } - // Brief ring highlight acknowledging a sensor (tip-tap) gesture. - var flashUntil by remember { mutableStateOf(0L) } - var flashing by remember { mutableStateOf(false) } - // Which d-pad arrow lights up for the swipe just sent. - var litArrow by remember { mutableStateOf(null) } - var litTick by remember { mutableStateOf(0L) } + val density = LocalDensity.current + val edgeRevealPx = remember(density) { with(density) { EDGE_REVEAL_ZONE.toPx() } } + val buttonTrayHeightPx = remember(density) { with(density) { BUTTON_TRAY_HEIGHT.toPx() } } + var controlsVisible by remember { mutableStateOf(false) } + var longPressSent by remember { mutableStateOf(false) } // Rotary (crown) events are only delivered to a focused node. // rememberActiveFocusRequester requests focus through the hierarchical // focus machinery; the resume observer below takes it back after every @@ -130,17 +126,19 @@ fun RemoteScreen( onUnavailable = { haptics.error() }, ) + fun glassesScreenIsOff(): Boolean = currentState?.connected == true && currentState?.screenOn == false + + fun gestureAllowed(gesture: Gesture): Boolean = + !glassesScreenIsOff() || gesture == Gesture.DOUBLE_CLICK + fun scroll(gesture: Gesture, steps: Int) { + if (!gestureAllowed(gesture)) return haptics.tick() link.sendGesture(gesture, steps) } - fun light(arrow: Arrow) { - litArrow = arrow - litTick = System.currentTimeMillis() - } - fun click() { + if (!gestureAllowed(Gesture.CLICK)) return haptics.click() link.sendGesture(Gesture.CLICK) } @@ -153,12 +151,18 @@ fun RemoteScreen( /** Run a horizontal-swipe action; `left` says which way the finger went. */ fun perform(action: SwipeAction, left: Boolean) { when (action) { - SwipeAction.NAVIGATE -> { haptics.click(); link.sendGesture(if (left) Gesture.SWIPE_LEFT else Gesture.SWIPE_RIGHT) } - SwipeAction.SIDEBAR -> { haptics.click(); link.sendCommand(Command.SIDEBAR) } + SwipeAction.NAVIGATE -> { + val gesture = if (left) Gesture.SWIPE_LEFT else Gesture.SWIPE_RIGHT + if (gestureAllowed(gesture)) { haptics.click(); link.sendGesture(gesture) } + } + SwipeAction.SIDEBAR -> if (!glassesScreenIsOff()) { + haptics.click() + link.sendCommand(Command.SIDEBAR, "source" to "gesture") + } SwipeAction.DOUBLE_CLICK -> doubleClick() SwipeAction.CLICK -> click() - SwipeAction.LONG_PRESS -> { haptics.heavy(); link.sendGesture(Gesture.LONG_PRESS) } - SwipeAction.WAKEWORD -> { haptics.click(); link.sendGesture(Gesture.WAKEWORD) } + SwipeAction.LONG_PRESS -> if (!glassesScreenIsOff()) { haptics.heavy(); link.sendGesture(Gesture.LONG_PRESS) } + SwipeAction.WAKEWORD -> if (!glassesScreenIsOff()) { haptics.click(); link.sendGesture(Gesture.WAKEWORD) } SwipeAction.NONE -> Unit } } @@ -196,28 +200,41 @@ fun RemoteScreen( } }, onLongPressStart = { - holding = true - haptics.heavy() - link.sendGesture(Gesture.LONG_PRESS_START) + longPressSent = !glassesScreenIsOff() + if (longPressSent) { + haptics.heavy() + link.sendGesture(Gesture.LONG_PRESS_START) + } }, onLongPressEnd = { - holding = false - haptics.click() - link.sendGesture(Gesture.LONG_PRESS_RELEASE) + if (longPressSent) { + longPressSent = false + haptics.click() + link.sendGesture(Gesture.LONG_PRESS_RELEASE) + } }, - onSwipe = { dx, dy, _ -> - if (abs(dy) >= abs(dx)) { - // One step per swipe, regardless of length: the glasses - // repaint per step, and multi-step swipes overshot lists - // whenever the display lagged the finger. Fast repeated - // swiping, the crown, or a two-finger page swipe cover - // long distances instead. - val up = swipeIsUp(dy) - light(if (up) Arrow.UP else Arrow.DOWN) - scroll(if (up) Gesture.SWIPE_UP else Gesture.SWIPE_DOWN, 1) - } else { - light(if (dx < 0) Arrow.LEFT else Arrow.RIGHT) - perform(if (dx < 0) currentPrefs.swipeLeft else currentPrefs.swipeRight, left = dx < 0) + onSwipe = { start, dx, dy, _ -> + val vertical = abs(dy) >= abs(dx) + val padBottom = padHeight[0] + when { + vertical && !controlsVisible && dy < 0 && start.y >= padBottom - edgeRevealPx -> { + controlsVisible = true + haptics.click() + } + vertical && controlsVisible && dy > 0 && start.y >= padBottom - buttonTrayHeightPx -> { + controlsVisible = false + haptics.click() + } + vertical -> { + // One step per swipe, regardless of length: the glasses + // repaint per step, and multi-step swipes overshot lists + // whenever the display lagged the finger. Fast repeated + // swiping, the crown, or a two-finger page swipe cover + // long distances instead. + val up = swipeIsUp(dy) + scroll(if (up) Gesture.SWIPE_UP else Gesture.SWIPE_DOWN, 1) + } + else -> perform(if (dx < 0) currentPrefs.swipeLeft else currentPrefs.swipeRight, left = dx < 0) } }, ) @@ -235,8 +252,8 @@ fun RemoteScreen( sensitivity = { currentPrefs.tapSensitivity }, quietUntil = { haptics.quietUntil() }, onBody = { onBody.onBody }, - onTap = { flashUntil = System.currentTimeMillis() + FLASH_MS; click() }, - onDoubleTap = { flashUntil = System.currentTimeMillis() + FLASH_MS; doubleClick() }, + onTap = { click() }, + onDoubleTap = { doubleClick() }, ) } WhileStartedEffect(fingerTapDetector, start = { fingerTapDetector?.start() }, stop = { fingerTapDetector?.stop() }) @@ -248,21 +265,10 @@ fun RemoteScreen( sensitivity = { currentPrefs.twistSensitivity }, quietUntil = { haptics.quietUntil() }, onBody = { onBody.onBody }, - onDoubleTwist = { flashUntil = System.currentTimeMillis() + FLASH_MS; doubleClick() }, + onDoubleTwist = { doubleClick() }, ) } WhileStartedEffect(wristTwistDetector, start = { wristTwistDetector?.start() }, stop = { wristTwistDetector?.stop() }) - LaunchedEffect(litTick) { - if (litTick == 0L) return@LaunchedEffect - delay(ARROW_LIT_MS) - litArrow = null - } - LaunchedEffect(flashUntil) { - if (flashUntil == 0L) return@LaunchedEffect - flashing = true - delay((flashUntil - System.currentTimeMillis()).coerceAtLeast(1L)) - flashing = false - } // A refused or unanswered gesture gets a distinct buzz, so the wrist knows // without looking (the notice pill says why). @@ -275,15 +281,16 @@ fun RemoteScreen( modifier = Modifier .fillMaxSize() .onRotaryScrollEvent { event -> - // Clockwise (positive) scrolls down, as in every Wear list. crownAccumulator += event.verticalScrollPixels val threshold = currentPrefs.crownSensitivity.pixelsPerStep var steps = 0 while (crownAccumulator >= threshold) { crownAccumulator -= threshold; steps++ } while (crownAccumulator <= -threshold) { crownAccumulator += threshold; steps-- } // Capped low: a fast twirl otherwise outruns the display. - if (steps > 0) { light(Arrow.DOWN); scroll(Gesture.SCROLL_DOWN, steps.coerceAtMost(2)) } - if (steps < 0) { light(Arrow.UP); scroll(Gesture.SCROLL_UP, (-steps).coerceAtMost(2)) } + val clockwise = if (currentState?.crownClockwiseNext == true) Gesture.SCROLL_DOWN else Gesture.SCROLL_UP + val counterClockwise = if (currentState?.crownClockwiseNext == true) Gesture.SCROLL_UP else Gesture.SCROLL_DOWN + if (steps > 0) scroll(clockwise, steps.coerceAtMost(2)) + if (steps < 0) scroll(counterClockwise, (-steps).coerceAtMost(2)) true } .focusRequester(focusRequester) @@ -291,68 +298,47 @@ fun RemoteScreen( .onSizeChanged { padHeight[0] = it.height.toFloat() } .pointerInput(callbacks) { detectTouchpadGestures(callbacks) }, ) { - // The pad: a ring with a d-pad arrow at each compass point (the one - // you swiped lights up), the current glasses app in the middle, and - // the tap legend under it. Brightens while a hold is in progress. - BoxWithConstraints(modifier = Modifier.fillMaxSize()) { - val ringRadius = minOf(maxWidth, maxHeight) * RING_RADIUS_FRACTION - val ringCenterY = maxHeight * RING_CENTER_Y_FRACTION - val ringColor = if (holding || flashing) MaterialTheme.colors.primary else Color(0xFF2E2E2E) - Canvas(modifier = Modifier.fillMaxSize()) { - drawCircle( - color = ringColor, - radius = ringRadius.toPx(), - center = Offset(size.width / 2f, ringCenterY.toPx()), - style = Stroke(width = if (holding || flashing) 4f else 2f), - ) - } + StraightTime(modifier = Modifier.align(Alignment.Center)) - TimeText() - - ArrowGlyph("▲", litArrow == Arrow.UP, Modifier.align(Alignment.TopCenter).padding(top = ringCenterY - ringRadius + ARROW_INSET)) - ArrowGlyph("▼", litArrow == Arrow.DOWN, Modifier.align(Alignment.TopCenter).padding(top = ringCenterY + ringRadius - ARROW_INSET - ARROW_SIZE)) - ArrowGlyph("◀", litArrow == Arrow.LEFT, Modifier.align(Alignment.TopStart).padding(start = maxWidth / 2 - ringRadius + ARROW_INSET, top = ringCenterY - ARROW_SIZE / 2)) - ArrowGlyph("▶", litArrow == Arrow.RIGHT, Modifier.align(Alignment.TopEnd).padding(end = maxWidth / 2 - ringRadius + ARROW_INSET, top = ringCenterY - ARROW_SIZE / 2)) - - // The single status indicator: what the next gesture lands on (the - // app on the glasses, or the screen/lock state in the way of it), - // or the connection problem to fix first. Above the centre line; - // the tap legend below it, clear of the side arrows. + AnimatedVisibility( + visible = !controlsVisible, + enter = fadeIn(), + exit = fadeOut(), + modifier = Modifier.align(Alignment.Center).offset(y = 46.dp), + ) { val pad = padLine(state, linkStatus) Text( - text = if (holding) "holding" else pad.text, + text = pad.text, style = MaterialTheme.typography.title3, - color = when { - holding -> MaterialTheme.colors.primary - pad.tone == StatusTone.GOOD -> MaterialTheme.colors.onSurface - else -> pad.tone.color() - }, + color = if (pad.tone == StatusTone.GOOD) MaterialTheme.colors.onSurface else pad.tone.color(), textAlign = TextAlign.Center, maxLines = 1, overflow = TextOverflow.Ellipsis, - modifier = Modifier - .align(Alignment.TopCenter) - .padding(top = ringCenterY - 44.dp, start = 60.dp, end = 60.dp), - ) - Text( - text = if (prefs.tapZones) "▲▼ tap zones · ● select" else "● select ●● back ‒ menu", - style = MaterialTheme.typography.caption3, - color = MaterialTheme.colors.onSurfaceVariant, - textAlign = TextAlign.Center, - maxLines = 1, - modifier = Modifier - .align(Alignment.TopCenter) - .padding(top = ringCenterY + 18.dp, start = 56.dp, end = 56.dp), + modifier = Modifier.padding(horizontal = 42.dp), ) + } + AnimatedVisibility( + visible = controlsVisible, + enter = slideInVertically(initialOffsetY = { it }), + exit = slideOutVertically(targetOffsetY = { it }), + modifier = Modifier.align(Alignment.BottomCenter), + ) { Row( // Four 36dp buttons need 144dp; at this height the round // display's chord is ~186dp wide, so 36dp margins keep every // button inside the glass. modifier = Modifier - .align(Alignment.BottomCenter) .fillMaxWidth() - .padding(horizontal = 36.dp, vertical = 26.dp), + .height(BUTTON_TRAY_HEIGHT) + .pointerInput(Unit) { + detectTrayDismiss { + controlsVisible = false + haptics.click() + } + } + .padding(horizontal = 36.dp) + .padding(bottom = 26.dp), horizontalArrangement = Arrangement.SpaceBetween, verticalAlignment = Alignment.CenterVertically, ) { @@ -393,14 +379,27 @@ private fun WhileStartedEffect(key: Any?, start: () -> Unit, stop: () -> Unit) { } } +/** A large, straight clock fixed on the vertical centre of the touchpad. */ @Composable -private fun ArrowGlyph(glyph: String, lit: Boolean, modifier: Modifier) { +private fun StraightTime(modifier: Modifier = Modifier) { + val context = LocalContext.current + var now by remember { mutableStateOf(System.currentTimeMillis()) } + val pattern = remember(context) { if (DateFormat.is24HourFormat(context)) "HH:mm" else "h:mm" } + val formatter = remember(pattern) { SimpleDateFormat(pattern, Locale.getDefault()) } + LaunchedEffect(Unit) { + while (true) { + val current = System.currentTimeMillis() + now = current + delay(60_000L - current % 60_000L) + } + } Text( - text = glyph, - style = MaterialTheme.typography.caption1, - color = if (lit) MaterialTheme.colors.primary else Color(0xFF6E6E6E), + text = formatter.format(Date(now)), + color = MaterialTheme.colors.onSurface, + fontSize = 42.sp, textAlign = TextAlign.Center, - modifier = modifier.size(ARROW_SIZE), + maxLines = 1, + modifier = modifier, ) } diff --git a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/TouchpadGestures.kt b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/TouchpadGestures.kt index 1dee96cc..3698af99 100644 --- a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/TouchpadGestures.kt +++ b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/TouchpadGestures.kt @@ -4,8 +4,10 @@ import androidx.compose.foundation.gestures.awaitEachGesture import androidx.compose.foundation.gestures.awaitFirstDown import androidx.compose.foundation.gestures.waitForUpOrCancellation import androidx.compose.ui.geometry.Offset +import androidx.compose.ui.input.pointer.PointerEventPass import androidx.compose.ui.input.pointer.PointerInputScope import androidx.compose.ui.input.pointer.positionChanged +import kotlin.math.abs /** What the remote's touch surface can report. */ class TouchpadCallbacks( @@ -17,7 +19,7 @@ class TouchpadCallbacks( val onLongPressStart: () -> Unit, val onLongPressEnd: () -> Unit, /** Finger travelled past touch slop; dx/dy are the total displacement. */ - val onSwipe: (dx: Float, dy: Float, durationMs: Long) -> Unit, + val onSwipe: (start: Offset, dx: Float, dy: Float, durationMs: Long) -> Unit, ) /** @@ -86,7 +88,7 @@ suspend fun PointerInputScope.detectTouchpadGestures(callbacks: TouchpadCallback callbacks.onLongPressEnd() } maxPointers >= 2 -> if (moved) callbacks.onTwoFingerSwipe(displacement.x, displacement.y) else callbacks.onTwoFingerTap() - moved -> callbacks.onSwipe(displacement.x, displacement.y, duration) + moved -> callbacks.onSwipe(down.position, displacement.x, displacement.y, duration) else -> { // A plain tap; give a second tap a chance to make it a double. val second = withTimeoutOrNull(doubleTapTimeout) { awaitFirstDown() } @@ -108,6 +110,30 @@ suspend fun PointerInputScope.detectTouchpadGestures(callbacks: TouchpadCallback } } +/** + * Observe the button tray before its child buttons consume a pointer. A + * downward drag claims the gesture and dismisses the tray; a tap remains + * untouched so the button below receives its normal click. + */ +suspend fun PointerInputScope.detectTrayDismiss(onDismiss: () -> Unit) { + val slop = viewConfiguration.touchSlop + awaitEachGesture { + val down = awaitFirstDown(requireUnconsumed = false, pass = PointerEventPass.Initial) + var dismissed = false + while (true) { + val event = awaitPointerEvent(PointerEventPass.Initial) + val primary = event.changes.firstOrNull { it.id == down.id } ?: event.changes.first() + val displacement = primary.position - down.position + if (!dismissed && displacement.y > slop && displacement.y >= abs(displacement.x)) { + dismissed = true + onDismiss() + } + if (dismissed) event.changes.forEach { it.consume() } + if (event.changes.none { it.pressed }) break + } + } +} + /** Poll interval while a hold or drag is in progress (no timeout semantics needed). */ private const val HOLD_POLL_MS = 60_000L From ed8302bc6bedd381967ae45ec9efe025b726022b Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 28 Aug 2026 11:56:31 -0700 Subject: [PATCH 02/10] Refactor build scripts --- .gitignore | 4 ++-- CLAUDE.md | 31 +++++++++++++++----------- build.sh | 5 +++++ build_and_run.sh | 7 ++++++ build_paths.sh.template | 9 ++++++++ build_wear.sh | 5 +++++ scripts/release.sh | 48 ++++++++++++++++++++++++++++++----------- 7 files changed, 81 insertions(+), 28 deletions(-) create mode 100755 build.sh create mode 100755 build_and_run.sh create mode 100644 build_paths.sh.template create mode 100755 build_wear.sh diff --git a/.gitignore b/.gitignore index dc56b331..5f98a77a 100644 --- a/.gitignore +++ b/.gitignore @@ -41,5 +41,5 @@ old faceclaw_settings.xml # Developer configs -build.sh -build_and_run.sh +build_paths.sh + diff --git a/CLAUDE.md b/CLAUDE.md index 6433edb7..3ef2a977 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,20 +8,19 @@ Typescript parts are in app/. Java parts are in App_Resources/Android/src/main/j wear/ is a separate Gradle project (Kotlin + Compose for Wear OS): the watch remote that drives Faceclaw over the Wearable Data Layer. Its phone-side counterparts are FaceclawWearBridge.java, app/native/wear-bridge.ts and -app/g2/wear-remote.ts; the message format is in wear/PROTOCOL.md. Build it -with `cd wear && ./gradlew :app:assembleDebug` (needs JAVA_HOME and -ANDROID_HOME); it is not part of `npm run build`. +app/g2/wear-remote.ts; the message format is in wear/PROTOCOL.md. -If build.sh exists, it's a machine-specific wrapper that sets some environment -variables to point to where tools are installed, then runs `npm run build`. -If build_and_run.sh exists, it does everything build.sh does plus - `nativescript run android --device --justlaunch`, -which will launch the app on the developer's phone if it is plugged in and has -adb enabled. If no phone is connected, it will still build but the install step -will fail and the output will contain the string "Cannot find connected -devices." To lint and typecheck, prefer to use build.sh; if the user asks you -to run or test the app, use build_and_run.sh and then use `adb logcat` to view -the results. +`build.sh` and `build_wear.sh` build the Android and Wear OS apps respectively. +`build_and_run.sh` builds the Android app then also installs it on a phone +paired with `adb`. Building may require configuring environment variables +(JAVA_HOME, ANDROID_HOME, PATH, ANDROID_KEYSTORE, ANDROID_KEYSTORE) to point at +relevant tools and an Android device ID to install on; do this in +build_paths.sh, which is created from build_paths.sh.template and not checked +into git. + +To lint and typecheck, prefer to use build.sh; if the user asks you to run or +test the app, use build_and_run.sh and then use `adb logcat` to view the +results. If you are working on low-level communication bits, consider checking out https://github.com/Commute773/g2-kit-unofficial/ and referring to ble/docs/ @@ -30,4 +29,10 @@ well as some communication test scripts and documentation of caveats that come up when communicating with the headset. There may already be an existing local checkout above this workspace at ../g2-kit-unofficial. +This Android app uses a modded firmware for the G2 smart glasses. Source code +to the corresponding firmware modifications lives in +https://github.com/jimrandomh/g2flash; there is a compiled version of the +firmware patch-set in app/g2/firmware/cfw-patches.ts. Strongly prefer making +changes to the Android app over making changes to changes to the firmware, as +firmware development is considerably more fraught. diff --git a/build.sh b/build.sh new file mode 100755 index 00000000..bfb8d3ad --- /dev/null +++ b/build.sh @@ -0,0 +1,5 @@ +#!/bin/bash +cd "$(dirname "$0")"; source scripts/before_build.sh + +npx nativescript build android "$@" + diff --git a/build_and_run.sh b/build_and_run.sh new file mode 100755 index 00000000..67c7e0a3 --- /dev/null +++ b/build_and_run.sh @@ -0,0 +1,7 @@ +#!/bin/bash +cd "$(dirname "$0")"; source scripts/before_build.sh + +npx nativescript build android "$@" && \ + adb connect "$DEVICE_ID" >/dev/null && \ + nativescript run android --device "$DEVICE_ID" --justlaunch + diff --git a/build_paths.sh.template b/build_paths.sh.template new file mode 100644 index 00000000..991937b3 --- /dev/null +++ b/build_paths.sh.template @@ -0,0 +1,9 @@ +# Copy this file to build_paths.sh and add any paths or other prelude needed +# before build. Other build scripts will `source` it. + +#export JAVA_HOME= +#export ANDROID_HOME= +#export PATH= +#export ANDROID_KEYSTORE= +#export DEVICE_ID= + diff --git a/build_wear.sh b/build_wear.sh new file mode 100755 index 00000000..6df4e785 --- /dev/null +++ b/build_wear.sh @@ -0,0 +1,5 @@ +#!/bin/bash +cd "$(dirname "$0")"; source scripts/before_build.sh + +cd wear && ./gradlew build "$@" + diff --git a/scripts/release.sh b/scripts/release.sh index dc68483f..471ff59b 100755 --- a/scripts/release.sh +++ b/scripts/release.sh @@ -1,20 +1,24 @@ #!/bin/bash -# Build a signed release APK at dist/Faceclaw-.apk, where -# comes from FACECLAW_VERSION in app/version.ts. +# Build signed release APKs at dist/Faceclaw-.apk (phone) and +# dist/Faceclaw-Wear-.apk (watch), where comes from +# FACECLAW_VERSION in app/version.ts. Both are signed with the same key: +# the Wearable Data Layer only routes between apps with matching package +# names and signing keys. # # Prompts for the keystore passphrase. Override the keystore location with # ANDROID_KEYSTORE=/path/to/store.jks. # -# Note: the passphrase is passed to the nativescript CLI on its command line, -# so it is briefly visible in `ps` on this machine while the build runs. +# Note: the passphrase is passed to the nativescript CLI and Gradle on their +# command lines, so it is briefly visible in `ps` on this machine while the +# build runs. set -euo pipefail ROOT="$(cd "$(dirname "$0")/.." && pwd)" cd "$ROOT" +source scripts/before_build.sh -KEYSTORE="${ANDROID_KEYSTORE:-$HOME/repositories/AndroidKeystore/jimrandomh-android-keystore.jks}" -if [ ! -f "$KEYSTORE" ]; then - echo "Keystore not found: $KEYSTORE (set ANDROID_KEYSTORE to override)" >&2 +if [ ! -f "$ANDROID_KEYSTORE" ]; then + echo "Keystore not found: $ANDROID_KEYSTORE (set ANDROID_KEYSTORE in build_paths.sh)" >&2 exit 1 fi @@ -34,17 +38,17 @@ if [ -z "$VERSION" ]; then exit 1 fi -read -r -s -p "Keystore passphrase for $(basename "$KEYSTORE"): " STORE_PASS +read -r -s -p "Keystore passphrase for $(basename "$ANDROID_KEYSTORE"): " STORE_PASS echo # Validate the passphrase up front and discover the signing-key alias. -if ! LISTING="$(keytool -list -keystore "$KEYSTORE" -storepass "$STORE_PASS" 2>&1)"; then +if ! LISTING="$(keytool -list -keystore "$ANDROID_KEYSTORE" -storepass "$STORE_PASS" 2>&1)"; then printf '%s\n' "$LISTING" >&2 exit 1 fi ALIAS="$(printf '%s\n' "$LISTING" | awk -F', ' '/PrivateKeyEntry/{print $1; exit}')" if [ -z "$ALIAS" ]; then - echo "No private-key entry found in $KEYSTORE:" >&2 + echo "No private-key entry found in $ANDROID_KEYSTORE:" >&2 printf '%s\n' "$LISTING" >&2 exit 1 fi @@ -55,19 +59,37 @@ echo KEY_PASS="${KEY_PASS:-$STORE_PASS}" OUT="dist/Faceclaw-$VERSION.apk" +WEAR_OUT="dist/Faceclaw-Wear-$VERSION.apk" mkdir -p dist -rm -f "$OUT" +rm -f "$OUT" "$WEAR_OUT" +echo "=== Building Android app ===" npx nativescript build android --release \ - --key-store-path "$KEYSTORE" \ + --key-store-path "$ANDROID_KEYSTORE" \ --key-store-password "$STORE_PASS" \ --key-store-alias "$ALIAS" \ --key-store-alias-password "$KEY_PASS" \ --copy-to "$OUT" +# Wear app: sign with the same key via AGP's injected signing properties, so +# no signing config needs to live in the wear build files. +echo "=== Building Wear app ===" +(cd wear && ./gradlew :app:assembleRelease \ + -Pandroid.injected.signing.store.file="$ANDROID_KEYSTORE" \ + -Pandroid.injected.signing.store.password="$STORE_PASS" \ + -Pandroid.injected.signing.key.alias="$ALIAS" \ + -Pandroid.injected.signing.key.password="$KEY_PASS") +cp wear/app/build/outputs/apk/release/app-release.apk "$WEAR_OUT" + echo echo "Built $OUT" +echo "Built $WEAR_OUT" if [ -n "${ANDROID_HOME:-}" ] && [ -d "$ANDROID_HOME/build-tools" ]; then APKSIGNER="$(printf '%s\n' "$ANDROID_HOME/build-tools"/*/apksigner | sort -V | tail -1)" - [ -x "$APKSIGNER" ] && "$APKSIGNER" verify --print-certs "$OUT" | head -5 + if [ -x "$APKSIGNER" ]; then + for apk in "$OUT" "$WEAR_OUT"; do + echo "== $apk" + "$APKSIGNER" verify --print-certs "$apk" | head -5 + done + fi fi From 6cd7d5fff9640fd3efdc52fd0e36d8391fb758b7 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 28 Aug 2026 18:36:35 -0700 Subject: [PATCH 03/10] Watch display shows if glasses are charging or silent mode --- app/g2/dashboard-controller.ts | 41 +++++++++++++++---- app/g2/glasses-display-state.ts | 34 +++++++++++++++ app/g2/wear-remote.ts | 7 +++- app/phone-ui/main-view-model.ts | 5 +-- tests/glasses-display-state.test.cjs | 29 +++++++++++++ tests/tsconfig.json | 1 + wear/PROTOCOL.md | 6 ++- .../main/kotlin/com/faceclaw/wear/Protocol.kt | 7 +++- .../kotlin/com/faceclaw/wear/ui/Common.kt | 5 +++ .../com/faceclaw/wear/ui/StatusScreen.kt | 7 +++- 10 files changed, 122 insertions(+), 20 deletions(-) create mode 100644 app/g2/glasses-display-state.ts create mode 100644 tests/glasses-display-state.test.cjs diff --git a/app/g2/dashboard-controller.ts b/app/g2/dashboard-controller.ts index 2ce9de76..66565521 100644 --- a/app/g2/dashboard-controller.ts +++ b/app/g2/dashboard-controller.ts @@ -66,6 +66,7 @@ import { uninstallEvenHubPackage, } from "../apps/evenhub/installed-apps"; import { closeRunningPackage, launchInstalledPackage } from "../apps/evenhub/manager"; +import { glassesDisplayLabel } from "./glasses-display-state"; type ConnectionPhase = "disconnected" | "connecting" | "connected" | "charging" | "disconnecting"; @@ -300,12 +301,13 @@ class DashboardController { requestShellRender: () => this.requestShellRender(), onWindowsChanged: () => { this.persistOpenApps(); - this.wearRemote?.schedulePublish(); + // The foreground title is mirrored on both remote-control faces. + this.emit(); }, onScreenStateChanged: (on) => { this.handleScreenStateChanged(on); if (on) this.requestShellRender(); - this.wearRemote?.schedulePublish(); + this.emit(); }, }); // Boot hooks register windows that exist from startup (the launcher, @@ -353,6 +355,8 @@ class DashboardController { status: this.status, glassesLocked: this.glassesLocked, glassesWorn: this.glassesWorn, + silentMode: this.silentMode, + lastHeadsetBattery: this.lastHeadsetBattery, }), appendLog: (line) => this.appendLog(line), }); @@ -847,12 +851,15 @@ class DashboardController { /** * Message to show in place of the display preview, or "" to show the preview. * - * Both cases look identical to a dead pair of glasses from the phone side: - * silent mode blanks the display and swallows input while the BLE session - * stays up, and a battery that just ran out simply stops answering. + * These states look identical to a dead pair of glasses from the phone side: + * charging and silent mode both make the display unavailable while BLE stays + * up, and a battery that just ran out simply stops answering. */ private displayPreviewMessage(): string { - if (this.silentMode && (this.phase === "connected" || this.phase === "charging")) { + if (this.phase === "charging") { + return this.glassesDisplayLabel(); + } + if (this.silentMode && this.phase === "connected") { return "Connected (Silent mode enabled)"; } const connectionFailing = this.phase === "disconnected" || this.phase === "connecting"; @@ -866,6 +873,17 @@ class DashboardController { return ""; } + /** What occupies the foreground-title line on the watch-style controls. */ + glassesDisplayLabel(): string { + return glassesDisplayLabel({ + phase: this.phase, + silentMode: this.silentMode, + screenOn: shell.isScreenOn(), + battery: this.lastHeadsetBattery, + foregroundTitle: shell.getForegroundApp()?.title ?? null, + }); + } + /** * Re-check the Doze exemption (cheap system call, but cached so snapshot() * stays trivial). Called on connect, page load, and after the user answers @@ -1047,16 +1065,21 @@ class DashboardController { this.handlePhoneLockState(locked); }); this.offBattery = communicator.onBatteryState((state) => { - this.lastHeadsetBattery = state.battery >= 0 ? state.battery : null; + // An unavailable reading must not erase the useful last-known value, + // especially while the glasses remain reachable in their case. + const hasBatteryLevel = Number.isInteger(state.battery) && state.battery >= 0 && state.battery <= 100; + if (hasBatteryLevel) this.lastHeadsetBattery = state.battery; shell.setBatteryLevels({ - headset: state.battery, + headset: hasBatteryLevel ? state.battery : this.lastHeadsetBattery, headsetCharging: state.chargingStatus > 0, }); if ((this.phase === "connected" || this.phase === "charging") && this.communicator) { // Repaint the top bar (battery indicators live in the shell chrome). this.requestShellRender(); } - this.wearRemote?.schedulePublish(); + // Battery belongs in the charging stand-in on the phone as well as in + // the watch state, so refresh both consumers on every report. + this.emit(); }); this.offEvenAppConflict = communicator.onEvenAppConflict((message) => { this.refreshEvenAppStatus(); diff --git a/app/g2/glasses-display-state.ts b/app/g2/glasses-display-state.ts new file mode 100644 index 00000000..88f951ae --- /dev/null +++ b/app/g2/glasses-display-state.ts @@ -0,0 +1,34 @@ +export type GlassesDisplayState = { + phase: string; + silentMode: boolean; + screenOn: boolean; + battery: number | null; + foregroundTitle: string | null; +}; + +/** Compact status shown where the foreground-window title normally lives. */ +export function glassesDisplayLabel(state: GlassesDisplayState): string { + // Charging wins over every session-local state: the glasses are in their + // case, so neither the lock screen nor the foreground window is visible. + if (state.phase === "charging") { + return chargingDisplayLabel(state.battery); + } + if (state.phase !== "connected") { + return "Glasses disconnected"; + } + if (state.silentMode) { + return "Silent mode"; + } + if (!state.screenOn) { + return "Display off"; + } + return state.foregroundTitle || "Launcher"; +} + +export function chargingDisplayLabel(battery: number | null): string { + return validBatteryLevel(battery) ? `Charging · G2 ${battery}%` : "Charging"; +} + +function validBatteryLevel(battery: number | null): battery is number { + return battery !== null && Number.isInteger(battery) && battery >= 0 && battery <= 100; +} diff --git a/app/g2/wear-remote.ts b/app/g2/wear-remote.ts index 99af5c67..d2b7f460 100644 --- a/app/g2/wear-remote.ts +++ b/app/g2/wear-remote.ts @@ -102,6 +102,8 @@ export type WearRemoteHost = { status: string; glassesLocked: boolean; glassesWorn: boolean | null; + silentMode: boolean; + lastHeadsetBattery: number | null; }; appendLog: (line: string) => void; }; @@ -196,8 +198,9 @@ export class WearRemote { locked: state.glassesLocked, worn: state.glassesWorn, listening: voiceActivity.isActive(), - battery: battery.headset, - charging: battery.headsetCharging === true, + battery: state.lastHeadsetBattery, + charging: state.phase === "charging" || battery.headsetCharging === true, + silentMode: state.silentMode, foreground: foreground ? { appId: foreground.appId, title: foreground.title } : null, windows: shell.getWindows().map((window) => ({ windowId: window.windowId, diff --git a/app/phone-ui/main-view-model.ts b/app/phone-ui/main-view-model.ts index eb4beae3..d313362b 100644 --- a/app/phone-ui/main-view-model.ts +++ b/app/phone-ui/main-view-model.ts @@ -766,10 +766,7 @@ export class MainViewModel extends Observable { /** What the next gesture lands on, as the watch pad shows it. */ get padFocusLine(): string { - if (this.phase !== "connected" && this.phase !== "charging") return "Glasses disconnected"; - if (!shell.isScreenOn()) return "Display off"; - const foreground = shell.getForegroundApp(); - return foreground ? foreground.title : "Launcher"; + return dashboardController.glassesDisplayLabel(); } private refreshPadFocusLine(): void { diff --git a/tests/glasses-display-state.test.cjs b/tests/glasses-display-state.test.cjs new file mode 100644 index 00000000..eed75ca9 --- /dev/null +++ b/tests/glasses-display-state.test.cjs @@ -0,0 +1,29 @@ +const test = require("node:test"); +const assert = require("node:assert/strict"); + +const { chargingDisplayLabel, glassesDisplayLabel } = require("../.test-build/app/g2/glasses-display-state.js"); + +const connected = { + phase: "connected", + silentMode: false, + screenOn: true, + battery: 72, + foregroundTitle: "Music", +}; + +test("the foreground-title line covers visible, dark, and silent displays", () => { + assert.equal(glassesDisplayLabel(connected), "Music"); + assert.equal(glassesDisplayLabel({ ...connected, foregroundTitle: null }), "Launcher"); + assert.equal(glassesDisplayLabel({ ...connected, screenOn: false }), "Display off"); + assert.equal(glassesDisplayLabel({ ...connected, screenOn: false, silentMode: true }), "Silent mode"); +}); + +test("charging takes precedence and includes the last-known G2 battery", () => { + assert.equal( + glassesDisplayLabel({ ...connected, phase: "charging", silentMode: true, screenOn: false }), + "Charging · G2 72%", + ); + assert.equal(chargingDisplayLabel(null), "Charging"); + assert.equal(chargingDisplayLabel(-1), "Charging"); + assert.equal(chargingDisplayLabel(101), "Charging"); +}); diff --git a/tests/tsconfig.json b/tests/tsconfig.json index e8c694a6..daaaeded 100644 --- a/tests/tsconfig.json +++ b/tests/tsconfig.json @@ -15,6 +15,7 @@ "../app/g2/ble-proximity.ts", "../app/g2/even-advertisement.ts", "../app/g2/glasses-artwork.ts", + "../app/g2/glasses-display-state.ts", "../app/g2/pairing-candidates.ts" ] } diff --git a/wear/PROTOCOL.md b/wear/PROTOCOL.md index 485c5c9b..a94c2a4e 100644 --- a/wear/PROTOCOL.md +++ b/wear/PROTOCOL.md @@ -49,7 +49,7 @@ dashboard state, re-sent whenever it changes (and at least every 30 s): "protocol": 1, "version": "…", "phase": "connected", "status": "…", "connected": true, "screenOn": true, "locked": false, "worn": true, "listening": false, - "battery": 78, "charging": false, + "battery": 78, "charging": false, "silentMode": false, "foreground": {"appId": "music", "title": "Music"}, "windows": [{"windowId": "…", "title": "…", "appId": "…", "focused": true, "closeable": true, "acceptsText": false}], "apps": [{"appId": "timer", "title": "Timer"}], @@ -60,6 +60,10 @@ dashboard state, re-sent whenever it changes (and at least every 30 s): } ``` +`battery` is the current or last-known G2 percentage. `charging` and +`silentMode` identify the two states in which the glasses display is not +visible even though the BLE session remains available. + `protocol` is reserved for incompatible revisions of this format (nothing checks it yet); `displayMode` mirrors the phone's Display > Display mode and is what the `display-mode` command changes. `crownClockwiseNext` mirrors the diff --git a/wear/app/src/main/kotlin/com/faceclaw/wear/Protocol.kt b/wear/app/src/main/kotlin/com/faceclaw/wear/Protocol.kt index 7221a2ab..f2d0903a 100644 --- a/wear/app/src/main/kotlin/com/faceclaw/wear/Protocol.kt +++ b/wear/app/src/main/kotlin/com/faceclaw/wear/Protocol.kt @@ -100,9 +100,10 @@ data class PhoneState( val listening: Boolean, /** Display mode wire value ("576x288" | "576x480" | "640x480"). */ val displayMode: String, - // The state item also carries "battery"; the watch doesn't show it (the - // glasses' own top bar does), so it is left unparsed. + /** Current or last-known G2 charge percentage. */ + val battery: Int?, val charging: Boolean, + val silentMode: Boolean, val foreground: AppEntry?, val windows: List, val apps: List, @@ -129,7 +130,9 @@ data class PhoneState( worn = if (o.isNull("worn")) null else o.optBoolean("worn"), listening = o.optBoolean("listening", false), displayMode = o.optString("displayMode", "576x288"), + battery = if (o.isNull("battery")) null else o.optInt("battery", -1).takeIf { it in 0..100 }, charging = o.optBoolean("charging", false), + silentMode = o.optBoolean("silentMode", false), foreground = foreground?.let { AppEntry(it.optString("appId", ""), it.optString("title", "")) }, diff --git a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/Common.kt b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/Common.kt index 8dc7b6c9..e571e861 100644 --- a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/Common.kt +++ b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/Common.kt @@ -63,6 +63,8 @@ fun padLine(state: PhoneState?, link: LinkStatus): StatusLine = when { state == null -> StatusLine("Waiting for phone", StatusTone.BUSY) state.remoteEnabled == false -> StatusLine("Watch control off", StatusTone.PROBLEM) state.connected -> when { + state.charging || state.phase == "charging" -> StatusLine(chargingLine(state.battery), StatusTone.BUSY) + state.silentMode -> StatusLine("Silent mode", StatusTone.OFF) state.locked -> StatusLine("Locked", StatusTone.OFF) !state.screenOn -> StatusLine("●● Wake", StatusTone.OFF) state.listening -> StatusLine("Listening…", StatusTone.BUSY) @@ -73,6 +75,9 @@ fun padLine(state: PhoneState?, link: LinkStatus): StatusLine = when { else -> StatusLine("Glasses disconnected", StatusTone.OFF) } +private fun chargingLine(battery: Int?): String = + if (battery != null) "Charging · G2 $battery%" else "Charging" + fun StatusTone.color(): Color = when (this) { StatusTone.GOOD -> Color(0xFF7BD88F) StatusTone.BUSY -> Color(0xFFF2C14E) diff --git a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/StatusScreen.kt b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/StatusScreen.kt index a95fa84d..d34f659c 100644 --- a/wear/app/src/main/kotlin/com/faceclaw/wear/ui/StatusScreen.kt +++ b/wear/app/src/main/kotlin/com/faceclaw/wear/ui/StatusScreen.kt @@ -42,10 +42,13 @@ fun StatusScreen(link: PhoneLink, haptics: Haptics, onOpenSettings: () -> Unit) ScalingLazyColumn(state = listState, modifier = Modifier.fillMaxSize()) { item { ListHeader { Text("Glasses") } } item { - // No battery figure here: the glasses' own top bar shows it. + // Ordinarily the glasses' own top bar shows battery. While + // charging that screen is inside the case, so show it here. val phaseLabel = when { state == null -> "No status yet" - connected -> "Connected" + if (state?.charging == true) " · charging" else "" + state?.charging == true || state?.phase == "charging" -> + state?.battery?.let { "Charging · G2 $it%" } ?: "Charging" + connected -> "Connected" state?.phase == "connecting" -> "Connecting…" state?.phase == "disconnecting" -> "Disconnecting…" else -> "Disconnected" From fe28a6de4b6b7a5e506256c07c715117a9ffb7d6 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Fri, 28 Aug 2026 21:23:22 -0700 Subject: [PATCH 04/10] Add missing scripts/before_build.sh --- scripts/before_build.sh | 7 +++++++ 1 file changed, 7 insertions(+) create mode 100644 scripts/before_build.sh diff --git a/scripts/before_build.sh b/scripts/before_build.sh new file mode 100644 index 00000000..9a1c34f0 --- /dev/null +++ b/scripts/before_build.sh @@ -0,0 +1,7 @@ + +if [ -f build_paths.sh ]; then + source ./build_paths.sh +else + cp build_paths.sh.template build_paths.sh +fi + From 756ee4e63b51044a02f5532489125ae57df53a5a Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 29 Aug 2026 10:16:52 -0700 Subject: [PATCH 05/10] Fix mic drop issues MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit
Prompts Used Investigate and fix the bug in https://github.com/jimrandomh/faceclaw/issues/18 > Fixed. Here's what was going on and what changed. > > ## Root cause > > The issue's diagnosis was right, and the underlying flaw is a bit broader than the holder set: **`captureHolders` is phone-side bookkeeping, but the mic enable lives in the glasses' EvenHub session.** That enable dies — silently, from the phone's point of view — on a transport drop, the charging case, an EvenHub screen-off suspend, or a refused enable (`startG2AudioCapture` returns false when the display path isn't warm, and the Java worker then exits while the JS side still believes it started). > > `acquireCapture()` answered "is the mic running?" from the holder set, so a single stranded holder (a Transcribe window that was open when the link dropped) made every later request — wakeword assistant included — return early onto a stream that no longer existed, for the life of the process. > > The reported repro hits it via `resumeEvenHubSession()`, which resets `audioCaptureActive` and replays the prelude without re-enabling the mic; nothing on either side cleaned up. > > ## The fix > > **Java** — expose the real state of the stream instead of inferring it: > - `FaceclawBleCommunicator.isAudioCaptureActive()` (`App_Resources/.../FaceclawBleCommunicator.java:363`) — true only while the session is up, not shut down, and the enable has been acked. Every teardown path already clears that flag. > - `FaceclawVoiceController.isCapturing()` — `started` plus the communicator's view, with a lock-guarded `audioStarted` so the mic-warmup window doesn't read as dead. > > **`app/native/voice-control.ts`** — the bridge now asks `micIsLive()` rather than trusting the set, and tears a dead capture down before starting a new one. Added `handleSessionEnded()` (parks live holders, drops the local state) and `resumeCapture()` (restarts them on the next session); `releaseCapture`/`stop` clear the parked set. The raw-PCM tap for EvenHub mic apps had the identical staleness bug (`if (this.rawActive) return true`) and is covered the same way. > > **`app/g2/dashboard-controller.ts`** — wired the two session boundaries: any phase leaving `connected` parks the capture, and the first composited frame of the next session resumes it (a rendered frame is exactly the signal that a mic enable will be accepted). The screen-off EvenHub suspend is now deferred while a capture is held, so the screen timeout no longer kills a live transcription; a capture that races the suspend is parked by the same path. > > So Transcribe recovers on its own after a reconnect instead of sitting on a dead "Listening…", and the wakeword assistant is no longer blocked by anything left behind. > > ## Verification > > `./build.sh` (Java + webpack) clean, `tsc --noEmit` clean, `npm test` 61/61. Not committed. > > The behavior is all glasses-session state, which the test harness (pure modules only) can't reach, so it needs hardware. I wrote `notes/voice-capture-session-resume.md` with the five checks that matter — most importantly: Transcribe open → walk out of range → return → "Hey Even" should now get audio, and Transcribe should resume itself.
--- .../faceclaw/app/FaceclawBleCommunicator.java | 13 +++ .../faceclaw/app/FaceclawVoiceController.java | 32 ++++++ app/g2/dashboard-controller.ts | 55 ++++++++-- app/native/voice-control.ts | 103 +++++++++++++++++- 4 files changed, 188 insertions(+), 15 deletions(-) diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java index e2f26a64..927d202b 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawBleCommunicator.java @@ -360,6 +360,19 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable { } } + /** + * Whether the glasses mic is enabled right now. The enable lives in the + * current EvenHub session, so it dies with a transport drop, the charging + * case, or a suspend — silently, from the phone's point of view. Callers + * that track a capture across those events must check this rather than + * assume their earlier enable still holds. + */ + public boolean isAudioCaptureActive() { + synchronized (lock) { + return running && sessionReady && !shutdownRequested && audioCaptureActive; + } + } + /** * Acquire/renew or release CFW's volatile wake-takeover lease on both * arms. Delivery (not a protocol ACK) is awaited so a caller can ensure diff --git a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java index e0a75ab3..2bdacece 100644 --- a/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java +++ b/App_Resources/Android/src/main/java/com/faceclaw/app/FaceclawVoiceController.java @@ -76,6 +76,9 @@ public class FaceclawVoiceController { private volatile FaceclawBleCommunicator communicator; private Thread workerThread; private volatile boolean started; + // Set once the worker has the glasses mic enabled for this session. + // Read and written under `lock`, so it flips with `started` atomically. + private boolean audioStarted; private VoiceInputMode mode = VoiceInputMode.CLOUD; private OfflineRecognizer recognizer; private FaceclawLc3Decoder lc3Decoder; @@ -137,11 +140,36 @@ public class FaceclawVoiceController { } mode = parseMode(requestedMode); started = true; + audioStarted = false; workerThread = new Thread(this::runLoop, "FaceclawVoiceController"); workerThread.start(); } } + /** + * Whether mic audio is actually flowing. {@link #start} only records + * intent: the enable lives in the glasses' EvenHub session, so a transport + * drop or a session suspend can leave this controller started with a + * worker that will never see another packet. Anything deciding whether to + * (re)start capture must ask this rather than assume its own bookkeeping. + */ + public boolean isCapturing() { + boolean audioUp; + synchronized (lock) { + if (!started) { + return false; + } + audioUp = audioStarted; + } + if (!audioUp) { + // The worker is still bringing the mic up; report it as running so + // a concurrent request shares it instead of restarting it. + return true; + } + FaceclawBleCommunicator currentCommunicator = communicator; + return currentCommunicator != null && currentCommunicator.isAudioCaptureActive(); + } + public void stop() { Thread threadToJoin; synchronized (lock) { @@ -200,6 +228,9 @@ public class FaceclawVoiceController { emitStatus("Could not start G2 microphone input."); return; } + synchronized (lock) { + audioStarted = true; + } emitStatus(currentMode == VoiceInputMode.CLOUD ? "Listening (cloud)..." @@ -220,6 +251,7 @@ public class FaceclawVoiceController { releaseLc3(); synchronized (lock) { started = false; + audioStarted = false; workerThread = null; } } diff --git a/app/g2/dashboard-controller.ts b/app/g2/dashboard-controller.ts index 66565521..5ba35a8b 100644 --- a/app/g2/dashboard-controller.ts +++ b/app/g2/dashboard-controller.ts @@ -702,6 +702,14 @@ class DashboardController { return; } + if (voiceControlBridge.isCaptureHeld()) { + // Ending the plugin task ends the mic with it, so a live capture (the + // Transcribe window, typically) outranks the screen-off power save. + // Check before the lease refresh below, which costs a BLE message. + this.scheduleEvenHubSuspend(); + return; + } + void (async () => { if (this.faceclawWakeLeaseSupported) { // Refresh immediately before teardown so the first suspended wake @@ -727,6 +735,9 @@ class DashboardController { .then((suspended) => { if (suspended === undefined) return; if (suspended) { + // A capture that raced the suspend lost its mic with the plugin + // task; park it for the resume path. + voiceControlBridge.handleSessionEnded(); this.appendLog("EvenHub session suspended while screen is off"); return; } @@ -1036,6 +1047,10 @@ class DashboardController { // the transport comes back, so do not make lock decisions from a // stale pre-disconnect value in the meantime. this.glassesWorn = null; + // The mic enable was session-scoped too: park any live capture so + // the next session restarts it, instead of leaving a holder that + // makes every later request think the mic is already running. + voiceControlBridge.handleSessionEnded(); } this.setPhase(mappedPhase); this.setStatus(state.status); @@ -1098,6 +1113,10 @@ class DashboardController { this.schedulePreviewUpdate(); if (this.phase === "connected") { this.setStatus("Connected."); + // A rendered frame also means the display path is warm enough for + // the glasses to accept a mic enable, so this is where a capture + // parked by the previous session (or by an EvenHub suspend) resumes. + this.resumeVoiceCapture(); // A rendered frame means the session is warmed up (fixedLayoutCreated), // so the buzzer won't be dropped. Play the one-time welcome sound now. if (this.welcomeSoundArmed) { @@ -1390,7 +1409,7 @@ class DashboardController { // Faceclaw's final BLE message before the transport closes. await mediaControllerBridge.stop().catch(() => {}); await nightscoutBridge.stop().catch(() => {}); - voiceControlBridge.stop(); + voiceControlBridge.handleSessionEnded(); const cleanupAcked = skipFirmwareCleanup ? false @@ -1558,6 +1577,30 @@ class DashboardController { voiceControlBridge.stopContinuousCapture(); } + /** Provider and key settings for a capture on the given connection. */ + private voiceCaptureOptions(communicator: FaceclawCommunicatorBridge) { + return { + communicator: communicator.getNativeCommunicator(), + provider: voiceProviderSetting.get(), + elevenLabsApiKey: elevenLabsApiKeySetting.get(), + openAiApiKey: openAiApiKeySetting.get(), + sonioxApiKey: sonioxApiKeySetting.get(), + saveRecording: saveVoiceRecordingsSetting.get(), + }; + } + + /** + * Restart the mic for a capture that a previous session left holding. Cheap + * to call per frame: it does nothing unless one is actually parked. + */ + private resumeVoiceCapture(): void { + if (!voiceControlBridge.hasSuspendedCapture()) return; + const communicator = this.communicator; + if (!communicator || this.phase !== "connected") return; + this.appendLog("resuming voice capture on the new glasses session"); + voiceControlBridge.resumeCapture(this.voiceCaptureOptions(communicator)); + } + private beginVoiceCapture(kind: "ptt" | "continuous", endpointing = false): void { if (this.phase !== "connected" || !this.communicator) { return; @@ -1566,15 +1609,7 @@ class DashboardController { void ensureVoicePermissions() .then(() => { if (this.phase !== "connected" || this.communicator !== communicator) return; - const options = { - communicator: communicator.getNativeCommunicator(), - provider: voiceProviderSetting.get(), - elevenLabsApiKey: elevenLabsApiKeySetting.get(), - openAiApiKey: openAiApiKeySetting.get(), - sonioxApiKey: sonioxApiKeySetting.get(), - saveRecording: saveVoiceRecordingsSetting.get(), - endpointing, - }; + const options = { ...this.voiceCaptureOptions(communicator), endpointing }; if (kind === "ptt") { voiceControlBridge.startPushToTalk(options); } else { diff --git a/app/native/voice-control.ts b/app/native/voice-control.ts index 121acf09..74aeb812 100644 --- a/app/native/voice-control.ts +++ b/app/native/voice-control.ts @@ -56,6 +56,13 @@ export class FaceclawVoiceControlBridge { // when the last one releases. Transcript events broadcast to every // listener, so push-to-talk and the Transcribe window both receive text. private readonly captureHolders = new Set(); + // Holders whose stream died with the glasses session (transport drop, + // charging case, EvenHub suspend). They still want the mic, so the next + // session restarts it for them; see handleSessionEnded/resumeCapture. + private readonly suspendedHolders = new Set(); + private suspendedRaw = false; + // Endpointing of the live capture, replayed when it is resumed. + private captureEndpointing = false; // Non-null while a cloud provider owns the transcript; Java only decodes PCM. private cloudClient: CloudSttClient | null = null; // Raw-PCM tap (EvenHub mic apps): when active, the controller runs in the @@ -117,8 +124,13 @@ export class FaceclawVoiceControlBridge { */ startRawCapture(options: { communicator: any }): boolean { if (!global.isAndroid) return false; - if (this.rawActive) return true; - if (this.captureHolders.size > 0 || this.started) return false; + if (this.rawActive && this.micIsLive()) return true; + // An STT holder owns the mic even while its stream waits on a new glasses + // session; the tap re-tries when the app's eligibility is re-evaluated. + if (this.captureHolders.size > 0 || this.suspendedHolders.size > 0) return false; + // A tap left over from a dead session is not something to share. + if (this.started || this.rawActive) this.teardownCapture(); + this.suspendedRaw = false; this.ensureController(); this.controller?.setCommunicator(options.communicator); this.controller?.setSaveRecordings(false); @@ -133,6 +145,7 @@ export class FaceclawVoiceControlBridge { } stopRawCapture(): void { + this.suspendedRaw = false; if (!this.rawActive) return; this.rawActive = false; this.started = false; @@ -144,17 +157,26 @@ export class FaceclawVoiceControlBridge { // STT preempts the raw-PCM tap: a live transcription session owns the mic, // and an EvenHub app gets no audio for its duration. if (this.rawActive) this.stopRawCapture(); - const wasIdle = this.captureHolders.size === 0; + // Whether the mic is already running is a question about the stream, not + // about this set: a holder whose capture died with the glasses session + // (or whose mic enable was refused) is still in it. Trusting the set here + // let one stale holder silently swallow every later request for the + // process's lifetime. + const micLive = this.micIsLive(); + this.suspendedHolders.delete(holder); this.captureHolders.add(holder); - if (!wasIdle) { + if (micLive) { // Mic already running; the new holder just shares the existing stream // (transcripts are already broadcast to its listeners). return; } + // Any leftover capture is dead; drop it before starting the new one. + if (this.started) this.teardownCapture(); this.ensureController(); this.controller?.setCommunicator(options.communicator); this.controller?.setSaveRecordings(options.saveRecording); this.controller?.setEndpointing(Boolean(options.endpointing)); + this.captureEndpointing = Boolean(options.endpointing); const cloudClient = this.createCloudClient(options); if (cloudClient) { @@ -209,6 +231,9 @@ export class FaceclawVoiceControlBridge { } private releaseCapture(holder: CaptureHolder, commit: boolean): void { + // A holder that gives up while its capture is parked must not be resumed + // by the next session. + this.suspendedHolders.delete(holder); if (!this.captureHolders.delete(holder)) { // Never held; still finish a dangling cloud commit if one is pending. if (commit) this.cloudClient?.finish(); @@ -236,6 +261,75 @@ export class FaceclawVoiceControlBridge { stop(): void { this.captureHolders.clear(); + this.suspendedHolders.clear(); + this.suspendedRaw = false; + this.teardownCapture(); + this.setStatus("Voice control stopped."); + } + + /** + * The glasses session ended under a live capture (transport drop, charging + * case, EvenHub suspend). Its mic enable did not survive, so drop the local + * capture state — leaving it in place would make the holder set claim a + * stream that no longer exists — and remember who was holding so + * resumeCapture() can bring the mic back on the next session. + */ + handleSessionEnded(): void { + if (this.captureHolders.size === 0 && !this.started && !this.rawActive) return; + for (const holder of this.captureHolders) { + this.suspendedHolders.add(holder); + } + this.captureHolders.clear(); + this.suspendedRaw = this.rawActive; + this.teardownCapture(); + if (this.suspendedHolders.size > 0) { + this.setStatus("Waiting for the glasses..."); + } + } + + /** Whether a capture is parked waiting for a session to come back. */ + hasSuspendedCapture(): boolean { + return this.suspendedHolders.size > 0 || this.suspendedRaw; + } + + /** Whether anyone holds the mic, including across a session outage. */ + isCaptureHeld(): boolean { + return this.captureHolders.size > 0 || this.suspendedHolders.size > 0; + } + + /** + * A fresh glasses session is ready (its display path warmed up, so a mic + * enable will be accepted): restart the mic for every holder that was + * capturing when the last session ended. Mic permission was granted for the + * original capture and cannot be revoked without restarting the process, so + * this does not ask again. + */ + resumeCapture(options: Omit): void { + const holders = Array.from(this.suspendedHolders); + const resumeRaw = this.suspendedRaw; + this.suspendedHolders.clear(); + this.suspendedRaw = false; + for (const holder of holders) { + this.acquireCapture(holder, { ...options, endpointing: this.captureEndpointing }); + } + if (resumeRaw && !holders.length) { + this.startRawCapture({ communicator: options.communicator }); + } + } + + /** + * Whether the glasses mic is actually streaming. The holder set and + * `started` are phone-side bookkeeping; the enable itself lives in the + * glasses session, so the controller (via the communicator) is the only + * authority on whether audio is still flowing. + */ + private micIsLive(): boolean { + if (!global.isAndroid || !this.started) return false; + return Boolean(this.controller?.isCapturing()); + } + + /** Stop the native capture and any cloud client; leaves holders alone. */ + private teardownCapture(): void { this.rawActive = false; if (global.isAndroid) { this.controller?.stop(); @@ -243,7 +337,6 @@ export class FaceclawVoiceControlBridge { this.started = false; this.cloudClient?.stop(); this.cloudClient = null; - this.setStatus("Voice control stopped."); } private ensureController(): void { From 63b7a13df1cbc3137a8e309d03174c7d2e9eccb9 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 29 Aug 2026 11:41:49 -0700 Subject: [PATCH 06/10] Gate R1 direct connection behind a dev setting MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit
Prompts Used Currently we receive user input events from the R1 ring mainly via the G2 glasses, which have their own connection to ring, and we also try to connect to the ring directly; but the direct connection currently winds up not workign reliably. Let's add a "Ring connection mode" to the Developer section of the Settings app, with options "Only via glasses" (new default) and "Direct". If the "Only via glasses" option is selected, we don't open a bluetooth connection to the ring at all. > Done. Build + typecheck pass. > > **Changes:** > > - `app/ui/dashboard-settings.ts:393` — new `ringConnectionModeSetting` (`ConfigSettingEnum`), values `"glasses"` (default, displayed "Only via glasses") and `"direct"`, stored under `developer.ringConnectionMode`. > - `app/ui/dashboard/settings-menus.ts:182` — added it as the first row of the Developer section. > - `app/g2/dashboard-controller.ts:988` — `connect()` now computes `ringAddress = mode === "direct" ? addresses.ring : ""` and passes that to `FaceclawCommunicatorBridge` (and into the connect log line). > > The gate works by handing the Java communicator an empty ring address: `FaceclawBleCommunicator.hasRingAddress()` then returns false, so `tryConnectRing`/`shouldAttemptRingConnect`/the teardown `disconnect(ringAddress)` all short-circuit — no GATT connection to the ring is ever opened, and the retry loop never fires. Gestures still arrive over the glasses' own link to the ring, unchanged. > > Since the mode is read at connect time, changing it while connected takes effect on the next connection; the setting's description says so. If you'd rather it apply live (drop/raise the ring link without cycling the glasses), that needs a small new Java method on the communicator — say the word and I'll add it.
--- app/g2/dashboard-controller.ts | 11 ++++++++--- app/ui/dashboard-settings.ts | 13 +++++++++++++ app/ui/dashboard/settings-menus.ts | 4 ++++ 3 files changed, 25 insertions(+), 3 deletions(-) diff --git a/app/g2/dashboard-controller.ts b/app/g2/dashboard-controller.ts index 5ba35a8b..4bd52ef1 100644 --- a/app/g2/dashboard-controller.ts +++ b/app/g2/dashboard-controller.ts @@ -58,7 +58,7 @@ import { type InProcessAppOptions, type InProcessWindow } from "../ui/shell/in-p import { loadPersistedOpenApps, savePersistedOpenApps } from "../ui/shell/open-apps-persistence"; import { appViewportRect, SIDEBAR_WIDTH, sidebarStripVisible, type WindowHeightMode } from "../ui/shell/geometry"; import { type LayerActions } from "../ui/layers"; -import { assistantAllowProactiveSetting, assistantBackendSetting, assistantBridgeHostSetting, assistantBridgePortSetting, assistantBridgeTokenSetting, brightnessSetting, brightnessSettingToLevel, displayModeSetting, elevenLabsApiKeySetting, getStringSettingById, openAiApiKeySetting, nightscoutApiTokenSetting, firmwareDebugFlagsSetting, lockScreenEnabledSetting, nightscoutSiteUrlSetting, onAnySettingChanged, previewColorSetting, saveVoiceRecordingsSetting, sonioxApiKeySetting, screenTimeoutSetting, screenTimeoutSettingToMs, suspendEvenHubWhenScreenOffSetting, verticalPositionSetting, voiceProviderSetting, wakeWordActionSetting, type ConfigSettingString } from "../ui/dashboard-settings"; +import { assistantAllowProactiveSetting, assistantBackendSetting, assistantBridgeHostSetting, assistantBridgePortSetting, assistantBridgeTokenSetting, brightnessSetting, brightnessSettingToLevel, displayModeSetting, elevenLabsApiKeySetting, getStringSettingById, openAiApiKeySetting, nightscoutApiTokenSetting, firmwareDebugFlagsSetting, lockScreenEnabledSetting, nightscoutSiteUrlSetting, onAnySettingChanged, previewColorSetting, ringConnectionModeSetting, saveVoiceRecordingsSetting, sonioxApiKeySetting, screenTimeoutSetting, screenTimeoutSettingToMs, suspendEvenHubWhenScreenOffSetting, verticalPositionSetting, voiceProviderSetting, wakeWordActionSetting, type ConfigSettingString } from "../ui/dashboard-settings"; import { isIgnoringBatteryOptimizations, requestIgnoreBatteryOptimizations } from "../native/battery-optimization"; import { getInstalledEvenHubAppById, @@ -981,8 +981,13 @@ class DashboardController { this.refreshEvenAppStatus(); this.setPhase("connecting"); this.setStatus("Connecting to the glasses..."); + // "Only via glasses" (the default) means the phone never opens its own + // link to the ring: the glasses relay its gestures to us anyway, and the + // direct link is currently unreliable. An empty address disables every + // direct-ring code path in the communicator. + const ringAddress = ringConnectionModeSetting.get() === "direct" ? addresses.ring : ""; this.appendLog( - `Using configured arms: R=${addresses.right} L=${addresses.left}${addresses.ring ? ` ring=${addresses.ring}` : ""}`, + `Using configured arms: R=${addresses.right} L=${addresses.left}${ringAddress ? ` ring=${ringAddress}` : ""}`, ); let communicator: FaceclawCommunicatorBridge | null = null; @@ -999,7 +1004,7 @@ class DashboardController { communicator = new FaceclawCommunicatorBridge({ right: addresses.right, left: addresses.left, - ring: addresses.ring, + ring: ringAddress, }); this.communicator = communicator; this.offLog = communicator.onLog((line) => { diff --git a/app/ui/dashboard-settings.ts b/app/ui/dashboard-settings.ts index 6a723296..d2ae86d4 100644 --- a/app/ui/dashboard-settings.ts +++ b/app/ui/dashboard-settings.ts @@ -390,6 +390,19 @@ export const suspendEvenHubWhenScreenOffSetting = new ConfigSettingBoolean({ description: "Suspend the EvenHub session while the display is off. This significantly improves battery life, but increases the latency of waking the screen.", }); +export type RingConnectionMode = "glasses" | "direct"; + +export const ringConnectionModeSetting = new ConfigSettingEnum({ + id: "ring-connection-mode", + label: "Ring connection", + storageKey: "developer.ringConnectionMode", + defaultValue: "glasses", + values: ["glasses", "direct"], + formatValue: (value) => (value === "direct" ? "Direct" : "Only via glasses"), + description: + "How R1 ring input reaches the phone. Only via glasses: the ring's own link to the glasses carries its gestures, and the phone never opens a Bluetooth connection to the ring. Direct: also connect to the ring from the phone (currently unreliable). Takes effect on the next connection to the glasses.", +}); + export type VoiceProvider = "onboard" | "elevenlabs" | "whisper" | "soniox"; const voiceProviderLabels: Record = { diff --git a/app/ui/dashboard/settings-menus.ts b/app/ui/dashboard/settings-menus.ts index 45464c61..a66cf2cf 100644 --- a/app/ui/dashboard/settings-menus.ts +++ b/app/ui/dashboard/settings-menus.ts @@ -41,6 +41,7 @@ import { mirrorTouchSetting, openAiApiKeySetting, previewColorSetting, + ringConnectionModeSetting, roamApiTokenSetting, roamGraphNameSetting, sonioxApiKeySetting, @@ -176,6 +177,9 @@ function settingsSections(): SettingsSection[] { { label: "Developer", items: [ + // Whether the phone opens its own BLE link to the R1 ring; the + // glasses relay ring gestures either way. Applied at connect time. + enumSettingMenuItem(ringConnectionModeSetting), toggleSettingMenuItem(saveVoiceRecordingsSetting), toggleSettingMenuItem(firmwareDebugFlagsSetting), toggleSettingMenuItem(suspendEvenHubWhenScreenOffSetting), From aebb88f9173863a3306b8eaf32c0697f8d7934ce Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 29 Aug 2026 13:26:01 -0700 Subject: [PATCH 07/10] Small fixes in README and build script wiring --- README.md | 19 ++++++++----------- package.json | 3 ++- 2 files changed, 10 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index 92f73153..0bb463ea 100644 --- a/README.md +++ b/README.md @@ -23,17 +23,14 @@ 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. +up to date npm and nodejs installed. You can put environment variables in +build_paths.sh and they will be used by all build commands. -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` +To install a version that you compiled, you will need developer mode enabled on +your phone, and `adb` connected. To enable developer mode, 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, and run +`./build_and_run.sh` to install. ## Features @@ -157,7 +154,7 @@ 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](https://github.com/jimrandomh/faceclaw); changes there require more +[g2flash](https://github.com/jimrandomh/g2flash); changes there require more caution. Faceclaw is Free Software (GPLv3). Please only contribute code that you wrote diff --git a/package.json b/package.json index 9a8b1ee5..c4a1783e 100644 --- a/package.json +++ b/package.json @@ -4,7 +4,8 @@ "version": "1.0.0", "private": false, "scripts": { - "build": "nativescript build android", + "build": "./build.sh", + "run": "./build_and_run.sh", "release": "scripts/release.sh", "clean": "rm -rf platforms", "test": "tsc -p tests/tsconfig.json && node --test tests/*.test.cjs" From 20677116ca713fe81abdbf9c35213a9f6797a99f Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 29 Aug 2026 15:02:22 -0700 Subject: [PATCH 08/10] Add a GitHub Pages website --- .github/workflows/pages.yml | 40 ++++ README.md | 98 +++++----- website/CNAME | 1 + website/README.md | 59 ++++++ website/content/features.md | 24 +++ website/images/faceclaw-logo.png | Bin 0 -> 21863 bytes website/images/favicon.png | Bin 0 -> 48654 bytes website/index.html | 147 +++++++++++++++ website/install.html | 80 ++++++++ website/privacy.html | 80 ++++++++ .../screenshots}/launcher.png | Bin .../screenshots}/music-player.png | Bin .../screenshots}/settings-assistant.png | Bin .../screenshots}/settings-display.png | Bin website/style.css | 178 ++++++++++++++++++ 15 files changed, 660 insertions(+), 47 deletions(-) create mode 100644 .github/workflows/pages.yml create mode 100644 website/CNAME create mode 100644 website/README.md create mode 100644 website/content/features.md create mode 100644 website/images/faceclaw-logo.png create mode 100644 website/images/favicon.png create mode 100644 website/index.html create mode 100644 website/install.html create mode 100644 website/privacy.html rename {screenshots => website/screenshots}/launcher.png (100%) rename {screenshots => website/screenshots}/music-player.png (100%) rename {screenshots => website/screenshots}/settings-assistant.png (100%) rename {screenshots => website/screenshots}/settings-display.png (100%) create mode 100644 website/style.css diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 00000000..cffc8d6a --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,40 @@ +name: Deploy website + +# Publishes website/ to GitHub Pages. Requires the repository's +# Settings > Pages > Source to be set to "GitHub Actions". + +on: + push: + branches: [main] + paths: + - 'website/**' + - 'PRIVACY' + - 'scripts/sync-site.mjs' + - '.github/workflows/pages.yml' + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: false + +jobs: + deploy: + runs-on: ubuntu-latest + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - uses: actions/checkout@v4 + - name: Check generated blocks are up to date + run: node scripts/sync-site.mjs --check + - uses: actions/configure-pages@v5 + - uses: actions/upload-pages-artifact@v3 + with: + path: website + - id: deployment + uses: actions/deploy-pages@v4 diff --git a/README.md b/README.md index 0bb463ea..d83b2e48 100644 --- a/README.md +++ b/README.md @@ -9,13 +9,15 @@ 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. +User-facing documentation lives at https://faceclaw.org/. + ## Screenshots -![App launcher](screenshots/launcher.png) -![Music player](screenshots/music-player.png) -![Assistant settings](screenshots/settings-assistant.png) -![Display settings](screenshots/settings-display.png) +![App launcher](website/screenshots/launcher.png) +![Music player](website/screenshots/music-player.png) +![Assistant settings](website/screenshots/settings-assistant.png) +![Display settings](website/screenshots/settings-display.png) ## Installation @@ -34,53 +36,55 @@ port into your computer, authorize access on the phone, and run ## 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 + + + * **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. + * **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. + * **The full display.** 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. + * **Terminal mirroring.** 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 + * **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. + * **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 + 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 + 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) diff --git a/website/CNAME b/website/CNAME new file mode 100644 index 00000000..c248600c --- /dev/null +++ b/website/CNAME @@ -0,0 +1 @@ +faceclaw.org diff --git a/website/README.md b/website/README.md new file mode 100644 index 00000000..bc65a419 --- /dev/null +++ b/website/README.md @@ -0,0 +1,59 @@ +# faceclaw.org + +The Faceclaw website: plain HTML and one stylesheet, no build step and no +external dependencies. GitHub Actions publishes this directory to GitHub Pages +on every push to `main` that touches it (`.github/workflows/pages.yml`). + +## Layout + + index.html landing page + install.html install instructions + privacy.html privacy policy (body generated, see below) + style.css the whole stylesheet + content/ canonical copies of content shared with the repo root + images/ logo and favicon, derived from ../images/FaceclawAppIcon.png + screenshots/ glasses captures, also used by the root README + CNAME custom domain + +## Shared content + +Two things appear both here and in the repository root, and are generated +rather than copied by hand: + +| Source | Destinations | +| --------------------------- | ------------------------------------- | +| `content/features.md` | `README.md`, `index.html` | +| `../PRIVACY` | `privacy.html` | + +Edit the source, then run: + + node scripts/sync-site.mjs + +Each destination has a `` / `` +pair; the script rewrites what is between them and leaves the rest alone. CI +runs `node scripts/sync-site.mjs --check` and fails the deploy if a +destination is stale. + +## Previewing + +Any static file server will do, since there is nothing to compile: + + python3 -m http.server -d website 8000 + +## Setting up the custom domain + +Publishing needs Settings > Pages > Source set to "GitHub Actions". For +`faceclaw.org`, point the apex at GitHub's Pages addresses: + + A faceclaw.org 185.199.108.153 + A faceclaw.org 185.199.109.153 + A faceclaw.org 185.199.110.153 + A faceclaw.org 185.199.111.153 + AAAA faceclaw.org 2606:50c0:8000::153 + AAAA faceclaw.org 2606:50c0:8001::153 + AAAA faceclaw.org 2606:50c0:8002::153 + AAAA faceclaw.org 2606:50c0:8003::153 + CNAME www jimrandomh.github.io. + +Then set the custom domain in Settings > Pages and enable "Enforce HTTPS" +once the certificate has been issued. diff --git a/website/content/features.md b/website/content/features.md new file mode 100644 index 00000000..b59baa8d --- /dev/null +++ b/website/content/features.md @@ -0,0 +1,24 @@ + + +- **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. +- **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. +- **The full display.** 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. +- **Terminal mirroring.** 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. +- **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. diff --git a/website/images/faceclaw-logo.png b/website/images/faceclaw-logo.png new file mode 100644 index 0000000000000000000000000000000000000000..36053dffa8fca571b5cfa79250bab27b74ba32eb GIT binary patch literal 21863 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 BZ9M=0 literal 0 HcmV?d00001 diff --git a/website/images/favicon.png b/website/images/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..805cc0c0ba90d0975daa5850394197e61fc73d6f GIT binary patch literal 48654 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 + + + + +Faceclaw — an unofficial interface for the Even Realities G2 + + + + + + + + + + + + +
+ +
+ +
+ +
+
+ +

Faceclaw

+

An unofficial user interface for the Even Realities G2 smart glasses. Apps, a voice assistant, notifications and a watch remote — running from your Android phone.

+ +
+
+ +
+
+
+

Unofficial

+

Faceclaw is not made by, endorsed by, or supported by Even Realities. It comes with no warranty from them or from anyone. It runs on Android, and it requires installing custom firmware on the glasses — the app can install and uninstall that firmware for you, downloading the stock firmware from Even and applying patches generated from g2flash.

+
+
+
+ +
+
+

What it looks like

+
+
+ The Faceclaw app launcher on the glasses display +
The app launcher, with the app-switcher sidebar on the left.
+
+
+ The music player on the glasses display +
Media controls, working with most Android media players.
+
+
+ Assistant settings on the glasses display +
Assistant settings, edited on the glasses themselves.
+
+
+ Display settings on the glasses display +
Display settings, including height and vertical position.
+
+
+
+
+ +
+
+

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.
  • +
  • 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.
  • +
  • The full display. 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.
  • +
  • Terminal mirroring. Mirror terminal apps such as Claude Code or Codex CLI with 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.
  • +
  • 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.
  • +
+ +
+
+ +
+
+

Beyond the glasses

+
+
+

Watch remote

+

A Wear OS companion app turns the whole watch face into a touchpad that outdoes the R1 ring: swipes, crown scrolling, side buttons, app launching, and spoken or typed queries with the reply on your wrist.

+
+
+

EvenHub apps

+

Faceclaw runs EvenHub apps through an emulation layer. Install them from the Hub, or sideload your own by opening an .ehpk file on your phone.

+
+
+

Your own agent

+

Instead of calling an LLM API from the phone, the assistant can route queries to your own long-running OpenClaw agent, which also gets access to the glasses' tools.

+
+
+
+
+ +
+
+

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, open a pull request. Faceclaw is Free Software under the GPLv3. See the contributing notes for what to test before you send a change.

+
+
+ +
+ + + + + diff --git a/website/install.html b/website/install.html new file mode 100644 index 00000000..66323def --- /dev/null +++ b/website/install.html @@ -0,0 +1,80 @@ + + + + + +Install — Faceclaw + + + + + + +
+ +
+ +
+
+
+

Installing Faceclaw

+ +
+

Read this first

+

Faceclaw is unofficial and unsupported, and it replaces the firmware on your glasses. Installing it means running code that Even Realities did not write and will not help you with. The app can put the stock firmware back, but you are doing this at your own risk.

+
+ +

What you need

+
    +
  • A pair of Even Realities G2 glasses.
  • +
  • An Android phone. Faceclaw runs as a background app and talks to the glasses over Bluetooth LE.
  • +
  • Optionally, a Wear OS 3+ watch, if you want the watch remote instead of the R1 ring.
  • +
+

There is no iOS version, and there will not be one — the app depends on Android APIs for background Bluetooth, notification access and media control.

+ +

Install the app

+

Faceclaw is not on the Play Store. Download the most recent APK from the releases page and open it on your phone; Android will ask you to allow installing apps from that source.

+ +

Install the firmware

+

Faceclaw needs custom firmware on the glasses, and installs it for you. On first run, the onboarding flow will offer to download the stock firmware from Even Realities, apply the g2flash patches locally, and flash the result. You confirm the flash on the glasses themselves.

+

Onboarding also offers a preview-only path, which connects to unmodified glasses so you can look around before committing. Faceclaw can restore the stock firmware later from the same screens.

+ +

Grant permissions

+

Android does not reliably prompt for everything Faceclaw uses. After installing, go to Settings → Apps → Faceclaw and check that permissions are granted — notification access and Bluetooth in particular — or parts of the app will silently do nothing.

+

Also exempt Faceclaw from battery optimization. Being a background app on a locked Android phone is fraught, and manufacturer-specific battery software may pause it or throttle it to low CPU usage.

+ +

Optional extras

+
    +
  • Watch remote. The Wear OS app is a separate Gradle build in wear/, sideloaded over adb; it needs no Play Store, but the phone side requires Google Play services.
  • +
  • API keys. The voice assistant needs a model provider key (Anthropic or OpenAI), cloud transcription needs a key for OpenAI Whisper, ElevenLabs or Soniox, and turn-by-turn directions need a Mapbox token. On-device transcription needs no key.
  • +
  • Terminal mirroring. Install g2mirror on the machine whose terminal you want to see.
  • +
  • External agent. To route assistant queries to your own long-running agent, install the faceclaw-agent-bridge OpenClaw plugin; setup lives in that repository's README.
  • +
+ +

Building from source

+

Faceclaw is a NativeScript app written in TypeScript and Java, and builds with an Android SDK 35 environment and a JDK 21. The README has the current build and adb instructions; they are kept there rather than duplicated here, so they stay in step with the code.

+
+
+
+ +
+
+ +

Faceclaw is Free Software, licensed under the GPLv3. It is unofficial, and is not affiliated with Even Realities.

+
+
+ + + diff --git a/website/privacy.html b/website/privacy.html new file mode 100644 index 00000000..3cd84806 --- /dev/null +++ b/website/privacy.html @@ -0,0 +1,80 @@ + + + + + +Privacy policy — Faceclaw + + + + + + +
+ +
+ +
+
+
+ +

Faceclaw Privacy Policy

+

Faceclaw is a privacy-conscious app. The developers of Faceclaw don't collect or store user data. Faceclaw does integrate with some third-party services, which have their own privacy policies; this document describes what those services are, what they're used for and what data they collect, and links to their privacy policies.

+

Audio

+

Faceclaw allows users to transcribe audio (for use with the voice assistant, the Transcribe app, typing into Terminal, and other apps). The default setting is that this is done using an on-device model running on your phone. If an on-device model is selected, audio never leaves your device, and is not stored after it is processed.

+

Users can also provide their own API key for a third-party transcription service such as OpenAI Whisper, ElevenLabs, or Soniox, which may offer better accuracy. Faceclaw never transmits audio to any party other than a user-selected transcription service. If a third-party transcription service is selected, audio will be sent to that third party, is linked to the account with which that API key was created, and is subject to that party's privacy and retention policies:

+ +

Third party data retention and privacy policies may differ based on the API key provided. API keys are part of a relationship between the user and the API provider; Faceclaw does not manage accounts or process billing information.

+

AI Assistant Transcripts

+

Faceclaw has a builtin AI voice assistant. Using the voice assistant requires providing an API key for a model provider such as Anthropic or OpenAI. Prompts and responses are subject to that model provider's privacy policy:

+ +

AI conversation histories and memory files may be stored on your phone. Faceclaw does not transmit voice-assistant prompts or responses to any party other than a user-selected AI model provider. The voice assistant is given tools with which it is able to access most things on the user's phone, including all content displayed on the glasses, location, notifications, and content accessible through the Terminal app.

+

The AI assistant can take actions on the user's behalf, including sharing any information it has access to. The user is responsible for any instructions they give it.

+

Location

+

Faceclaw has a builtin Navigate app, which provides turn-by-turn directions. Using the Navigate app requires providing an API key for Mapbox. While the Navigate app is active, the user's exact location and selected destination are transmitted to Mapbox, and are subject to Mapbox's privacy policy.

+ +

The Weather app will retrieve the user's coarse location, and will use it to query a third-party weather information provider.

+

EvenHub

+

The EvenHub app store is subject to Even Realities' privacy policy: https://support.evenrealities.com/hc/en-us/articles/14127464826511-Privacy-Policy. Apps downloaded from the EvenHub app store come with their own privacy policies.

+

Wear OS Watch

+

The optional Faceclaw watch app (wear/) talks to the phone over Google Play services' Wearable Data Layer, the same channel the watch uses for notifications and other companion apps. Gestures, commands, the watch's own speech-recognition results, and the mirrored glasses status and assistant replies travel between your watch and your phone over their Bluetooth (or, when paired that way, Wi-Fi) link; Faceclaw does not send any of it to a server. Speech recognized on the watch uses the watch's system speech recognizer, which may send audio to Google under Google's privacy policy:

+ +

The phone does nothing watch-related on phones without Google Play services.

+ +

This page is generated from the PRIVACY file in the Faceclaw repository, which is the authoritative copy.

+
+
+
+ +
+
+ +

Faceclaw is Free Software, licensed under the GPLv3. It is unofficial, and is not affiliated with Even Realities.

+
+
+ + + diff --git a/screenshots/launcher.png b/website/screenshots/launcher.png similarity index 100% rename from screenshots/launcher.png rename to website/screenshots/launcher.png diff --git a/screenshots/music-player.png b/website/screenshots/music-player.png similarity index 100% rename from screenshots/music-player.png rename to website/screenshots/music-player.png diff --git a/screenshots/settings-assistant.png b/website/screenshots/settings-assistant.png similarity index 100% rename from screenshots/settings-assistant.png rename to website/screenshots/settings-assistant.png diff --git a/screenshots/settings-display.png b/website/screenshots/settings-display.png similarity index 100% rename from screenshots/settings-display.png rename to website/screenshots/settings-display.png diff --git a/website/style.css b/website/style.css new file mode 100644 index 00000000..e067c5e5 --- /dev/null +++ b/website/style.css @@ -0,0 +1,178 @@ +/* Faceclaw website. Hand-written, no build step, no external assets. */ + +:root { + --bg: #0d1226; + --bg-raised: #141b38; + --line: #26305a; + --fg: #e9ecf7; + --fg-dim: #98a1c4; + --accent: #f5c531; + --accent-warm: #e8503a; + --lens: #000; + --mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace; + --sans: system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; +} + +* { box-sizing: border-box; } + +body { + margin: 0; + background: var(--bg); + color: var(--fg); + font: 16px/1.65 var(--sans); + -webkit-font-smoothing: antialiased; +} + +.wrap { width: 100%; max-width: 960px; margin: 0 auto; padding: 0 24px; } + +a { color: var(--accent); text-decoration-color: rgba(245, 197, 49, 0.4); text-underline-offset: 2px; } +a:hover { text-decoration-color: var(--accent); } + +h1, h2, h3 { line-height: 1.2; letter-spacing: -0.015em; } +h2 { font-size: 1.5rem; margin: 0 0 16px; } +h3 { font-size: 1.05rem; margin: 0 0 8px; } +p { margin: 0 0 16px; } + +code, kbd { font-family: var(--mono); font-size: 0.9em; } +code { + background: var(--bg-raised); + border: 1px solid var(--line); + border-radius: 4px; + padding: 1px 5px; +} +pre { + background: var(--bg-raised); + border: 1px solid var(--line); + border-radius: 8px; + padding: 14px 16px; + overflow-x: auto; + margin: 0 0 16px; +} +pre code { background: none; border: 0; padding: 0; } + +/* ---- site chrome ---- */ + +.topbar { + border-bottom: 1px solid var(--line); + position: sticky; + top: 0; + background: rgba(13, 18, 38, 0.9); + backdrop-filter: blur(8px); + z-index: 10; +} +.topbar .wrap { display: flex; align-items: center; gap: 20px; height: 56px; } +.brand { display: flex; align-items: center; gap: 9px; font-weight: 650; color: var(--fg); text-decoration: none; } +.brand img { width: 22px; height: 22px; } +.topbar nav { margin-left: auto; display: flex; gap: 20px; font-size: 0.94rem; } +.topbar nav a { color: var(--fg-dim); text-decoration: none; } +.topbar nav a:hover, .topbar nav a[aria-current="page"] { color: var(--fg); } + +section { padding: 56px 0; border-top: 1px solid var(--line); } +section:first-of-type { border-top: 0; } + +footer { + border-top: 1px solid var(--line); + padding: 32px 0 56px; + color: var(--fg-dim); + font-size: 0.9rem; +} +footer a { color: var(--fg-dim); } +footer .links { display: flex; flex-wrap: wrap; gap: 18px; margin-bottom: 12px; } + +/* ---- hero ---- */ + +.hero { text-align: center; padding: 72px 0 56px; } +.hero img.logo { width: 104px; height: 104px; } +.hero h1 { font-size: clamp(2.2rem, 6vw, 3.1rem); margin: 18px 0 10px; } +.hero .tagline { font-size: 1.2rem; color: var(--fg-dim); max-width: 34em; margin: 0 auto 28px; } + +.buttons { display: flex; gap: 12px; justify-content: center; flex-wrap: wrap; } +.btn { + display: inline-block; + padding: 11px 22px; + border-radius: 8px; + border: 1px solid var(--line); + font-weight: 600; + text-decoration: none; + color: var(--fg); +} +.btn:hover { border-color: var(--fg-dim); } +.btn.primary { background: var(--accent); border-color: var(--accent); color: #1a1400; } +.btn.primary:hover { background: #ffd44f; border-color: #ffd44f; } + +.eyebrow { + font-family: var(--mono); + font-size: 0.78rem; + letter-spacing: 0.08em; + text-transform: uppercase; + color: var(--accent-warm); +} + +/* ---- callout ---- */ + +.callout { + border: 1px solid var(--line); + border-left: 3px solid var(--accent-warm); + border-radius: 8px; + background: var(--bg-raised); + padding: 16px 20px; + margin: 0 0 24px; +} +.callout p:last-child { margin-bottom: 0; } + +/* ---- screenshots ---- */ + +.shots { display: grid; grid-template-columns: repeat(2, 1fr); gap: 24px; } +.shot { margin: 0; } +.shot img { + display: block; + width: 100%; + background: var(--lens); + border: 1px solid var(--line); + border-radius: 6px; + image-rendering: pixelated; +} +.shot figcaption { color: var(--fg-dim); font-size: 0.88rem; margin-top: 8px; } + +/* ---- features ---- */ + +.features { list-style: none; padding: 0; margin: 0; columns: 2; column-gap: 40px; } +.features li { + break-inside: avoid; + margin: 0 0 18px; + padding-left: 20px; + position: relative; + color: var(--fg-dim); +} +.features li::before { content: "▸"; position: absolute; left: 0; color: var(--accent); } +.features li strong { color: var(--fg); font-weight: 600; } + +/* ---- cards ---- */ + +.cards { display: grid; grid-template-columns: repeat(3, 1fr); gap: 20px; } +.card { + border: 1px solid var(--line); + border-radius: 10px; + background: var(--bg-raised); + padding: 20px; +} +.card p { color: var(--fg-dim); font-size: 0.94rem; margin: 0; } + +/* ---- long-form prose (privacy, install) ---- */ + +.prose { max-width: 44em; } +.prose h2 { margin-top: 40px; padding-top: 8px; } +.prose h2:first-child { margin-top: 0; } +.prose ul { padding-left: 22px; } +.prose li { margin-bottom: 6px; } +.prose ul.links { list-style: none; padding-left: 0; font-family: var(--mono); font-size: 0.88rem; } +.prose ul.links li { margin-bottom: 4px; } +.prose .meta { color: var(--fg-dim); font-size: 0.9rem; } + +@media (max-width: 700px) { + .shots { grid-template-columns: 1fr; } + .features { columns: 1; } + .cards { grid-template-columns: 1fr; } + .topbar nav { gap: 14px; } + section { padding: 40px 0; } +} From 4415c645f797ae17b512b85ff21bb61feba7bf4e Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 29 Aug 2026 15:21:53 -0700 Subject: [PATCH 09/10] Add sync-site script --- scripts/sync-site.mjs | 126 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100755 scripts/sync-site.mjs diff --git a/scripts/sync-site.mjs b/scripts/sync-site.mjs new file mode 100755 index 00000000..a699f361 --- /dev/null +++ b/scripts/sync-site.mjs @@ -0,0 +1,126 @@ +#!/usr/bin/env node +// Keeps the website in step with the files that own the content. +// +// website/content/features.md -> README.md and website/index.html +// PRIVACY -> website/privacy.html +// +// Each destination has a `` / `` +// pair; everything between them is replaced. Run after editing either source: +// +// node scripts/sync-site.mjs rewrite the destinations +// node scripts/sync-site.mjs --check exit non-zero if they are out of date + +import { readFileSync, writeFileSync } from "node:fs"; +import { fileURLToPath } from "node:url"; +import { dirname, join } from "node:path"; + +const root = join(dirname(fileURLToPath(import.meta.url)), ".."); +const check = process.argv.includes("--check"); +const stale = []; + +// ---------- generic helpers ---------- + +function splice(relPath, key, body) { + const path = join(root, relPath); + const before = readFileSync(path, "utf8"); + const begin = ``; + const end = ``; + const i = before.indexOf(begin); + const j = before.indexOf(end); + if (i < 0 || j < 0) throw new Error(`${relPath}: missing ${begin} / ${end} markers`); + if (j < i) throw new Error(`${relPath}: ${end} comes before ${begin}`); + const after = before.slice(0, i + begin.length) + "\n" + body.replace(/\n+$/, "") + "\n" + before.slice(j); + if (after === before) return; + if (check) stale.push(`${relPath} (${key})`); + else writeFileSync(path, after); +} + +const escapeHtml = (s) => + s.replace(/&/g, "&").replace(//g, ">"); + +// The small markdown subset the sources use: `code`, **bold**, [text](url), bare URLs. +function inlineHtml(text) { + return escapeHtml(text) + .replace(/`([^`]+)`/g, "$1") + .replace(/\*\*([^*]+)\*\*/g, "$1") + .replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, '$1') + // Bare URLs, minus any trailing sentence punctuation. + .replace(/(^|[\s(])(https?:\/\/[^\s<)]+?)([.,;:)]?)(?=$|[\s<)])/g, + (_, lead, url, tail) => `${lead}${url}${tail}`); +} + +function wrap(text, width, firstPrefix, contPrefix) { + const lines = []; + let line = firstPrefix; + let indent = firstPrefix; + for (const word of text.split(/\s+/)) { + if (line !== indent && (line + " " + word).length > width) { + lines.push(line); + indent = contPrefix; + line = contPrefix + word; + } else { + line = line === indent ? line + word : line + " " + word; + } + } + lines.push(line); + return lines.join("\n"); +} + +// ---------- features ---------- + +function parseFeatures(md) { + const body = md.replace(//g, ""); + const features = []; + for (const raw of body.split("\n")) { + const line = raw.trimEnd(); + if (/^- /.test(line)) features.push(line.slice(2).trim()); + else if (/^\s+\S/.test(line) && features.length) { + features[features.length - 1] += " " + line.trim(); + } + } + if (!features.length) throw new Error("website/content/features.md: no `- ` bullets found"); + return features; +} + +const features = parseFeatures(readFileSync(join(root, "website/content/features.md"), "utf8")); + +splice("README.md", "features", + features.map((f) => wrap(f, 78, " * ", " ")).join("\n")); + +splice("website/index.html", "features", + '
    \n' + + features.map((f) => `
  • ${inlineHtml(f)}
  • `).join("\n") + + "\n
"); + +// ---------- privacy ---------- + +function privacyHtml(md) { + const out = []; + for (const block of md.trim().split(/\n\s*\n/)) { + const lines = block.split("\n").filter((l) => l.trim()); + if (/^# /.test(lines[0])) { + out.push(`

${inlineHtml(lines[0].slice(2).trim())}

`); + } else if (/^## /.test(lines[0])) { + out.push(`

${inlineHtml(lines[0].slice(3).trim())}

`); + } else if (lines.every((l) => /^\s{2,}\S/.test(l))) { + // An indented run of "Provider: https://..." lines. + out.push('"); + } else { + out.push(`

${inlineHtml(lines.map((l) => l.trim()).join(" "))}

`); + } + } + return out.map((l) => " " + l).join("\n"); +} + +splice("website/privacy.html", "privacy", + privacyHtml(readFileSync(join(root, "PRIVACY"), "utf8"))); + +// ---------- report ---------- + +if (check && stale.length) { + console.error("Out of date, run `node scripts/sync-site.mjs`:\n " + stale.join("\n ")); + process.exit(1); +} +console.log(check ? "sync-site: up to date" : "sync-site: wrote generated blocks"); From 17d5f754908b70753ff1f50c45736f516c77e9e3 Mon Sep 17 00:00:00 2001 From: James Babcock Date: Sat, 29 Aug 2026 15:24:11 -0700 Subject: [PATCH 10/10] Fix aspect ratio on screenshots --- website/index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/website/index.html b/website/index.html index 8983a314..755c4dfb 100644 --- a/website/index.html +++ b/website/index.html @@ -56,19 +56,19 @@

What it looks like

- The Faceclaw app launcher on the glasses display + The Faceclaw app launcher on the glasses display
The app launcher, with the app-switcher sidebar on the left.
- The music player on the glasses display + The music player on the glasses display
Media controls, working with most Android media players.
- Assistant settings on the glasses display + Assistant settings on the glasses display
Assistant settings, edited on the glasses themselves.
- Display settings on the glasses display + Display settings on the glasses display
Display settings, including height and vertical position.