# 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.