Add a GitHub Pages website
No files matched your search
@@ -0,0 +1,40 @@
|
||||
name: Deploy website
|
||||
|
||||
# Publishes website/ to GitHub Pages. Requires the repository's
|
||||
# Settings > Pages > Source to be set to "GitHub Actions".
|
||||
|
||||
on:
|
||||
push:
|
||||
branches: [main]
|
||||
paths:
|
||||
- 'website/**'
|
||||
- 'PRIVACY'
|
||||
- 'scripts/sync-site.mjs'
|
||||
- '.github/workflows/pages.yml'
|
||||
workflow_dispatch:
|
||||
|
||||
permissions:
|
||||
contents: read
|
||||
pages: write
|
||||
id-token: write
|
||||
|
||||
concurrency:
|
||||
group: pages
|
||||
cancel-in-progress: false
|
||||
|
||||
jobs:
|
||||
deploy:
|
||||
runs-on: ubuntu-latest
|
||||
environment:
|
||||
name: github-pages
|
||||
url: ${{ steps.deployment.outputs.page_url }}
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- name: Check generated blocks are up to date
|
||||
run: node scripts/sync-site.mjs --check
|
||||
- uses: actions/configure-pages@v5
|
||||
- uses: actions/upload-pages-artifact@v3
|
||||
with:
|
||||
path: website
|
||||
- id: deployment
|
||||
uses: actions/deploy-pages@v4
|
||||
@@ -9,13 +9,15 @@ 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.
|
||||
|
||||
User-facing documentation lives at https://faceclaw.org/.
|
||||
|
||||
|
||||
## Screenshots
|
||||
|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||
|
||||
## Installation
|
||||
|
||||
@@ -34,53 +36,55 @@ port into your computer, authorize access on the phone, and run
|
||||
|
||||
## Features
|
||||
|
||||
* A voice assistant that wakes up when you say "Hey Even", transcribes text
|
||||
with an on-device model, OpenAI Whisper, ElevenLabs, or Soniox API, and
|
||||
responds to queries and commands using an onboard model (Qwen3 4B, slow)
|
||||
or with an Anthropic or OpenAI model (requires an API key), or using your
|
||||
own long-running OpenClaw agent (see "Connecting an external agent" below).
|
||||
* Multitasking, with an app-switcher sidebar and app launcher
|
||||
* Mostly-compatible with EvenHub apps
|
||||
* A lock screen; glasses lock automatically when you take them off and unlock
|
||||
when you unlock your phone
|
||||
* Full-screen apps can use 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
|
||||
<!-- Generated from website/content/features.md by scripts/sync-site.mjs; edit there. -->
|
||||
<!-- BEGIN GENERATED: features -->
|
||||
* **A voice assistant** that wakes up when you say "Hey Even", transcribes
|
||||
text with an on-device model, OpenAI Whisper, ElevenLabs, or Soniox API,
|
||||
and responds to queries and commands using an onboard model (Qwen3 4B,
|
||||
slow) or with an Anthropic or OpenAI model (requires an API key), or using
|
||||
your own long-running OpenClaw agent.
|
||||
* **Multitasking**, with an app-switcher sidebar and app launcher.
|
||||
* **Mostly-compatible with EvenHub apps.**
|
||||
* **A lock screen**; glasses lock automatically when you take them off and
|
||||
unlock when you unlock your phone.
|
||||
* **The full display.** Full-screen apps can use 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.
|
||||
* **Terminal mirroring.** 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
|
||||
* A Wear OS watch app that replaces (and outdoes) the R1 ring: tap, swipe,
|
||||
hold and crown gestures, side buttons, app launching and window switching,
|
||||
voice or keyboard queries to the assistant with the reply on your wrist,
|
||||
typing into apps, and glasses status/lock/display control (see "Watch
|
||||
remote" below)
|
||||
* On-phone screen mirroring with touch control: tap what you see on the
|
||||
* **Connection management** with auto-reconnect, and autodetection of
|
||||
conflict with the official Even Realities app.
|
||||
* **A Wear OS watch app** that replaces (and outdoes) the R1 ring: tap,
|
||||
swipe, hold and crown gestures, side buttons, app launching and window
|
||||
switching, voice or keyboard queries to the assistant with the reply on
|
||||
your wrist, typing into apps, and glasses status/lock/display control.
|
||||
* **On-phone screen mirroring with touch control**: tap what you see on the
|
||||
mirror (sidebar icons, launcher cells), or use the phone's own touchpad,
|
||||
d-pad and Back/Menu buttons — the same spatial scheme as the watch — plus
|
||||
a compact ring simulator. A display-mode picker (576×288 band, 576×480
|
||||
tall, or the full 640×480 panel with an auto-hiding sidebar) and a
|
||||
brightness slider with an Auto toggle sit beside the mirror.
|
||||
* Bluetooth pairing that scans for nearby glasses and identifies each pair
|
||||
before connecting: model, frame shape, and colour decoded from the
|
||||
d-pad and Back/Menu buttons — the same spatial scheme as the watch — plus a
|
||||
compact ring simulator. A display-mode picker (576×288 band, 576×480 tall,
|
||||
or the full 640×480 panel with an auto-hiding sidebar) and a brightness
|
||||
slider with an Auto toggle sit beside the mirror.
|
||||
* **Bluetooth pairing** that scans for nearby glasses and identifies each
|
||||
pair before connecting: model, frame shape, and colour decoded from the
|
||||
advertised serial (with product photos), left and right arms matched to
|
||||
each other by that serial, an estimated distance so the pair in your hand
|
||||
sorts first, and the optional R1 ring
|
||||
* Dual-language NativeScript architecture with Java for the multithreaded
|
||||
Android API and bluetooth stack bits, Typescript for the bits you want to
|
||||
hack on
|
||||
sorts first, and the optional R1 ring.
|
||||
* **Dual-language NativeScript architecture**, with Java for the
|
||||
multithreaded Android API and bluetooth stack bits, Typescript for the bits
|
||||
you want to hack on.
|
||||
<!-- END GENERATED: features -->
|
||||
|
||||
## Watch remote (Wear OS)
|
||||
|
||||
|
||||
@@ -0,0 +1 @@
|
||||
faceclaw.org
|
||||
@@ -0,0 +1,59 @@
|
||||
# faceclaw.org
|
||||
|
||||
The Faceclaw website: plain HTML and one stylesheet, no build step and no
|
||||
external dependencies. GitHub Actions publishes this directory to GitHub Pages
|
||||
on every push to `main` that touches it (`.github/workflows/pages.yml`).
|
||||
|
||||
## Layout
|
||||
|
||||
index.html landing page
|
||||
install.html install instructions
|
||||
privacy.html privacy policy (body generated, see below)
|
||||
style.css the whole stylesheet
|
||||
content/ canonical copies of content shared with the repo root
|
||||
images/ logo and favicon, derived from ../images/FaceclawAppIcon.png
|
||||
screenshots/ glasses captures, also used by the root README
|
||||
CNAME custom domain
|
||||
|
||||
## Shared content
|
||||
|
||||
Two things appear both here and in the repository root, and are generated
|
||||
rather than copied by hand:
|
||||
|
||||
| Source | Destinations |
|
||||
| --------------------------- | ------------------------------------- |
|
||||
| `content/features.md` | `README.md`, `index.html` |
|
||||
| `../PRIVACY` | `privacy.html` |
|
||||
|
||||
Edit the source, then run:
|
||||
|
||||
node scripts/sync-site.mjs
|
||||
|
||||
Each destination has a `<!-- BEGIN GENERATED: key -->` / `<!-- END GENERATED: key -->`
|
||||
pair; the script rewrites what is between them and leaves the rest alone. CI
|
||||
runs `node scripts/sync-site.mjs --check` and fails the deploy if a
|
||||
destination is stale.
|
||||
|
||||
## Previewing
|
||||
|
||||
Any static file server will do, since there is nothing to compile:
|
||||
|
||||
python3 -m http.server -d website 8000
|
||||
|
||||
## Setting up the custom domain
|
||||
|
||||
Publishing needs Settings > Pages > Source set to "GitHub Actions". For
|
||||
`faceclaw.org`, point the apex at GitHub's Pages addresses:
|
||||
|
||||
A faceclaw.org 185.199.108.153
|
||||
A faceclaw.org 185.199.109.153
|
||||
A faceclaw.org 185.199.110.153
|
||||
A faceclaw.org 185.199.111.153
|
||||
AAAA faceclaw.org 2606:50c0:8000::153
|
||||
AAAA faceclaw.org 2606:50c0:8001::153
|
||||
AAAA faceclaw.org 2606:50c0:8002::153
|
||||
AAAA faceclaw.org 2606:50c0:8003::153
|
||||
CNAME www jimrandomh.github.io.
|
||||
|
||||
Then set the custom domain in Settings > Pages and enable "Enforce HTTPS"
|
||||
once the certificate has been issued.
|
||||
@@ -0,0 +1,24 @@
|
||||
<!--
|
||||
Canonical feature list for both README.md and website/index.html.
|
||||
Edit here, then run `node scripts/sync-site.mjs` to update both.
|
||||
|
||||
Format: one `- ` bullet per feature, continuation lines indented two spaces.
|
||||
Inline markdown supported by the sync script: **bold**, [text](url), `code`.
|
||||
-->
|
||||
|
||||
- **A voice assistant** that wakes up when you say "Hey Even", transcribes text with an on-device model, OpenAI Whisper, ElevenLabs, or Soniox API, and responds to queries and commands using an onboard model (Qwen3 4B, slow) or with an Anthropic or OpenAI model (requires an API key), or using your own long-running OpenClaw agent.
|
||||
- **Multitasking**, with an app-switcher sidebar and app launcher.
|
||||
- **Mostly-compatible with EvenHub apps.**
|
||||
- **A lock screen**; glasses lock automatically when you take them off and unlock when you unlock your phone.
|
||||
- **The full display.** Full-screen apps can use 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.
|
||||
- **Terminal mirroring.** 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.
|
||||
- **A Wear OS watch app** that replaces (and outdoes) the R1 ring: tap, swipe, hold and crown gestures, side buttons, app launching and window switching, voice or keyboard queries to the assistant with the reply on your wrist, typing into apps, and glasses status/lock/display control.
|
||||
- **On-phone screen mirroring with touch control**: tap what you see on the mirror (sidebar icons, launcher cells), or use the phone's own touchpad, d-pad and Back/Menu buttons — the same spatial scheme as the watch — plus a compact ring simulator. A display-mode picker (576×288 band, 576×480 tall, or the full 640×480 panel with an auto-hiding sidebar) and a brightness slider with an Auto toggle sit beside the mirror.
|
||||
- **Bluetooth pairing** that scans for nearby glasses and identifies each pair before connecting: model, frame shape, and colour decoded from the advertised serial (with product photos), left and right arms matched to each other by that serial, an estimated distance so the pair in your hand sorts first, and the optional R1 ring.
|
||||
- **Dual-language NativeScript architecture**, with Java for the multithreaded Android API and bluetooth stack bits, Typescript for the bits you want to hack on.
|
||||
|
After Width: | Height: | Size: 21 KiB |
|
After Width: | Height: | Size: 48 KiB |
@@ -0,0 +1,147 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>Faceclaw — an unofficial interface for the Even Realities G2</title>
|
||||
<meta name="description" content="Faceclaw is an unofficial Android user interface for the Even Realities G2 smart glasses: multitasking apps, a voice assistant, notifications, terminal mirroring and a Wear OS remote.">
|
||||
<meta property="og:title" content="Faceclaw">
|
||||
<meta property="og:description" content="An unofficial Android user interface for the Even Realities G2 smart glasses.">
|
||||
<meta property="og:type" content="website">
|
||||
<meta property="og:url" content="https://faceclaw.org/">
|
||||
<meta property="og:image" content="https://faceclaw.org/screenshots/launcher.png">
|
||||
<link rel="icon" href="images/favicon.png">
|
||||
<link rel="apple-touch-icon" href="images/favicon.png">
|
||||
<link rel="stylesheet" href="style.css">
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header class="topbar">
|
||||
<div class="wrap">
|
||||
<a class="brand" href="./"><img src="images/faceclaw-logo.png" alt="">Faceclaw</a>
|
||||
<nav>
|
||||
<a href="#features">Features</a>
|
||||
<a href="install.html">Install</a>
|
||||
<a href="privacy.html">Privacy</a>
|
||||
<a href="https://github.com/jimrandomh/faceclaw">GitHub</a>
|
||||
</nav>
|
||||
</div>
|
||||
</header>
|
||||
|
||||
<main>
|
||||
|
||||
<div class="wrap">
|
||||
<div class="hero">
|
||||
<img class="logo" src="images/faceclaw-logo.png" alt="Faceclaw logo: a lobster perched on a smiley face">
|
||||
<h1>Faceclaw</h1>
|
||||
<p class="tagline">An unofficial user interface for the Even Realities G2 smart glasses. Apps, a voice assistant, notifications and a watch remote — running from your Android phone.</p>
|
||||
<div class="buttons">
|
||||
<a class="btn primary" href="install.html">Install</a>
|
||||
<a class="btn" href="https://github.com/jimrandomh/faceclaw">Source on GitHub</a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<section>
|
||||
<div class="wrap">
|
||||
<div class="callout">
|
||||
<p><span class="eyebrow">Unofficial</span></p>
|
||||
<p>Faceclaw is not made by, endorsed by, or supported by Even Realities. It comes with no warranty from them or from anyone. It runs on Android, and it requires installing custom firmware on the glasses — the app can install and uninstall that firmware for you, downloading the stock firmware from Even and applying patches generated from <a href="https://github.com/jimrandomh/g2flash">g2flash</a>.</p>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<div class="wrap">
|
||||
<h2>What it looks like</h2>
|
||||
<div class="shots">
|
||||
<figure class="shot">
|
||||
<img src="screenshots/launcher.png" alt="The Faceclaw app launcher on the glasses display" width="604" height="288">
|
||||
<figcaption>The app launcher, with the app-switcher sidebar on the left.</figcaption>
|
||||
</figure>
|
||||
<figure class="shot">
|
||||
<img src="screenshots/music-player.png" alt="The music player on the glasses display" width="604" height="288">
|
||||
<figcaption>Media controls, working with most Android media players.</figcaption>
|
||||
</figure>
|
||||
<figure class="shot">
|
||||
<img src="screenshots/settings-assistant.png" alt="Assistant settings on the glasses display" width="604" height="288">
|
||||
<figcaption>Assistant settings, edited on the glasses themselves.</figcaption>
|
||||
</figure>
|
||||
<figure class="shot">
|
||||
<img src="screenshots/settings-display.png" alt="Display settings on the glasses display" width="604" height="288">
|
||||
<figcaption>Display settings, including height and vertical position.</figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section id="features">
|
||||
<div class="wrap">
|
||||
<h2>Features</h2>
|
||||
<!-- BEGIN GENERATED: features -->
|
||||
<ul class="features">
|
||||
<li><strong>A voice assistant</strong> that wakes up when you say "Hey Even", transcribes text with an on-device model, OpenAI Whisper, ElevenLabs, or Soniox API, and responds to queries and commands using an onboard model (Qwen3 4B, slow) or with an Anthropic or OpenAI model (requires an API key), or using your own long-running OpenClaw agent.</li>
|
||||
<li><strong>Multitasking</strong>, with an app-switcher sidebar and app launcher.</li>
|
||||
<li><strong>Mostly-compatible with EvenHub apps.</strong></li>
|
||||
<li><strong>A lock screen</strong>; glasses lock automatically when you take them off and unlock when you unlock your phone.</li>
|
||||
<li><strong>The full display.</strong> Full-screen apps can use the full 640x480 display area, rather than the 576x288 that EvenHub apps can use.</li>
|
||||
<li><strong>Integration with Android notifications</strong>: 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.</li>
|
||||
<li><strong>Terminal mirroring.</strong> Mirror terminal apps such as Claude Code or Codex CLI with <a href="https://github.com/jimrandomh/g2mirror">g2mirror</a>, view them on the glasses, and send them inputs with the voice assistant.</li>
|
||||
<li><strong>Media player controls</strong> including playlist and media library navigation, compatible with most Android media players.</li>
|
||||
<li><strong>Turn-by-turn directions</strong> (requires a Mapbox API token).</li>
|
||||
<li><strong>Nightscout</strong>, an app for viewing blood-glucose data (requires a cloud server and API token).</li>
|
||||
<li><strong>Power management</strong>: 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.</li>
|
||||
<li><strong>Connection management</strong> with auto-reconnect, and autodetection of conflict with the official Even Realities app.</li>
|
||||
<li><strong>A Wear OS watch app</strong> that replaces (and outdoes) the R1 ring: tap, swipe, hold and crown gestures, side buttons, app launching and window switching, voice or keyboard queries to the assistant with the reply on your wrist, typing into apps, and glasses status/lock/display control.</li>
|
||||
<li><strong>On-phone screen mirroring with touch control</strong>: tap what you see on the mirror (sidebar icons, launcher cells), or use the phone's own touchpad, d-pad and Back/Menu buttons — the same spatial scheme as the watch — plus a compact ring simulator. A display-mode picker (576×288 band, 576×480 tall, or the full 640×480 panel with an auto-hiding sidebar) and a brightness slider with an Auto toggle sit beside the mirror.</li>
|
||||
<li><strong>Bluetooth pairing</strong> that scans for nearby glasses and identifies each pair before connecting: model, frame shape, and colour decoded from the advertised serial (with product photos), left and right arms matched to each other by that serial, an estimated distance so the pair in your hand sorts first, and the optional R1 ring.</li>
|
||||
<li><strong>Dual-language NativeScript architecture</strong>, with Java for the multithreaded Android API and bluetooth stack bits, Typescript for the bits you want to hack on.</li>
|
||||
</ul>
|
||||
<!-- END GENERATED: features -->
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<div class="wrap">
|
||||
<h2>Beyond the glasses</h2>
|
||||
<div class="cards">
|
||||
<div class="card">
|
||||
<h3>Watch remote</h3>
|
||||
<p>A Wear OS companion app turns the whole watch face into a touchpad that outdoes the R1 ring: swipes, crown scrolling, side buttons, app launching, and spoken or typed queries with the reply on your wrist.</p>
|
||||
</div>
|
||||
<div class="card">
|
||||
<h3>EvenHub apps</h3>
|
||||
<p>Faceclaw runs EvenHub apps through an emulation layer. Install them from the Hub, or sideload your own by opening an <code>.ehpk</code> file on your phone.</p>
|
||||
</div>
|
||||
<div class="card">
|
||||
<h3>Your own agent</h3>
|
||||
<p>Instead of calling an LLM API from the phone, the assistant can route queries to your own long-running <a href="https://github.com/jimrandomh/faceclaw-agent-bridge">OpenClaw agent</a>, which also gets access to the glasses' tools.</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<div class="wrap">
|
||||
<h2>Contributing</h2>
|
||||
<p class="prose">Be bold. Modify Faceclaw into the app that you want it to be for yourself, without worrying about whether other people will like your version — then, if you think your changes might be useful to others, open a pull request. Faceclaw is Free Software under the GPLv3. See the <a href="https://github.com/jimrandomh/faceclaw#contributing">contributing notes</a> for what to test before you send a change.</p>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
<div class="wrap">
|
||||
<div class="links">
|
||||
<a href="https://github.com/jimrandomh/faceclaw">GitHub</a>
|
||||
<a href="install.html">Install</a>
|
||||
<a href="privacy.html">Privacy policy</a>
|
||||
<a href="https://github.com/jimrandomh/g2flash">g2flash firmware patches</a>
|
||||
<a href="https://github.com/jimrandomh/g2mirror">g2mirror</a>
|
||||
</div>
|
||||
<p>Faceclaw is Free Software, licensed under the GPLv3. It is unofficial, and is not affiliated with Even Realities.</p>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,80 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>Install — Faceclaw</title>
|
||||
<meta name="description" content="How to install Faceclaw on an Android phone and flash the custom firmware onto Even Realities G2 glasses.">
|
||||
<link rel="icon" href="images/favicon.png">
|
||||
<link rel="stylesheet" href="style.css">
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header class="topbar">
|
||||
<div class="wrap">
|
||||
<a class="brand" href="./"><img src="images/faceclaw-logo.png" alt="">Faceclaw</a>
|
||||
<nav>
|
||||
<a href="./#features">Features</a>
|
||||
<a href="install.html" aria-current="page">Install</a>
|
||||
<a href="privacy.html">Privacy</a>
|
||||
<a href="https://github.com/jimrandomh/faceclaw">GitHub</a>
|
||||
</nav>
|
||||
</div>
|
||||
</header>
|
||||
|
||||
<main>
|
||||
<section>
|
||||
<div class="wrap prose">
|
||||
<h1>Installing Faceclaw</h1>
|
||||
|
||||
<div class="callout">
|
||||
<p><span class="eyebrow">Read this first</span></p>
|
||||
<p>Faceclaw is unofficial and unsupported, and it replaces the firmware on your glasses. Installing it means running code that Even Realities did not write and will not help you with. The app can put the stock firmware back, but you are doing this at your own risk.</p>
|
||||
</div>
|
||||
|
||||
<h2>What you need</h2>
|
||||
<ul>
|
||||
<li>A pair of Even Realities G2 glasses.</li>
|
||||
<li>An Android phone. Faceclaw runs as a background app and talks to the glasses over Bluetooth LE.</li>
|
||||
<li>Optionally, a Wear OS 3+ watch, if you want the watch remote instead of the R1 ring.</li>
|
||||
</ul>
|
||||
<p>There is no iOS version, and there will not be one — the app depends on Android APIs for background Bluetooth, notification access and media control.</p>
|
||||
|
||||
<h2>Install the app</h2>
|
||||
<p>Faceclaw is not on the Play Store. Download the most recent APK from the <a href="https://github.com/jimrandomh/faceclaw/releases">releases page</a> and open it on your phone; Android will ask you to allow installing apps from that source.</p>
|
||||
|
||||
<h2>Install the firmware</h2>
|
||||
<p>Faceclaw needs custom firmware on the glasses, and installs it for you. On first run, the onboarding flow will offer to download the stock firmware from Even Realities, apply the <a href="https://github.com/jimrandomh/g2flash">g2flash</a> patches locally, and flash the result. You confirm the flash on the glasses themselves.</p>
|
||||
<p>Onboarding also offers a preview-only path, which connects to unmodified glasses so you can look around before committing. Faceclaw can restore the stock firmware later from the same screens.</p>
|
||||
|
||||
<h2>Grant permissions</h2>
|
||||
<p>Android does not reliably prompt for everything Faceclaw uses. After installing, go to <strong>Settings → Apps → Faceclaw</strong> and check that permissions are granted — notification access and Bluetooth in particular — or parts of the app will silently do nothing.</p>
|
||||
<p>Also exempt Faceclaw from battery optimization. Being a background app on a locked Android phone is fraught, and manufacturer-specific battery software may pause it or throttle it to low CPU usage.</p>
|
||||
|
||||
<h2>Optional extras</h2>
|
||||
<ul>
|
||||
<li><strong>Watch remote.</strong> The Wear OS app is a separate Gradle build in <code>wear/</code>, sideloaded over adb; it needs no Play Store, but the phone side requires Google Play services.</li>
|
||||
<li><strong>API keys.</strong> The voice assistant needs a model provider key (Anthropic or OpenAI), cloud transcription needs a key for OpenAI Whisper, ElevenLabs or Soniox, and turn-by-turn directions need a Mapbox token. On-device transcription needs no key.</li>
|
||||
<li><strong>Terminal mirroring.</strong> Install <a href="https://github.com/jimrandomh/g2mirror">g2mirror</a> on the machine whose terminal you want to see.</li>
|
||||
<li><strong>External agent.</strong> To route assistant queries to your own long-running agent, install the <a href="https://github.com/jimrandomh/faceclaw-agent-bridge">faceclaw-agent-bridge</a> OpenClaw plugin; setup lives in that repository's README.</li>
|
||||
</ul>
|
||||
|
||||
<h2>Building from source</h2>
|
||||
<p>Faceclaw is a NativeScript app written in TypeScript and Java, and builds with an Android SDK 35 environment and a JDK 21. The <a href="https://github.com/jimrandomh/faceclaw#installation">README</a> has the current build and <code>adb</code> instructions; they are kept there rather than duplicated here, so they stay in step with the code.</p>
|
||||
</div>
|
||||
</section>
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
<div class="wrap">
|
||||
<div class="links">
|
||||
<a href="https://github.com/jimrandomh/faceclaw">GitHub</a>
|
||||
<a href="./">Home</a>
|
||||
<a href="privacy.html">Privacy policy</a>
|
||||
</div>
|
||||
<p>Faceclaw is Free Software, licensed under the GPLv3. It is unofficial, and is not affiliated with Even Realities.</p>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,80 @@
|
||||
<!doctype html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>Privacy policy — Faceclaw</title>
|
||||
<meta name="description" content="The Faceclaw privacy policy: what third-party services the app can talk to, what they receive, and where their own policies live.">
|
||||
<link rel="icon" href="images/favicon.png">
|
||||
<link rel="stylesheet" href="style.css">
|
||||
</head>
|
||||
<body>
|
||||
|
||||
<header class="topbar">
|
||||
<div class="wrap">
|
||||
<a class="brand" href="./"><img src="images/faceclaw-logo.png" alt="">Faceclaw</a>
|
||||
<nav>
|
||||
<a href="./#features">Features</a>
|
||||
<a href="install.html">Install</a>
|
||||
<a href="privacy.html" aria-current="page">Privacy</a>
|
||||
<a href="https://github.com/jimrandomh/faceclaw">GitHub</a>
|
||||
</nav>
|
||||
</div>
|
||||
</header>
|
||||
|
||||
<main>
|
||||
<section>
|
||||
<div class="wrap prose">
|
||||
<!-- BEGIN GENERATED: privacy -->
|
||||
<h1>Faceclaw Privacy Policy</h1>
|
||||
<p>Faceclaw is a privacy-conscious app. The developers of Faceclaw don't collect or store user data. Faceclaw does integrate with some third-party services, which have their own privacy policies; this document describes what those services are, what they're used for and what data they collect, and links to their privacy policies.</p>
|
||||
<h2>Audio</h2>
|
||||
<p>Faceclaw allows users to transcribe audio (for use with the voice assistant, the Transcribe app, typing into Terminal, and other apps). The default setting is that this is done using an on-device model running on your phone. If an on-device model is selected, audio never leaves your device, and is not stored after it is processed.</p>
|
||||
<p>Users can also provide their own API key for a third-party transcription service such as OpenAI Whisper, ElevenLabs, or Soniox, which may offer better accuracy. Faceclaw never transmits audio to any party other than a user-selected transcription service. If a third-party transcription service is selected, audio will be sent to that third party, is linked to the account with which that API key was created, and is subject to that party's privacy and retention policies:</p>
|
||||
<ul class="links">
|
||||
<li>OpenAI: <a href="https://openai.com/policies/row-privacy-policy/">https://openai.com/policies/row-privacy-policy/</a></li>
|
||||
<li>ElevenLabs: <a href="https://elevenlabs.io/privacy-policy">https://elevenlabs.io/privacy-policy</a></li>
|
||||
<li>Soniox: <a href="https://soniox.com/policies/privacy-policy">https://soniox.com/policies/privacy-policy</a></li>
|
||||
</ul>
|
||||
<p>Third party data retention and privacy policies may differ based on the API key provided. API keys are part of a relationship between the user and the API provider; Faceclaw does not manage accounts or process billing information.</p>
|
||||
<h2>AI Assistant Transcripts</h2>
|
||||
<p>Faceclaw has a builtin AI voice assistant. Using the voice assistant requires providing an API key for a model provider such as Anthropic or OpenAI. Prompts and responses are subject to that model provider's privacy policy:</p>
|
||||
<ul class="links">
|
||||
<li>OpenAI: <a href="https://openai.com/policies/row-privacy-policy/">https://openai.com/policies/row-privacy-policy/</a></li>
|
||||
<li>Anthropic: <a href="https://www.anthropic.com/legal/privacy">https://www.anthropic.com/legal/privacy</a></li>
|
||||
</ul>
|
||||
<p>AI conversation histories and memory files may be stored on your phone. Faceclaw does not transmit voice-assistant prompts or responses to any party other than a user-selected AI model provider. The voice assistant is given tools with which it is able to access most things on the user's phone, including all content displayed on the glasses, location, notifications, and content accessible through the Terminal app.</p>
|
||||
<p>The AI assistant can take actions on the user's behalf, including sharing any information it has access to. The user is responsible for any instructions they give it.</p>
|
||||
<h2>Location</h2>
|
||||
<p>Faceclaw has a builtin Navigate app, which provides turn-by-turn directions. Using the Navigate app requires providing an API key for Mapbox. While the Navigate app is active, the user's exact location and selected destination are transmitted to Mapbox, and are subject to Mapbox's privacy policy.</p>
|
||||
<ul class="links">
|
||||
<li>Mapbox: <a href="https://www.mapbox.com/legal/privacy">https://www.mapbox.com/legal/privacy</a></li>
|
||||
</ul>
|
||||
<p>The Weather app will retrieve the user's coarse location, and will use it to query a third-party weather information provider.</p>
|
||||
<h2>EvenHub</h2>
|
||||
<p>The EvenHub app store is subject to Even Realities' privacy policy: <a href="https://support.evenrealities.com/hc/en-us/articles/14127464826511-Privacy-Policy">https://support.evenrealities.com/hc/en-us/articles/14127464826511-Privacy-Policy</a>. Apps downloaded from the EvenHub app store come with their own privacy policies.</p>
|
||||
<h2>Wear OS Watch</h2>
|
||||
<p>The optional Faceclaw watch app (wear/) talks to the phone over Google Play services' Wearable Data Layer, the same channel the watch uses for notifications and other companion apps. Gestures, commands, the watch's own speech-recognition results, and the mirrored glasses status and assistant replies travel between your watch and your phone over their Bluetooth (or, when paired that way, Wi-Fi) link; Faceclaw does not send any of it to a server. Speech recognized on the watch uses the watch's system speech recognizer, which may send audio to Google under Google's privacy policy:</p>
|
||||
<ul class="links">
|
||||
<li>Google: <a href="https://policies.google.com/privacy">https://policies.google.com/privacy</a></li>
|
||||
</ul>
|
||||
<p>The phone does nothing watch-related on phones without Google Play services.</p>
|
||||
<!-- END GENERATED: privacy -->
|
||||
<p class="meta">This page is generated from the <a href="https://github.com/jimrandomh/faceclaw/blob/main/PRIVACY">PRIVACY</a> file in the Faceclaw repository, which is the authoritative copy.</p>
|
||||
</div>
|
||||
</section>
|
||||
</main>
|
||||
|
||||
<footer>
|
||||
<div class="wrap">
|
||||
<div class="links">
|
||||
<a href="https://github.com/jimrandomh/faceclaw">GitHub</a>
|
||||
<a href="./">Home</a>
|
||||
<a href="install.html">Install</a>
|
||||
</div>
|
||||
<p>Faceclaw is Free Software, licensed under the GPLv3. It is unofficial, and is not affiliated with Even Realities.</p>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
|
Before Width: | Height: | Size: 5.0 KiB After Width: | Height: | Size: 5.0 KiB |
|
Before Width: | Height: | Size: 8.9 KiB After Width: | Height: | Size: 8.9 KiB |
|
Before Width: | Height: | Size: 4.8 KiB After Width: | Height: | Size: 4.8 KiB |
|
Before Width: | Height: | Size: 3.9 KiB After Width: | Height: | Size: 3.9 KiB |
@@ -0,0 +1,178 @@
|
||||
/* Faceclaw website. Hand-written, no build step, no external assets. */
|
||||
|
||||
:root {
|
||||
--bg: #0d1226;
|
||||
--bg-raised: #141b38;
|
||||
--line: #26305a;
|
||||
--fg: #e9ecf7;
|
||||
--fg-dim: #98a1c4;
|
||||
--accent: #f5c531;
|
||||
--accent-warm: #e8503a;
|
||||
--lens: #000;
|
||||
--mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
|
||||
--sans: system-ui, -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
|
||||
}
|
||||
|
||||
* { box-sizing: border-box; }
|
||||
|
||||
body {
|
||||
margin: 0;
|
||||
background: var(--bg);
|
||||
color: var(--fg);
|
||||
font: 16px/1.65 var(--sans);
|
||||
-webkit-font-smoothing: antialiased;
|
||||
}
|
||||
|
||||
.wrap { width: 100%; max-width: 960px; margin: 0 auto; padding: 0 24px; }
|
||||
|
||||
a { color: var(--accent); text-decoration-color: rgba(245, 197, 49, 0.4); text-underline-offset: 2px; }
|
||||
a:hover { text-decoration-color: var(--accent); }
|
||||
|
||||
h1, h2, h3 { line-height: 1.2; letter-spacing: -0.015em; }
|
||||
h2 { font-size: 1.5rem; margin: 0 0 16px; }
|
||||
h3 { font-size: 1.05rem; margin: 0 0 8px; }
|
||||
p { margin: 0 0 16px; }
|
||||
|
||||
code, kbd { font-family: var(--mono); font-size: 0.9em; }
|
||||
code {
|
||||
background: var(--bg-raised);
|
||||
border: 1px solid var(--line);
|
||||
border-radius: 4px;
|
||||
padding: 1px 5px;
|
||||
}
|
||||
pre {
|
||||
background: var(--bg-raised);
|
||||
border: 1px solid var(--line);
|
||||
border-radius: 8px;
|
||||
padding: 14px 16px;
|
||||
overflow-x: auto;
|
||||
margin: 0 0 16px;
|
||||
}
|
||||
pre code { background: none; border: 0; padding: 0; }
|
||||
|
||||
/* ---- site chrome ---- */
|
||||
|
||||
.topbar {
|
||||
border-bottom: 1px solid var(--line);
|
||||
position: sticky;
|
||||
top: 0;
|
||||
background: rgba(13, 18, 38, 0.9);
|
||||
backdrop-filter: blur(8px);
|
||||
z-index: 10;
|
||||
}
|
||||
.topbar .wrap { display: flex; align-items: center; gap: 20px; height: 56px; }
|
||||
.brand { display: flex; align-items: center; gap: 9px; font-weight: 650; color: var(--fg); text-decoration: none; }
|
||||
.brand img { width: 22px; height: 22px; }
|
||||
.topbar nav { margin-left: auto; display: flex; gap: 20px; font-size: 0.94rem; }
|
||||
.topbar nav a { color: var(--fg-dim); text-decoration: none; }
|
||||
.topbar nav a:hover, .topbar nav a[aria-current="page"] { color: var(--fg); }
|
||||
|
||||
section { padding: 56px 0; border-top: 1px solid var(--line); }
|
||||
section:first-of-type { border-top: 0; }
|
||||
|
||||
footer {
|
||||
border-top: 1px solid var(--line);
|
||||
padding: 32px 0 56px;
|
||||
color: var(--fg-dim);
|
||||
font-size: 0.9rem;
|
||||
}
|
||||
footer a { color: var(--fg-dim); }
|
||||
footer .links { display: flex; flex-wrap: wrap; gap: 18px; margin-bottom: 12px; }
|
||||
|
||||
/* ---- hero ---- */
|
||||
|
||||
.hero { text-align: center; padding: 72px 0 56px; }
|
||||
.hero img.logo { width: 104px; height: 104px; }
|
||||
.hero h1 { font-size: clamp(2.2rem, 6vw, 3.1rem); margin: 18px 0 10px; }
|
||||
.hero .tagline { font-size: 1.2rem; color: var(--fg-dim); max-width: 34em; margin: 0 auto 28px; }
|
||||
|
||||
.buttons { display: flex; gap: 12px; justify-content: center; flex-wrap: wrap; }
|
||||
.btn {
|
||||
display: inline-block;
|
||||
padding: 11px 22px;
|
||||
border-radius: 8px;
|
||||
border: 1px solid var(--line);
|
||||
font-weight: 600;
|
||||
text-decoration: none;
|
||||
color: var(--fg);
|
||||
}
|
||||
.btn:hover { border-color: var(--fg-dim); }
|
||||
.btn.primary { background: var(--accent); border-color: var(--accent); color: #1a1400; }
|
||||
.btn.primary:hover { background: #ffd44f; border-color: #ffd44f; }
|
||||
|
||||
.eyebrow {
|
||||
font-family: var(--mono);
|
||||
font-size: 0.78rem;
|
||||
letter-spacing: 0.08em;
|
||||
text-transform: uppercase;
|
||||
color: var(--accent-warm);
|
||||
}
|
||||
|
||||
/* ---- callout ---- */
|
||||
|
||||
.callout {
|
||||
border: 1px solid var(--line);
|
||||
border-left: 3px solid var(--accent-warm);
|
||||
border-radius: 8px;
|
||||
background: var(--bg-raised);
|
||||
padding: 16px 20px;
|
||||
margin: 0 0 24px;
|
||||
}
|
||||
.callout p:last-child { margin-bottom: 0; }
|
||||
|
||||
/* ---- screenshots ---- */
|
||||
|
||||
.shots { display: grid; grid-template-columns: repeat(2, 1fr); gap: 24px; }
|
||||
.shot { margin: 0; }
|
||||
.shot img {
|
||||
display: block;
|
||||
width: 100%;
|
||||
background: var(--lens);
|
||||
border: 1px solid var(--line);
|
||||
border-radius: 6px;
|
||||
image-rendering: pixelated;
|
||||
}
|
||||
.shot figcaption { color: var(--fg-dim); font-size: 0.88rem; margin-top: 8px; }
|
||||
|
||||
/* ---- features ---- */
|
||||
|
||||
.features { list-style: none; padding: 0; margin: 0; columns: 2; column-gap: 40px; }
|
||||
.features li {
|
||||
break-inside: avoid;
|
||||
margin: 0 0 18px;
|
||||
padding-left: 20px;
|
||||
position: relative;
|
||||
color: var(--fg-dim);
|
||||
}
|
||||
.features li::before { content: "▸"; position: absolute; left: 0; color: var(--accent); }
|
||||
.features li strong { color: var(--fg); font-weight: 600; }
|
||||
|
||||
/* ---- cards ---- */
|
||||
|
||||
.cards { display: grid; grid-template-columns: repeat(3, 1fr); gap: 20px; }
|
||||
.card {
|
||||
border: 1px solid var(--line);
|
||||
border-radius: 10px;
|
||||
background: var(--bg-raised);
|
||||
padding: 20px;
|
||||
}
|
||||
.card p { color: var(--fg-dim); font-size: 0.94rem; margin: 0; }
|
||||
|
||||
/* ---- long-form prose (privacy, install) ---- */
|
||||
|
||||
.prose { max-width: 44em; }
|
||||
.prose h2 { margin-top: 40px; padding-top: 8px; }
|
||||
.prose h2:first-child { margin-top: 0; }
|
||||
.prose ul { padding-left: 22px; }
|
||||
.prose li { margin-bottom: 6px; }
|
||||
.prose ul.links { list-style: none; padding-left: 0; font-family: var(--mono); font-size: 0.88rem; }
|
||||
.prose ul.links li { margin-bottom: 4px; }
|
||||
.prose .meta { color: var(--fg-dim); font-size: 0.9rem; }
|
||||
|
||||
@media (max-width: 700px) {
|
||||
.shots { grid-template-columns: 1fr; }
|
||||
.features { columns: 1; }
|
||||
.cards { grid-template-columns: 1fr; }
|
||||
.topbar nav { gap: 14px; }
|
||||
section { padding: 40px 0; }
|
||||
}
|
||||