forked from Blendman974/faceclaw
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.
|
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
|
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
|
Realities or from anyone.
|
||||||
warranty.
|
|
||||||
|
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
|
THIS IS AN UNFINISHED DEVELOPMENT PROTOTYPE; IF YOU DON'T HAVE ANY PROGRAMMING
|
||||||
EXPERIENCE, OR YOU AREN'T COMFORTABLE EDITING, COMPILING, AND SIDELOADING AN
|
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
|
ANDROID APPLICATION YOURSELF, OR YOU DON'T HAVE AN ANDROID DEVICE TO RUN IT
|
||||||
ON, THIS IS NOT FOR YOU.
|
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
|
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
|
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.
|
smart glasses today, consider using OcuClaw (which is an Even Hub app) instead.
|
||||||
@@ -36,18 +30,27 @@ installed.
|
|||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
* Extreme slowness and accelerated battery drain, due to lack of compression
|
* Integration with Android notifications: A top-bar that shows the
|
||||||
and additional factors in the G2 BLE image sending protocol
|
same icons your phone does, popups when notifications arrive, and menu
|
||||||
* Dual-language NativeScript architecture with Java for the multithreaded
|
items to dismiss or use Android-app-provided custom actions like mark as
|
||||||
Android API and bluetooth stack bits, Typescript for the bits you want to
|
read or quick reply.
|
||||||
hack on
|
* An app-launcher and app-switcher sidebar
|
||||||
* Dashboard with four configurable tiles, Nightscout integration, media player
|
* Mirror terminal apps such as coding agents with g2mirror
|
||||||
integration, Android notification icons, and battery levels for the phone
|
(https://github.com/jimrandomh/g2mirror) and view them on the glasses
|
||||||
and the G2 headset. (No battery indicator for the ring, currently.)
|
* 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
|
* Connection management with auto-reconnect, autodetection of conflict with
|
||||||
the official Even Realities app, and some amount of experience/iteration
|
the official Even Realities app, and some amount of experience/iteration
|
||||||
on the issues that come with keeping it runnign all day
|
on the issues that come with keeping it runnign all day
|
||||||
* On-phone screen mirroring and simulated ring input
|
* 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
|
## 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
|
Settings > Apps > Faceclaw to ensure permissions are available or things may
|
||||||
not work.
|
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
|
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
|
issues with manufacturer-psecific battery optimization software that lead to
|
||||||
to it getting paused, throttled to low CPU usage, etc. It's currently hard to
|
it getting paused, throttled to low CPU usage, etc.
|
||||||
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.
|
|
||||||
Reference in new issue
Block a user