mirror of
https://git.undefined-dev.fr/Blendman974/faceclaw.git
synced 2026-11-19 21:03:09 +00:00
65 lines
3.0 KiB
Plaintext
65 lines
3.0 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.
|
|
|
|
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.
|
|
|
|
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
|
|
|
|
* 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
|
|
|
|
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.
|
|
|
|
Being a background app on a locked Android phone is fraught, and there may be
|
|
issues with manufacturer-psecific battery optimization software that lead to
|
|
it getting paused, throttled to low CPU usage, etc.
|
|
|