forked from Blendman974/faceclaw
79 lines
4.1 KiB
Plaintext
79 lines
4.1 KiB
Plaintext
# Faceclaw - An unofficial user interface for the Even Realities G2 smart glasses
|
|
|
|
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.
|
|
|
|
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.
|
|
|
|
|
|
## Compiling and Installing
|
|
|
|
To compile this, 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 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.
|
|
|
|
|
|
## 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.)
|
|
* 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
|
|
|
|
## Additional Caveats
|
|
|
|
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.
|