Prepare 0.8.3-rc1 TestFlight beta and public signup

This commit is contained in:
James Babcock committed 2026-10-10 18:43:02 -07:00
1 parent 5df873e5b1
commit e5f6dc1976
17 files changed
+263 -40

No files matched your search

+5 -4
View File
@@ -4,9 +4,9 @@
<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 name="description" content="Faceclaw is an unofficial user interface for the Even Realities G2 smart glasses, running on Android and iPhone: multitasking apps, a voice assistant and terminal mirroring.">
<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:description" content="An unofficial user interface for the Even Realities G2 smart glasses, running on Android and iPhone.">
<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">
@@ -34,9 +34,10 @@
<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>
<p class="tagline">An unofficial user interface for the Even Realities G2 smart glasses. Apps, a voice assistant and terminal mirroring — running from your Android phone or iPhone.</p>
<div class="buttons">
<a class="btn primary" href="install.html">Install</a>
<a class="btn" href="install.html#ios">iPhone beta</a>
<a class="btn" href="https://github.com/jimrandomh/faceclaw">Source on GitHub</a>
</div>
</div>
@@ -46,7 +47,7 @@
<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>
<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 iPhone, and full glasses functionality requires installing custom firmware — 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>
+23 -8
View File
@@ -4,7 +4,7 @@
<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.">
<meta name="description" content="Install Faceclaw on Android or try the iPhone beta, and set up your Even Realities G2 glasses.">
<link rel="icon" href="images/favicon.png">
<link rel="stylesheet" href="style.css">
</head>
@@ -34,20 +34,35 @@
<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>
<li>A pair of Even Realities G2 glasses, or use Preview Only to explore on your phone without glasses.</li>
<li>An Android phone or an iPhone running iOS 15.1 or later. Faceclaw talks to the glasses over Bluetooth LE.</li>
<li>On Android, 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>
<p>Some features are platform-specific: Android notification access, Android media controls and the Wear OS remote are Android features.</p>
<h2>Install the app</h2>
<h2 id="ios">iPhone beta</h2>
<p>The iPhone beta uses Apple's TestFlight. No compiling or developer account is needed.</p>
<p><strong>First public build pending:</strong> installation will become available after Apple approves the beta. Until then, TestFlight may say this beta is not accepting testers.</p>
<div class="callout">
<p><strong>TestFlight privacy:</strong> Apple automatically collects crash logs, installs, sessions and device/app details, and shares beta testing data with Faceclaw's developers. Faceclaw's statistics setting cannot disable this. Joining through a public link hides your name and email from us, but not from Apple; email invitations and optional feedback can identify you. Read the <a href="privacy.html">privacy policy</a> before joining.</p>
</div>
<p><a class="btn primary" href="https://testflight.apple.com/join/R7kPtdqm">Join the iPhone beta</a></p>
<ol>
<li>Open the signup link on your iPhone and follow Apple's instructions to install TestFlight.</li>
<li>Return to the signup link, accept the invitation, and install Faceclaw in TestFlight.</li>
<li>Open Faceclaw and follow onboarding, or choose <strong>Preview Only</strong> to explore without glasses.</li>
</ol>
<p>TestFlight builds expire after 90 days. Keep Faceclaw updated through TestFlight. To leave, open Faceclaw's page in TestFlight and choose <strong>Stop Testing</strong>, then uninstall the beta.</p>
<h2 id="android">Android</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>
<p>Onboarding also offers a Preview Only path so you can explore the interface on your phone without glasses. Faceclaw can restore the stock firmware later from the same screens.</p>
<h2>Grant permissions</h2>
<p>On iPhone, allow Bluetooth when prompted to connect your glasses. Features such as voice input and navigation may request microphone, speech recognition or location access when needed; you can review Faceclaw's permissions in iPhone Settings.</p>
<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>
@@ -60,7 +75,7 @@
</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>
<p>Faceclaw uses NativeScript, TypeScript and native platform code. See the <a href="https://github.com/jimrandomh/faceclaw#installation">README</a> for Android build instructions and the <a href="https://github.com/jimrandomh/faceclaw/blob/main/notes/ios-development.md">iOS development guide</a> for building with Xcode on a Mac.</p>
</div>
</section>
</main>
+12 -4
View File
@@ -27,10 +27,10 @@
<div class="wrap prose">
<!-- BEGIN GENERATED: privacy -->
<h1>Faceclaw Privacy Policy</h1>
<p>Faceclaw is a privacy-conscious app. Unless you choose to share anonymous usage statistics (described below), the developers of Faceclaw don't collect or store any data about you or how you use the app. 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>
<p>Faceclaw's own usage statistics are off unless you opt in. Separately, Apple collects and shares information when you use an iOS TestFlight build, even when Faceclaw statistics are set to None. Information you voluntarily send us, such as feedback, may also identify you. This policy describes these separate channels and the third-party services you can choose to use.</p>
<h2>Usage Statistics</h2>
<p>The first time you connect your glasses, Faceclaw asks whether to share anonymous usage statistics with its developers, to help them fix problems and improve the app. The choices are None, Minimal and Full, and you can change your choice at any time in Settings &gt; Privacy. Until you choose, it is None.</p>
<p>With None, Faceclaw sends nothing and keeps no statistics on your phone.</p>
<p>The first time you connect your glasses, Faceclaw asks whether to share usage statistics with its developers, to help them fix problems and improve the app. The choices are None, Minimal and Full, and you can change your choice at any time in Settings &gt; Privacy &gt; Faceclaw statistics. Until you choose, it is None. This setting controls only Faceclaw's own statistics.</p>
<p>With None, Faceclaw sends and stores none of its own usage statistics. This does not disable Apple's TestFlight reports or services you choose to use.</p>
<p>With Minimal, Faceclaw keeps counts on your phone and sends them about once a day to stats.faceclaw.org, a server run by Faceclaw's developers:</p>
<ul class="links">
<li>- the Faceclaw version, whether it runs on Android or iOS, and whether it is</li>
@@ -51,7 +51,15 @@
<li>switches and pick-one lists. Settings you type in, such as addresses,</li>
<li>URLs and names, are never sent.</li>
</ul>
<p>Statistics never include your name or contact details, your location, Bluetooth device addresses, anything you say or type, or what is shown on your glasses. Each report carries a random identifier, created when you turn statistics on, which links your reports to each other but not to you. Turning statistics off deletes that identifier and everything kept on the phone, and stops all reports; turning them back on starts a new identifier. The statistics server doesn't record the IP addresses reports come from.</p>
<p>Faceclaw's own statistics never include your name or contact details, your location, Bluetooth device addresses, anything you say or type, or what is shown on your glasses. Each report carries a random identifier, created when you turn statistics on, which links your reports to each other but not to you. Turning statistics off deletes that identifier and everything kept on the phone, and stops all reports; turning them back on starts a new identifier. The statistics server doesn't record the IP addresses reports come from.</p>
<h2>iOS and TestFlight</h2>
<p>For TestFlight builds, Apple automatically collects crash reports and beta usage information and shares them with us. This includes installations, sessions, crashes, app/build and OS versions, device model and identifier, and language. It is separate from Faceclaw statistics, with no in-app opt-out.</p>
<p>Joining only through a public TestFlight link hides your name and email from us, not from Apple. Email invitations can identify you to us. Apple also collects your device's name (not shared with us) and may use your IP address to estimate your region for beta availability.</p>
<p>Feedback is optional. Comments, screenshots and diagnostics submitted through TestFlight go to Apple and us. Public-link testers can omit their email in the feedback form. Email sent directly to us reveals your email even after public-link enrollment, but is not shared with Apple. Check screenshots and comments for private content; feedback can include device state such as battery level, free storage and network type.</p>
<p>Faceclaw has no public iOS API to switch off TestFlight's automatic reporting. Its statistics setting and iOS tracking permissions do not control it. To leave, select Stop Testing on Faceclaw's TestFlight information page, then stop using and uninstall the beta. This does not erase previous reports. Self-built installations do not use TestFlight reporting.</p>
<p>For ordinary iOS analytics, use iPhone Settings &gt; Privacy &amp; Security &gt; Analytics &amp; Improvements, including Share With App Developers. Faceclaw cannot change these system settings. TestFlight crash reporting applies regardless of those settings. See <a href="https://www.apple.com/legal/privacy/data/en/app-analytics/">https://www.apple.com/legal/privacy/data/en/app-analytics/</a>.</p>
<p>We use TestFlight reports only to improve Faceclaw, not for advertising or sharing with third parties. Apple retains feedback for one year and may keep crash/usage reports until bugs are resolved. For access/deletion requests, contact us using the developer email in TestFlight; manage Apple's data at <a href="https://privacy.apple.com/">https://privacy.apple.com/</a>.</p>
<p>Apple's details: <a href="https://www.apple.com/legal/privacy/data/en/test-flight/">https://www.apple.com/legal/privacy/data/en/test-flight/</a> and <a href="https://testflight.apple.com/">https://testflight.apple.com/</a>.</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>