Add a GitHub Pages website

This commit is contained in:
James Babcock committed 2026-08-29 15:02:22 -07:00
1 parent aebb88f917
commit 20677116ca
15 files changed
+660 -47

No files matched your search

+40
View File
@@ -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
+51 -47
View File
@@ -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
![App launcher](screenshots/launcher.png)
![Music player](screenshots/music-player.png)
![Assistant settings](screenshots/settings-assistant.png)
![Display settings](screenshots/settings-display.png)
![App launcher](website/screenshots/launcher.png)
![Music player](website/screenshots/music-player.png)
![Assistant settings](website/screenshots/settings-assistant.png)
![Display settings](website/screenshots/settings-display.png)
## 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)
+1
View File
@@ -0,0 +1 @@
faceclaw.org
+59
View File
@@ -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.
+24
View File
@@ -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.
Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

+147
View File
@@ -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>
+80
View File
@@ -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 &rarr; Apps &rarr; 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>
+80
View File
@@ -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>
File renamed without changes.

Before

Width:  |  Height:  |  Size: 5.0 KiB

After

Width:  |  Height:  |  Size: 5.0 KiB

File renamed without changes.

Before

Width:  |  Height:  |  Size: 8.9 KiB

After

Width:  |  Height:  |  Size: 8.9 KiB

File renamed without changes.

Before

Width:  |  Height:  |  Size: 4.8 KiB

After

Width:  |  Height:  |  Size: 4.8 KiB

File renamed without changes.

Before

Width:  |  Height:  |  Size: 3.9 KiB

After

Width:  |  Height:  |  Size: 3.9 KiB

+178
View File
@@ -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; }
}