Makes the button-row appear and disappear with a slide-in/out gesture.
Rearranges the other UI elements for a more watchface-like view.
<details>
<summary>Prompts used</summary>
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.
</details>
6.6 KiB
Faceclaw for Wear OS
A watch remote for Faceclaw: everything the Even R1 ring can do, plus the things it can't. Runs on a Wear OS 3+ watch (API 30) paired with the phone that runs Faceclaw. It is a remote, not a standalone app — without Faceclaw on the phone it only tells you to install it.
What it does
The pad (the home screen; the whole display is the touch surface):
| On the watch | On the glasses |
|---|---|
| tap | select |
| 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 | 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. |
| Tap zones mode | tap the top / bottom third to scroll, the middle to select — for when swiping is awkward |
The R1 ring's scheme is untouched: the ring only has up/down, tap, double-tap and hold, so on the glasses it still works in the stock two-step way (pick a launcher row, tap, pick the app). Watch input is tagged as its own source, so the same screens give the watch the direct scheme above without the ring ever seeing a difference.
Side buttons (when the app is in front): button 1 tap = select, hold = 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. 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 it streams, mirrored from the glasses overlay. The watch buzzes when the reply finishes. "Hey Even" instead opens the glasses' own voice dialog, which uses the glasses mic.
- Type into app — dictate or type text into the foreground app (the terminal, for instance), the same path finalized voice input takes.
- Apps — the sidebar's open windows (tap to switch, × to close) and the full launcher, including installed EvenHub apps.
- Status — connection and battery, display on/off, lock/unlock, connect / disconnect, and whether Faceclaw is running on the phone; watch settings (haptics, keep screen on, swipe direction, tap zones, horizontal swipe actions, tip taps and their sensitivity, crown sensitivity).
The pad keeps the watch display awake while it is showing (Watch settings > "Keep screen on", default on). Wear OS otherwise dozes within seconds of the 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, 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 bottom of the pad says why.
Building and installing
The watch app is a separate Gradle project (Kotlin + Compose for Wear OS). It needs the same Android SDK the phone build uses and a JDK 17+:
cd wear && JAVA_HOME=/path/to/jdk ANDROID_HOME=~/Library/Android/sdk ./gradlew :app:assembleDebug
The APK lands in app/build/outputs/apk/debug/. Install it on the watch over
adb (enable developer options on the watch, then ADB debugging and, for a
watch without USB, Wireless debugging / debug over Wi-Fi):
adb connect <watch-ip>:5555
adb -s <watch-ip>:5555 install -r app/build/outputs/apk/debug/app-debug.apk
Two things must match the phone app or the Data Layer silently won't route:
- Application id
com.faceclaw.app— already set inapp/build.gradle.kts. - Signing key. Debug builds of both apps use the shared Android debug
keystore (
~/.android/debug.keystore) on the machine that builds them, so building both on the same computer just works. For release builds, sign the watch APK with the same keystore as the phone APK.
There's no Play Store listing; sideload.
Troubleshooting
- "No phone connected" — the watch has no Bluetooth link to any phone.
- "Install Faceclaw on the phone" — a phone is connected but no app there
advertises the
faceclaw_phonecapability: the phone build predates the watch integration, or the app ids / signing keys differ. - "Open Faceclaw on the phone" — the phone app is installed but its dashboard isn't running (Play services started the process just for our message). Open Faceclaw once; it keeps running with its foreground service while connected to the glasses.
- "The glasses are not connected" — tap Status > Connect.
- Nothing happens and no message: check Settings > Watch on the phone.
Gestures the watch itself owns — the edge swipe-to-dismiss, the OS-level double-pinch / "universal" gestures on some watches — are not available to apps and aren't remapped here.
Protocol details: PROTOCOL.md.