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.
+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.
Unofficial
-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 g2flash.
+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 g2flash.
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.
+Some features are platform-specific: Android notification access, Android media controls and the Wear OS remote are Android features.
-The iPhone beta uses Apple's TestFlight. No compiling or developer account is needed.
+First public build pending: installation will become available after Apple approves the beta. Until then, TestFlight may say this beta is not accepting testers.
+TestFlight privacy: 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 privacy policy before joining.
+TestFlight builds expire after 90 days. Keep Faceclaw updated through TestFlight. To leave, open Faceclaw's page in TestFlight and choose Stop Testing, then uninstall the beta.
+ +Faceclaw is not on the Play Store. Download the most recent APK from the releases page and open it on your phone; Android will ask you to allow installing apps from that source.
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 g2flash patches locally, and flash the result. You confirm the flash on the glasses themselves.
-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.
+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.
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.
Android does not reliably prompt for everything Faceclaw uses. After installing, go to Settings → Apps → Faceclaw and check that permissions are granted — notification access and Bluetooth in particular — or parts of the app will silently do nothing.
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.
@@ -60,7 +75,7 @@Faceclaw is a NativeScript app written in TypeScript and Java, and builds with an Android SDK 35 environment and a JDK 21. The README has the current build and adb instructions; they are kept there rather than duplicated here, so they stay in step with the code.
Faceclaw uses NativeScript, TypeScript and native platform code. See the README for Android build instructions and the iOS development guide for building with Xcode on a Mac.
diff --git a/website/privacy.html b/website/privacy.html index 938337ac..48700a64 100644 --- a/website/privacy.html +++ b/website/privacy.html @@ -27,10 +27,10 @@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.
+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.
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 > Privacy. Until you choose, it is None.
-With None, Faceclaw sends nothing and keeps no statistics on your phone.
+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 > Privacy > Faceclaw statistics. Until you choose, it is None. This setting controls only Faceclaw's own statistics.
+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.
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:
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.
+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.
+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.
+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.
+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.
+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.
+For ordinary iOS analytics, use iPhone Settings > Privacy & Security > Analytics & Improvements, including Share With App Developers. Faceclaw cannot change these system settings. TestFlight crash reporting applies regardless of those settings. See https://www.apple.com/legal/privacy/data/en/app-analytics/.
+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 https://privacy.apple.com/.
+Apple's details: https://www.apple.com/legal/privacy/data/en/test-flight/ and https://testflight.apple.com/.
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.
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: