Update README to reflect current status of the project

This commit is contained in:
James Babcock committed 2026-07-08 11:00:36 -07:00
1 parent 22c779553c
commit 3a10c9b13e
1 file changed
+26 -40
+26 -40
View File
@@ -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.