From 3a10c9b13e2e07397760d57cdc67fbeef005447f Mon Sep 17 00:00:00 2001 From: James Babcock Date: Wed, 8 Jul 2026 11:00:36 -0700 Subject: [PATCH] Update README to reflect current status of the project --- README | 66 +++++++++++++++++++++++----------------------------------- 1 file changed, 26 insertions(+), 40 deletions(-) diff --git a/README b/README index f0767adb..085bc734 100644 --- a/README +++ b/README @@ -2,24 +2,18 @@ This is an unofficial user interface for the Even Realities G2 smart glasses. It is entirely unofficial, and comes with no support or warranty from Even -Realities or from anyone. If this damages your glasses somehow, this void your -warranty. +Realities or from anyone. + +To use it, you uninstall or unpair the official Even Realities app, then +install the custom firmware from from https://github.com/jimrandomh/g2flash, +then install this app on the same phone. Faceclaw is not compatible with the +stock firmware due to limitations in how the stock firmware handles images. THIS IS AN UNFINISHED DEVELOPMENT PROTOTYPE; IF YOU DON'T HAVE ANY PROGRAMMING EXPERIENCE, OR YOU AREN'T COMFORTABLE EDITING, COMPILING, AND SIDELOADING AN ANDROID APPLICATION YOURSELF, OR YOU DON'T HAVE AN ANDROID DEVICE TO RUN IT ON, THIS IS NOT FOR YOU. -In its current state, it's more of a demo/research project than something you -could actually use, mainly because it's extremely slow: updating the display -on the headset takes multiple seconds. This is because it's entirely designed -around sending images to the headset, which is slow, rather than updating text -containers that use the builtin font, which is fast but very limiting. Hopefully -a future firmware update or reverse-engineering discovery will speed this up -enough to be fully usable. In the mean time, you can use it as a dashboard -(which doesn't require fast updates), and you can operate the UI via the phone -screen, which shows the same UI but more quickly. - The name Faceclaw implies plans to integrate this with OpenClaw. These plans have not yet been iplemented. If you want to use OpenClaw with Even Realities G2 smart glasses today, consider using OcuClaw (which is an Even Hub app) instead. @@ -36,18 +30,27 @@ installed. ## Features - * Extreme slowness and accelerated battery drain, due to lack of compression - and additional factors in the G2 BLE image sending protocol - * Dual-language NativeScript architecture with Java for the multithreaded - Android API and bluetooth stack bits, Typescript for the bits you want to - hack on - * Dashboard with four configurable tiles, Nightscout integration, media player - integration, Android notification icons, and battery levels for the phone - and the G2 headset. (No battery indicator for the ring, currently.) + * 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. + * An app-launcher and app-switcher sidebar + * Mirror terminal apps such as coding agents with g2mirror + (https://github.com/jimrandomh/g2mirror) and view them on the glasses + * A media player integration, which can view and control the currently + playing track and playlist. Compatible with most Android media players + (Spotify and VLC media player tested). + * Integratation with Nightscout, an outside app for viewing blood-glucose + data. + * Voice transcription using the G2's microphone with ElevenLabs' cloud + transcription model (requires an API key from ElevenLabs) * Connection management with auto-reconnect, autodetection of conflict with the official Even Realities app, and some amount of experience/iteration on the issues that come with keeping it runnign all day * On-phone screen mirroring and simulated ring input + * Dual-language NativeScript architecture with Java for the multithreaded + Android API and bluetooth stack bits, Typescript for the bits you want to + hack on ## Additional Caveats @@ -55,24 +58,7 @@ Some permissions are used, but may not reliably prompted for. Go to Android Settings > Apps > Faceclaw to ensure permissions are available or things may not work. -Sometimes the official Even Realities app restarts itself in the background, -and does things that make the already-bad image sending throughput even worse. -If you're seeing paint times >3s, this is probably why. Other apps that use -BLE (such as Dexcom) can also do things that interfere. - -The R1 ring communicates with the headset, and Faceclaw gets ring events -indirectly via the headset. However if you click the Disconnect button on the -headset in the Even Realities app, in addition to disconnecting the headset -from the phone it will also disconnect the headset from the ring. You can -work around this by force-stopping the Even Realities app instead, which will -leave them connected, but this leads to the problems described above with the -Even Realities app silently restarting and interfering. This can probably be -fixed by sending the right messages to the ring and the headset to reconnect -them to each other, but I don't know how to do that yet. - Being a background app on a locked Android phone is fraught, and there may be -issues, both with Android in general and with specific phone models, that lead -to it getting paused, throttled to low CPU usage, etc. It's currently hard to -disentangle this class of issue from other connectivity issues related to the -slowness of image sending and conflict with the Even Realities app, but it's -probably there. +issues with manufacturer-psecific battery optimization software that lead to +it getting paused, throttled to low CPU usage, etc. +