Update README to reflect current status of the project
This commit is contained in:
1 parent
22c779553c
commit
3a10c9b13e
1 file changed
+26
-40
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user