2026-07-31 22:17:31 -07:00
2026-04-26 23:07:54 -07:00
2026-07-31 22:17:31 -07:00
2026-04-26 23:07:54 -07:00
2026-05-01 15:00:53 -07:00
2026-07-26 13:27:44 -07:00
2026-04-26 23:07:54 -07:00
2026-07-26 13:27:44 -07:00
2026-04-26 23:07:54 -07:00
2026-04-26 23:07:54 -07:00
2026-04-26 23:07:54 -07:00

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

This app runs on Android, and requires installing custom firmware on the
glasses. The Android app itself can install and uninstall the custom firmware;
it downloads the stock firmware from Even and applies patches generated from
https://github.com/jimrandomh/g2flash.

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.


## Installation

To compile, 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 Nativescript installed, and 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.

To install a version that you compiled, you will need `adb` connected. Go to
Settings>About phone and tap the "Build number" field seven times. Then plug
the phone's USB-C port into your computer, authorize access on the phone, then
run `nativescript run android 

The compile, run
  'npm run build'
To install, run
  `nativescript run android --juslaunch`

## Features

 * A voice assistant that wakes up when you say "Hey Even", transcribes text
   with an on-device model, OpenAI Whisper, or ElevenLabs API, and responds
   to queries and commands using an Anthropic or OpenAI model (requires an API
   key).
 * Multitasking, with an app-switcher sidebar and app launcher
 * Supports full-screen apps using the full 640x480 display area (rather than
   the 576x288 that EvenHub apps can use)
 * 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.
 * Mirror terminal apps such as Claude Code or Codex CLI with g2mirror
   (https://github.com/jimrandomh/g2mirror), view them on the glasses, and
   send them inputs with the voice assistant
 * Media player controls including playlist and media library navigation,
   compatible with most Android media players
 * Turn-by-turn directions (requires a Mapbox API token)
 * Nightscout, an app for viewing blood-glucose data (requires a cloud server
   and API token)
 * Power management: the glasses go to sleep properly when the screen is off,
   and wake when you double-tap the ring or speak the wakeword, allowing
   battery life similar to the stock Even app.
 * Connection management with auto-reconnect, and autodetection of conflict
   with the official Even Realities app
 * 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.

S
Description
No description provided
Readme GPL-3.0
49 MiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 51.1%
Kotlin 23.2%
JavaScript 12.9%
C 6.6%
Objective-C 2.2%
Other 4%