mirror of
https://git.undefined-dev.fr/Blendman974/faceclaw.git
synced 2026-11-19 21:03:09 +00:00
Merge branch 'main' of https://github.com/jimrandomh/faceclaw
This commit is contained in:
commit
d01dbf5432
19 files changed
+268
-43
No files matched your search
@@ -251,7 +251,8 @@ if (faceclawVersionFile.exists()) {
|
||||
}
|
||||
}
|
||||
def faceclawVersionCode = {
|
||||
def parts = (faceclawVersionName.tokenize('.') + ["0", "0"]).take(3)*.toInteger()
|
||||
// Prerelease labels belong in versionName, not the numeric versionCode.
|
||||
def parts = (faceclawVersionName.split('-')[0].tokenize('.') + ["0", "0"]).take(3)*.toInteger()
|
||||
return parts[0] * 10000 + parts[1] * 100 + parts[2]
|
||||
}()
|
||||
|
||||
|
||||
@@ -13,7 +13,8 @@
|
||||
<key>CFBundleDisplayName</key>
|
||||
<string>Faceclaw</string>
|
||||
<key>CFBundleShortVersionString</key>
|
||||
<string>1.0.0</string>
|
||||
<!-- Apple requires a numeric version; the app displays 0.8.3-rc1. -->
|
||||
<string>0.8.3</string>
|
||||
<key>CFBundleVersion</key>
|
||||
<string>1</string>
|
||||
<key>LSRequiresIPhoneOS</key>
|
||||
|
||||
@@ -0,0 +1,30 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>NSPrivacyAccessedAPITypes</key>
|
||||
<array>
|
||||
<dict>
|
||||
<!-- Faceclaw preferences in its own NSUserDefaults domain. -->
|
||||
<key>NSPrivacyAccessedAPIType</key>
|
||||
<string>NSPrivacyAccessedAPICategoryUserDefaults</string>
|
||||
<key>NSPrivacyAccessedAPITypeReasons</key>
|
||||
<array><string>CA92.1</string></array>
|
||||
</dict>
|
||||
<dict>
|
||||
<!-- App-container files used by Faceclaw and its NativeScript/Kotlin runtimes. -->
|
||||
<key>NSPrivacyAccessedAPIType</key>
|
||||
<string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
|
||||
<key>NSPrivacyAccessedAPITypeReasons</key>
|
||||
<array><string>C617.1</string></array>
|
||||
</dict>
|
||||
<dict>
|
||||
<!-- NativeScript's monotonic clock measures elapsed time within the app. -->
|
||||
<key>NSPrivacyAccessedAPIType</key>
|
||||
<string>NSPrivacyAccessedAPICategorySystemBootTime</string>
|
||||
<key>NSPrivacyAccessedAPITypeReasons</key>
|
||||
<array><string>35F9.1</string></array>
|
||||
</dict>
|
||||
</array>
|
||||
</dict>
|
||||
</plist>
|
||||
@@ -1,10 +1,11 @@
|
||||
# Changelog
|
||||
|
||||
## 0.8.3 - Future
|
||||
## 0.8.3-rc1 - 2026-10-10
|
||||
|
||||
* Fix several issues that would cause disconnection and disconnect-looping
|
||||
* Add a client for T3 Code
|
||||
* Optional anonymous usage statistics (Settings>Privacy>Data collection; off by default)
|
||||
* Optional usage statistics (Settings>Privacy>Faceclaw statistics; off by default)
|
||||
* Disclose Apple's separate TestFlight reporting in iOS onboarding and privacy settings
|
||||
* Add an on-glasses Onboarding app, which prompts you to configure some things
|
||||
* iOS Notifications have an icon based on ANCS category
|
||||
* iOS voice input can use the ElevenLabs, OpenAI, and Soniox cloud transcription providers (Settings>Voice>Transcription Provider)
|
||||
|
||||
@@ -1,21 +1,22 @@
|
||||
# Faceclaw Privacy Policy
|
||||
|
||||
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.
|
||||
|
||||
|
||||
## Usage Statistics
|
||||
|
||||
The first time you connect your glasses, Faceclaw asks whether to share
|
||||
anonymous usage statistics with its developers, to help them fix problems and
|
||||
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.
|
||||
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 nothing and keeps no statistics on your phone.
|
||||
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:
|
||||
@@ -38,7 +39,7 @@ With Full, it also sends:
|
||||
switches and pick-one lists. Settings you type in, such as addresses,
|
||||
URLs and names, are never sent.
|
||||
|
||||
Statistics never include your name or contact details, your location,
|
||||
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.
|
||||
@@ -47,6 +48,46 @@ 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.
|
||||
|
||||
|
||||
## iOS and TestFlight
|
||||
|
||||
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/.
|
||||
|
||||
|
||||
## Audio
|
||||
|
||||
Faceclaw allows users to transcribe audio (for use with the voice assistant,
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
/** Conditional wording: also shown on self-built iOS apps, where TestFlight does not apply. */
|
||||
export const IOS_PRIVACY_NOTICE = [
|
||||
"If installed with TestFlight, Apple automatically collects crash logs, installs, sessions, and device/app details and shares them with Faceclaw's developers. This continues even when Faceclaw statistics are None; the app cannot turn it off.",
|
||||
"Joining only through a public link hides your name and email from us, not from Apple. Email invitations can identify you. Optional feedback can disclose your email, comments, screenshots and diagnostics. Review what you send.",
|
||||
"iPhone Settings > Privacy & Security > Analytics & Improvements controls ordinary iOS analytics. It does not stop TestFlight crash reports. Faceclaw cannot change Apple's analytics settings.",
|
||||
"To leave the beta, open Faceclaw in TestFlight and choose Stop Testing, then stop using and uninstall the beta. This does not erase earlier reports. Details: Settings > Privacy > Privacy policy.",
|
||||
].join("\n\n");
|
||||
|
||||
export const IOS_PRIVACY_SUMMARY =
|
||||
"With TestFlight, crash/usage reports continue even with None. Open iOS / TestFlight privacy for details.";
|
||||
@@ -31,9 +31,9 @@ export class DataCollectionPage implements OnboardingPage {
|
||||
paint(image: GrayImage, focused: boolean): void {
|
||||
const top = drawPageHeading(
|
||||
image,
|
||||
"Data collection",
|
||||
"Choose what Faceclaw may send its developers to help fix problems and improve the app. " +
|
||||
"You can change this later in Settings > Privacy.",
|
||||
"Faceclaw statistics",
|
||||
(global.isIOS ? "If using TestFlight, crash/usage reports cannot be disabled here. " : "") +
|
||||
"Choose optional Faceclaw statistics. Change later in Settings > Privacy.",
|
||||
3,
|
||||
) + CONTENT_GAP;
|
||||
const body = onboardingFont("body");
|
||||
|
||||
@@ -0,0 +1,42 @@
|
||||
import { IOS_PRIVACY_NOTICE } from "../../analytics/privacy-disclosure";
|
||||
import type { GrayImage } from "../../graphics/image";
|
||||
import { wrapText } from "../../graphics/textwrap";
|
||||
import type { InputEvent } from "../../ui/gestures";
|
||||
import { onboardingFont } from "./onboarding-fonts";
|
||||
import { drawPageHeading, PAGE_X, type OnboardingNav, type OnboardingPage } from "./onboarding-page";
|
||||
|
||||
/** Paginate the notice so no disclosure is silently clipped on a short glasses viewport. */
|
||||
export class IosPrivacyPage implements OnboardingPage {
|
||||
private page = 0;
|
||||
private pageCount = 1;
|
||||
|
||||
enter(): void { this.page = 0; }
|
||||
|
||||
paint(image: GrayImage): void {
|
||||
const top = drawPageHeading(image, "iOS / TestFlight privacy", "") + 8;
|
||||
const font = onboardingFont("detail");
|
||||
const lines = IOS_PRIVACY_NOTICE.split("\n\n").flatMap((paragraph, index) => [
|
||||
...(index ? [""] : []), ...wrapText(font, paragraph, image.width - 2 * PAGE_X),
|
||||
]);
|
||||
const perPage = Math.max(1, Math.floor((image.height - top - font.lineHeight - 20) / font.lineHeight));
|
||||
this.pageCount = Math.ceil(lines.length / perPage);
|
||||
this.page = Math.min(this.page, this.pageCount - 1);
|
||||
lines.slice(this.page * perPage, (this.page + 1) * perPage).forEach((line, index) => {
|
||||
image.drawText(font, PAGE_X, top + index * font.lineHeight, line, 200);
|
||||
});
|
||||
const action = this.page + 1 < this.pageCount ? "Tap for more" : "Tap to choose statistics";
|
||||
image.drawText(font, PAGE_X, image.height - font.lineHeight - 8,
|
||||
`${this.page + 1}/${this.pageCount} - ${action}`, 230);
|
||||
}
|
||||
|
||||
handleInput(event: InputEvent, nav: OnboardingNav): void {
|
||||
if (event.type === "click") {
|
||||
if (this.page + 1 < this.pageCount) this.page++;
|
||||
else nav.next();
|
||||
} else if (event.type === "scroll-down" || event.type === "swipe-up") {
|
||||
this.page = Math.min(this.page + 1, this.pageCount - 1);
|
||||
} else if (event.type === "scroll-up" || event.type === "swipe-down") {
|
||||
this.page = Math.max(0, this.page - 1);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -5,6 +5,7 @@ import { createInProcessWindow, type InProcessAppOptions, type InProcessWindow }
|
||||
import { shell } from "../../ui/shell/shell";
|
||||
import { findSoundEffect, playSoundEffect } from "../../ui/sound-effects";
|
||||
import { DataCollectionPage } from "./data-collection-page";
|
||||
import { IosPrivacyPage } from "./ios-privacy-page";
|
||||
import { markGlassesOnboardingFinished, ONBOARDING_APP_ID } from "./onboarding-progress";
|
||||
import type { OnboardingPage } from "./onboarding-page";
|
||||
import { TextSizePage } from "./text-size-page";
|
||||
@@ -21,7 +22,11 @@ export const ONBOARDING_SURFACE_ID = "window:onboarding";
|
||||
* closing it early leaves onboarding due.
|
||||
*/
|
||||
export function createOnboardingAppWindow(options: InProcessAppOptions): InProcessWindow {
|
||||
const pages: OnboardingPage[] = [new WelcomePage(), new TextSizePage(), new DataCollectionPage()];
|
||||
const pages: OnboardingPage[] = [
|
||||
new WelcomePage(), new TextSizePage(),
|
||||
...(global.isIOS ? [new IosPrivacyPage()] : []),
|
||||
new DataCollectionPage(),
|
||||
];
|
||||
const app = createInProcessWindow({
|
||||
appId: ONBOARDING_APP_ID,
|
||||
windowId: ONBOARDING_WINDOW_ID,
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
import { finishOnboardingNavigation } from "./onboarding-navigation";
|
||||
import { Frame, Observable, Screen } from "@nativescript/core";
|
||||
import { IOS_PRIVACY_NOTICE } from "../analytics/privacy-disclosure";
|
||||
|
||||
import { setOnboardingCompleted, setPreviewOnlyMode } from "./onboarding-state";
|
||||
|
||||
@@ -29,7 +30,8 @@ const STEP_CONTENT: Record<OnboardingStep, StepContent> = {
|
||||
2: {
|
||||
headline: "Before You Continue",
|
||||
tagline: "",
|
||||
body: "This software provides a custom user interface and functionality for the Even Realities G2 smart glasses. It is not created or supported by Even Realities. If this software somehow breaks your headset, this is not Even's fault and is not covered by the hardware's warranty. If this software doesn't break you headset, using this software may void the hardware's warranty anyways, at the sole discretion of Even Realities. This software is beta; don't rely on it for anything critically important.",
|
||||
body: "This software provides a custom user interface and functionality for the Even Realities G2 smart glasses. It is not created or supported by Even Realities. If this software somehow breaks your headset, this is not Even's fault and is not covered by the hardware's warranty. If this software doesn't break you headset, using this software may void the hardware's warranty anyways, at the sole discretion of Even Realities. This software is beta; don't rely on it for anything critically important." +
|
||||
(global.isIOS ? "\n\niOS / TestFlight privacy\n\n" + IOS_PRIVACY_NOTICE : ""),
|
||||
primaryLabel: "Agree",
|
||||
secondaryLabel: "Back",
|
||||
splash: false,
|
||||
|
||||
@@ -24,6 +24,7 @@ import { LIST_ROW_TEXT_INSET, lineStep } from "./metrics";
|
||||
import { Layer, type LayerContext } from "./layers";
|
||||
import { GrayImage } from "~/graphics/image";
|
||||
import type { DataCollectionLevel } from "../analytics/analytics-store";
|
||||
import { IOS_PRIVACY_SUMMARY } from "../analytics/privacy-disclosure";
|
||||
|
||||
export type NightscoutSettings = {
|
||||
siteUrl: string;
|
||||
@@ -697,7 +698,7 @@ const DATA_COLLECTION_LABELS: Record<DataCollectionLevel, string> = {
|
||||
// What each level collects is set out in app/analytics/analytics-store.ts and
|
||||
// the privacy policy (PRIVACY); keep these in step with both.
|
||||
const DATA_COLLECTION_SUMMARIES: Record<DataCollectionLevel, string> = {
|
||||
none: "Send nothing",
|
||||
none: "No Faceclaw statistics",
|
||||
minimal: "Version, devices, connection reliability",
|
||||
full: "Also settings and API-key presence",
|
||||
};
|
||||
@@ -710,14 +711,15 @@ export function dataCollectionSummary(level: DataCollectionLevel): string {
|
||||
/** Chosen in the on-glasses onboarding; changeable in Settings > Privacy. */
|
||||
export const dataCollectionSetting = new ConfigSettingEnum<DataCollectionLevel>({
|
||||
id: "data-collection",
|
||||
label: "Data collection",
|
||||
label: "Faceclaw statistics",
|
||||
storageKey: DATA_COLLECTION_KEY,
|
||||
defaultValue: "none",
|
||||
values: ["none", "minimal", "full"],
|
||||
formatValue: (value) => DATA_COLLECTION_LABELS[value],
|
||||
description:
|
||||
"Anonymous statistics Faceclaw may send its developers once a day, to help fix problems and improve the " +
|
||||
"app. None: send nothing, and keep nothing on the phone. Minimal: the app version, which devices are " +
|
||||
(global.isIOS ? IOS_PRIVACY_SUMMARY + " " : "") +
|
||||
"Optional statistics Faceclaw may send its developers once a day, to help fix problems and improve the " +
|
||||
"app. None: no Faceclaw statistics are stored or sent. Minimal: the app version, which devices are " +
|
||||
"paired and in use, and how reliable the connection to them is. Full: also settings chosen from fixed " +
|
||||
"options, and which kinds of API key are set (never the keys themselves).",
|
||||
});
|
||||
|
||||
@@ -23,6 +23,7 @@ import {
|
||||
type AsrModelId,
|
||||
} from "../../native/asr-model";
|
||||
import { TextViewerLayer } from "../../apps/files/text-viewer";
|
||||
import { IOS_PRIVACY_NOTICE } from "../../analytics/privacy-disclosure";
|
||||
import type { LayerContext } from "../layers";
|
||||
import { drawRightValueMenuItem, openModalMenu, submenuItem, type MenuItem } from "../menu";
|
||||
import { shell } from "../shell/shell";
|
||||
@@ -197,6 +198,12 @@ function settingsSections(): SettingsSection[] {
|
||||
items: [
|
||||
// First chosen in the on-glasses onboarding (app/apps/onboarding/).
|
||||
enumSettingMenuItem(dataCollectionSetting),
|
||||
...(global.isIOS ? [{
|
||||
label: "iOS / TestFlight privacy",
|
||||
description: "Apple's beta reports are separate from Faceclaw statistics. Tap to read.",
|
||||
onSelect: (ctx: LayerContext) => ctx.stack.push(new TextViewerLayer(IOS_PRIVACY_NOTICE, "iOS / TestFlight privacy")),
|
||||
}] : []),
|
||||
bundledDocMenuItem("PRIVACY", "Privacy policy"),
|
||||
],
|
||||
},
|
||||
{
|
||||
|
||||
+1
-1
@@ -1,2 +1,2 @@
|
||||
export const FACECLAW_VERSION = "0.8.2";
|
||||
export const FACECLAW_VERSION = "0.8.3-rc1";
|
||||
export const USER_AGENT = "Faceclaw/"+FACECLAW_VERSION;
|
||||
@@ -0,0 +1,57 @@
|
||||
const test = require('node:test');
|
||||
const assert = require('node:assert/strict');
|
||||
const { loader } = require('./helpers/load-typescript.cjs');
|
||||
|
||||
function harness(width, height) {
|
||||
const font = { lineHeight: 20, measureText: text => text.length * 10, getGlyph: () => ({ dwidthX: 10 }) };
|
||||
const load = loader({}, { './onboarding-fonts': { onboardingFont: () => font } });
|
||||
const { IosPrivacyPage } = load('app/apps/onboarding/ios-privacy-page.ts');
|
||||
const { IOS_PRIVACY_NOTICE } = load('app/analytics/privacy-disclosure.ts');
|
||||
const page = new IosPrivacyPage();
|
||||
let next = 0;
|
||||
return {
|
||||
page, notice: IOS_PRIVACY_NOTICE, get next() { return next; },
|
||||
input(type) { page.handleInput({ type }, { next: () => next++ }); },
|
||||
paint() {
|
||||
const rows = [];
|
||||
page.paint({ width, height, drawText(font, x, y, text) {
|
||||
assert.ok(x + font.measureText(text) <= width, `horizontal overflow: ${text}`);
|
||||
assert.ok(y >= 0 && y + font.lineHeight <= height, `vertical overflow: ${text}`);
|
||||
rows.push({ y, text });
|
||||
} });
|
||||
return rows;
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
for (const [width, height] of [[576, 188], [576, 260], [640, 432]]) {
|
||||
test(`entire iOS notice is readable before continuing at ${width}x${height}`, () => {
|
||||
const h = harness(width, height);
|
||||
const shown = [];
|
||||
for (let i = 0; !h.next && i < 30; i++) {
|
||||
const rows = h.paint();
|
||||
const footer = rows.at(-1);
|
||||
for (const row of rows.slice(1, -1)) {
|
||||
assert.ok(row.y + 20 <= footer.y, 'body must not overlap navigation');
|
||||
shown.push(row.text);
|
||||
}
|
||||
h.input('click');
|
||||
}
|
||||
assert.equal(h.next, 1);
|
||||
// Line breaking may also split after punctuation (e.g. device/app).
|
||||
assert.equal(shown.join('').replace(/\s+/g, ''), h.notice.replace(/\s+/g, ''));
|
||||
});
|
||||
}
|
||||
|
||||
test('scrolling stays inside the notice; revisiting starts at the beginning', () => {
|
||||
const h = harness(576, 188);
|
||||
const first = h.paint().map(row => row.text);
|
||||
h.input('scroll-up');
|
||||
assert.deepEqual(h.paint().map(row => row.text), first);
|
||||
h.input('scroll-down');
|
||||
assert.notDeepEqual(h.paint().map(row => row.text), first);
|
||||
for (let i = 0; i < 30; i++) h.input('scroll-down');
|
||||
assert.equal(h.next, 0, 'scrolling must not accept the notice');
|
||||
h.page.enter();
|
||||
assert.deepEqual(h.paint().map(row => row.text), first);
|
||||
});
|
||||
+4
-2
@@ -10,9 +10,11 @@ import kotlin.test.*
|
||||
*/
|
||||
class PreviewAnimationListenerTest {
|
||||
// FrameDisplayListTest's menu golden (a 2x2 highlight sliding in to rest at (3, 2)),
|
||||
// restarted at 0 of its 240 ms so the slide is still in flight at the first pull.
|
||||
// restarted at 1 of its 240 ms so the slide is still in flight at the first pull. Not 0:
|
||||
// at exactly 0 the highlight is wholly above this 8x8 screen, so a pull in the same
|
||||
// millisecond as the submit (a warm JIT) would match the settled frame.
|
||||
private val menu = "077f0000000300020002000200022a00000096000000010002000200ffffffff0200080000ff24017e30020000000001812c8001812c1611010017328001812c16103001812c3023414031ff24017c30020000000001812c8001812c1611010017328001812c16103001812c30234140310200020001000103100400000000000000001f"
|
||||
.chunked(2).map { it.toInt(16).toByte() }.toByteArray().also { it.fill(0, 18, 22) }
|
||||
.chunked(2).map { it.toInt(16).toByte() }.toByteArray().also { it.fill(0, 18, 22); it[18] = 1 }
|
||||
|
||||
private fun settledPreview(): ByteArray {
|
||||
val reader = ArrayByteReader(menu)
|
||||
|
||||
@@ -453,7 +453,7 @@ class GlassesSessionCoreTest {
|
||||
s.core.interruptibleSleep.interrupt()
|
||||
assertTrue(waitUntil(3_000) { s.listener.phases.contains("retrying") }, s.host.logs().takeLast(10).toString())
|
||||
assertTrue(s.host.hasLog("message timed out: create-layout"))
|
||||
assertTrue(s.host.hasLog("Transport failure: ack timeout"))
|
||||
assertTrue(s.host.hasLog("Transport failure: create layout ack timeout"))
|
||||
assertTrue(s.link.disconnected.containsAll(listOf(RIGHT, LEFT)))
|
||||
s.core.disconnect()
|
||||
assertEquals("disconnected", s.listener.phases.last())
|
||||
|
||||
+5
-4
@@ -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
@@ -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 16 or later for TestFlight. 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 → 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>
|
||||
|
||||
@@ -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
@@ -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 > 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 > Privacy > 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 > Privacy & Security > Analytics & 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>
|
||||
|
||||
Reference in new issue
Block a user