2026-04-27 04:08:07 -07:00
2026-04-26 23:07:54 -07:00
2026-04-27 03:05:53 -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
2026-04-26 23:07:54 -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
2026-04-27 03:05:53 -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. 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
S
Description
No description provided
Readme GPL-3.0
41 MiB
0 Stars 1 Watchers 0 Forks
2026-11-18 21:49:32 +00:00
Languages
TypeScript 51%
Kotlin 23.9%
JavaScript 13.4%
C 5.9%
Objective-C 2%
Other 3.8%