Docs: update screenshots and videos

Game menu: Update with a newer APK… (#161 )
Pick the new APK from the game's right-click or … menu: pipeline.replace_apk checks it's the same app (refuses another package, warns when its versionCode is older), points the entry at it and analyses it again; title, art, tags and the user's own recipe stay, the game data stays unless the new APK's folder has its own. The game page then offers Update on Frame.
2026-10-13 22:01:31 +02:00 · 2026-10-13 03:22:34 +00:00 · 2026-10-12 23:15:07 -04:00 · 2026-10-12 23:04:01 -04:00 · 2026-10-12 22:57:54 -04:00 · 2026-10-12 22:40:49 -04:00
190 changed files with 6948 additions and 1050 deletions
@@ -30,3 +30,8 @@ site/src/assets/media/
 site/media-hq/
 site/public/s
 site/public/setup.sh
+
+# Impeccable design-tool files (kept local, not in the repo)
+/PRODUCT.md
+/DESIGN.md
+/.impeccable/
@@ -69,6 +69,10 @@ Read `docs/PLAYBOOK.md` (symptom → fix) before debugging a game, and `docs/FRA
    Live Frame data comes from one app-owned `app.monitor_hub` (`frame/monitor_hub.py`): subscribers name modules +
    interval, the hub runs one agent `_monitor` stream (union of modules, fastest interval; per-module collection
    needs agent v73), reconnects after a lost stream and stops it when nobody subscribes; `_poll` retries an "error".
+    Games in a sample (agent v81): FramePort's own (launch.sh / container / Proton folder), any other game Steam's
+    reaper runs (`steam:<appid>`, title from the appmanifest, e.g. Job Simulator from Steam's store; not SteamVR, not
+    devkit entries; End game = Steam's Exit game), overlay apps flagged `overlay` and listed last; newest first. The
+    UI takes `frame/monitor.main_game(sample)` (never an overlay app alone). The agent's own workers never count.
    Subscribers: "monitor" (the Monitor tab, everything, only while shown) and "card" = the sidebar's live Frame card
    (`ui/frame_card.py` helpers: battery ring, "now playing" row with fps + 2-min sparkline → click opens Monitor;
    games + battery every 5 s, paused while a job's stage is "Upload…", only while connected and setting
@@ -323,8 +327,17 @@ Games tests: `pytest -m games` (FRAMEPORT_GAMES=<downloads dir>); on-device chec
 native layer test: `FRAMEPORT_NATIVE_TESTS=1 pytest -m native` (compiles with the NDK, ~2 min on NTFS).
 Repo is on an NTFS drive (`core.fileMode=false`); line endings are LF (`.gitattributes`).
 - `FRAMEPORT_HOME=<dir>` isolates all app data (tests use it); `FRAMEPORT_JAVA/_OVERPORT_JAR/_APKSIGNER_JAR` override
-  managed tools. Real app data (WSL): `~/.local/share/frameport` (tools, overport workspace + game keystores, library,
-  artwork, frames.json, the app's SSH key which the dev Frame authorizes).
+  managed tools. **The owner's real app data is the Windows copy's: `%LOCALAPPDATA%\FramePort`** (= `/mnt/c/Users/
+  <user>/AppData/Local/FramePort`; tools, overport workspace + game keystores, library, artwork, frames.json, the app's
+  SSH key which the dev Frame authorizes; moved from WSL's `~/.local/share/frameport` on 2026-10-11, which is now only
+  a stale backup). The desktop shortcut "FramePort (dev)" runs the source checkout natively on Windows
+  (`%LOCALAPPDATA%\FramePort-dev\launch-frameport-dev.vbs`: venv `FramePort-dev\venv` via `UV_PROJECT_ENVIRONMENT`,
+  `uv sync --frozen`, log `FramePort\logs\dev-gui.log`). **WSL runs on that data need `FRAMEPORT_WINDOWS_DATA=1`**
+  (set in `.claude/settings.local.json`; `paths.shares_windows_data`): the data folder becomes the Windows one, saved
+  paths from the other side are translated on load (`paths.localize`: /mnt/d/X <-> D:\X in library.json, tools.json,
+  PC deployment records), Java/Cpp2IL keep one copy per OS (tools.json `java-<os>-<arch>`), and the link handler isn't
+  registered (it would point the Windows copy's links at WSL). Don't run a WSL GUI and the Windows GUI at once
+  (the gui.lock flock/msvcrt locks don't see each other; only the gui.alive heartbeat does).
 - Device checks: `frameport test <pkg>` / `frameport parity-device --results <parity.json> --baseline <launch.txt>
  [--test-only]`; the pre-FramePort baseline is `PATCHED/_known-good-2026-09-28/_frame-state/baseline-launch.txt`.
 - Docs screenshots + videos (docs/SHOWCASE.md): never by hand. `uv run python scripts/showcase/render_docs.py`
@@ -795,6 +808,24 @@ index lines; no index (fp_spirv) = the old newest-by-mtime 4 MB. One JSON line (
 is read whole by `Frame.agent` (fine at that size); `_Writer.fit` drops the least recently used modules last, after
 cutting logs, to stay under the 24 MB zip limit.
 **Unreal OBB check (GitHub #159, 2026-10-10):** Epic's DownloaderActivity checks OBB name+size (OBBData), then with `bVerifyOBBOnStartUp=true` CRCs the whole OBB; its screens are invisible in Lepton (stuck at `Displayed …/.DownloaderActivity`, triage `unreal-obb-check-stuck`) → `frame.unreal_skip_obb_check` (analysis `unreal_verify_obb`, ANALYSIS_VERSION 11) flips the manifest boolean (`axml.set_meta_data_bool`); skips only the CRC pass. Host-tested only.
+**Issue round 2026-10-12 (agent v83):** Lepton pastes STEAM_COMPAT_DATA_PATH unquoted into `sh -c "ln -s …/internal/<pkg>
+/data/data/<pkg>"` (mounting.sh): a game on a card named "Steam Frame 512g" got no internal storage (no saves/prefs;
+Beyond Sandbox's EOS then looped `createKeychain→resetKeychain` forever, 1.85 GB log). Quest launchers with an unsafe
+path now `ln -sfn <base> ~/.local/share/frameport/lepton-paths/<pkg>` at every start and give Lepton that path
+(`app_dir_lines`/`set_app_dir`/`launcher_base`; upgrade_launchers converts; deployment.json keeps the real base).
+Verified on the device with a spaced copy of Stremio (old: the `ln` error; new: /data/data link, shared_prefs
+writable). `frame.eos_keychain_loop` (opt-in, triage `eos-keychain-loop`) returns from EOSSDK.resetKeychain. Wander
+0.3570 (Unity 6.5, Firebase, Gecko) ran out of bionic's 128 pthread keys → `frame.unity_tls_key_pool` (Klownicle's
+approach, #198: libunity's 4 key imports renamed `fp_tkey_*` via `elf.rename_imports`, `libfp_tkeys.so` pools
+destructor-less keys behind one real key); device: past Firestore, 72 fps. Cpp2IL releases can't read metadata v107
+(Unity 6.5) → `tools/cpp2il.py` falls back to the development CI build (nightly.link) on that error. Vermillion's canvas
+is an OVROverlay quad (drawn above the hand) → `frame.vermillion_scene_canvas` (PaintableMesh getters → false;
+installed build checked, 72 fps headless; headset not yet). Linux apps: `desktop_icon` switch, a deleted desktop copy
+stays deleted (#212). Findings: OLAR (#201) RHIThread null deref in libUnreal (`ldr x8,[x19,#792]`, x19=0) not fixed by
+hide_space_warp / vk_hide_fdm / no Valve layers; FNAF HW (#135) "freeze" = first-start GL program-binary-cache compile
+on Zink (threads busy in zink/disk cache), not a hang; VR4 (#199) reporter's patch.203 OBB truncated. Upload benchmark
+(`scripts/upload_bench.py`, #242): home Wi-Fi caps every method at ~11 MB/s; paramiko uses ~3x OpenSSH's CPU; Windows
+OpenSSH refuses FramePort's key file (ACL "bad permissions") until its permissions are tightened.
 **Meta user id (GitHub #182, 2026-10-11):** OVRPort's platform loader (runtimes 3.4.3-23204ea and -aa54c3f) answers
 `ovr_GetLoggedInUserID` (and two other callers) without a Meta account with a made-up id from a helper (`stp; mov x29,
 sp; bl random; …; mov/movk x9 = 0x53444835ec580000 (6e18); add x0, x8, x9; ldp; ret`), kept only in memory → a new id
@@ -832,7 +863,8 @@ on the dev Frame) in `files/framebridge-vrapi-fov.txt` and answers with it at th
 r_3dwidth/height, r_width/height from the runtime eye size (FrameBridge logs `runtime recommended eye size`) × scale,
 written at finalize, set_settings and by launch.sh before Lepton starts (`_config_sync`). Headless runs at scale 1.7
 end in `zink: DEVICE LOST` right after the bridge's 30 s no-tracking deadline tears the session down (gpu fault at the
-teardown; not at scale 1.0): a headless-only artifact, the headset never hits that deadline.
+teardown; not at scale 1.0): a headless-only artifact, the headset never hits that deadline. Launch tests count an exit/crash after
+such a line as a pass (triage.yaml `headless_end`, finding `headless-end`; GitHub #57 "Failed to launch" on install).
 **Session triage (agent v70, 2026-10-09):** launch tests never reach FOCUSED, so real play sessions are triaged
 too. list_installed gives each game `last_play` {start, end, test} from `<anchor>/plays.log` (launch tests write a
 `test <unix>` line first → test sessions are only marked); `session_log` returns the newest session's launch.log
@@ -44,7 +44,7 @@ try:
 except ImportError:  # Windows: pc_revive loads this file for its VDF code only (GitHub #131)
    fcntl = None

-AGENT_VERSION = 79
+AGENT_VERSION = 84
 HOME = os.path.expanduser("~")
 STEAM = os.path.join(HOME, ".local/share/Steam")
 ANCHORS = os.path.join(HOME, "Applications/quest-frame")
@@ -2890,10 +2890,57 @@ def cmd_prepare(args):
            "free_bytes": free, "lepton": lepton}


+# Valve's Lepton pastes the game's paths unquoted into shell commands (liblepton mounting.sh: `sh -c "... ln -s
+# ${STEAM_COMPAT_DATA_PATH}/internal/<pkg> /data/data/<pkg>"`, `lepton_basename ${APK}`), so a game on a drive whose
+# name has a space ("Steam Frame 512g") never gets its internal storage: no saves, no SharedPreferences, and e.g. Epic's
+# EOS SDK retries its keychain forever (GitHub #213/#214/#215/#221). Such games reach Lepton through a link without
+# spaces, made again at every start (a card can be mounted elsewhere); deployment.json keeps the real path.
+LEPTON_PATHS = os.path.join(HOME, ".local/share/frameport/lepton-paths")
+LEPTON_SAFE_RE = re.compile(r"[A-Za-z0-9._/+@%=:,-]+")
+APP_DIR_RE = re.compile(r"^(?:mkdir -p \S*lepton-paths\S* && ln -sfn .*\n)?app_dir=(.*)$", re.M)
+
+
+def app_dir_lines(base, pkg):
+    """The launcher's app_dir line for a game in `base` (a link line first when Lepton can't take that path)."""
+    if LEPTON_SAFE_RE.fullmatch(base):
+        return "app_dir=" + shlex.quote(base)
+    link = os.path.join(LEPTON_PATHS, pkg)
+    return (f"mkdir -p {shlex.quote(LEPTON_PATHS)} && ln -sfn {shlex.quote(base)} {shlex.quote(link)}"
+            f"  # Lepton can't take paths with spaces\napp_dir={shlex.quote(link)}")
+
+
+def remove_lepton_path(pkg):
+    try:
+        os.remove(os.path.join(LEPTON_PATHS, pkg))
+    except OSError:
+        pass
+
+
+def set_app_dir(text, base, pkg):
+    """launch.sh with its app_dir line(s) for `base`; (text, False) when it has none."""
+    text, n = APP_DIR_RE.subn(lambda m: app_dir_lines(base, pkg), text, count=1)
+    return text, bool(n)
+
+
+def launcher_base(text, pkg):
+    """The game folder a Quest launcher points at (the link's target when it goes through LEPTON_PATHS), or None."""
+    m = APP_DIR_RE.search(text)
+    if not m:
+        return None
+    try:
+        words = shlex.split(m.group(0).splitlines()[0], comments=True)
+    except ValueError:
+        return None
+    if m.group(0).startswith("mkdir -p ") and len(words) >= 8 and words[3:6] == ["&&", "ln", "-sfn"]:
+        return words[6]
+    value = shlex.split(m.group(1)) if m.group(1) else []
+    return value[0] if len(value) == 1 else None
+
+
 LAUNCH_SH = (r"""#!/usr/bin/env bash
 # Steam Frame launcher for {title} ({pkg}). Generated by FramePort.
 set -euo pipefail
-app_dir={base_q}
+{app_dir}
 [[ -d "$app_dir/lepton-app" ]] || {{ echo "Game files missing at $app_dir (storage not mounted?)" >&2; exit 1; }}
 {single}
 # Some games (Unreal cloud saves, SUPERHOT's cloud/data: mode 1700) create folders without write/search permission
@@ -2907,6 +2954,9 @@ r""" true; }}
 r""" here.
 mkdir -p "$app_dir/lepton-data/external/Android/data/{pkg}/files" """
 r""""$app_dir/lepton-data/external/Android/data/{pkg}/cache" 2>/dev/null || true
+# Prepare cloud saves before startup: a newly created cloud folder can have mode 1700, and the game may try to
+# create its data subfolder before the permission watchdog repairs it (Jurassic World Aftermath, GitHub #239).
+{cloud_dirs}
 fix_perms
 {watchdog}
 export SteamAppId={appid}
@@ -2970,6 +3020,12 @@ SINGLE_LINE = ('exec 9>"$app_dir/.launch.lock"; flock -n 9 || '
 LOGCAT_LINE = ('python3 {agent_q} _logcat_keeper "$app_dir/launch.log" "$SteamAppId" $$ '
               '>"$app_dir/logcat-keeper.log" 2>&1 9>&- &')

+CLOUD_DIRS_LINE = 'mkdir -p "$app_dir/lepton-data/external/Android/data/{pkg}/files/cloud/data" 2>/dev/null || true'
+
+
+def cloud_dirs_line(pkg):
+    return CLOUD_DIRS_LINE.format(pkg=pkg)
+

 def dashboard_line():
    return DASHBOARD_LINE.format(agent_q=shlex.quote(os.path.abspath(__file__)))
@@ -3000,10 +3056,17 @@ def upgrade_launchers():
        # the codec line follows the game's deployment (only Lepton launchers have this variable; Proton/Linux
        # launchers are never touched). Running launchers keep reading their old file.
        if "export LEPTON_ENV_FRAMEBRIDGE_CONFIG=" in new:
+            cloud = cloud_dirs_line(os.path.basename(os.path.dirname(path)))
+            if cloud not in new:
+                new = new.replace("\nfix_perms\n", "\n" + cloud + "\nfix_perms\n", 1)
            new = set_codec_line(new, wants_hw_video(os.path.dirname(path)))
            new = set_gamepad_line(new, wants_gamepad(os.path.dirname(path)))
            new = set_config_sync_line(new, os.path.basename(os.path.dirname(path)),
                                       wants_config_sync(os.path.dirname(path)))
+            pkg = os.path.basename(os.path.dirname(path))
+            base = launcher_base(new, pkg)
+            if base:  # games on a drive whose path has a space reach Lepton through a link (agent v83)
+                new = set_app_dir(new, base, pkg)[0]
        if "a Linux app. Generated by FramePort" in new and "FRAMEPORT_DESKTOP" not in new:
            new = upgrade_linux_launcher(new)
        if OLD_WATCHDOG in new and "parent=$PPID" not in new:
@@ -3361,9 +3424,10 @@ def upgrade_linux_launcher(text):
 def write_launcher(anchor, base, pkg, title, appid, lepton, env, hw_video=False, gamepad=False, config_sync=False):
    extra = "".join(f"export {k}={shlex.quote(str(v))}\n" for k, v in (env or {}).items()
                    if re.fullmatch(r"[A-Z_][A-Z0-9_]*", k))
-    text = LAUNCH_SH.format(title=title.replace("\n", " "), pkg=pkg, base_q=shlex.quote(base), appid=appid,
+    text = LAUNCH_SH.format(title=title.replace("\n", " "), pkg=pkg, app_dir=app_dir_lines(base, pkg), appid=appid,
                            lepton_q=shlex.quote(lepton), extra_env=extra, watchdog=WATCHDOG,
                            dashboard=dashboard_line(), logcat=logcat_line(), single=SINGLE_LINE,
+                            cloud_dirs=cloud_dirs_line(pkg),
                            video_codec=wrapper_lines(hw_video, gamepad),
                            plays_start=plays_lines(anchor)[0],
                            plays_end=plays_lines(anchor)[1])
@@ -4529,7 +4593,8 @@ def cmd_finalize_linux(args):
           "sha256": args.get("exe_sha256"),
           "missing_libraries": missing, "recipe": args.get("recipe"), "installed_by": "frameport",
           "launcher": {"env": args.get("env") or {}}, "desktop_entry": args.get("desktop_entry", True) is not False,
-           "files": {"app": want or {}}, "agent_version": AGENT_VERSION, "time": time.time()}
+           "desktop_icon": args.get("desktop_icon", True) is not False, "files": {"app": want or {}},
+           "agent_version": AGENT_VERSION, "time": time.time()}
    with open(os.path.join(anchor, "deployment.json"), "w") as f:
        json.dump(dep, f, indent=2)
    try:  # the app's own icon (GitHub #99), found again for every install: a new version may bring another
@@ -4832,9 +4897,11 @@ def desktop_entries(pkg=None, folder=None):
    return out


-def write_desktop_entry(pkg):
-    """The app's menu entry, plus a copy on ~/Desktop when that folder exists (Plasma starts executable .desktop files
-    there without asking). Returns {"menu": path, "desktop": path or None, "changed": bool}."""
+def write_desktop_entry(pkg, refresh=False):
+    """The app's menu entry, plus a copy on ~/Desktop when that folder exists and deployment.json's "desktop_icon"
+    isn't off (Plasma starts executable .desktop files there without asking). `refresh` (every connection) only
+    updates a desktop copy that is there: one the user deleted stays deleted (GitHub #212). Returns {"menu": path,
+    "desktop": path or None, "changed": bool}."""
    anchor = os.path.join(ANCHORS, pkg)
    dep = deployment(pkg)
    if not dep:
@@ -4846,10 +4913,16 @@ def write_desktop_entry(pkg):
            os.remove(path)
    menu = os.path.join(DESKTOP_APPS, name)
    changed = _write_if_changed(menu, text, 0o755)
-    desk = None
-    if os.path.isdir(DESKTOP_DIR):
-        desk = os.path.join(DESKTOP_DIR, name)
+    desk = os.path.join(DESKTOP_DIR, name)
+    if dep.get("desktop_icon", True) is False:
+        if os.path.exists(desk):
+            os.remove(desk)
+            changed = True
+        desk = None
+    elif os.path.isdir(DESKTOP_DIR) and not (refresh and not os.path.exists(desk)):
        changed = _write_if_changed(desk, text, 0o755) or changed
+    else:
+        desk = None
    return {"menu": menu, "desktop": desk, "changed": changed}


@@ -4879,7 +4952,7 @@ def refresh_desktop_entries():
            continue
        wanted.add(dep["package"])
        try:
-            if write_desktop_entry(dep["package"])["changed"]:
+            if write_desktop_entry(dep["package"], refresh=True)["changed"]:
                changed.append(dep["package"])
        except (OSError, AgentError):
            pass
@@ -4891,7 +4964,8 @@ def refresh_desktop_entries():


 def cmd_desktop_entry(args):
-    """Turn a Linux app's Desktop Mode entry on or off (deployment.json keeps the choice)."""
+    """Turn a Linux app's Desktop Mode entry on or off, and with `icon` its copy on the desktop (agent v83; deployment
+    .json keeps both choices)."""
    pkg = check_pkg(args["package"])
    dep = deployment(pkg)
    if not dep or dep.get("kind") != "linux":
@@ -4901,6 +4975,8 @@ def cmd_desktop_entry(args):
    with open(path) as f:
        raw = json.load(f)
    raw["desktop_entry"] = on
+    if args.get("icon") is not None:
+        raw["desktop_icon"] = bool(args["icon"])
    with open(path + ".tmp", "w") as f:
        json.dump(raw, f, indent=2)
    os.replace(path + ".tmp", path)
@@ -5095,6 +5171,7 @@ def cmd_uninstall(args):
        remove_empty_drive_dir(base)
    if linux:
        remove_desktop_entries(pkg)
+    remove_lepton_path(pkg)
    anchor = os.path.join(ANCHORS, pkg)
    removed_sc = False
    if args.get("remove_shortcut") and steam_users():
@@ -5181,7 +5258,7 @@ def rebase_launcher(dep, anchor, new):
    kind = dep.get("kind", "quest")
    launcher = dep.get("launcher")
    if kind == "quest":
-        text, n = re.subn(r"^app_dir=.*$", lambda m: "app_dir=" + shlex.quote(new), text, count=1, flags=re.M)
+        text, n = set_app_dir(text, new, pkg)
        if not n:
            raise AgentError("launch.sh has no app_dir line; reinstall the game once, then move it")
    elif kind == "linux" and launcher is not None:
@@ -6604,6 +6681,10 @@ MON_CRITICAL = ("steam", "steamwebhelper", "reaper", "vrserver", "vrcompositor",
 # processes whose command line can name a game (only these are read: cmdlines of ~500 processes cost too much)
 MON_ROOT_COMMS = ("conmon", "launch.sh", "reaper", "bash", "sh")
 MON_ROOT_PREFIXES = ("python", "proton", "pv-", "wine", "steam-runtime")
+AGENT_FILES = {os.path.abspath(__file__), os.path.realpath(__file__)}
+STEAM_GAME = "steam:"  # monitor: a game Steam started that FramePort didn't install ("steam:<appid>", e.g. a Lepton
+# game from Steam's store); its title comes from the appmanifest
+REAPER_APPID = re.compile(r"\bAppId=(\d+)")
 MON_GROUPS = (  # (group, comm prefixes), first match wins; games are found by their process tree
    ("steamvr", ("vr", "XRService", "V4L2Cam", "eyetracking", "proxmicmute", "systemlayer")),
    ("steam", ("steam", "reaper", "fossilize")),
@@ -6935,6 +7016,7 @@ class Monitor:
        self.logs = {}      # launch.log path -> [offset, fps, avg ms, time of the line]
        self.deps = []
        self.deps_at = -1e9
+        self.steam_titles = {}
        self.tick = 0
        self.last = None    # time of the previous sample
        self.disk_at = -1e9
@@ -7035,10 +7117,16 @@ class Monitor:
                    m = re.search(r"lepton-steamlaunch-(\d+)", cmd)
                    if m and m.group(1) in by_appid:
                        root = (by_appid[m.group(1)]["package"], "container")
-                else:
+                elif not any(a in cmd for a in AGENT_FILES):
+                    # the agent's own workers name a game's launch.sh too (uninstall's shortcut removal while Steam
+                    # restarts): they aren't the game (helpers launch.sh starts still count, as its children)
                    pkg = next((k for path, k in anchors if path in cmd), None) or \
                        next((k for base, k in bases if base in cmd), None)
                    root = (pkg, "launcher") if pkg else None
+                    m = REAPER_APPID.search(cmd) if comm == "reaper" and not pkg else None
+                    # any other game Steam runs (its reaper); not SteamVR itself, not a devkit entry of ours
+                    if m and m.group(1) not in by_appid and m.group(1) != STEAMVR_APPID and "/devkit-game/" not in cmd:
+                        root = (STEAM_GAME + m.group(1), "steam")
                self.root_cache[key] = root
            if self.root_cache[key]:
                roots[pid] = self.root_cache[key]
@@ -7116,7 +7204,7 @@ class Monitor:
        deps = {d["package"]: d for d in self.deployments(now)}
        out = []
        for pkg in sorted({v[0] for v in self.roots.values()}):
-            d = deps.get(pkg) or {}
+            d = deps.get(pkg) or (self.steam_game(pkg[len(STEAM_GAME):]) if pkg.startswith(STEAM_GAME) else {})
            pids = [p["pid"] for p in self.procs if p["game"] == pkg]
            cpu = sum(p["cpu"] for p in self.procs if p["game"] == pkg)
            rss = sum(p["rss"] for p in self.procs if p["game"] == pkg)
@@ -7136,10 +7224,25 @@ class Monitor:
                        "appid": d.get("appid"), "elapsed": max(ages) if ages else None,
                        "cpu": round(max(cpu, 0.0), 1), "mem": mem if mem is not None else rss,
                        "gpu": round(sum(self.gpu_pct.get(p, 0.0) for p in pids), 1),
-                        "fps": fps, "frame_ms": ms, "processes": len(pids)})
+                        "fps": fps, "frame_ms": ms, "processes": len(pids), "overlay": is_overlay(d)})
+        # the game in front first: overlay apps (they run next to games) last, then the most recently started
+        out.sort(key=lambda g: (g["overlay"], g["elapsed"] is None, g["elapsed"] or 0))
        self.games = out
        return out

+    def steam_game(self, appid):
+        """{title, kind, appid} of a Steam game FramePort didn't install (cached: appmanifest/shortcuts reads)."""
+        if appid not in self.steam_titles:
+            app = find_app_id(appid)
+            name = (app or {}).get("name")
+            if not name:
+                for user in steam_users():
+                    name = shortcut_names(user).get(appid)
+                    if name:
+                        break
+            self.steam_titles[appid] = name or f"App {appid}"
+        return {"title": self.steam_titles[appid], "kind": "steam", "appid": appid}
+
    def filtered(self, now=None):
        procs = self.procs
        span = (now - self.scan_prev) if now is not None and self.scan_prev is not None else 0.0
@@ -7285,8 +7388,29 @@ class Monitor:
        return {"ended": False, "pid": pid, "name": comm}


+def steam_app_running(appid):
+    """A Steam reaper runs this app id (a Steam game FramePort didn't install)."""
+    for name in os.listdir(PROC):
+        if name.isdigit() and _rd(f"{PROC}/{name}/comm").strip() == "reaper" and \
+                re.search(rf"\bAppId={appid}\b", _rd(f"{PROC}/{name}/cmdline").replace("\0", " ")):
+            return True
+    return False
+
+
 def monitor_end_game(pkg, wait=6.0):
-    """Steam's Exit game for a FramePort game (so Steam's session ends cleanly), then cmd_stop if it still runs."""
+    """Steam's Exit game for a FramePort game (so Steam's session ends cleanly), then cmd_stop if it still runs.
+    A Steam game FramePort didn't install ("steam:<appid>"): Steam's Exit game only."""
+    if str(pkg).startswith(STEAM_GAME):
+        appid = str(pkg)[len(STEAM_GAME):]
+        if not appid.isdigit():
+            raise AgentError(f"bad Steam app id {appid!r}")
+        if not steam_app_running(appid):
+            return {"ended": True, "via": None, "package": pkg, "note": "not running"}
+        steam_js(f"SteamClient.Apps.TerminateApp('{appid}', false)")
+        end = time.monotonic() + wait
+        while time.monotonic() < end and steam_app_running(appid):
+            time.sleep(0.5)
+        return {"ended": not steam_app_running(appid), "via": "steam", "package": pkg}
    pkg = check_pkg(pkg)
    dep = deployment(pkg)
    if not dep:
@@ -1,16 +1,19 @@
+1a4dce5c4a6d0dfc5f20e55ac29e70c73cc2cc124c21ca6a7e1b316e6afb1c79  ./arm64-v8a/libVkLayer_fdm_darken.so
 5becb96ee86fbda0ce98c0e0fd064f8ba092314aceaa400e3dcc785705dc3c23  ./arm64-v8a/libVkLayer_fp_shaderfix.so
 e7554c6343ee2989b0a273ee6230e65c25bfe6499eefd00de19f5f0fee58754f  ./arm64-v8a/libfp_langpack.so
 321da502e0f8f46f0880aad39fe6b84bdef88f925164568814cf704a1b31a577  ./arm64-v8a/libfp_ovrp.so
 40defdaddcda53bd2649eb48076fae1622bfc2bfc88e9e03c94fc8b45af2a4f2  ./arm64-v8a/libfp_ovrtrace.so
+0167c2fde5dfde62897f9d85afc4fc8e97784e988b5b8df6cea8c407240b3424  ./arm64-v8a/libfp_tkeys.so
 e8c0965c188665a4e565e4a3af983ef1866d1cf9225665cc90d8df286bc96ef3  ./arm64-v8a/libfp_vk.so
 383054f8b3b41dde76d062c71856cd3163655e50009c08454bc1793f393ead65  ./arm64-v8a/libfpg.so
 5432674a59d02f411cd853a5dc57e3fa547d1ac518f25bf433fc54c43677177a  ./arm64-v8a/libfpglmv.so
 8a8f6b1da8952cb3933a5b53558424a5fc56043b2527a16bb6dd62a00d2de01a  ./arm64-v8a/libframe_xrshim.so
 19ba5ed3c4b780f5ae46251f6958f552acfc5f13c8bb39f995579593fa8990c6  ./arm64-v8a/libglshim.so
-449e13bbe58de6718d4e530177924e09552a95d748a082739899144e2cb3ccf3  ./arm64-v8a/libopenxr_loader_generic.so
+e44ded778758de33ad87bb31398281d7ec94c1ecd43dcf55b1dc99311f011859  ./arm64-v8a/libopenxr_loader_generic.so
 1feaeafad467c4cafdf2b018a4d84b0bee200c3f711697b4ce97e66a3ba256ca  ./arm64-v8a/libovrplatformcompat.so
-1d83eb94ec1df44f29a5f525dce4d5b608dbbb13a9c7a5efeb80a4b1dc54a721  ./arm64-v8a/libvrapi.so
-47f736dfeffce6aa56be2fc049c2d11b87b0d1f7389db7ee1737fcded9457811  ./armeabi-v7a/libopenxr_loader_generic.so
+7f30861c770361a4e311e3f486dcd2e48cd99a7f907961829ce68e24af17d775  ./arm64-v8a/libvrapi.so
+7f30861c770361a4e311e3f486dcd2e48cd99a7f907961829ce68e24af17d775  ./arm64-v8a/libvrapi_foveation.so
+d2361ee8b6ff62d2ff6b3f59f7b15730b95bdbe0e9dcee469ffa1117411e7288  ./armeabi-v7a/libopenxr_loader_generic.so
 1871eae093432d277da4bc751bf5f3269dfcf11f9168260b0c3caadb0dedb19d  ./dex/oculusos-stubs.dex
 b634ab5640e258563c536e658cad87080553df6f34f62269a21d554844e58bfe  ./hevc/COPYING.FFmpeg
 141de01f0d40b97d4f9a720db5ab8ea442f6aa35db5272048899292884994a1c  ./hevc/libstagefrighthw.so
@@ -10,12 +10,14 @@ frame:
 - frame.unity_text_input
 device:
 - device.text_input_window
+adapter:
+  haptic_fix: 1
 verified:
-  date: '2026-10-05'
-  known_good_sha256: 522cfebf954e1cab6054798479b0b32c5ba9e38cca83dd98db2ac0f7e3c0802a
-  app: 0.9.1
+  date: '2026-10-11'
+  known_good_sha256: 0e55a80ed420395b7eaf8075230fad1fae288f6c25d2ce8cc6aa49899e9b7596
+  app: 1.0.4
  overport_cli: 1.2.5
-  frame_build: '20260922.6101926'
-  agent: 48
-  issue: 44
-source_hint: WotW
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 211
+source_hint: Waltz
@@ -0,0 +1,21 @@
+package: com.GenderGames.Ladder
+title: Ladder
+status: works
+tested_version: Release
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+- frame.unity_runtime_msaa_off
+- frame.unity_gl_shim
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-12'
+  known_good_sha256: 7d23692149d40fe469dbf2e13446ceeb94a8a32807e09ddad7731158de9be0a2
+  app: 1.0.4
+  overport_cli: 1.2.5
+  issue: 243
+source_hint: Ladder
@@ -0,0 +1,23 @@
+package: com.HarmonixMusic.DCVRQuest
+title: Dance Central
+status: works
+tested_version: 1.2.2
+engine: Unreal
+xr: VrApi
+alt_overport:
+- patch_remove_unreal_force_quit
+frame:
+- frame.unreal_skip_obb_check
+- frame.hw_video_decode
+adapter:
+  haptic_fix: 1
+  pose_time_fix: 1
+verified:
+  date: '2026-10-12'
+  known_good_sha256: cbaf2eb594cb25d6a345b50612f9e7ca3e2b2f05abaa072632e8fc0d91277c61
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 228
+source_hint: com.HarmonixMusic.DCVRQuest
@@ -0,0 +1,20 @@
+package: com.InnoverseLtd.FrenzyVR
+title: FrenzyVR
+status: works
+notes: Works, runs good
+tested_version: '107'
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+device:
+- device.text_input_window
+verified:
+  date: '2026-10-11'
+  known_good_sha256: 0d87e78dcbe1c705af0d01cda8eabbea514849f7403e5904f0ef49b5cf0653fb
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 216
+source_hint: Frenzy VR
@@ -0,0 +1,22 @@
+package: com.LocoMotionDevs.Superfly
+title: Superfly
+status: works
+notes: Works, take a bit to launch but works
+tested_version: 1.3.3
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-11'
+  known_good_sha256: e180b6c58b80c1c2d0cc49e75d645a41d3d4bc63ed7ffe1e6f91eac51e486a17
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 217
+source_hint: Superfly
@@ -0,0 +1,20 @@
+package: com.PubTest.PubTest
+title: Drunkn Bar Fight 2 - Early Access
+status: works
+notes: Game launches and plays fine
+tested_version: '0.515'
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+device:
+- device.text_input_window
+verified:
+  date: '2026-10-11'
+  known_good_sha256: f340b5ba70ee9368ead6bfe2c287eda6c5686280ddb8e12b8c9a8d720326de36
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 218
+source_hint: Drunkn Bar Fight 2 - Early Access
@@ -0,0 +1,21 @@
+package: com.StatusPro.NFLProEra2
+title: NFL PRO ERA II
+status: works
+tested_version: 2.4.0
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+- frame.unity_runtime_msaa_off
+- frame.unity_gl_shim
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-11'
+  known_good_sha256: caf2e8f148ca4929ba5e73112fa7e0958c00d7ee0c5f28926c3f39714db6c923
+  app: 1.0.4
+  overport_cli: 1.2.3
+  issue: 226
+source_hint: com.StatusPro.NFLProEra2
@@ -0,0 +1,23 @@
+package: com.TinyBuild.killitwithfirevr
+title: Kill It With Fire VR
+status: works
+notes: Works
+tested_version: 1.0.5.4208
+engine: Unreal
+xr: OpenXR
+alt_overport:
+- patch_remove_unreal_force_quit
+frame:
+- frame.unreal_skip_obb_check
+- frame.hw_video_decode
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-11'
+  known_good_sha256: fcadbdaf3255e2909edf763d0c61fb55808ba448d4f277e91ba37b0a0ff9f497
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 219
+source_hint: Kill It With Fire VR
@@ -0,0 +1,21 @@
+package: com.WfelisCorp.MunkrFunkrTheLegacyDays
+title: Munkr Funkr (The Legacy Days)
+status: works
+tested_version: '2'
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-12'
+  known_good_sha256: 94079c1a2a802322f907058964c4ebbb22edba1dc0f3ec26e3c121ed9d8b0379
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 241
+source_hint: Munkrfunkr
@@ -2,19 +2,22 @@ package: com.beatgames.beatsaber
 title: Beat Saber
 status: works
 notes: Purchased DLC isn't detected (ownership comes from Meta's servers).
-tested_version: 1.40.8_7379
+tested_version: 1.45.2_28848
 engine: Unity
 xr: OpenXR
 frame:
 - frame.unity_text_input
 device:
 - device.text_input_window
+adapter:
+  haptic_fix: 1
+  pose_time_fix: 1
 verified:
-  date: '2026-10-03'
-  known_good_sha256: ee720e040931f2547f7611e58ec5ad72d86e800dd4cf3135f576019683f2f359
-  app: 0.6.1
+  date: '2026-10-11'
+  known_good_sha256: b7976f36d39b22eb0fd9c8eb6cce204125430cd2a3e2bfab8ba5d1f7c86f0ac6
+  app: 1.0.4
  overport_cli: 1.2.5
-  frame_build: '20260930.6234839'
-  agent: 33
-  issue: 6
-source_hint: Beat Saber
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 210
+source_hint: beat-saber
@@ -0,0 +1,23 @@
+package: com.greensky.swarm2
+title: Swarm 2
+status: issues
+notes: MSAA creates visible seams around edge geometry and also the skybox edge
+tested_version: '8472'
+engine: Unity
+xr: VrApi
+frame:
+- frame.unity_text_input
+- frame.unity_runtime_msaa_off
+- frame.unity_gl_shim
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-12'
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20260922.6101926'
+  agent: 79
+  issue: 224
+source_hint: SWARM 2
@@ -0,0 +1,25 @@
+package: com.halfbrick.fruitninjavr
+title: Fruit Ninja
+status: works
+notes: Works, launches and plays
+tested_version: 1.7.3.696775
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+- frame.unity_runtime_msaa_off
+- frame.hw_video_decode
+- frame.unity_gl_shim
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-11'
+  known_good_sha256: 5afd1383c6f4aab50425bea955202c74e1706a8a8ba4219689ef5b6e0c984318
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 220
+source_hint: Fruit Ninja
@@ -1,15 +1,22 @@
 package: com.ilmxlab.tales
 title: 'Star Wars: Tales from the Galaxy''s Edge'
-status: unknown
-notes: Not working yet - after the intro logos and a loading animation the picture goes black (GitHub issue 61).
-  Gets the controller fixes found for Vader Immortal (same studio) to test.
+status: works
+notes: >-
+  Headset tested for GitHub issue 61: full view, loading into gameplay, both eyes, controller input and sound
+  work with the splash bypass and multiview depth-size fix. Keep the main OBB and all three content/sound-bank PAKs.
 details: Unreal Engine 4 (GLES) by ILMxLAB, like Vader Immortal, but a different engine build - it has none of Vader's
  Quest-only branches (no GetQuestShaderPrecompilePercent or RPOC key map; it precompiles shaders through Unreal's
  own pipeline cache), so frame.unreal_quest_precompile/_keymap don't apply. Its seasons and Wwise banks are Meta
  platform asset files (frame.asset_files). Vader's OVRPlugin findings apply to it as well - poses asked for at
  OVRPlugin's own clock (pose_time_fix) and thumbs from near-touch, which the Frame never reports (frame.unreal_thumb_touch).
-  Ruled out for the black picture so far (see the diagnostics in issue 61) - asset-file paks, Valve's foveation,
-  GL errors; the game's own eye image reads back black.
+  Map travel stalls with the game thread waiting in FlushRenderingCommands and the render thread waiting in
+  FSplash::RenderFrame_RenderThread / ovrp_WaitToBeginFrame. frame.unreal_splash_bypass lets loading finish.
+  SideQuest backups with sibling apk/ and obb/ folders must include all three PAKs; old scans omitted them and
+  lost sound. The scanner and library refresh recover that layout. Eye clipping came from cached Android window
+  dimensions for the depth attachment (1920x1016 versus the 1728x1728 eye color texture).
+  frame.unreal_multiview_depth refreshes both cached dimensions from the current eye render size; multiview and
+  multisampling remain enabled. The two engine fixes check exported symbols, function sizes and instruction bytes
+  before changing one instruction each; unrecognized engine builds are left unchanged.
 tested_version: 1.1.9+734762.cl.439699
 engine: Unreal
 xr: VrApi
@@ -18,10 +25,12 @@ alt_overport:
 frame:
 - frame.asset_files
 - frame.unreal_thumb_touch
+- frame.unreal_splash_bypass
+- frame.unreal_multiview_depth
 adapter:
  pose_time_fix: 1
 verified:
  issue: 61
-updated: '2026-10-09'
-min_app: 0.12.1
+updated: '2026-10-12'
+min_app: 1.0.4
 source_hint: Star Wars- Tales from the Galaxys Edge
@@ -0,0 +1,24 @@
+package: com.othergate.doe
+title: Dungeons of Eternity
+status: issues
+notes: It can not connect to servers
+tested_version: '1.3'
+engine: Unity
+xr: OpenXR
+frame:
+- frame.vivox_audio_route
+- frame.unity_text_input
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+  pose_time_fix: 1
+verified:
+  date: '2026-10-11'
+  known_good_sha256: 006a53b81988f1bb088ccb0847c9e4085ee89743ed6b4d5acf161abf99e30365
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 206
+source_hint: com.othergate.doe
@@ -1,12 +1,15 @@
 package: com.parkline.wander
 title: Wander
 status: works
-tested_version: '0.3569'
+notes: 0.3570 (Unity 6.5) runs out of thread keys at start without the thread-key pool (fix found by Klownicle,
+  GitHub #198).
+tested_version: '0.3570'
 engine: Unity
 xr: OpenXR
 frame:
 - frame.unity_text_input
 - frame.unity_runtime_msaa_off
+- frame.unity_tls_key_pool
 device:
 - device.text_input_window
 verified:
@@ -17,4 +20,5 @@ verified:
  frame_build: '20260930.6234839'
  agent: 35
  issue: 17
+updated: '2026-10-12'
 source_hint: Wander
@@ -0,0 +1,21 @@
+package: com.poncle.vampiresurvivorsvr
+title: Vampire Survivors
+status: works
+tested_version: 1.0.717
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-12'
+  known_good_sha256: 42c3c18fd6b69a79d9e337d359aa9940428b9193a9ffc3ef987571be6aa6901a
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 234
+source_hint: Vampire Survivors
@@ -0,0 +1,24 @@
+package: com.themunky.drunknbarfightQuest
+title: Drunkn Bar Fight
+status: works
+notes: Works
+tested_version: '11.00'
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+- frame.unity_runtime_msaa_off
+- frame.unity_gl_shim
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-11'
+  known_good_sha256: a66895bf0fde60a7ccd9bea6b8b1e922650cf1692fe26c1d08bee5b5c866b8b6
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 222
+source_hint: Drunkn Bar Fight
@@ -0,0 +1,23 @@
+package: com.viewerready.totallybaseball
+title: Totally Baseball
+status: works
+notes: Game Launches and works
+tested_version: '2.5886'
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+- frame.oculusos
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-11'
+  known_good_sha256: 80d53ee2c59cd1846e42a1c309bd8b0c365841d0aaea4092854fa01d2902a839
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 223
+source_hint: TOTALLY BASEBALL
@@ -0,0 +1,23 @@
+package: com.vrmonkey.skyclimb
+title: MacacoVR
+status: issues
+notes: 2d loading screens are glitchy, otherwise main gameplay is fine
+tested_version: '1.1325'
+engine: Unreal
+xr: OpenXR
+alt_overport:
+- patch_remove_unreal_force_quit
+frame:
+- frame.unreal_skip_obb_check
+- frame.hw_video_decode
+adapter:
+  haptic_fix: 1
+verified:
+  date: '2026-10-12'
+  known_good_sha256: 78de47cf0200a6e8e06feeef4a02da0737393b5007e71ba8f62f01dfa93cec0a
+  app: 1.0.4
+  overport_cli: 1.2.5
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 236
+source_hint: MacacoVR
@@ -0,0 +1,25 @@
+package: xyz.TheAviary.Vermillion
+title: Vermillion
+status: issues
+notes: Runs. The canvas used to hide the hand and brush while painting (the Frame draws the game's canvas layer in
+  front of everything); the recipe makes the game draw canvases in the scene instead (fix found by Klownicle, GitHub
+  #200). Not yet confirmed in the headset with this patch.
+tested_version: 1.7.2
+engine: Unity
+xr: OpenXR
+frame:
+- frame.unity_text_input
+- frame.vermillion_scene_canvas
+device:
+- device.text_input_window
+adapter:
+  haptic_fix: 1
+  scene_emul: 1
+verified:
+  date: '2026-10-11'
+  app: 1.0.1
+  frame_build: '20261007.6125817'
+  agent: 79
+  issue: 200
+updated: '2026-10-12'
+source_hint: Vermillion - VR Painting
@@ -6,6 +6,19 @@
 # with diagnostics. Launch tests and real play sessions (agent session_log, `frameport session`) are both matched.
 # Sources: every failure we hit porting 34 games to the Steam Frame (see docs/PLAYBOOK.md).
 signatures:
+  - id: vrapi-frame-rejected
+    pattern: 'OVRPortVrApi:\s+Unsupported frame flags or swap interval'
+    severity: fatal
+    diagnosis: The VrApi bridge rejected the game's frame options, so no picture reaches the headset even though frame pacing can appear in the log. Rebuild and reinstall with the updated bridge; it accepts the old texture-density debug flag used by The Climb (GitHub #238). Other unsupported options are logged with their flags and swap interval.
+    suggest: [frame.vrapi_bridge]
+  - id: foveation-instance-skipped
+    pattern: 'fdm_injection_CreateInstance: skipped'
+    severity: info
+    diagnosis: Valve's foveation layer skipped a Vulkan instance. This may be a helper instance; it does not prove
+      that every game render pass lacks foveation. Compare with instance-created and render-pass diagnostics.
+      For a compatible renderer, Customize > Eye-tracked foveation > Eye-tracked explicitly enables injection.
+      Verify image quality and GPU time before retaining it; a loaded layer alone is not proof of active foveation.
+    suggest: []
  - id: no-launcher
    pattern: 'APP_ACTIVITY is empty'
    severity: fatal
@@ -41,6 +54,17 @@ signatures:
    severity: fatal
    diagnosis: The game's graphics crashed a few seconds after start. Its render thread jumped to address 0x10000 in the Frame's GL driver (Mesa/Zink), which reads past a render-pass cache when a game uses multisampled render-to-texture (Unreal's mobile MSAA, for example Star Wars Pinball VR); the GL shim hides that extension.
    suggest: [frame.unreal_gl_shim, frame.unity_gl_shim]
+  - id: unreal-splash-frame-stall
+    pattern: '(?s)\A(?=.*CSxrSession::WaitFrame)(?=.*FSplash::RenderFrame_RenderThread)(?=.*FlushRenderingCommands)'
+    severity: error
+    diagnosis: Unreal's map loading waits for rendering while its separate Oculus splash waits for an unbegun VR frame (Tales from the Galaxy's Edge, issue 61). Bypass the splash renderer to let loading finish; the last image stays visible during loading.
+    suggest: [frame.unreal_splash_bypass]
+  # Attachment sizes captured by the issue 61 GL diagnostic probe, not ordinary launch logs.
+  - id: unreal-multiview-depth-size
+    pattern: '(?s)\A(?=.*ViewLog[^\n]*attachment 8ce0[^\n]*renderbuffer=1728x1728)(?=.*ViewLog[^\n]*attachment 8d00[^\n]*renderbuffer=1920x10(?:16|20))'
+    severity: warning
+    diagnosis: The measured multiview depth attachment keeps the initial Android window dimensions and clips the taller eye color target (Tales from the Galaxy's Edge, issue 61). Refresh Unreal's cached depth dimensions from its eye render size; menu panels use separate layers and remain intact.
+    suggest: [frame.unreal_multiview_depth]
  - id: pac-unpaired
    pattern: 'ILL_ILLOPN\), fault addr 0x[0-9a-f]+ \(\*pc=0xd50323bf\)'
    severity: fatal
@@ -308,6 +332,28 @@ signatures:
    diagnosis: The game's Vivox voice-chat SDK calls Android 12 audio-routing methods (AudioManager communication devices) without checking the Android version; Lepton runs Android 11, so the app crashes (for example Green Hell VR). The patch makes Vivox's audio-route check return early (voice chat keeps the default route).
    suggest: [frame.vivox_audio_route]
    supersedes: [java-crash]
+  - id: lepton-data-link-failed
+    pattern: "ln: cannot create symbolic link from '[^']*' to '/data/data/|Couldn't create directory for SharedPreferences file /data/user/0/"
+    severity: fatal
+    diagnosis: The game has no internal storage (saves, settings) inside Lepton. Usually its folder's path has a space (a microSD card named for example "Steam Frame 512g"), which Lepton's own scripts can't handle; FramePort's launcher (agent 83 and newer) gives Lepton a path without spaces. Connect FramePort once so the launcher is updated, then start the game again.
+    report: true
+    supersedes: [java-crash, native-crash]
+  - id: bhaptics-permission-prompt
+    pattern: 'GrantPermissionsActivity: Permission grant result .*permission=android\.permission\.BLUETOOTH_CONNECT'
+    severity: error
+    diagnosis: The game asked for Android 12's Bluetooth permission (bHaptics' vest SDK, for example Yupitergrad). Lepton runs Android 11, so Android's permission screen opens for a moment, the game is paused, and Meta's OVRPlugin may stop drawing (a frozen loading screen). The patch makes that request return at once.
+    suggest: [frame.bhaptics_permission]
+  - id: eos-keychain-loop
+    pattern: 'LogEos: Resetting EOS SDK keychain: Failed to create'
+    severity: error
+    diagnosis: Epic Online Services can't save its login keychain and retries without end (a start that never finishes, 100 % CPU). The usual cause is missing internal storage (see lepton-data-link-failed); the patch stops the loop, and EOS then reports the failure to the game once.
+    suggest: [frame.eos_keychain_loop]
+  - id: pthread-keys-exhausted
+    pattern: 'cannot create thread specific key'
+    severity: fatal
+    diagnosis: The game ran out of thread keys (Android allows 128 per process; Unity 6 plus large native libraries such as Firebase or Gecko, and the Frame's own graphics/OpenXR libraries, use them up), so a library aborted at start (for example Wander in Firebase's Firestore). The patch lets Unity's keys without a clean-up function share one real key.
+    suggest: [frame.unity_tls_key_pool]
+    supersedes: [native-crash]
  - id: unreal-obb-check-stuck
    pattern: 'Displayed \S+/\S*DownloaderActivity\b'
    # the downloader returned (the engine's main init resumed, OpenXR started) or the game crashed (its own finding)
@@ -358,6 +404,11 @@ signatures:
    severity: fatal
    diagnosis: The game can't read its own data files (OBB/data folder) - they are incomplete or from another version of the game than the APK. Copy the whole data folder again from the same install as the APK, add the game again and reinstall.
    suggest: []
+  - id: fmod-bank-missing
+    pattern: 'Error loading FMOD bank "/(sdcard|storage/emulated/\d+)/Android/obb/[^"\r\n]+\.bank": (ERROR|ERR_[A-Z_]+)\b'
+    severity: fatal
+    diagnosis: The game can't load its external sound banks, so it may show a file-loading error even while rendering frames. Copy the whole obb folder from the same backup as the APK, including the .bank files (not just .obb files). Keep apk/ and obb/ beside each other, add the backup folder again and reinstall.
+    suggest: []
  - id: permission-denied-save
    pattern: 'Permission denied.*(Android/data|/sdcard)|EACCES.*Android/data'
    severity: warning
@@ -463,6 +514,12 @@ signatures:
    severity: error
    diagnosis: The game can't write to a folder it created, so it may quit at start (for example SUPERHOT's cloud/data, mode 1700). FramePort's launcher (agent 41 or newer) gives such folders owner and group write permission before and during every launch; reinstall the game to get the new launcher. A folder the game creates and checks in the same moment on its very first start can't be repaired in time, so start the game again.
    suggest: []
+  - id: startup-save-permission
+    pattern: '(?s)UnauthorizedAccessException: Access to the path "/(?:sdcard|storage/emulated/0)/Android/data/[^"\r\n]+/files/cloud/data" is denied\.[^\n]*(?:\n[^\n]*){0,25}?StartupLoading\+<Start>'
+    severity: fatal
+    diagnosis: The startup routine stopped because it couldn't create the cloud-save directory, so the game stays on its loading screen even while rendering frames (Jurassic World Aftermath). The launcher's permission repair happens after this first-start error; close the game and start it again without uninstalling. Agent 84 prepares the cloud-save directory before startup to avoid this race on fresh installs.
+    suggest: []
+    supersedes: [save-folder-permission]
  - id: surface-swapchain-emulated
    pattern: 'surface_emul: emulated Android surface swapchain'
    severity: info
@@ -481,6 +538,13 @@ signatures:
      the video was decoded in software instead, which is slow for 4K/8K. Turn off hardware video decoding in Steam's
      settings, restart Steam, then start the game again.
    suggest: []
+# Launch tests run without a worn headset. Some parts give up on tracking after a while and end the VR session; what
+# the game does after that (often a crash in the GPU driver while its renderer tears down) never happens in the
+# headset. In a launch test that already had paced frames before such a line, a later exit or crash still passes,
+# with a note (finding `headless-end`). Play sessions ignore this list.
+headless_end:
+  - label: the VrApi bridge's 30 s tracking deadline
+    pattern: 'EnterVrMode: no tracked head pose before deadline'
 milestones:  # progress markers, in order; the furthest one reached is reported
  - {id: pcvr-launch, kind: pcvr, pattern: 'FramePort: launching|Launched injector with', label: Launcher started}
  - {id: pcvr-oculus-hmd, kind: pcvr, pattern: 'FramePort oculushmd: OculusHMDConnected event ready', label: Oculus headset event provided}
@@ -85,6 +85,23 @@
  the session stays below FOCUSED.

 ## Graphics stack
+- Explicit foveation injection probe (SteamOS 0.4.5, 20261007.6125817, Lepton 3.0.5, 2026-10-11):
+  Batman's normal Steam environment requested the FDM Vulkan layer but supplied no `FDM_DEBUG` flag.
+  Appending `debug` while preserving inherited flags showed `fdm_injection_CreateInstance: skipped`.
+  A temporary `FDM_DEBUG=enable,debug` launch created the Unity/Manta Vulkan instance and device,
+  detected a 54x54 two-layer density map for 1728x1728 eye buffers, and logged render passes with
+  `fdm 1`, `already_has_fdm=1`, and changing offsets for both eyes. This verifies the injection path,
+  not visual quality, gaze calibration, sustained gameplay stability, or an FPS/power improvement.
+  `device.foveation` mode `tracked` now explicitly loads the layer and sets `FDM_DEBUG=enable` without
+  debug spam. It is opt-in; do not enable it globally or assume all GLES/Zink and Vulkan renderers work.
+  Follow-up wearer test on 2026-10-11 FAILED in Batman: large rainbow glitches outside the gaze region
+  and jitter even in clear regions. Restoring the original launcher and restarting removed BOTH symptoms,
+  confirmed by the wearer. Do not recommend forced injection for this Batman build. Reaching foveated
+  render passes was only a technical probe, not a working visual implementation. Eye-tracking logs also
+  showed left-eye filter resets, but they do not establish the rendering bug's root cause.
+  Keep `adapter.foveation_fix` separate: hiding the game's Quest extensions does not prevent the
+  independent Valve injection path. A swapchain sample count of 1 also does not prove the absence of
+  internal MSAA: the enabled Batman render-pass trace reported `samples 2`.
 - Vulkan: freedreno (Mesa Turnip); Valve injects `VK_LAYER_VALVE_rpo` and `VALVE_fdm_injection` via
  VK_INSTANCE_LAYERS (set `VK_INSTANCE_LAYERS=""` through `device.lepton_env` to test without them).
  The FDM layer follows each eye's gaze; one-eye jitter in some games (GitHub #69) is fixed per game with
@@ -324,6 +341,45 @@ over Quest games.
 - Unity text fields close without a system keyboard; see `frame.unity_text_input` in PLAYBOOK.md.


+## Shared foveation controls (tested 2026-10-12)
+
+Under a Quest game's Advanced patches, choose **Foveated rendering → Eye-tracked**, then **Update on Frame**.
+The full-resolution area selector defaults to **Default (30% radius)**: no radius override, preserving the
+runtime profile used in the headset experiments. Larger radii retain more detail and save less shading work.
+Custom radii set `FOVE_INNER`; `FOVE_OUTER` is twice that value, matching the runtime's profile proportions.
+The inspected runtime's built-in inner/outer pairs are 0.30/0.60, 0.25/0.50 and 0.20/0.40.
+The shared-texture injection path selects profile 1: 0.30 inner radius and 0.60 outer radius.
+
+`device.foveation` enables Valve's shared Vulkan injection and suppresses competing native foveation through
+`foveation_fix=1`. Recipes and shared catalog entries preserve mode, radius and test selection. This remains
+experimental: complete images were confirmed in RE4, Batman, Deadpool, The Climb 2 and Asgard's Wrath 2,
+not all Quest games or renderers. RE4 and Batman checks include title/calibration scenes; these are not
+equivalent to extended gameplay coverage. Asgard gameplay was visually confirmed, without an on/off benchmark.
+Batman additionally receives the verified ordinary shared-allocation patch, guarded by the full original
+OVRPlugin hash; unknown Batman versions fail explicitly rather than receiving unchecked binary offsets.
+
+The Climb 2 uses a private `libvrapi_foveation.so` bridge, installed only into that game's APK after the
+standard bridge patch. It retains images during held-focus visibility dips, separates mono overlay output
+storage from stereo density-map storage, and rate-limits its view-cache writes. Its process-local Valve layer
+correction supplies both eye offsets and avoids the invalid subpass mask-table reads seen during Alps loading;
+`yflip` corrects vertical gaze direction. The renderer SHA-256 and 1.0 resolution scale are checked before
+installation. The runtime correction additionally checks the exact Valve library SHA-256 and all four original
+instructions before touching executable memory; unsupported libraries request injection be disabled and log
+the reason. No system library is changed. A SteamOS update requires revalidation of this compatibility path.
+Both-eye gaze following was confirmed in Climb's darkening diagnostic, but long-session stability remains
+experimental. Off rebuilds from the source APK and removes this private support, including its visibility fix.
+
+**Darken lower-resolution regions (test)** adds an optional Vulkan shader diagnostic. It dims RGB where the
+actual `FragSizeEXT` footprint exceeds one pixel; alpha is unchanged. Deadpool's shaded regions were confirmed
+to follow gaze in the headset. Unsupported shader output interfaces are skipped, and multiple passes may
+compound darkening, so this is a diagnostic rather than a precise composited mask. Do not benchmark with it on.
+Uncheck it and update from the original source APK to remove the diagnostic library, except in Climb where
+the same library also carries the compatibility correction. Darkening stays dormant without its launcher opt-in.
+
+High-resolution Deadpool samples crossed from about 45 to 90 FPS with injection enabled, but temperatures and
+power rose as it rendered twice as many frames. Foveation does not guarantee lower temperature at uncapped FPS.
+The new configurable radii have configuration/build coverage; each radius has not been separately play-tested.
+
 ## Monitoring sources (probed 2026-10-07, SteamOS 0.4.3, kernel 6.18; used by the Monitor tab, agent `_monitor`)

 All readable by the steamos user without root; the agent reads them directly (no programs started per sample).
@@ -22,32 +22,43 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Beat Saber | PC VR | ✅ Works |  |
 | Beat Saber (co-existence build) | Quest | ✅ Works |  |
 | Blade & Sorcery: Nomad | Quest | ✅ Works |  |
+| BlazeRush | Quest | ✅ Works |  |
 | BodyCombat | Quest | ✅ Works |  |
 | BONELAB | Quest | ✅ Works |  |
 | Carve Snowboarding | Quest | ✅ Works |  |
 | Caves | Quest | ✅ Works |  |
 | Clockwork | Quest | ✅ Works |  |
 | Cook-Out | Quest | ✅ Works |  |
+| Cosmodread | Quest | ✅ Works |  |
 | Creed | Quest | ✅ Works |  |
 | cubism | Quest | ✅ Works |  |
+| Dance Central | Quest | ✅ Works |  |
 | Deep Cuts | Quest | ✅ Works |  |
 | Demeter | Quest | ✅ Works |  |
 | Dinosaur Island | Quest | ✅ Works |  |
 | Doom3Quest | Quest | ✅ Works |  |
 | Down the Rabbit Hole | Quest | ✅ Works |  |
+| Drunkn Bar Fight | Quest | ✅ Works |  |
+| Drunkn Bar Fight 2 - Early Access | Quest | ✅ Works |  |
 | Eleven: Table Tennis VR | PC VR | ✅ Works |  |
 | Espire 2 | Quest | ✅ Works |  |
+| FrenzyVR | Quest | ✅ Works |  |
+| Fruit Ninja | Quest | ✅ Works |  |
+| Fruit Salon | Quest | ✅ Works |  |
 | Genotype | Quest | ✅ Works |  |
 | GORN2 | Quest | ✅ Works |  |
 | Gravity Lab | Quest | ✅ Works |  |
 | H.U.N.T | Quest | ✅ Works |  |
 | I Am Cat | Quest | ✅ Works |  |
 | I Am Monkey | Quest | ✅ Works |  |
+| IEYTD3 | Quest | ✅ Works |  |
 | In Death: Unchained | Quest | ✅ Works |  |
 | Into The Radius 2 | Quest | ✅ Works |  |
 | Job Simulator | Quest | ✅ Works |  |
 | Jurassic World Aftermath Collection | Quest | ✅ Works |  |
 | Keep Talking and Nobody Explodes | Quest | ✅ Works |  |
+| Kill It With Fire VR | Quest | ✅ Works |  |
+| Ladder | Quest | ✅ Works |  |
 | Lambda1VR | Quest | ✅ Works |  |
 | LEGO® Bricktales | Quest | ✅ Works |  |
 | Lucky's Tale | Quest | ✅ Works |  |
@@ -57,8 +68,10 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Medieval Dynasty New Settlement | Quest | ✅ Works |  |
 | Metro Awakening | Quest | ✅ Works |  |
 | Mobile Suit Gundam: Silver Phantom | Quest | ✅ Works |  |
+| Munkr Funkr (The Legacy Days) | Quest | ✅ Works |  |
 | Nano | Quest | ✅ Works |  |
 | NEX Player | Quest | ✅ Works |  |
+| NFL PRO ERA II | Quest | ✅ Works |  |
 | NOPE CHALLENGE | Quest | ✅ Works |  |
 | palazzo_santacruz | Quest | ✅ Works |  |
 | Path of the Warrior | Quest | ✅ Works |  |
@@ -77,25 +90,34 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Robo Recall | Quest | ✅ Works |  |
 | RUINSMAGUS | Quest | ✅ Works |  |
 | Shores of Loci | Quest | ✅ Works |  |
+| SilentSlayer | Quest | ✅ Works |  |
 | Sniper Elite VR | Quest | ✅ Works |  |
 | Sniper Elite VR: Winter Warrior | Quest | ✅ Works |  |
 | Space Pirate Trainer Quest | Quest | ✅ Works |  |
 | Star Wars Pinball VR | Quest | ✅ Works |  |
+| Star Wars: Tales from the Galaxy's Edge | Quest | ✅ Works |  |
 | Stremio | Quest | ✅ Works |  |
+| Superfly | Quest | ✅ Works |  |
 | SUPERHOT VR | PC VR | ✅ Works |  |
 | SUPERHOT VR | Quest | ✅ Works |  |
 | SynthRiders | Quest | ✅ Works |  |
+| Taskmaster | Quest | ✅ Works |  |
 | TetrisEffect | Quest | ✅ Works |  |
 | The Boys VR | Quest | ✅ Works |  |
 | The Climb 2 | Quest | ✅ Works |  |
 | The Room VR | Quest | ✅ Works |  |
 | The Tale of Onogoro | Quest | ✅ Works |  |
+| Time Crisis II VR (Test) | Quest | ✅ Works |  |
 | Time Crisis VR (Experimental) | Quest | ✅ Works |  |
+| Totally Baseball | Quest | ✅ Works |  |
 | Toy Master | Quest | ✅ Works |  |
+| TRIANGLE STRATEGY | Quest | ✅ Works |  |
 | Under Cover | Quest | ✅ Works |  |
+| Vacation Simulator | Quest | ✅ Works |  |
 | Vader Immortal: Episode I | Quest | ✅ Works |  |
 | Vader Immortal: Episode II | Quest | ✅ Works |  |
 | Vader Immortal: Episode III | Quest | ✅ Works |  |
+| Vampire Survivors | Quest | ✅ Works |  |
 | VR HOT Quest | Quest | ✅ Works |  |
 | VR4 | Quest | ✅ Works |  |
 | Walkabout Mini Golf | Quest | ✅ Works |  |
@@ -107,17 +129,22 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Arcsmith | Quest | ⚠️ Works with issues | Right eye distorts during movement (unresolved; swap, tracking, Valve layers, depth and pacing ruled out). |
 | Assassin's Creed Nexus | Quest | ⚠️ Works with issues | Some launch warning text is still upside down; the rest of the UI is fixed by flip emulation. |
 | Does it Stack? | Quest | ⚠️ Works with issues | Mixed reality mode does not work (works on Demeo), everything else seems to be OK |
+| Dungeons of Eternity | Quest | ⚠️ Works with issues | It can not connect to servers |
 | End Space | Quest | ⚠️ Works with issues | Controls stop responding after the first mission loads. |
 | ExploreVR | Quest | ⚠️ Works with issues | The 3D world warps and shifts with head movement (wrong perspective). |
+| Fisherman | Quest | ⚠️ Works with issues | Loading screens have corruption, but everything works otherwise. |
 | Freedom | Quest | ⚠️ Works with issues | Volume can't be changed in the game. |
+| MacacoVR | Quest | ⚠️ Works with issues | 2d loading screens are glitchy, otherwise main gameplay is fine |
 | Myst | Quest | ⚠️ Works with issues | Minor graphical glitches on some objects. |
 | Phantom: Covert Ops | Quest | ⚠️ Works with issues | DLC/store button crashes (no Meta store). |
 | Pinball FX VR | Quest | ⚠️ Works with issues | Plays; mixed reality mode not working yet. |
 | Silhouette | Quest | ⚠️ Works with issues | Hand-tracking game; the Frame synthesizes hands from controllers, so it is janky. |
+| Swarm 2 | Quest | ⚠️ Works with issues | MSAA creates visible seams around edge geometry and also the skybox edge |
 | The Light Brigade | Quest | ⚠️ Works with issues | Judder in weapons |
+| The Thrill Of The Fight | Quest | ⚠️ Works with issues | Right eye doesn't draw the opponent or the referee. |
 | Time Stall | Quest | ⚠️ Works with issues | Both eyes distort during movement (unresolved). |
+| Vermillion | Quest | ⚠️ Works with issues | Runs. |
 | WiiCompiled VR | Quest | ⚠️ Works with issues | To add a game: in FramePort's Files tab, upload your .wcgame file to this game's storage, folder Android/data/org.wiicompiled.quest/files/WiiCompiledOpenXRVR… |
-| BlazeRush | Quest | ❌ Doesn't run | Starts and reaches the menu room, but the room shows no controllers and ignores all input (it all reaches the game); no fix yet. |
 | Eleven Table Tennis | Quest | ❌ Doesn't run | Stops at the splash screen. |
 | Espire 1: VR Operative (Quest Edition) | Quest | ❌ Doesn't run | Mesa GL driver crash during texture upload. |
 | GOLF+ | Quest | ❌ Doesn't run | Black screen. |
@@ -2,7 +2,7 @@

 # Patches

-Every patch and game setting FramePort knows: 156 entries in 5 groups. A game's recipe is its chosen patches and settings; tested games get theirs from the catalog ([GAMES.md](GAMES.md)), and other games get the patches FramePort suggests from its analysis. You change them on the game page under Customize.
+Every patch and game setting FramePort knows: 163 entries in 5 groups. A game's recipe is its chosen patches and settings; tested games get theirs from the catalog ([GAMES.md](GAMES.md)), and other games get the patches FramePort suggests from its analysis. You change them on the game page under Customize.

 Each entry says what the patch does, whether it changes the APK or only the install, when FramePort suggests it, its options, the catalog games whose recipe names it and the launch-test signatures that suggest it. Patches that are on by default are on for every game, so the catalog rarely names them.

@@ -11,8 +11,8 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 ## Groups

 - [Patches from OVRPort](#group-overport) (25)
- [Steam Frame patches](#group-frame) (45)
- [Game settings](#group-adapter) (65)
+- [Steam Frame patches](#group-frame) (51)
+- [Game settings](#group-adapter) (66)
 - [Files and settings on the Frame](#group-device) (8)
 - [PC VR (Proton and Revive)](#group-pcvr) (13)

@@ -39,7 +39,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Patch Oculus detection for Unity](#patch_oculus_unity) | `patch_oculus_unity` | Patches from OVRPort | default |
 | [Patch Oculus detection for Unreal](#patch_oculus_unreal) | `patch_oculus_unreal` | Patches from OVRPort | default |
 | [Remove localized app names](#patch_remove_localized_names) | `patch_remove_localized_names` | Patches from OVRPort | default |
-| [Remove Unreal's ForceQuit](#patch_remove_unreal_force_quit) | `patch_remove_unreal_force_quit` | Patches from OVRPort | 31 |
+| [Remove Unreal's ForceQuit](#patch_remove_unreal_force_quit) | `patch_remove_unreal_force_quit` | Patches from OVRPort | 34 |
 | [Remove uses-library](#patch_remove_uses_library) | `patch_remove_uses_library` | Patches from OVRPort | default |
 | [Remove VrApi library](#patch_remove_vrapi) | `patch_remove_vrapi` | Patches from OVRPort |  |
 | [Replace application label and icon](#patch_replace_icon_label) | `patch_replace_icon_label` | Patches from OVRPort | default |
@@ -48,18 +48,20 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [FrameBridge OpenXR adapter](#frame-adapter) | `frame.adapter` | Steam Frame patches | default |
 | [Content files from the game's data](#frame-asset_files) | `frame.asset_files` | Steam Frame patches | 1 |
 | [Skip Meta avatars](#frame-avatar_stub) | `frame.avatar_stub` | Steam Frame patches | 1 |
+| [bHaptics: skip the Bluetooth permission request](#frame-bhaptics_permission) | `frame.bhaptics_permission` | Steam Frame patches |  |
 | [BlazeRush: controllers without Meta avatars, own shader cache](#frame-blazerush) | `frame.blazerush` | Steam Frame patches | 1 |
+| [Epic Online Services: stop the keychain retry loop](#frame-eos_keychain_loop) | `frame.eos_keychain_loop` | Steam Frame patches |  |
 | [OpenGL ES: multiview shaders on flat panels (HUD, menus)](#frame-gl_multiview_fbo) | `frame.gl_multiview_fbo` | Steam Frame patches | 1 |
 | [GL shim (Mesa GLSL compatibility)](#frame-gl_shim) | `frame.gl_shim` | Steam Frame patches | 2 |
 | [Godot apps: start without a clipboard service](#frame-godot_clipboard) | `frame.godot_clipboard` | Steam Frame patches |  |
-| [Hardware video decoding (H.264, HEVC, VP9)](#frame-hw_video_decode) | `frame.hw_video_decode` | Steam Frame patches | 2 |
+| [Hardware video decoding (H.264, HEVC, VP9)](#frame-hw_video_decode) | `frame.hw_video_decode` | Steam Frame patches | 6 |
 | [Language packs from the game's files](#frame-langpacks) | `frame.langpacks` | Steam Frame patches |  |
 | [Launcher category (INFO → LAUNCHER)](#frame-launcher) | `frame.launcher` | Steam Frame patches | default |
 | [GL wrapper: OpenGL ES depth formats (Minecraft)](#frame-ltw_depth) | `frame.ltw_depth` | Steam Frame patches | default |
 | [Declare Meta-only permissions](#frame-meta_permissions) | `frame.meta_permissions` | Steam Frame patches | 1 |
 | [Meta XR Audio: skip Quest telemetry class](#frame-metaxr_telemetry) | `frame.metaxr_telemetry` | Steam Frame patches | default |
 | [Clear android:debuggable](#frame-nodebug) | `frame.nodebug` | Steam Frame patches | 3 |
-| [Oculus OS telemetry class stubs](#frame-oculusos) | `frame.oculusos` | Steam Frame patches | 14 |
+| [Oculus OS telemetry class stubs](#frame-oculusos) | `frame.oculusos` | Steam Frame patches | 15 |
 | [Fix crash when the game prepares the microphone](#frame-ovr_microphone) | `frame.ovr_microphone` | Steam Frame patches |  |
 | [Keep the same Meta user between starts](#frame-ovr_stable_user) | `frame.ovr_stable_user` | Steam Frame patches | default |
 | [Trace Meta platform requests (diagnostics)](#frame-ovr_trace) | `frame.ovr_trace` | Steam Frame patches |  |
@@ -71,21 +73,25 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Start straight in VR (skip the 2D launcher)](#frame-start_activity) | `frame.start_activity` | Steam Frame patches |  |
 | [Allow swapchains larger than 4096 px](#frame-swapchain_limit) | `frame.swapchain_limit` | Steam Frame patches | default |
 | [Team Beef ports: treat the Frame as a Meta headset](#frame-tbxr_vendor) | `frame.tbxr_vendor` | Steam Frame patches | 1 |
-| [GL shim for Unity (no multisampled render-to-texture)](#frame-unity_gl_shim) | `frame.unity_gl_shim` | Steam Frame patches | 12 |
+| [GL shim for Unity (no multisampled render-to-texture)](#frame-unity_gl_shim) | `frame.unity_gl_shim` | Steam Frame patches | 17 |
 | [Unity: render each eye separately (no multiview)](#frame-unity_multipass) | `frame.unity_multipass` | Steam Frame patches | 1 |
 | [Unity: disable MSAA](#frame-unity_no_msaa) | `frame.unity_no_msaa` | Steam Frame patches | 7 |
 | [Unity: skip OVROverlay layers (fades, splash screens)](#frame-unity_no_overlay_copy) | `frame.unity_no_overlay_copy` | Steam Frame patches | 2 |
 | [Unity: start VR without Meta's system apps](#frame-unity_oculus_check) | `frame.unity_oculus_check` | Steam Frame patches | 9 |
-| [Unity: keep MSAA off at runtime (OVRManager)](#frame-unity_runtime_msaa_off) | `frame.unity_runtime_msaa_off` | Steam Frame patches | 17 |
-| [Make Unity text fields work](#frame-unity_text_input) | `frame.unity_text_input` | Steam Frame patches | 56 |
+| [Unity: keep MSAA off at runtime (OVRManager)](#frame-unity_runtime_msaa_off) | `frame.unity_runtime_msaa_off` | Steam Frame patches | 22 |
+| [Make Unity text fields work](#frame-unity_text_input) | `frame.unity_text_input` | Steam Frame patches | 69 |
+| [Unity: share thread keys (games that run out of them)](#frame-unity_tls_key_pool) | `frame.unity_tls_key_pool` | Steam Frame patches | 1 |
 | [Unity: headset always counts as worn](#frame-unity_user_presence) | `frame.unity_user_presence` | Steam Frame patches | 1 |
 | [GL shim for Unreal (no multisampled render-to-texture)](#frame-unreal_gl_shim) | `frame.unreal_gl_shim` | Steam Frame patches | 1 |
+| [Unreal: match multiview depth to the eye size](#frame-unreal_multiview_depth) | `frame.unreal_multiview_depth` | Steam Frame patches | 1 |
 | [Unreal: stand-ins for OVRPlugin functions OVRPort lacks](#frame-unreal_ovrp_entrypoints) | `frame.unreal_ovrp_entrypoints` | Steam Frame patches | 1 |
 | [Unreal: Quest controller bindings (RPOC key map)](#frame-unreal_quest_keymap) | `frame.unreal_quest_keymap` | Steam Frame patches | 3 |
 | [Unreal: don't wait for the Quest shader precompile](#frame-unreal_quest_precompile) | `frame.unreal_quest_precompile` | Steam Frame patches | 3 |
-| [Unreal: start without the OBB check](#frame-unreal_skip_obb_check) | `frame.unreal_skip_obb_check` | Steam Frame patches |  |
+| [Unreal: start without the OBB check](#frame-unreal_skip_obb_check) | `frame.unreal_skip_obb_check` | Steam Frame patches | 3 |
+| [Unreal: bypass the stalled loading splash](#frame-unreal_splash_bypass) | `frame.unreal_splash_bypass` | Steam Frame patches | 1 |
 | [Unreal: thumb follows the capacitive touches](#frame-unreal_thumb_touch) | `frame.unreal_thumb_touch` | Steam Frame patches | 7 |
-| [Vivox voice chat: skip Android 12 audio routing](#frame-vivox_audio_route) | `frame.vivox_audio_route` | Steam Frame patches |  |
+| [Vermillion: paint canvases in the scene](#frame-vermillion_scene_canvas) | `frame.vermillion_scene_canvas` | Steam Frame patches | 1 |
+| [Vivox voice chat: skip Android 12 audio routing](#frame-vivox_audio_route) | `frame.vivox_audio_route` | Steam Frame patches | 1 |
 | [Vulkan: drop invalid render-pass pointers](#frame-vk_sanitize) | `frame.vk_sanitize` | Steam Frame patches | default · 1 |
 | [VrApi → OpenXR bridge](#frame-vrapi_bridge) | `frame.vrapi_bridge` | Steam Frame patches | 3 |
 | [Quiet Meta's VrApi loader (OpenXR games)](#frame-vrapi_stub) | `frame.vrapi_stub` | Steam Frame patches | 2 |
@@ -104,6 +110,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [360° sharpness](#adapter-equirect_res) | `adapter.equirect_res` | Game settings |  |
 | [360° 3D](#adapter-equirect_stereo) | `adapter.equirect_stereo` | Game settings |  |
 | [Per-eye diagnostics (log)](#adapter-eye_debug) | `adapter.eye_debug` | Game settings |  |
+| [Draw fades over the picture](#adapter-fade_quad) | `adapter.fade_quad` | Game settings |  |
 | [Fix upside-down menus](#adapter-flip_emul) | `adapter.flip_emul` | Game settings |  |
 | [Rotate panels 180°](#adapter-flip_quads) | `adapter.flip_quads` | Game settings |  |
 | [Don't pause on short interruptions](#adapter-focus_hold) | `adapter.focus_hold` | Game settings | 4 |
@@ -114,7 +121,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [GL shim: high-precision vertex shaders](#adapter-gl_highp_markers) | `adapter.gl_highp_markers` | Game settings | 1 |
 | [GL shim: integer vertex inputs](#adapter-gl_int_attribs) | `adapter.gl_int_attribs` | Game settings | 1 |
 | [Flat panel diagnostics (log)](#adapter-gl_mv_debug) | `adapter.gl_mv_debug` | Game settings |  |
-| [Fix freezes when controllers vibrate](#adapter-haptic_fix) | `adapter.haptic_fix` | Game settings | 44 |
+| [Fix freezes when controllers vibrate](#adapter-haptic_fix) | `adapter.haptic_fix` | Game settings | 60 |
 | [Vibration strength](#adapter-haptic_scale) | `adapter.haptic_scale` | Game settings |  |
 | [Turn off space warp](#adapter-hide_space_warp) | `adapter.hide_space_warp` | Game settings | 4 |
 | [Controller input diagnostics (log)](#adapter-input_diag) | `adapter.input_diag` | Game settings |  |
@@ -126,7 +133,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [See your room](#adapter-passthrough_emul) | `adapter.passthrough_emul` | Game settings |  |
 | [Steadier head tracking](#adapter-pose_consistency) | `adapter.pose_consistency` | Game settings | 1 |
 | [Pose timing diagnostics (log)](#adapter-pose_debug) | `adapter.pose_debug` | Game settings |  |
-| [Fix hands lagging behind controllers](#adapter-pose_time_fix) | `adapter.pose_time_fix` | Game settings | 8 |
+| [Fix hands lagging behind controllers](#adapter-pose_time_fix) | `adapter.pose_time_fix` | Game settings | 11 |
 | [Treat newer Quest controllers as Touch](#adapter-profile_remap) | `adapter.profile_remap` | Game settings |  |
 | [Animate fingers from touch](#adapter-proximity_emul) | `adapter.proximity_emul` | Game settings |  |
 | [Keep pictures in bounds](#adapter-rect_clamp) | `adapter.rect_clamp` | Game settings |  |
@@ -135,7 +142,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Re-create play space](#adapter-respace_kick) | `adapter.respace_kick` | Game settings |  |
 | [Sharpness](#adapter-scale) | `adapter.scale` | Game settings | 4 |
 | [Room depth](#adapter-scene_depth) | `adapter.scene_depth` | Game settings |  |
-| [Pretend room layout](#adapter-scene_emul) | `adapter.scene_emul` | Game settings | 1 |
+| [Pretend room layout](#adapter-scene_emul) | `adapter.scene_emul` | Game settings | 2 |
 | [Room height](#adapter-scene_height) | `adapter.scene_height` | Game settings |  |
 | [Room width](#adapter-scene_width) | `adapter.scene_width` | Game settings |  |
 | [Eye-image snapshots (diagnostics)](#adapter-snapshot) | `adapter.snapshot` | Game settings |  |
@@ -158,11 +165,11 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Keep the game's saved resolution in step](#device-config_sync) | `device.config_sync` | Files and settings on the Frame | 1 |
 | [Show as VR or as a flat window](#device-display_mode) | `device.display_mode` | Files and settings on the Frame |  |
 | [Settings files for the game](#device-files) | `device.files` | Files and settings on the Frame | 2 |
-| [Eye-tracked foveation (Valve)](#device-foveation) | `device.foveation` | Files and settings on the Frame |  |
+| [Foveated rendering (Valve)](#device-foveation) | `device.foveation` | Files and settings on the Frame |  |
 | [Hide Android's navigation bar](#device-hide_navbar) | `device.hide_navbar` | Files and settings on the Frame |  |
 | [Extra Lepton settings](#device-lepton_env) | `device.lepton_env` | Files and settings on the Frame | 3 |
 | [Controllers as a gamepad (Steam Input)](#device-steam_gamepad) | `device.steam_gamepad` | Files and settings on the Frame |  |
-| [Show the app's Android window (for typing)](#device-text_input_window) | `device.text_input_window` | Files and settings on the Frame | 56 |
+| [Show the app's Android window (for typing)](#device-text_input_window) | `device.text_input_window` | Files and settings on the Frame | 69 |
 | [Launch options (SteamVR or OpenXR)](#pcvr-launch_args) | `pcvr.launch_args` | PC VR (Proton and Revive) | 2 |
 | [Provide the Oculus runtime from Revive (Frame)](#pcvr-libovr_redirect) | `pcvr.libovr_redirect` | PC VR (Proton and Revive) |  |
 | [No Unreal crash reporter](#pcvr-no_crash_reporter) | `pcvr.no_crash_reporter` | PC VR (Proton and Revive) |  |
@@ -407,7 +414,7 @@ Stops some Unreal games from closing themselves right after starting.
 - `patch_remove_unreal_force_quit`
 - **Changes:** Changes the APK (during the OVRPort conversion).
 - **Offered (off):** Built as the alternate APK for Unreal games (use it if the game quits itself).
- **Catalog games (31):** Asgard's Wrath 2, BARTENDER VR SIMULATOR, Carve Snowboarding, Creed, Espire 1: VR Operative (Quest Edition), Espire 2, ExploreVR, Fisherman and 23 more.
+- **Catalog games (34):** Asgard's Wrath 2, BARTENDER VR SIMULATOR, Carve Snowboarding, Creed, Dance Central, Espire 1: VR Operative (Quest Edition), Espire 2, ExploreVR and 26 more.
 - **Suggested by launch-test signatures:**
  - `force-quit` (error): The game quit itself right after starting.
 - **Source:** [patches/overport.py](../src/frameport/patches/overport.py)
@@ -517,6 +524,19 @@ Lets games start that would stop at Meta's avatars (for example BlazeRush). No M

 > Meta's avatar library needs Meta's Horizon app, which the Frame doesn't have; it then stops the game at start ("Failed to launch SystemActivities", for example BlazeRush). Replaces it with a library that does nothing, so the game runs without Meta avatars.

+### <a id="frame-bhaptics_permission"></a>bHaptics: skip the Bluetooth permission request
+
+Stops bHaptics from asking for a Bluetooth permission the Frame doesn't have (the game would freeze on its loading screen).
+
+- `frame.bhaptics_permission` · also for 2D apps
+- **Changes:** Changes the APK (a rebuild and reinstall apply it).
+- **Suggested (on):** bHaptics asks for an Android 12 Bluetooth permission at start; the permission screen interrupts the game on the Frame.
+- **Suggested by launch-test signatures:**
+  - `bhaptics-permission-prompt` (error): The game asked for Android 12's Bluetooth permission (bHaptics' vest SDK, for example Yupitergrad).
+- **Source:** [patches/frame/bhaptics_permission.py](../src/frameport/patches/frame/bhaptics_permission.py)
+
+> bHaptics' vest SDK asks for an Android 12 Bluetooth permission at start; on Lepton's Android 11 the permission screen takes the foreground for a moment and Meta's OVRPlugin stops drawing (for example Yupitergrad freezing on its loading screen). The request returns at once instead (an in-place edit of classes.dex).
+
 ### <a id="frame-blazerush"></a>BlazeRush: controllers without Meta avatars, own shader cache

 Makes BlazeRush's menus and controllers work without Meta's avatars, and lets its shader fixes take effect.
@@ -530,6 +550,19 @@ Makes BlazeRush's menus and controllers work without Meta's avatars, and lets it

 > BlazeRush 1.0.349 only (Klownicle's guide, GitHub #57). Its menus wait for Meta's avatar, which never comes on the Frame, before they create the game's own controllers: the second menu ignored all input. Two instructions in libtargemapp.so skip that wait and the avatar mesh drawing; the game's shader cache gets a new folder name (cache/br_shader_v1), so programs compiled before the GL shim's shader fixes aren't reused. Only this exact build is changed (code fingerprint and every instruction checked); anything else is left as it is.

+### <a id="frame-eos_keychain_loop"></a>Epic Online Services: stop the keychain retry loop
+
+Stops Epic Online Services from retrying its login keychain forever (the game would never finish starting).
+
+- `frame.eos_keychain_loop` · also for 2D apps
+- **Changes:** Changes the APK (a rebuild and reinstall apply it).
+- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
+- **Suggested by launch-test signatures:**
+  - `eos-keychain-loop` (error): Epic Online Services can't save its login keychain and retries without end (a start that never finishes, 100 % CPU).
+- **Source:** [patches/frame/eos_keychain_loop.py](../src/frameport/patches/frame/eos_keychain_loop.py)
+
+> Epic Online Services (EOS) keeps its login keychain in the app's settings storage. When it can't write there, it resets the keychain and tries again without end (for example Beyond Sandbox: a start that never finishes, 100 % CPU, a log of gigabytes). The reset method returns at once instead (an in-place edit of classes.dex), so EOS reports the failure to the game once.
+
 ### <a id="frame-gl_multiview_fbo"></a>OpenGL ES: multiview shaders on flat panels (HUD, menus)

 Experimental: shows HUDs, menus and other flat panels that stay black on the Frame (for example Doom3Quest's HUD and PDA).
@@ -577,7 +610,7 @@ Plays the game's videos on the Frame's video hardware, so 4K and 8K video runs s
 - `frame.hw_video_decode` · also for 2D apps
 - **Changes:** Install only: written on the Frame when the game is installed; the APK isn't changed.
 - **Suggested (on):** The game plays video through Android's decoders (MediaCodec, ExoPlayer or VLC): decode it on the Frame's hardware.
- **Catalog games (2):** 4XVR Video Player, Batman: Arkham Shadow.
+- **Catalog games (6):** 4XVR Video Player, Batman: Arkham Shadow, Dance Central, Fruit Ninja, Kill It With Fire VR, MacacoVR.
 - **Source:** [patches/frame/hw_video_decode.py](../src/frameport/patches/frame/hw_video_decode.py)

 > Decodes the game's videos on the Frame's hardware video decoder instead of Android's software decoders, which stutter or fall behind with 4K/8K video (for example video players, Batman: Arkham Shadow's cutscenes). Adds FramePort's codec plugin (OMX.frameport.avc/hevc/vp9.decoder) to this game's container only; the APK isn't changed. When the hardware is busy (for example Steam's own hardware video decoding is on) the video is decoded in software as before.
@@ -668,7 +701,7 @@ Provides stand-ins for Quest system calls some games make at start.
 - **Suggested (on):** The Unreal build of Meta XR Audio looks up com.oculus.os.AnalyticsEvent and aborts without it (for example NOPE Challenge).
 - **Suggested (on):** Several Meta SDK libraries look up com.oculus.os.AnalyticsEvent (…); games like this abort without the stub (for example Nano).
 - **Offered (off):** … references com.oculus.os.AnalyticsEvent; usually harmless (for example Batman: Arkham Shadow and LEGO Bricktales run without it). Enable if the game aborts with ClassNotFoundException.
- **Catalog games (14):** AgeOfJoy, AllInOneSports, Caves, Deep Cuts, Does it Stack?, Nano, NOPE CHALLENGE, RC Pilot Trainer and 6 more.
+- **Catalog games (15):** AgeOfJoy, AllInOneSports, Caves, Deep Cuts, Does it Stack?, Nano, NOPE CHALLENGE, RC Pilot Trainer and 7 more.
 - **Suggested by launch-test signatures:**
  - `oculus-os-class` (fatal): The game looks up a Quest-only system class and aborts.
 - **Source:** [patches/frame/telemetry.py](../src/frameport/patches/frame/telemetry.py)
@@ -823,7 +856,7 @@ Stops a gray or frozen screen in Unity games that turn on anti-aliasing while ru
 - `frame.unity_gl_shim`
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Unity GLES game that may switch to MSAA at runtime: hide multisampled render-to-texture, which crashes the Frame's GL driver (for example The Room VR).
- **Catalog games (12):** Audica, BattleSisters, Beat Saber, Clockwork, Cosmodread, Down the Rabbit Hole, End Space, Gravity Lab and 4 more.
+- **Catalog games (17):** Audica, BattleSisters, Beat Saber, Clockwork, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight, End Space and 9 more.
 - **Suggested by launch-test signatures:**
  - `unreal-msrtt-crash` (fatal): The game's graphics crashed a few seconds after start.
 - **Source:** [patches/frame/vrapi_bridge.py](../src/frameport/patches/frame/vrapi_bridge.py)
@@ -892,7 +925,7 @@ Keeps a smoothing setting off that the game turns on itself and that can freeze
 - `frame.unity_runtime_msaa_off` · revision 2
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** GLES Unity game whose OVRManager turns 4x MSAA on at runtime: multisampled render-to-texture can hang the Frame's GPU.
- **Catalog games (17):** Audica, BattleSisters, Beat Saber, Clockwork, Cosmodread, Down the Rabbit Hole, End Space, Gravity Lab and 9 more.
+- **Catalog games (22):** Audica, BattleSisters, Beat Saber, Clockwork, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight, End Space and 14 more.
 - **Suggested by launch-test signatures:**
  - `unity-render-crash` (fatal): The game's graphics crashed, so the picture freezes or stays gray.
  - `unity-runtime-msaa` (info): The game turns MSAA on at runtime, which can hang the Frame's GPU.
@@ -908,11 +941,25 @@ Lets you type into this app's text fields on the Frame (they'd close at once).
 - `frame.unity_text_input` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Unity app with text fields (…): they close at once on the Frame because it has no system keyboard.
- **Catalog games (56):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Audica, BattleSisters, Beat Saber, Beat Saber (co-existence build), Blade & Sorcery: Nomad and 48 more.
+- **Catalog games (69):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Audica, BattleSisters, Beat Saber, Beat Saber (co-existence build), Blade & Sorcery: Nomad and 61 more.
 - **Source:** [patches/frame/unity_text_input.py](../src/frameport/patches/frame/unity_text_input.py)

 > Unity's TMP_InputField / InputField wait for Android's on-screen keyboard and close themselves a frame later when there is none (Lepton has no on-screen keyboard; Meta's system keyboard does this on a Quest), so a selected text field only flashes a caret. Rewrites TouchScreenKeyboardShouldBeUsed -&gt; false and isKeyboardUsingEvents (TMP) / InPlaceEditing (uGUI) -&gt; true in libil2cpp.so, found per game with Cpp2IL (downloaded on first use), so fields stay selected and take key presses: Steam's keyboard (with "Show the app window") or Type on Frame from the PC.

+### <a id="frame-unity_tls_key_pool"></a>Unity: share thread keys (games that run out of them)
+
+Lets Unity 6 games with many native libraries start when they run out of thread keys (they'd abort with "cannot create thread specific key"), for example Wander.
+
+- `frame.unity_tls_key_pool` · also for 2D apps
+- **Changes:** Changes the APK (a rebuild and reinstall apply it).
+- **Offered (off):** Unity 6 with …: turn on if the game aborts at start with "cannot create thread specific key" (for example Wander).
+- **Catalog games (1):** Wander.
+- **Suggested by launch-test signatures:**
+  - `pthread-keys-exhausted` (fatal): The game ran out of thread keys (Android allows 128 per process; Unity 6 plus large native libraries such as Firebase or Gecko, and the Frame's own graphics/OpenXR libraries, use them up), so a library aborted at start (for example Wander in Firebase's Firestore).
+- **Source:** [patches/frame/unity_tls_key_pool.py](../src/frameport/patches/frame/unity_tls_key_pool.py)
+
+> Android gives a process 128 thread keys (pthread keys, per-thread storage slots). Unity 6 takes about 40, and on the Frame the graphics and OpenXR libraries take more than on a Quest, so games with many other native libraries run out: Wander aborted at start ("cannot create thread specific key" in Firebase). Unity's keys without a clean-up function become slots behind one real key (libfp_tkeys.so); every other key and every other library keep real ones. Approach by Klownicle (GitHub #198).
+
 ### <a id="frame-unity_user_presence"></a>Unity: headset always counts as worn

 Counts the headset as worn, so games that only move the player while it's worn get head tracking and controls (for example BONELAB).
@@ -939,6 +986,20 @@ Stops a crash a few seconds after start in some Unreal games with anti-aliasing

 > Loads the GL shim into an Unreal GLES game and hides GL_EXT_multisampled_render_to_texture. Unreal's mobile MSAA renders through multisampled render-to-texture, and the Frame's GL driver (Mesa/Zink) can crash on it: SIGSEGV with fault address 0x10000 in libgallium_dri.so on the RHIThread a few seconds after start (Zink looks up a render-pass cache slot past its end, for example Star Wars Pinball VR). Hidden, Unreal renders without that path. Unreal's multiview stays on: Unreal only uses it when GL_OVR_multiview_multisampled_render_to_texture is listed too, so for Unreal the shim keeps that one visible and draws its multiview MSAA attachments single-sampled (glFramebufferTextureMultiviewOVR).

+### <a id="frame-unreal_multiview_depth"></a>Unreal: match multiview depth to the eye size
+
+Shows the full environment when its upper part is clipped but menu panels look correct.
+
+- `frame.unreal_multiview_depth`
+- **Changes:** Changes the APK (a rebuild and reinstall apply it).
+- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
+- **Catalog games (1):** Star Wars: Tales from the Galaxy's Edge.
+- **Suggested by launch-test signatures:**
+  - `unreal-multiview-depth-size` (warning): The measured multiview depth attachment keeps the initial Android window dimensions and clips the taller eye color target (Tales from the Galaxy's Edge, issue 61).
+- **Source:** [patches/frame/unreal_multiview_depth.py](../src/frameport/patches/frame/unreal_multiview_depth.py)
+
+> Some UE4 games keep the initial Android window size for their stereo depth buffer, clipping the upper part of the environment while menu panels look correct. Refreshes the cached depth dimensions from the current eye render target before allocation. Preserves multiview and multisampling. Verified in Tales from the Galaxy's Edge 1.1.9; changes one branch only when the function size and surrounding code match.
+
 ### <a id="frame-unreal_ovrp_entrypoints"></a>Unreal: stand-ins for OVRPlugin functions OVRPort lacks

 Lets older Unreal games start VR on the Frame (for example Star Wars Pinball VR).
@@ -982,12 +1043,27 @@ Starts Unreal games without re-checking their data file (they'd seem to hang on
 - `frame.unreal_skip_obb_check` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Unreal checks the OBB's contents before starting (bVerifyOBBOnStartUp); on the Frame a failed or slow check can't be seen and the game seems to hang.
+- **Catalog games (3):** Dance Central, Kill It With Fire VR, MacacoVR.
 - **Suggested by launch-test signatures:**
  - `unreal-obb-check-stuck` (fatal): The game stays on Unreal's OBB check screen (DownloaderActivity), which the Frame doesn't show, and never starts VR (for example Contractors, GitHub #159).
 - **Source:** [patches/frame/unreal_obb_check.py](../src/frameport/patches/frame/unreal_obb_check.py)

 > Unreal games can check their whole data file (.obb) before starting (bVerifyOBBOnStartUp). On the Frame that check's progress and error screens are invisible (Lepton runs VR games without an Android window), so the game seems to hang on its DownloaderActivity, for example Contractors. This turns the check off in the manifest; Unreal still checks that the OBB is there with the right size, so a missing or wrong-version OBB still stops the game.

+### <a id="frame-unreal_splash_bypass"></a>Unreal: bypass the stalled loading splash
+
+Lets the game finish loading when its separate loading splash stalls the render thread.
+
+- `frame.unreal_splash_bypass`
+- **Changes:** Changes the APK (a rebuild and reinstall apply it).
+- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
+- **Catalog games (1):** Star Wars: Tales from the Galaxy's Edge.
+- **Suggested by launch-test signatures:**
+  - `unreal-splash-frame-stall` (error): Unreal's map loading waits for rendering while its separate Oculus splash waits for an unbegun VR frame (Tales from the Galaxy's Edge, issue 61).
+- **Source:** [patches/frame/unreal_splash.py](../src/frameport/patches/frame/unreal_splash.py)
+
+> Some UE4 Oculus games stall during map loading: the game waits for the render thread, and the separate loading splash waits for an unbegun VR frame. Bypasses the splash renderer so loading finishes; the last image stays visible during loading. The normal environment and menu rendering continue. Verified in Tales from the Galaxy's Edge 1.1.9; changes one instruction only when the function size and prologue match.
+
 ### <a id="frame-unreal_thumb_touch"></a>Unreal: thumb follows the capacitive touches

 Makes the hands' thumbs follow what your thumb touches (they always pointed up: the Frame doesn't sense a thumb hovering, for example Vader Immortal).
@@ -1000,6 +1076,18 @@ Makes the hands' thumbs follow what your thumb touches (they always pointed up:

 > Unreal 4's Oculus input sets the ThumbUp axis (games animate the hand's thumb with it) from Meta's near-touch sensing, which the Frame never reports: the thumb always points up. Uses the touches instead (left X/Y/stick/thumb rest, right A/B/stick/thumb rest). Changes three instructions in OculusInput::SendControllerEvents, only where the code matches exactly (UE4 Oculus games of one engine generation, for example Vader Immortal, Robo Recall). Found by Klownicle (GitHub #49).

+### <a id="frame-vermillion_scene_canvas"></a>Vermillion: paint canvases in the scene
+
+Keeps the hand and brush visible over Vermillion's painting canvas (the canvas is drawn in the scene instead of as a layer in front).
+
+- `frame.vermillion_scene_canvas`
+- **Changes:** Changes the APK (a rebuild and reinstall apply it).
+- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
+- **Catalog games (1):** Vermillion.
+- **Source:** [patches/frame/vermillion_canvas.py](../src/frameport/patches/frame/vermillion_canvas.py)
+
+> Vermillion shows a canvas being painted as a separate compositor layer, which the Frame draws in front of everything: the hand and brush disappear over the canvas while they still paint. Rewrites PaintableMesh.HasCompositorLayerAvailable and ShouldUseCompositorOverlay -&gt; false in libil2cpp.so (found with Cpp2IL), so the game uses its own fallback and draws the canvas in the scene. The canvas may look a little less sharp.
+
 ### <a id="frame-vivox_audio_route"></a>Vivox voice chat: skip Android 12 audio routing

 Lets games with Vivox voice chat start on the Frame (they'd crash on an Android 12 audio call).
@@ -1007,6 +1095,7 @@ Lets games with Vivox voice chat start on the Frame (they'd crash on an Android
 - `frame.vivox_audio_route` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Vivox voice chat: it calls Android 12 audio methods, which Lepton (Android 11) lacks, and crashes.
+- **Catalog games (1):** Dungeons of Eternity.
 - **Suggested by launch-test signatures:**
  - `vivox-api31` (fatal): The game's Vivox voice-chat SDK calls Android 12 audio-routing methods (AudioManager communication devices) without checking the Android version; Lepton runs Android 11, so the app crashes (for example Green Hell VR).
 - **Source:** [patches/frame/vivox_audio_route.py](../src/frameport/patches/frame/vivox_audio_route.py)
@@ -1040,6 +1129,7 @@ Lets games built on Meta's oldest VR interface run on the Frame.
 - **Catalog games (3):** BlazeRush, Path of the Warrior, The Climb 2.
 - **Suggested by launch-test signatures:**
  - `direct-vrapi` (warning): The game uses Meta's VrApi directly and needs the VrApi bridge.
+  - `vrapi-frame-rejected` (fatal): The VrApi bridge rejected the game's frame options, so no picture reaches the headset even though frame pacing can appear in the log.
 - **Source:** [patches/frame/vrapi_bridge.py](../src/frameport/patches/frame/vrapi_bridge.py)

 > Replaces libvrapi.so with a VrApi→OpenXR bridge (Android-XR-Bridge/OVRPort fork, GPL-3.0, patched for the Frame: GLES sessions, cylinder→quad layers, sRGB format fallback, 30 s VR-mode deadline, emulated time conversion). Needed when the engine calls VrApi itself instead of through OVRPlugin (for example The Climb 2, Path of the Warrior); OVRPort cannot translate those.
@@ -1278,6 +1368,20 @@ Logs details when one eye looks wrong. No effect on the game.

 > For one eye looking wrong (for example a jittering right eye): logs each eye's submitted pose against a fresh one, the eye-to-eye relation and when each eye's image was released, also into framebridge.log in the game's storage (some games stop Android's log early). No effect on the game.

+### <a id="adapter-fade_quad"></a>Draw fades over the picture
+
+For games whose fades to black don't show, so you see the level loading (for example Batman: Arkham Shadow).
+
+- `adapter.fade_quad`
+- **Changes:** Game setting: stored in the build and on the Frame (settings.conf); can be changed without a rebuild.
+- **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
+- **Options:**
+  - Value: int, default `0`.
+  - Game settings → Picture → "Draw fades over the picture" (advanced).
+- **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
+
+> Games that fade to black by dimming their picture with a layer color scale (XR_KHR_composition_layer_color_scale_bias, for example Batman: Arkham Shadow's loading screens) can show the level loading instead of black on the Frame. FrameBridge then draws the fade itself: a black quad in front of the eyes whose opacity follows the game's dimming. 2 also removes the game's own dimming (if both show, the fade is doubled).
+
 ### <a id="adapter-flip_emul"></a>Fix upside-down menus

 Turns menus and text the right way up.
@@ -1436,7 +1540,7 @@ For games that freeze the Frame when a controller vibrates (for example Lucky's
 - **Options:**
  - Value: int, default `0`.
  - Game settings → Controllers → "Fix freezes when controllers vibrate" (advanced).
- **Catalog games (44):** AgeOfJoy, Ancient_Dungeon, Audica, BattleSisters, Caves, Clockwork, Cosmodread, cubism and 36 more.
+- **Catalog games (60):** AgeOfJoy, Ancient_Dungeon, Audica, BattleSisters, Beat Saber, Caves, Clockwork, Cosmodread and 52 more.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Routes OVRPlugin through FramePort's extension shim, which turns Meta's amplitude-envelope vibrations into plain ones: OVRPort's loader reads their nanosecond duration as seconds and allocates gigabytes, freezing the Frame when the game vibrates a controller (for example Lucky's Tale's save slots, GitHub #9). Needs a rebuild.
@@ -1614,7 +1718,7 @@ For games whose hands trail the controllers when you move them (for example Batt
 - **Options:**
  - Value: int, default `0`.
  - Game settings → Controllers → "Fix hands lagging behind controllers" (advanced).
- **Catalog games (8):** BattleSisters, Phantom: Covert Ops, Robo Recall, Star Wars: Tales from the Galaxy's Edge, Time Stall, Vader Immortal: Episode I, Vader Immortal: Episode II, Vader Immortal: Episode III.
+- **Catalog games (11):** BattleSisters, Beat Saber, Dance Central, Dungeons of Eternity, Phantom: Covert Ops, Robo Recall, Star Wars: Tales from the Galaxy's Edge, Time Stall and 3 more.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Poses a game asks for at a CLOCK_MONOTONIC time, or more than 0.5 s before the frame's display time, are located at the same moment in the runtime's time (or now). Meta's OVRPlugin passes the monotonic clock on as the OpenXR time, which on the Frame runs seconds behind the runtime's clock, so its "now" poses (Unity's physics step, controller poses) came from the past: hands trailing the controllers (for example BattleSisters, Sniper Elite VR).
@@ -1744,7 +1848,7 @@ Mixed-reality games that build their level from your room get a simple room with
 - **Options:**
  - Value: int, default `0`.
  - Game settings → Mixed reality → "Pretend room layout".
- **Catalog games (1):** Demeter.
+- **Catalog games (2):** Demeter, Vermillion.
 - **Suggested by launch-test signatures:**
  - `scene-missing` (warning): The game wants Meta's room data (scene API), which the Frame lacks.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
@@ -1854,7 +1958,7 @@ Shows videos that games play on a flat panel (for example an intro video).

 Shows Batman: Arkham Shadow's cutscenes; set by that game's recipe.

- `adapter.surface_native`
+- `adapter.surface_native` · revision 4
 - **Changes:** Game setting: stored in the build and on the Frame (settings.conf); can be changed without a rebuild.
 - **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
 - **Options:**
@@ -2073,24 +2177,27 @@ Puts settings files next to the game on the Frame, for example to turn off an un

 - `device.files` · also for 2D apps
 - **Changes:** Install only: written on the Frame when the game is installed; the APK isn't changed.
- **Suggested (on):** CryEngine: variable-rate shading isn't supported on the Frame, so user.cfg turns it off (r_variable_rate_shading = 0; for example The Climb 2).
+- **Suggested (on):** CryEngine: variable-rate shading isn't supported on the Frame, so user.cfg turns it off (… = 0; The Climb / The Climb 2).
 - **Options:** `files`: text, default none — path relative to files/ -&gt; content
 - **Catalog games (2):** SUPERHOT VR, The Climb 2.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Writes config files into the game's Android/data/&lt;package&gt;/files/ on the Frame, to turn off engine features the Frame doesn't support (for example a CryEngine user.cfg with r_variable_rate_shading = 0, as The Climb 2 needs).

-### <a id="device-foveation"></a>Eye-tracked foveation (Valve)
+### <a id="device-foveation"></a>Foveated rendering (Valve)

-Try Fixed or Off if one eye shimmers or jitters while menus look fine.
+Render less detail outside your gaze; adjust the full-resolution area or darken coarse regions to test it.

- `device.foveation`
- **Changes:** Install only: written on the Frame when the game is installed; the APK isn't changed.
+- `device.foveation` · experimental · revision 3
+- **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested:** not automatically; set on the game page (Customize), by a recipe or after a launch test.
- **Options:** `mode`: str, default empty — fixed or off (empty = Valve's default)
+- **Options:**
+  - `mode`: str, default empty — tracked, fixed or off (empty = Valve's default)
+  - `radius`: float, default `0.0`, 0–0.45 — Full-resolution radius; 0 keeps the current runtime default
+  - `test`: bool, default `False` — Darken lower-resolution regions (diagnostic)
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

-> Valve's foveation layer (VALVE_fdm_injection) lowers the image density away from where you look, following each eye's gaze. In some games one eye then shimmers or jitters while menus look fine (the right eye's gaze filter restarts often). "Fixed" keeps the foveation but stops it following the gaze (FDM_DEBUG=disable_offsets); "Off" loads none of Valve's Vulkan layers (VK_INSTANCE_LAYERS=""; costs GPU time in heavy games).
+> Reduces shading away from the full-resolution area, following each eye's gaze. Default area size keeps the runtime's current profile unchanged. Custom radius is a fraction of the shorter eye-image dimension; the transition ends at twice that radius. Larger areas retain more detail but save less GPU work. Fixed stops the area following your eyes. The optional test darkens actual coarse-shaded fragments; rebuild/reinstall to toggle it. Tested on RE4, Deadpool and Asgard's Wrath 2. The Climb 2 gets a version-guarded private bridge at 1.0 scale; Batman gets its hash-verified allocation fix (unsupported OVRPlugin versions are refused). Other games may need additional fixes; turn this off if artifacts appear.

 ### <a id="device-hide_navbar"></a>Hide Android's navigation bar

@@ -2134,7 +2241,7 @@ Lets typing reach this app from Steam's on-screen keyboard or your PC's keyboard
 - `device.text_input_window`
 - **Changes:** Install only: written on the Frame when the game is installed; the APK isn't changed.
 - **Suggested (on):** App with text fields: key presses only reach a shown Android window.
- **Catalog games (56):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Audica, Beat Saber, Beat Saber (co-existence build), Blade & Sorcery: Nomad, BodyCombat and 48 more.
+- **Catalog games (69):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Audica, Beat Saber, Beat Saber (co-existence build), Blade & Sorcery: Nomad, BodyCombat and 61 more.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Lepton runs VR apps headless: their Android window is never shown, so it never gets keyboard focus and no key press (Steam's on-screen keyboard, a USB/Bluetooth keyboard, Type on Frame) reaches the app's text fields. With Lepton's lepton-show-flatscreen marker the window is shown (behind the VR view, which keeps working) and Steam's keyboard opens for a selected text field. Steam lists the shown window as "Gamescope" (the Frame's compositor). Pairs with "Make Unity text fields work without a system keyboard".
@@ -14,11 +14,15 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | Symptom | Cause | Fix |
 |---|---|---|
 | A launch test suggests a patch (for example triage `sdl-no-clipboard` → `frame.sdl_clipboard`) but the game page doesn't show it / lists it as not applicable; or a game added long ago lacks warnings newer ones get (Android version, web wrapper, missing OBB) (GitHub #104, Dramatic Shape) | the library entry was analyzed by an older FramePort: the analysis field the patch reads (`sdl_java`, `min_sdk`, `web_wrapper`, `expects_obb`, …) is missing, so `applies()` is false | entries whose `analysis.extra.analysis_version` is below `detect.ANALYSIS_VERSION` are analyzed again at the GUI's start (background) and before a build (`pipeline.refresh_analyses`); by hand: game menu → "Analyze again", then Update on Frame. An unreadable APK is marked `analysis_failed` (retried after the next version bump). Adding an analysis field: bump `ANALYSIS_VERSION` |
-| One eye (usually the right) shimmers or jitters in the 3D view while menus and panels look steady; pacing is clean (GitHub #69, for example RTCWQuest, Moss) | Valve's eye-tracked foveation layer (`VALVE_fdm_injection`) moves its low-density regions with each eye's gaze, and the right eye's gaze filter restarts often (`CEyePoseUKF R: Large dt … Bootstrapped` in `~/.local/share/Steam/logs/eyetracking.txt`) | Customize → "Eye-tracked foveation (Valve)" (`device.foveation`): **Fixed** (`FDM_DEBUG=disable_offsets`, keeps the GPU saving) or **Off** (`VK_INSTANCE_LAYERS=""`); catalog field `foveation:` |
+| FDM layer loads but diagnostic logging reports `fdm_injection_CreateInstance: skipped` | Layer loading alone does not enable injection on the tested SteamOS 0.4.5 build; a skipped helper instance alone also does not establish game-wide inactivity | Opt-in `device.foveation` mode `tracked`: loads Valve's layer and sets `FDM_DEBUG=enable`. Batman probe reached foveated render passes with changing per-eye offsets. Validate graphics and matched gameplay GPU time; do not enable globally. Use `debug` only for brief diagnostics, preserving existing flags; never benchmark with debug spam. See FRAME_RUNTIME.md. |
+| One eye (usually the right) shimmers or jitters in the 3D view while menus and panels look steady; pacing is clean (GitHub #69, e.g. RTCWQuest, Moss) | Valve's eye-tracked foveation layer (`VALVE_fdm_injection`) moves its low-density regions with each eye's gaze, and the right eye's gaze filter restarts often (`CEyePoseUKF R: Large dt … Bootstrapped` in `~/.local/share/Steam/logs/eyetracking.txt`) | Customize → "Eye-tracked foveation (Valve)" (`device.foveation`): **Fixed** (`FDM_DEBUG=disable_offsets`; verify injection remains active on the installed runtime) or **Off** (`VK_INSTANCE_LAYERS=""`); catalog field `foveation:` |
 | A Unity OpenXR game closes right after the OpenXR instance is created: `F VrApiLoader: vrapi_SetPropertyInt was called before vrapi_Initialize()!`, SIGABRT on UnityMain (GitHub #62, Jurassic World Aftermath) | the APK still ships Meta's VrApi loader; OVRPlugin (1.89, on OpenXR) calls it without starting VrApi and Meta's loader aborts. The VrApi bridge can't replace it (39 of the loader's 114 functions: OVRPlugin wouldn't link) | `frame.vrapi_stub` (same exports, each returns 0); triage `vrapi-before-init` |
 | A VrApi game exits at once: `UnsatisfiedLinkError … dlopen failed: cannot locate symbol "vrapi_PollEvent"` (GitHub #57, BlazeRush) | the engine imports a VrApi function the VrApi bridge didn't implement | the bridge has `vrapi_PollEvent`, `RecenterPose`, `SetDisplayRefreshRate`, `GetSystemPropertyFloatArray` (rebuild the game); the static check "VrApi functions resolvable" names any other missing one; triage `vrapi-symbol-missing` |
 | A Team Beef port (Lambda1VR, RTCWQuest, …) exits at once: `UnsatisfiedLinkError: dlopen failed: library "libopenxr_loader_valve.so" not found` (GitHub #59) | TBXR loads `openxr_loader_<Build.MANUFACTURER>` (Lepton: valve) and takes the Meta path only when `strstr(OPENXR_HMD, "meta")` matches, else Pico's | `frame.tbxr_vendor` (empty `libopenxr_loader_valve.so` + the "meta" literal → "alve"). Game data (`xash/`, …) goes to /sdcard: upload it with the Files tab to the game's storage. Black eyes with `TBXR: Incomplete frame buffer object: GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE`: TBXR always uses multisampled render-to-texture (even `--msaa 1`); `frame.tbxr_vendor` links the GL shim, which hands it single-sampled versions (log `GL shim: multisampled render-to-texture … drawn single-sampled`) |
-| Logos and a loading animation, then black (no crash, frames keep coming) in a game whose OBB folder has extra `*.pak` files (GitHub #61, Star Wars: Tales from the Galaxy's Edge: seasons + Wwise banks) | the game asks Meta's platform for these asset files (`ovr_AssetFile_GetList` / `DownloadById`); OVRPort's loader doesn't know them, so the content never "arrives" | `frame.asset_files` (native/langpack lists the data's `*.pak` as installed `default` assets, IAP `free`, and answers DownloadById at once with the path; off: env FRAMEPORT_ASSET_FILES=0) |
+| Missing sound or extra content in a game whose OBB folder has separate `*.pak` files (GitHub #61, Star Wars: Tales from the Galaxy's Edge: seasons + Wwise banks) | the game asks Meta's platform for these asset files (`ovr_AssetFile_GetList` / `DownloadById`); OVRPort's loader doesn't list them | copy every content/sound-bank PAK and use `frame.asset_files` (native/langpack lists the data's `*.pak` as installed `default` assets, IAP `free`, and answers DownloadById at once with the path; off: env FRAMEPORT_ASSET_FILES=0). Tales also needs the splash and depth-size fixes below |
+| A SideQuest backup has `apk/` and a sibling `obb/` with content/sound-bank PAKs, but the Frame only has the main OBB (GitHub #61, Tales from the Galaxy's Edge) | older scans treated that layout as loose expansion files and selected only the named OBBs; the asset-file patch then found no PAKs | the scanner chooses the OBB folder by version first, then keeps the whole sibling data folder when all its expansion files are selected for this APK; app updates repair affected library entries and refresh asset/language-pack detection. Reinstall to copy the missing files, or scan the backup again first. Folders with other packages or unselected OBB versions still send only the selected OBBs |
+| Tales from the Galaxy's Edge stops during map loading (GitHub #61): game thread in `FlushRenderingCommands` / `UEngine::LoadMap`, render thread in `FSplash::RenderFrame_RenderThread` / `ovrp_WaitToBeginFrame` / SteamVR `WaitFrame` | the separate Oculus loading splash waits for an unbegun frame while map travel waits for rendering | `frame.unreal_splash_bypass`: returns from the splash renderer, with a checked symbol, size and prologue. The last image stays visible during loading; the normal renderer and menu layers continue. Headset test with the depth-size fix: gameplay, both eyes, controller input and sound work |
+| Upper part of the intro/environment is black or clipped, but a separate menu panel is intact (GitHub #61, Tales from the Galaxy's Edge) | `FSceneRenderTargets::AllocMobileMultiViewDepth` caches the initial Android window dimensions (1920x1016/1020), leaving the depth attachment shorter than the eye color texture (1728x1728); drawing is limited by the smaller attachment | `frame.unreal_multiview_depth`: refreshes both cached depth dimensions from the current scene `BufferSize` before allocation. Checks the exported symbol, function size and surrounding instructions, then replaces only the branch that skips refresh. Keeps multiview and multisampling. Headset test: full view and gameplay work |
 | `cannot locate symbol "ovrPeerConnectionState_ToString"` (or another `ovr<Enum>_ToString`) at start (BlazeRush, GitHub #57) | OVRPort's platform loader lacks several Platform SDK enum helpers | `frame.ovrstubs` now stubs them too; `*_ToString` stubs return "" (not NULL) |
 | Exits right after the OpenXR instance is created: `Failed to create XR session: -50` (`XR_ERROR_GRAPHICS_REQUIREMENTS_CALL_MISSING`, Lambda1VR) | the game skips `xrGet*GraphicsRequirementsKHR`; Meta's runtime tolerates it, SteamVR's doesn't. Lambda1VR's TBXR doesn't even enable `XR_KHR_opengl_es_enable` (only `XR_EXT_local_floor`) | FrameBridge adds `XR_KHR_opengl_es_enable` when an app enables no graphics API extension, asks for the requirements on the game's behalf and retries xrCreateSession once (logs `added XR_KHR_opengl_es_enable …`, `the app skipped …; asked for it`; every launch logs the final extension list `xrCreateInstance with N extension(s)`); triage `graphics-requirements-missing`. Verified headless: Lambda1VR runs at 72 fps |
 | Exits at start: `OVRAvatar-Loader: DisplayErrorAndExit: Failed to launch SystemActivities` after `ovrAvatar_Initialize: Failed to load AvatarSDK driver` (BlazeRush, GitHub #57) | Meta's avatar loader needs Horizon; it then tries Meta's error screen and aborts | `frame.avatar_stub` (same exports, do nothing); triage `avatar-driver-missing`. Games that ship the library but don't start avatars at launch (Lucky's Tale, BattleSisters, Arcsmith) don't need it |
@@ -31,13 +35,14 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | An overlay app (fpsVR, a wrist watch) installed on the Frame never appears, or SteamVR doesn't start it | not registered with the Frame's SteamVR, or registered with a manifest SteamVR skips: on the Frame vrserver reads only `binary_path_linux_arm` (vrserver.txt: "must specify binary_path for launch_type binary. Skipping") | `pcvr.vr_overlay` (Windows) / a Linux app with a bundled `.vrmanifest` (`is_dashboard_overlay`): agent v75 `register_vr_overlay` (check `vrcmd --overlays`, `~/.config/openvr/config/appconfig.json` manifest_paths); the app's own `--install` writes binary_path_linux only. fpsVR under Proton never loads OpenVR (quits after 60 s): unsupported for now |
 | An overlay app with **Start with SteamVR** on doesn't start by itself after the Frame or SteamVR starts (it works when started by hand) | SteamVR's own auto-launch flag (SetApplicationAutoLaunch) didn't persist on the Frame (no autolaunch entry in `~/.config/openvr/config/steamvr.vrsettings`) | agent v76: FramePort's service `frameport-vr-overlays.service` starts it at every new vrserver. Check `systemctl --user status frameport-vr-overlays`, `~/.local/share/frameport/vr-overlays.log` (`new SteamVR (vrserver N)` → `<pkg>: started` / `running` / `couldn't start it: …`), the deployment's `overlay.autostart`, and that `~/.local/share/frameport/vr-overlays.disabled` doesn't exist; `frameport frame info` (ensure_host_fixes) installs a missing service |
 | Every game suddenly fails to start: `crun: create keyring …: Disk quota exceeded`, `is not a running context` | rootless podman leaked a kernel keyring per launch; 200-key quota exhausted | `keyring = false` in `~/.config/containers/containers.conf` (FramePort agent does it), then reboot the Frame once |
+| Launch test "failed" although the game runs in the headset: frames paced, then `OVRPortVrApi: EnterVrMode: no tracked head pose before deadline`, then a crash (e.g. `zink: DEVICE LOST` + SIGSEGV in a `gdrv` thread) (GitHub #57, BlazeRush) | the VrApi bridge ends the VR session after 30 s without head tracking, which only happens without a worn headset; the game's renderer then crashes while tearing down | none needed: launch tests (`triage(..., headless=True)`) treat an exit or crash after a `headless_end` line (catalog/triage.yaml) as a pass when frames were paced before it (info finding `headless-end`); play sessions ignore it. Add new such markers to `headless_end` |
 | Launch test EXITED, launch.log has `Target app (<pkg>) did not start` and no `Start proc …:<pkg>` (GitHub #179) | Lepton occasionally doesn't start the app on the first start after an APK change; Android's `WebViewLoader-: System.exit` at boot is not the game (triage `app-not-started`) | start it again |
 | A game keeps no progress between starts although it saves (its storage gets a new `Profiles/Oculus/<id>/`-style folder per start; Walkabout Mini Golf, GitHub #182) | OVRPort's platform loader answers `ovr_GetLoggedInUserID` with a made-up id (6e18 + `random()`), new at every start; games file saves under the user id | `frame.ovr_stable_user` (default for games with the platform library): a fixed id per game and keystore. Old progress: copy the newest old profile into the new id's folder |
 | A Unity app's text field shows a caret for a moment and loses focus; no keyboard appears (for example Stremio VR login) | Unity's TMP_InputField/InputField wait for Android's on-screen keyboard and close themselves without one (Lepton has none); headless VR apps also have no focused Android window, so no key press reaches them | `frame.unity_text_input` (Cpp2IL finds `TouchScreenKeyboardShouldBeUsed`/`isKeyboardUsingEvents`, rewritten to false/true) + `device.text_input_window` (lepton-show-flatscreen: Steam's keyboard and Type on Frame work) |
 | Play gives Steam's "Game configuration unavailable"; Steam's console_log: `GameAction [AppID <id>] … RequestingLicense → UpdatingAppInfo → LaunchApp failed with AppError_9` | this Frame's Steam never loaded FramePort's shortcuts.vdf entry (it treats the id as a store app); cause unknown (GitHub #21/#30) | automatic since agent v43: Play registers the game through Steam's devkit interface ("Devkit Game: …", `devkit_register`) and starts that; uninstall removes it. Agent v58: a devkit entry Steam forgot after a restart is added again live on Play (no NOT_IN_LIBRARY → no Steam restart), and installs/art updates of devkit games only copy art (no Steam restart, GitHub #41) |
 | Steam's Exit game leaves the game running (container `lepton-steamlaunch-<appid>` still up) | Steam stopped only its `reaper`; launch.sh and Lepton (setsid) never got a signal (GitHub #36) | agent v44: launch.sh's 2 s loop ends the game when its parent is gone (`upgrade_launchers` adds it to existing launchers); by hand: `podman kill lepton-steamlaunch-<appid>` |
 | Black screen at start while audio/ExoPlayer runs; log `xrEndFrame: dropped N unusable layer(s)`, a quad layer with swapchain 0x0 (for example I Am Monkey's intro video) | The game plays video into an Android-surface swapchain (XR_KHR_android_surface_swapchain); the Frame's runtime lists the extension but returns FUNCTION_UNSUPPORTED | adapter `surface_emul` (default on): FrameBridge gives the player a SurfaceTexture-backed Surface and copies each frame into an ordinary swapchain (log `surface_emul: …`) |
-| The game quits right after start: `Something failed to initialize. Quitting!` / `We don't have write permission to …/files/cloud/data` (for example SUPERHOT) | The game created a save folder with mode 1700; inside Lepton the app writes through the folder's group | launch.sh `fix_perms` adds owner + group write to every folder in the game's storage (agent 41); reinstall to get the new launcher |
+| The game quits right after start: `Something failed to initialize. Quitting!` / `We don't have write permission to …/files/cloud/data` (for example SUPERHOT); or stays at loading with `UnauthorizedAccessException` in `StartupLoading.Start` (GitHub #239, Jurassic World Aftermath) | The game created a cloud-save folder with mode 1700; inside Lepton the app writes through the folder's group. Its startup routine can fail before the permission watchdog repairs the newly created folder | launch.sh `fix_perms` adds owner + group write to every folder in the game's storage (agent 41). Close and start the game again without uninstalling: the folders are now repaired (Aftermath confirmed in the headset). Agent 84 creates `files/cloud/data` before `fix_perms` and startup, including in upgraded launchers, to prevent the first-start race. Triage `startup-save-permission` fails the launch test despite rendering frames |
 | The whole Frame slows to a halt, then the game is killed (`Out of memory: Killed process … anon-rss:10+ GB`), for example Lucky's Tale | The game's own memory grows ~1 GB/s on Unity's `Loading.PreloadManager` thread (perf page-fault profile); not the flat window, not the text-input patches | none yet: mark unsupported; profile with `perf record -p <pid> -e page-faults --call-graph fp` (works as steamos, `perf_event_paranoid` 2) |
 | A Linux app exits at once: `cannot execute binary file: Exec format error` in launch.log | an x86_64 program started directly (installed before FramePort ran x86 builds through FEX, or by hand) | reinstall it: x86_64 Linux apps install FEX on the Frame and start through it (agent v61, `kind: linux_x86`; FEX also needs `STEAM_COMPAT_DATA_PATH`: "No compat data path?" in launch.log = an agent v60 launcher, reinstall); triage `linux-x86-no-fex`. Prefer an arm64 build when the app offers one |
 | `APP_ACTIVITY is empty`, nothing starts | Manifest has category INFO only; Lepton needs LAUNCHER | `frame.launcher` (automatic) |
@@ -54,8 +59,11 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | Unity PC VR game (Oculus + SteamVR build: `OVRPlugin.dll` and `openvr_api.dll` in `<Name>_Data/Plugins`) opens a window and quits after ~20 s; no VR Vulkan instance after the game's DXVK device in launch.log; Unity log (`unity log … Player.log`, agent v67): `OpenVR failed initialization` / `Initialization of device … failed` | Unity's built-in VR tries its SDKs in list order (Oculus first) unless `-vrmode` picks one; a catalog recipe verified with another build of the game (for example SUPERHOT VR's OpenXR build, GitHub #105) used to drop the build's own arguments | `pcvr.launch_args` = `-vrmode OpenVR` (detected for such builds; kept when the catalog's `xr` differs from the build's). A game's Electron launcher next to it (SHVR.exe) is ranked below the game |
 | Unreal PC VR game opens the crash reporter instead of closing | UE starts CrashReportClient.exe on a crash | `pcvr.no_crash_reporter` (default for Unreal Rift games): `-nocrashreports` + CrashReportClient.exe renamed `.disabled` in the Frame copy |
 | A backup's game was added without its data (library `data_dir` null, `data_bytes` 0) although the folder has .obb files | The OBBs sit in a layout the scan didn't know: `<game>/obb/<package>/`, `Android/obb/<package>/`, or SideQuest-style `<game>/apk/x.apk` + `<game>/obb/<package>/` | `sources/quest_dump.find_data_dir` finds a `<package>` folder with .obb files ≤3 levels below the APK's folder or ≤2 below its parent (skipping neighboring folders with APKs: other games); an `apk`/`apks` folder counts as part of its game folder. Add the folder again (Analyze again doesn't look for data) |
+| "Failed to correctly load the game files" at the menu; `Error loading FMOD bank "…/Android/obb/<package>/Master.bank": ERROR` (GitHub #239, Jurassic World Aftermath Collection); launch test previously passed at 72 fps | SideQuest's `<package>/<backup time>/apk/x.apk` + `obb/Master.bank` + `obb/Master.strings.bank` backup was scanned without data: these are raw sound banks, not .obb expansion files, so the sibling-folder search missed them | `quest_dump.find_data_dir` checks the parent game folder's `obb/` (or `obbs/`) when the APK is in `apk/` or `apks/`, including raw assets with or without a package subfolder. Add the backup folder again and reinstall; triage `fmod-bank-missing` fails the launch test even when the error screen renders frames. Copy the whole data folder from the same backup as the APK |
 | A game from an AXRB download starts and stops at once (Steam shows Resume), no OBB on the Frame; or a SideQuest backup adds a second game named after an APK in its `obb/` folder (reddit 2026-10-11) | AXRB keeps its own PC builds in `AXRB/patched/<package>/*-axrb.apk` (OVRPort-converted for its runtime, no OBBs); the scan added them over the original `AXRB/<app id>/<binary id>/base.apk`. SideQuest's VR4 backup has Unreal's `VR4-Android-Shipping-arm64.apk` next to the OBBs | `quest_dump._axrb_patched` skips AXRB's patched copies; a rescan replaces entries made from them; AXRB downloads send every non-APK file next to `base.apk` (DLC, assets) and are named after the package; APKs inside another game's data folder are ignored; SideQuest backups are named after the package folder, not the backup time. docs/FAQ.md has both layouts |
 | Game hangs at start / never loads although its .obb files are right there: next to the APK, in an `obb` folder beside an `apk` folder inside a `<package>` folder, or a SideQuest backup (`<timestamp>_<versionCode>.apk`) (GitHub #85, #91) | No folder named after the package, so the folder-layout checks found nothing and no OBB was uploaded | `quest_dump.find_data` then looks for the files by name, `(main\|patch).<versionCode>.<package>.obb` (any case), in the APK's folder, its parent and up to 3 levels below each (folders with their own APKs are other games); prefers the folder and files of the APK's own versionCode, else the newest older, else any version. When that folder also holds other things (the APK itself, other games' OBBs), the library entry gets `data_files` and only those files are uploaded, counted and deleted with the game. Add the folder again |
+| CryEngine game: `Powered by CRYENGINE`, then SIGTRAP in `libAndroidLauncher.so` during `CreateSystemInterface`, before any OpenXR instance (GitHub #238, The Climb 666.0) | Installed without its OBB: the SideQuest backup has `apk/com.crytek.climb.apk` + `obb/main.com.crytek.climb.obb`, but the scan required a versionCode in the OBB name and skipped it. The reported backtrace's fatal-error call formats `Engine initialization failed: Open Engine Paks: Unable to find "engine" pak files (%s)` | `quest_dump.find_data` accepts `(main\|patch).<package>.obb` as well as numbered names, keeping the original filename. Update on Frame finds the previously skipped data; a rescan finds it too. Analysis version 12 recognizes monolithic CryEngine through `assets/game.cryproject`, Vulkan through `assets/system.cfg` (`r_Driver = vk`), and an expected OBB through the launcher's expansion-path format strings; a missing OBB now gets the existing `missing-obb` warning/finding. This fixes the original missing-content startup failure; the rendering failures below were found once the data was installed |
+| The Climb 666.0: audio with no headset picture, `OVRPortVrApi: Unsupported frame flags or swap interval`; then SIGSEGV in `vulkan.freedreno.so` during `vkCmdEndRenderPass` once frames are accepted (GitHub #238) | The game submits the obsolete Quest texture-density debug flag (`0x100`), which the bridge rejected. It also binds the bridge's full-rate texture as a fragment-density attachment even though foveation support is reported off; Turnip reads density maps on the CPU, but an ordinary sampled image has no mapped backing memory | Updated `frame.vrapi_bridge` accepts the compositor debug/volume flags and creates the compatibility texture with `VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT`. Do not gate that usage on the advertised format features (the Frame reports R8G8_UNORM without the density bit). `device.files` selects `r_vr_foveated = 0` when the engine contains that cvar; The Climb 2 keeps `r_variable_rate_shading = 0`. Triage `vrapi-frame-rejected` marks rejected frames as fatal despite pacing logs. Picture confirmed on the headset. With the corrected config, an uncapped launch stayed running for over four minutes at a median 72 fps with no native crash or GPU fault. The user confirmed working menus and gameplay on 2026-10-12 |
 | Unreal game: `JNI_OnLoad` (OVRPlugin), then silence: no OpenXR instance, no crash, no frames (GitHub #85 TRIANGLE STRATEGY; launch-test finding `missing-obb`) | Installed without its OBB: the manifest says `com.epicgames.ue4.GameActivity.bHasOBBFiles` = true (UE5: `com.epicgames.unreal.…`) but the library has no data folder (`data_dir` null, `data_bytes` 0) | Put the .obb files in a `<package>` (or `obb/`) folder next to the APK, add the folder again, reinstall. Analysis `extra.expects_obb`; the game page, the install question and `frameport scan`/`install` warn; launch tests that sent no frames get the `missing-obb` finding from the library (the game logs nothing). Unity split-binary builds count too (`extra.unity_split`, `analysis/unity_split.py`): an XR-plugin build (Oculus XR Plugin / Unity OpenXR library) without `assets/bin/Data/UnitySubsystems/` in the APK, or BuildSettings listing more scenes than the APK has `levelN` files (globalgamemanagers loose or read from the head of data.unity3d); exact on the 48 Unity APKs of the dumps (13 split, 17 full games; OBBs of full builds are asset bundles or sound banks) |
 | Unreal game: launch.log ends with `ActivityTaskManager: START u0 {… cmp=<pkg>/.DownloaderActivity}` and `Displayed <pkg>/.DownloaderActivity`, then nothing: no OpenXR instance, no crash (GitHub #159 Contractors; triage `unreal-obb-check-stuck`, also when the OBB is on the Frame) | Epic's DownloaderActivity (started by GameActivity.onResume before the engine's main init) checks every OBB's name + size compiled into the APK (OBBData); with manifest meta-data `com.epicgames.ue4.GameActivity.bVerifyOBBOnStartUp=true` it then reads the whole OBB and compares each entry's CRC32 (cached in `files/cacheFile.txt` by the OBB's mtime). Its progress and error screens are invisible in Lepton (headless VR); a CRC mismatch waits for a button forever. A missing / wrong-size OBB starts Google Play's downloader (or a "No Google Play Store Key" dialog) and also waits | `frame.unreal_skip_obb_check` (suggested by analysis `unreal_verify_obb`): sets that meta-data to false (one boolean in the manifest, `axml.set_meta_data_bool`), which skips only the CRC pass. Still stuck: the OBB doesn't match the APK version (name `main.<versionCode>.<pkg>.obb` and its size) - copy APK + OBB from the same install |
 | `INSTALL_FAILED_NO_MATCHING_ABIS` | 32-bit-only APK; Frame has no AArch32 | None. PC/Rift version via Revive |
@@ -75,6 +83,8 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | SIGABRT right after start, backtrace `libopenxr_loader.so (xrCreateSwapchain+…)` | overport's dispatcher aborts on swapchains > 4096 px ("Wrong createInfo size"); video players use 7680×3840 theater textures | `frame.swapchain_limit` (default on; guard → 16384 px; triage `swapchain-size-abort`), for example 4XVR |
 | Video/menu panel missing, log `dropped N unusable layer(s)` with cylinder (1000017000) or equirect2 (1000091000) layers | the Frame runtime lacks XR_KHR_composition_layer_cylinder/equirect(2)/cube (its SteamVR runtime only composites quad + projection layers) | adapter shows cylinders as flat strips (setting `cylinder_strips`, default on); 360° equirect layers (theaters, 360° videos): `adapter.equirect_emul` (GLES only, per game) |
 | 360° theater / 360° video black or missing (for example 4XVR) | equirect layers dropped | `adapter.equirect_emul=1`: a worker thread with a shared GLES context converts each 360° image to a cube map when it changes and draws one adapter projection layer from it for every frame with exactly that frame's views; it replaces the 360° layers in place, so the game's own projection layer (balcony, controllers, 360° videos it draws itself) stays on top. Quads can't be used: the Frame draws quad layers above every projection layer whatever the order. Log: `first 360 view ready`, `in 5 s: N 360 image update(s) … M view redraw(s)`. Upside down / mirrored / behind you: `equirect_flip` 1/2/4 (`frameport settings <pkg> equirect_flip=1`, no rebuild). Never Vulkan (a Vulkan renderer hung the Frame's GPU in AC Nexus) |
+| Fades to black don't show: you see the level loading behind a loading screen (Batman: Arkham Shadow, GitHub #197); with `layer_debug=1` launch.log shows `color scale 0.00 0.00 0.00 …` on the projection layer | the game fades by dimming its eye image with XR_KHR_composition_layer_color_scale_bias; whether the Frame's runtime applies it isn't confirmed in the headset yet | `adapter.fade_quad=1` (opt-in, `native/adapter/fade_quad.c`): FrameBridge adds a black, alpha-blended quad right after the dimmed projection layer (VIEW space, 1 m ahead, 6×6 m; opacity = 1 − scale in 16 steps from one 8×8 swapchain refilled only when the step changes: Vulkan clear / GLES clear; one swapchain per step hit XR_ERROR_LIMIT_REACHED in Batman), log `fade_quad: drawing fades over the picture`; `fade_quad=2` also removes the layer's own scale (if both show, the fade is doubled) |
+| Vermillion: the hand and brush disappear over the canvas while painting, but still paint (GitHub #200) | the game shows a canvas being painted as its own compositor (quad) layer and turns the canvas's scene renderer off; the Frame draws quad layers above every projection layer whatever the order, so the canvas covers the hand (Vulkan game: no GL layer emulation) | `frame.vermillion_scene_canvas` (catalog): `PaintableMesh.HasCompositorLayerAvailable` / `ShouldUseCompositorOverlay` -> false in libil2cpp.so (Cpp2IL), so the game's own fallback draws the canvas in the scene (Klownicle's finding) |
 | Unity game hangs right after its first frames, no `pacing:` lines; SIGQUIT dump shows UnityMain in a game library's `JNI_OnLoad` → `usleep` (for example SKYBOX: `libskybox.so`, `SignatureChecker`) | the game checks its APK signing certificate; every port is re-signed | can't be fixed without defeating anti-tamper (FramePort doesn't): mark "Can't run". Diagnose hangs: `podman exec <container> kill -3 <pid>` writes all thread stacks to launch.log |
 | Video player doesn't list sent videos (for example 4XVR "Internal Storage" only shows some) | the player lists its own /sdcard folder (4XVR: /sdcard/4XPlayer), not /sdcard/Movies; Android's media index doesn't work in Lepton | game page "Add videos" / game menu "Add videos and files" (Videos + the app's own folder, hard links) or `frameport frame send <files> --app <pkg>` |
 | One eye gray in a stereo video, log `xrCreateSwapchain … result=-10` | the runtime refused a swapchain (XR_ERROR_LIMIT_REACHED) | fewer/smaller swapchains: lower `equirect_res`; unresolved |
@@ -106,6 +116,10 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | SDL / LÖVE app crashes at start: `NullPointerException … ClipboardManager.addPrimaryClipChangedListener` in `SDLClipboardHandler.<init>` (for example Dramatic Shape) | Lepton's Android has no clipboard service (`service check clipboard`: not found) | `frame.sdl_clipboard` (that call → nops in classes.dex, in place, `apk/dex.py`); reproduced and verified with LÖVE for Android 11.5 |
 | Godot 4 app crashes at start: `java.lang.NullPointerException: null cannot be cast to non-null type android.content.ClipboardManager` at `org.godotengine.godot.Godot.<init>` (Godot 4.3/4.4; 4.2 when the clipboard is first used, in `Godot$mClipboard$2.invoke`) (for example EndoparasiticVR, GitHub #134); triage `godot-no-clipboard` | Lepton's Android has no clipboard service and Godot's Kotlin code casts it with a non-null `as ClipboardManager` (`Intrinsics.checkNotNull` before the check-cast). Godot 4.1 (Java) and 4.5+ (`as?`) don't throw | `frame.godot_clipboard` (suggested by analysis `godot_clipboard`): that checkNotNull call → nops in classes.dex (check-cast accepts null), and Godot's getClipboard/hasClipboard/setClipboard return at once ("" / false / nothing; `Dex.return_early`), in place; matched exactly, other dex files untouched. Checked against the Maven godot-lib 4.2.2/4.3.0/4.4.1 and the 4.3/4.4.1 release export templates (D8 re-reads the result); not yet run on the device |
 | Game crashes at start: `java.lang.NoSuchMethodError: No virtual method getAvailableCommunicationDevices()… in class Landroid/media/AudioManager` at `com.vivox.sdk.AudioChangeListener.checkAudioRouteAndApplyChanges` (for example Green Hell VR, GitHub #101); triage `vivox-api31` | Newer Vivox (voice chat) builds call Android 12 audio-routing methods without a version check; Lepton is Android 11. Older Vivox builds (Eleven Table Tennis, BattleSisters) don't have that code | `frame.vivox_audio_route` (suggested by analysis `vivox_api31`): every AudioChangeListener method that calls one of them returns at once (`Dex.return_early`: return-void / `const/4 v0, 0; return v0`, in place); voice chat keeps the default audio route |
+| A game on a microSD card or another drive doesn't start, loses its saves or loops at start; launch.log has `ln: cannot create symbolic link from 'Frame' to '/data/data/<pkg>'` or `Couldn't create directory for SharedPreferences file /data/user/0/<pkg>/…` (GitHub #213/#214/#215/#221: a card named "Steam Frame 512g"); triage `lepton-data-link-failed` | Valve's Lepton pastes `STEAM_COMPAT_DATA_PATH` unquoted into `sh -c "ln -s …/internal/<pkg> /data/data/<pkg>"` (liblepton mounting.sh) and APK paths into unquoted substitutions, so a path with a space never gets the app's internal storage | agent v83: the Quest launcher links the game folder to `~/.local/share/frameport/lepton-paths/<pkg>` at every start and gives Lepton that path (`app_dir_lines`); `upgrade_launchers` converts existing launchers at the next connection; deployment.json keeps the real path |
+| Start never finishes, 100 % CPU, launch.log of gigabytes repeating `EOSSDK.createKeychain` / `resetKeychain` (Beyond Sandbox, GitHub #214); triage `eos-keychain-loop` | Epic Online Services' Java keychain can't write its SharedPreferences and resets/creates without end (seen when the app had no internal storage, row above) | fix the storage first; `frame.eos_keychain_loop` (opt-in, offered by triage; analysis `eos_keychain`) makes `EOSSDK.resetKeychain` return at once (`Dex.return_early`) |
+| Unity game freezes on its loading screen ~10-15 s in (Yupitergrad, GitHub #235); launch.log has `GrantPermissionsActivity: Permission grant result … permission=android.permission.BLUETOOTH_CONNECT`, then OVRPlugin `SetupDisplayObjects(): Unable to find EGLConfig for configId 0` and no more frames; triage `bhaptics-permission-prompt` | bHaptics' vest SDK (`com.bhaptics.commons.PermissionUtils.requestBluetoothPermission`) asks for Android 12's BLUETOOTH_CONNECT; on Lepton's Android 11 it can't be granted at install, so Android's permission screen takes the foreground for a moment, the game pauses/resumes and OVRPlugin's GLES compositor stops drawing | `frame.bhaptics_permission` (suggested by analysis `bhaptics_permission`): the request returns at once (`Dex.return_early`) |
+| Unity game aborts at start: `Abort message: 'cannot create thread specific key for __cxa_get_globals()'` (SIGABRT in a library such as `libFirebaseCppApp-*.so`, for example Wander 0.3570, GitHub #198); triage `pthread-keys-exhausted` | Bionic allows 128 pthread keys per process; Unity 6 takes ~40 (most without a destructor), large native libraries (Gecko `libxul.so`, Firebase, avatar SDKs) and the Frame's own libraries (Mesa/Zink, FrameBridge, OVRPort, Valve's Vulkan layers) take the rest | `frame.unity_tls_key_pool` (opt-in; suggested for Unity 6 with Firebase C++ or Gecko): libunity.so's `pthread_key_*`/`pthread_get/setspecific` imports are renamed to `fp_tkey_*` (`elf.rename_imports`, versions set global) and `libfp_tkeys.so` (`native/tlskeys`) is added to its DT_NEEDED; destructor-less keys become slots behind one real key (logs `fp_tkeys: pooling Unity's thread keys`). Approach by Klownicle (#198) |
 | Controllers do nothing (for example stuck on a setup screen); log: `xrSuggestInteractionProfileBindings … XR_ERROR_PATH_UNSUPPORTED` | the game only suggests bindings for Meta's newer profiles (Touch Plus / Touch Pro); the Frame's Android runtime knows `oculus/touch_controller`, not those | adapter `profile_remap` (default on): the bindings are suggested again for Touch (log: `controller profile … -> oculus/touch_controller`) |
 | Some buttons do nothing or the wrong thing (for example a Quest game's X/Y on the Frame's left controller) | the game binds only Quest Touch and SteamVR maps Touch onto the Frame controllers with its own remap (Touch left X/Y land on the d-pad, right X and Y repeat B), or the runtime rejected a profile or an input call | turn on adapter `input_diag` (diagnostics, off by default; `frameport settings <pkg> input_diag=1`) and look for `input_diag:` lines: `bindings: <profile> accepted` or `unsupported: interaction profile <profile> -> <result>` with the rejected paths, `bindings: /user/hand/<hand> uses <profile>`, `unsupported: function <name>`, `unsupported: xrCreateAction -> <result> (<action>)` |
 | Unity game hangs or the whole Frame restarts (for example in a menu); log: `The current MSAA level is 0, but the recommended MSAA level is 4. Switching to the recommended level.` (for example Lucky's Tale) | Meta's OVRManager (`useRecommendedMSAALevel`) turns 4x MSAA on at runtime, past QualitySettings; multisampled render-to-texture on GLES/Zink hangs the GPU | `frame.unity_runtime_msaa_off` (Cpp2IL: `OVRDisplay.get_recommendedMSAALevel` → 0) |
@@ -144,6 +158,7 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | MR game stuck waiting for room data (Demeter) | no Meta scene API | adapter `scene_emul=1` (+ `frame.meta_permissions`) |
 | Hand-tracking game janky (Silhouette) | Frame synthesizes hands from controllers | `controller_fix=0` passes hands through; not really fixable |
 | Eye distortion while moving (Arcsmith, Time Stall) | unknown (not eye swap, tracking, Valve layers, depth or pacing) | unresolved |
+| The Climb 666.0: hand outlines ripple in both eyes while menus and gameplay work (GitHub #238) | Unknown. Sessions paced around 72 fps, controller tracking reported valid, and SteamVR motion smoothing was already off; these checks do not establish the cause | Unresolved after wearer comparisons on 2026-10-12: disabling Valve's Vulkan layers, setting `r_AntialiasingMode = 1`, and setting `r_AntialiasingMode = 0` with `r_MotionBlur = 0` each gave the same or worse result. These were config comparisons; runtime cvar values were not verified. Restored the playable configuration (`r_vr_foveated = 0` with the default Vulkan layers), retaining the startup/rendering crash fixes above. Do not keep the unsuccessful experimental settings as a fix |
 | One eye gray / only effects (I Am Cat, Unity Oculus XR Plugin on GLES) | the game's multiview pass draws array slice 1 wrong on Zink | `frame.unity_multipass` (also rewrites the getter's inlined read in `OculusLoader.Initialize`; check for two `array=1` eye swapchains) |
 | View vibrates even when holding still after `frame.unity_multipass` (I Am Cat) | poses/times are consistent, but two passes on Zink make every frame one period late, and the game clamps its physics step to 10 ms | not fixed (scale 0.8 didn't help); next ideas: fix multiview instead, or the game's fixed timestep |
 | Game freezes / pauses for 0.5-2 s now and then, no flicker (for example Blade & Sorcery, Lucky's Tale) | the headset's wear sensor flickers off while worn (`logs/eyetracking.txt` `HMD off, stopping eye tracking` … `HMD on`), the Frame turns it into a focus loss and Quest games that pause on focus loss pause | adapter `focus_hold` (on by default since 2026-10-05, dips up to `focus_hold_ms` = 5000 ms are hidden; longer ones still pause) |
@@ -73,6 +73,42 @@ panoramas retain their layer rotation and have no translational parallax.

 ## Stable composition

+Adapter-owned video outputs explicitly request a static
+`XR_FOVEATION_LEVEL_NONE_FB` runtime profile before image enumeration. This
+prevents shared Valve foveation from coarsening the side-by-side video output.
+The profile applies only to those outputs; application eye swapchains retain
+foveation and gaze tracking. The runtime result is logged as
+`surface_video: full-rate runtime profile result=...`.
+
+Composition retains the original raster pipeline, linear-light blending and
+sRGB colour attachment. A compute compositor was also tested, but did not alone
+fix pixelation and added a private full-size image copy. The full-rate runtime
+profile fixed pixelation in the headset; the restored raster path was confirmed sharp and improved in-game presentation
+from roughly 40–44 to 65–71 FPS in the sampled cutscene. It still needs further
+performance work. Fully opaque video pixels skip the invisible scene texture
+sample and colour transform; partially transparent pixels retain the full blend. The next live cutscene run reported about 84 FPS across its first five post-startup samples, versus about 69 in the preceding run, with decoding steady at 60 FPS. These separate samples do not control for head motion or temperature; smooth playback is not yet fully established. The video surface patch revision marks affected
+recipes for rebuilding without forcing unrelated game updates.
+
+Once native video composition is active, the compositor can sample an sRGB view
+of the worker's shared hardware buffer directly. The renderer retains the slot
+across repeated frames; replacement queues a foreign-queue ownership handoff
+behind earlier compositor reads, and only its signalled fence makes the old slot
+reusable by the worker. Missing compatible views and initial/fallback presentation
+retain the copy path. The full-rate video profile and output resolution are
+unchanged. Deployment/performance validation is initially limited to Batman.
+The headset playback check confirmed good performance, and the live log confirms
+`direct shared-buffer sampling; cache copy skipped`. During active video,
+recorded application pacing was approximately 105–107 FPS, with decoding around
+60 FPS and visible-view GPU waits around 4.0–4.8 ms, versus roughly 6 ms in the
+preceding copy-path run. These are separate live runs, not a thermally controlled
+benchmark. The 8192x4096 decoded input and 2560x2560-per-eye output are retained;
+other games have not been redeployed or performance-tested with this change.
+
+The native GPU fixture checks stereo pixels, fades, image orientation, colour
+transforms, held frames and teardown, plus single-pixel alternating detail across
+both eyes including edges and corners. This is a compositor regression check;
+in-game playback with injection still needs visual confirmation on the headset.
+
 A separately submitted projected video layer can alternate with the main game
 projection as opaque coverage changes during head movement. That presentation
 path exhibited snap-back/doubled video in headset tests even when rendering
@@ -104,6 +140,19 @@ combined output with the exact camera that produced it; old pixels are never
 relabelled with a newer pose. Teardown retires snapshot writers and compositor
 readers. Depth/motion-vector images from another render are not attached.

+## Loading-screen blackout
+
+The native video adapter also preserves Batman's fully black loading state.
+When the first opaque projection requests zero RGB scale, unit alpha scale and
+zero bias, it omits that scene projection so the opaque runtime background stays
+black. Later loading UI layers retain their order. This avoids displaying assets
+as they stream in, without adding a GPU pass or changing the video resolution.
+Partially faded scenes, alpha-blended projections and composed video retain their
+existing paths. This fallback is limited to the native video adapter setting;
+other games do not gain it automatically. In-headset testing confirmed the black
+loading screen is restored. Revision 4 requests a rebuild of older native-video
+installs while leaving ordinary game recipes unchanged.
+
 ## Building and validation

 Rebuild FrameBridge with Android NDK r27c:
@@ -93,7 +93,7 @@ shots:
    docs: [docs/SHOWCASE.md]
    steps:
      - go: live
-      - wait_for: "What the player sees"
+      - wait_for: "Ready when you are"

  - name: install-progress
    docs: [docs/SHOWCASE.md]
@@ -62,7 +62,7 @@ scenes:
    caption: ["Connect your Steam Frame", "Once: one line on the Frame"]
    hold: 1.5
    steps:
-      - click: "Set up the Frame"
+      - click: "Set up your Frame"
      - wait: 1.6
      - click: "Start setup"
      - wait_for: "Waiting for your Frame to ask"
@@ -111,7 +111,7 @@ scenes:
      - hook: {name: pairing_done, args: [1.6]}
      - wait_for: "Ready to play"
      - wait: 1.2
-      - hover: "Quest games (Lepton)"
+      - hover: "Quest games"
      - wait: 1.6

  - name: add-games
@@ -12,11 +12,12 @@ embeds debug paths (`-g`) and the dex depends on the d8 version, so those differ
 | Dir | Artifact | What / why |
 |---|---|---|
 | `adapter/` | `{arm64-v8a,armeabi-v7a}/libopenxr_loader_generic.so` | **FrameBridge**: replaces overport's generic loader (which is renamed `libopenxr_loader_original.so`) and fixes Steam Frame runtime gaps. Hooks xrCreateInstance, swapchains, xrEndFrame, spaces, xrPollEvent, … everything else is forwarded by `gen_forwarders.py`-generated tail calls. `scene_emu.c` = Meta scene/spatial-entity emulation; `flip_vk.c` = Vulkan blit for VERTICAL_FLIP quads. `session_fixes.c` = per-game session fixes, all off by default and hooked only when on (`layer_debug` diagnostics, `stable_local`, `focus_hold`, aim correction `aim_pitch/aim_yaw/aim_forward`, `refresh_rate`, `proximity_emul` = finger proximity (XR_FB_touch_controller_proximity, which the Frame lacks) from the capacitive touch inputs: OVRPlugin's `hand_thumb_proximity`/`hand_trigger_proximity` actions get extra Touch bindings); `input_diag.c` = controller-input diagnostics (setting `input_diag`, off by default and hooked only when on; logs suggested interaction profiles and the runtime's answers, each hand's current profile, functions the runtime lacks and failing input/haptics/perf calls, each line once; tested on the host by `tests/test_input_diag.py`); `layer_emul_gl.c` = `equirect_emul` (GLES sessions only): 360° equirect/equirect2 layers become one adapter projection layer, drawn by a worker thread with its own EGL context shared with the app's: each 360° image is converted to a cube map only when it changes, and the view is redrawn only after a 4° head turn (GL/EGL resolved with dlopen, so Vulkan games never load them); `layer_math.h` = their pose/face math, tested on the host by `tests/test_layer_emul.py`. `render_model.c` = XR_FB_render_model emulation (setting `controller_models`, off by default): serves `files/framebridge/controller_{left,right}.glb`, which the agent converts on the Frame from SteamVR's own Frame controller render models (never shipped by FramePort); tested on the host by `tests/test_render_model.py`. Settings: `libframe_settings.so` in the APK + `settings.conf`/`framebridge.conf` on the Frame. |
-| `vrapi-bridge/` | `arm64-v8a/libvrapi.so` | VrApi → OpenXR bridge from [Android-XR-Bridge/OVRPort](https://github.com/Android-XR-Bridge/OVRPort) `native/vrapi` at 5e7df52 (GPL-3.0, `LICENSE.upstream`; unchanged upstream as of OVRPort v1.2.5, which ships the unpatched code as its opt-in `patch_vrapi_openxr` in experimental CLI builds), with our changes in `upstream-patches/`: GLES sessions + GL texture swapchains, cylinder→quad layers, GL vertical flip, UNORM↔sRGB format twins, 30 s VR-mode deadline, VALID-only recenter, loading-icon layers skipped, `vrapi_PollEvent`/`RecenterPose`/`SetDisplayRefreshRate`/`GetSystemPropertyFloatArray` (BlazeRush imports them, GitHub #57), diagnostics behind `-DOVP_GL_DIAG`. `upstream-patches/` reproduces these sources from the fork's `native/vrapi` (checked 2026-10-06 against its latest commit); upstream PRs Android-XR-Bridge/OVRPort#3-#8, tracked in GitHub #75. |
+| `vrapi-bridge/` | `arm64-v8a/libvrapi.so` | VrApi → OpenXR bridge from [Android-XR-Bridge/OVRPort](https://github.com/Android-XR-Bridge/OVRPort) `native/vrapi` at 5e7df52 (GPL-3.0, `LICENSE.upstream`; unchanged upstream as of OVRPort v1.2.5, which ships the unpatched code as its opt-in `patch_vrapi_openxr` in experimental CLI builds), with our changes in `upstream-patches/`: GLES sessions + GL texture swapchains, cylinder→quad layers, GL vertical flip, UNORM↔sRGB format twins, 30 s VR-mode deadline, VALID-only recenter, loading-icon layers skipped, `vrapi_PollEvent`/`RecenterPose`/`SetDisplayRefreshRate`/`GetSystemPropertyFloatArray` (BlazeRush imports them, GitHub #57), legacy compositor debug/volume frame flags accepted, full-rate Vulkan foveation images allocated as density attachments (The Climb, GitHub #238), diagnostics behind `-DOVP_GL_DIAG`. `upstream-patches/` reproduces these sources from the fork's `native/vrapi` (checked 2026-10-06 against its latest commit); upstream PRs Android-XR-Bridge/OVRPort#3-#8, tracked in GitHub #75. |
 | `platformcompat/` | `arm64-v8a/libovrplatformcompat.so` | Real `ovrMessageType_ToString` (same fork, `native/platform`). |
 | `langpack/` | `arm64-v8a/libfp_langpack.so` | Language packs for the Meta Platform SDK (patch `frame.langpacks`, opt-in). overport's platform loader is a dispatcher in front of Meta's own loader and answers `ovr_LanguagePack_GetCurrent/SetCurrent` with `return 0` (no reply ever). This library becomes the loader's first DT_NEEDED; the loader's own exports of the 31 functions it defines are made STB_LOCAL in `.dynsym` (`elf.hide_exports`, nothing moves), so symbol lookups reach the library first. It serves `<tag>.lang` files found in the game's OBB / app files (`$FRAMEPORT_LANGPACK_DIRS` overrides the search path) through `ovr_LanguagePack_*`, `ovr_AssetFile_GetList` (the loader's list + the packs) and `ovr_AssetFile_StatusById`; its own message queue is merged into `ovr_PopMessage`, and every handle that is not ours (an address-range check) goes to the loader's original function, whose address is read at run time from the loader's in-memory `.dynsym`. With patch `frame.asset_files` (marker byte `@FPASSETS@`, or env `FRAMEPORT_ASSET_FILES=1`) it also lists the data's `*.pak` content files as installed `default` asset files and answers `ovr_AssetFile_DownloadById` for them at once (a completed `DownloadUpdate`, then the result with the path). Host-tested against a stand-in loader (`tests/test_langpack.py`, plain `cc`, no NDK); the bionic/headset side is unverified. |
 | `glshim/` | `arm64-v8a/libglshim.so` | Mesa GLSL compatibility for GLAD engines (hooks eglGetProcAddress): comments out `#pragma` before `#extension`, enables `GL_EXT_shader_implicit_conversions`, hides GL_OVR_multiview (`gl_hide_multiview`, default 1) and logs failed shaders. `-DGLSHIM_TRACE` adds per-FBO draw/error tracing. |
 | `glmv/` | `arm64-v8a/libfpglmv.so` | Single-view draws of OVR_multiview programs (patch `frame.gl_multiview_fbo`, opt-in, GitHub #77). Mesa enforces OVR_multiview's rule that a draw's program declares as many views as the draw framebuffer has; engines that compile every shader with `num_views=2` and also draw into ordinary 2D framebuffers (Doom3Quest's HUD/PDA pool) lose those draws. The engine library gets it as first DT_NEEDED (direct `gl*` imports) and its `dlopen("libGLESv3.so")` string is rewritten to `libfpglmv.so` (same length; its `qgl*` dlsym table); linked `--no-as-needed` to libGLESv3 so dlsym on its handle finds everything it doesn't wrap. It records stage sources at glLinkProgram, caches the draw framebuffer's color-attachment view count per bind, and when a multiview program draws into a 0-view framebuffer it binds a lazily built twin (`glmv_rewrite.h`: num_views layout blanked, `gl_ViewID_OVR` -> `(0u)`; attribute locations + uniform block bindings copied, default-block uniforms copied before every such draw with a shadow to skip unchanged ones), draws, rebinds the original. Logcat tag `GLMV`; `gl_mv_debug=1`. The rewriter is host-tested on Doom3Quest's 19 shaders (`tests/test_gl_multiview_fbo.py`); untested on the device. |
+| `tlskeys/` | `arm64-v8a/libfp_tkeys.so` | Thread-key pool for Unity (patch `frame.unity_tls_key_pool`, opt-in, GitHub #198; approach and the first helper by Klownicle). Bionic allows 128 pthread keys per process; Unity 6 plus large native libraries (Firebase, Gecko) and the Frame's own libraries use them up (Wander: `cannot create thread specific key for __cxa_get_globals()`). libunity.so's four key imports are renamed to `fp_tkey_create/_delete/_get/_set` (`elf.rename_imports`, same `.dynstr` bytes, versions set global) and this library is added to its DT_NEEDED: keys without a destructor become slots (512, generation-tagged, `0x40000000 + slot`) in a per-thread table under one real key; keys with a destructor and all other libraries keep real keys. Lock-free get/set. Logs `fp_tkeys: pooling Unity's thread keys` once (tag FrameBridge). Host-tested (rename); not yet run on the device. |
 | `zinkfix/` | `arm64-v8a/libVkLayer_fp_shaderfix.so` | Shader-fix Vulkan layer `VK_LAYER_FP_shader_fix` for OpenGL ES games (patch `frame.zink_shader_fix`): sits between Zink (Mesa's GL on Vulkan) and the driver and inserts the words of `zink_shader_fix` (same format as the Vulkan shim's `vk_shader_fix`: size + SHA-256 match) into SPIR-V modules; `zink_shader_dump=1` writes every distinct module to `files/fp_spirv/`. The engine library loads it first (DT_NEEDED); its constructor puts the layer in front of Android's GraphicsEnv debug layer list (private Android 11 `getDebugLayers`/`setDebugLayers`, found through libvulkan.so's dependencies) before EGL starts, so the loader picks it up from the app's lib dir. Exports only the enumeration functions and `VK_LAYER_FP_shader_fixGet*ProcAddr` (never plain `vk*` entry points). Vader Immortal's lightspeed shaders (Klownicle, GitHub #49). |
 | `xrlayer/` | `linux-arm64/libxr_frameport_timefix.so` + `XR_APILAYER_FRAMEPORT_timefix.json` | OpenXR API layer for Windows PC VR games under Proton on the Frame (glibc aarch64, built freestanding with the NDK's clang), on by default (patch `pcvr.xr_timefix`). Retries `xrCreateInstance` as an OpenXR 1.0 app when the runtime rejects 1.1 (the Frame's SteamVR runtime does, and Proton 11's VR helper asks for 1.1). Also emulates `xrConvertTimespecTimeToTimeKHR`/`xrConvertTimeToTimespecTimeKHR` if the runtime refuses them (the Frame's Android runtime does; its Linux runtime, used by Proton, supports them as of 2026-09-29 — so this part is only a fallback; Proton's wineopenxr needs them for `XR_KHR_win32_convert_performance_counter_time`, which Revive requires) with the adapter's xrWaitFrame-calibrated offset, and drops the extension from xrCreateInstance if the runtime rejects it. Enabled per game by the Proton launch.sh (`XR_API_LAYER_PATH`, `XR_ENABLE_API_LAYERS`). `tests/test_xrlayer.py` builds it for x86_64 and drives it via ctypes. |
 | `oculushmd/` | `win-x64/fp_oculushmd.exe` | PC VR counterpart of overport's `patch_oculus_unreal` (patch `pcvr.oculus_unreal`, default for Unreal Rift games on the Frame). Unreal's OculusHMD and LibOVR's `ovr_Detect` only start when the Windows named event `OculusHMDConnected` exists and is signalled (the Oculus service creates it). `fp_oculushmd.exe <command line>` creates it (manual reset, signalled), runs the command (Revive's injector) in a job object and keeps the event until every process in the job — the game and its children — has exited (fallback without job support: 3 minutes); returns the command's exit code and logs `FramePort oculushmd: …` to stderr (launch.log). Freestanding Windows x64 console exe (no CRT, no Windows SDK): the NDK's clang + `lld-link /Brepro` with a kernel32 import library generated by `llvm-dlltool`, so it's byte-reproducible. Tested on Windows from WSL with a build whose event name is `-DEVENT_NAME=L"…"` (the Oculus service owns the real event on a PC with the Oculus app). |
@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// fade_quad.c: how dark the fade quad is for a layer's colour scale (host-tested: tests/fixtures/src/fade_level_test.c).
+#pragma once
+
+#define FADE_LEVELS 16
+
+// 0 = no fade (the picture is shown as it is), else 1..FADE_LEVELS = black at level / FADE_LEVELS opacity. The fade's
+// opacity is 1 - the average of the red, green and blue scale (games fade all three alike); 0.99 and above count as
+// "not dimmed", so a rounding scale never leaves a faint veil.
+static inline int fade_level_of(float r, float g, float b) {
+    float scale = (r + g + b) / 3.0f;
+    if (!(scale < 0.99f)) return 0;  // also NaN
+    if (scale < 0.0f) scale = 0.0f;
+    int level = (int)((1.0f - scale) * FADE_LEVELS + 0.5f);
+    return level > FADE_LEVELS ? FADE_LEVELS : level;
+}
@@ -0,0 +1,199 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Included by frame_adapter.c. fade_quad (per game, off by default; GitHub #197): games that fade to black by dimming
+// their eye image with XR_KHR_composition_layer_color_scale_bias (Batman: Arkham Shadow's loading screens: scale 0 ...
+// 1 on its projection layer) showed the level loading on the Frame instead of black. With the setting, FrameBridge
+// draws the fade itself: a black, alpha-blended quad layer right in front of the eyes (VIEW space, 1 m ahead, far
+// larger than the field of view), whose opacity is 1 - the layer's colour scale. The Frame draws quad layers above all
+// projection layers, which is what a fade needs; it is inserted right after the dimmed projection layer, so the game's
+// own quads (loading icons, subtitles) stay on top of it.
+//  * No drawing per frame: one tiny swapchain, refilled only when the fade level changes (at most FADE_LEVELS small
+//    clears per fade: Vulkan vkCmdClearColorImage on the app's queue through flip_vk.c's command buffer; GLES glClear
+//    through a temporary framebuffer in the app's current context). A swapchain's last released image stays valid
+//    for every later frame. (One swapchain per level hit XR_ERROR_LIMIT_REACHED in Batman: the Frame's runtime
+//    allows only a few swapchains per app.)
+//  * Set up on the first frame that needs it; any failure turns the fade off for the session (logged once).
+//  * fade_quad=2 also removes the layer's own colour scale (as strip_color_bias=1), for runtimes that do apply it
+//    (the fade would then be doubled).
+
+#include "fade_level.h"
+#define FADE_GLES_BINDING ((XrStructureType)1000024001)  // XR_TYPE_GRAPHICS_BINDING_OPENGL_ES_ANDROID_KHR
+#define FADE_GLES_IMAGE ((XrStructureType)1000024002)    // XR_TYPE_SWAPCHAIN_IMAGE_OPENGL_ES_KHR
+
+static struct {
+    XrSession session;
+    int state;  // 0 = not set up, 1 = ready, -1 = failed this session
+    int gles;   // the session's graphics API, from its binding
+    XrSpace view;
+    XrSwapchain swapchain;
+    uint32_t size, image_count;
+    XrSwapchainImageVulkanKHR vk_images[8];
+    emul_gles_image gl_images[8];
+    int shown;  // the level the last released image shows (0 = none yet)
+} fade;
+
+// GLES entry points for the one-time fill (resolved at run time like layer_emul_gl.c's: Vulkan games never load GL)
+#define FADE_GL_FUNCS(X) X(glGenFramebuffers) X(glDeleteFramebuffers) X(glBindFramebuffer) X(glFramebufferTexture2D) \
+    X(glCheckFramebufferStatus) X(glClearColor) X(glClear) X(glGetIntegerv) X(glGetFloatv) X(glGetBooleanv) \
+    X(glIsEnabled) X(glDisable) X(glEnable) X(glColorMask) X(glFinish)
+#define FADE_DECLARE(fn) static __typeof__(&fn) fade_##fn;
+FADE_GL_FUNCS(FADE_DECLARE)
+#undef FADE_DECLARE
+static __typeof__(&eglGetCurrentContext) fade_eglGetCurrentContext;
+
+static int fade_load_gl(void) {
+    void *egl = dlopen("libEGL.so", RTLD_NOW | RTLD_LOCAL), *gles = dlopen("libGLESv3.so", RTLD_NOW | RTLD_LOCAL);
+    if (!egl || !gles) return 0;
+    int ok = (fade_eglGetCurrentContext = (__typeof__(fade_eglGetCurrentContext))dlsym(egl, "eglGetCurrentContext")) != NULL;
+#define FADE_RESOLVE(fn) ok &= (fade_##fn = (__typeof__(fade_##fn))dlsym(gles, #fn)) != NULL;
+    FADE_GL_FUNCS(FADE_RESOLVE)
+#undef FADE_RESOLVE
+    return ok;
+}
+
+static void fade_on_create_session(XrSession session, const XrSessionCreateInfo *info) {
+    memset(&fade, 0, sizeof(fade));  // a new session owns new swapchains (the old ones went with its session)
+    fade.session = session;
+    for (const XrBaseInStructure *p = info ? (const XrBaseInStructure *)info->next : NULL; p; p = p->next)
+        if (p->type == FADE_GLES_BINDING) fade.gles = 1;
+}
+
+// Clear one swapchain image to black at `alpha`.
+static int fade_fill_vulkan(VkImage image, float alpha) {
+    if (!vk_ready() || !vk.CmdClearColorImage) return 0;
+    VkCommandBufferBeginInfo begin = {VK_STRUCTURE_TYPE_COMMAND_BUFFER_BEGIN_INFO, NULL,
+                                      VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT, NULL};
+    VkImageSubresourceRange range = {VK_IMAGE_ASPECT_COLOR_BIT, 0, 1, 0, 1};
+    VkClearColorValue black = {.float32 = {0.0f, 0.0f, 0.0f, alpha}};
+    vk.ResetCommandBuffer(vk.cmd, 0);
+    vk.BeginCommandBuffer(vk.cmd, &begin);
+    barrier(image, 0, VK_IMAGE_LAYOUT_UNDEFINED, VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL, 0, VK_ACCESS_TRANSFER_WRITE_BIT);
+    vk.CmdClearColorImage(vk.cmd, image, VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL, &black, 1, &range);
+    barrier(image, 0, VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL, VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL,
+            VK_ACCESS_TRANSFER_WRITE_BIT, VK_ACCESS_COLOR_ATTACHMENT_WRITE_BIT);
+    vk.EndCommandBuffer(vk.cmd);
+    VkSubmitInfo submit = {VK_STRUCTURE_TYPE_SUBMIT_INFO, NULL, 0, NULL, NULL, 1, &vk.cmd, 0, NULL};
+    int ok = vk.QueueSubmit(vk.queue, 1, &submit, vk.fence) == VK_SUCCESS &&
+             vk.WaitForFences(vk.device, 1, &vk.fence, VK_TRUE, 100000000ull) == VK_SUCCESS;
+    vk.ResetFences(vk.device, 1, &vk.fence);
+    return ok;
+}
+
+static int fade_fill_gles(GLuint texture, float alpha) {
+    if (!fade_load_gl() || !fade_eglGetCurrentContext()) return 0;  // xrEndFrame runs with the app's context current
+    GLint old_fbo = 0;
+    GLfloat old_clear[4];
+    GLboolean old_mask[4], scissor = fade_glIsEnabled(GL_SCISSOR_TEST);
+    fade_glGetIntegerv(GL_DRAW_FRAMEBUFFER_BINDING, &old_fbo);
+    fade_glGetFloatv(GL_COLOR_CLEAR_VALUE, old_clear);
+    fade_glGetBooleanv(GL_COLOR_WRITEMASK, old_mask);
+    GLuint fbo = 0;
+    fade_glGenFramebuffers(1, &fbo);
+    fade_glBindFramebuffer(GL_DRAW_FRAMEBUFFER, fbo);
+    fade_glDisable(GL_SCISSOR_TEST);
+    fade_glColorMask(GL_TRUE, GL_TRUE, GL_TRUE, GL_TRUE);
+    fade_glFramebufferTexture2D(GL_DRAW_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, texture, 0);
+    int ok = fade_glCheckFramebufferStatus(GL_DRAW_FRAMEBUFFER) == GL_FRAMEBUFFER_COMPLETE;
+    fade_glClearColor(0.0f, 0.0f, 0.0f, alpha);
+    if (ok) fade_glClear(GL_COLOR_BUFFER_BIT);
+    fade_glFinish();  // done before the image is released to the runtime
+    fade_glBindFramebuffer(GL_DRAW_FRAMEBUFFER, (GLuint)old_fbo);
+    fade_glDeleteFramebuffers(1, &fbo);
+    fade_glClearColor(old_clear[0], old_clear[1], old_clear[2], old_clear[3]);
+    fade_glColorMask(old_mask[0], old_mask[1], old_mask[2], old_mask[3]);
+    if (scissor) fade_glEnable(GL_SCISSOR_TEST);
+    return ok;
+}
+
+static int fade_setup(XrSession session) {
+    PFN_xrCreateReferenceSpace space = (PFN_xrCreateReferenceSpace)lookup(active_instance, "xrCreateReferenceSpace");
+    PFN_xrCreateSwapchain create = (PFN_xrCreateSwapchain)lookup(active_instance, "xrCreateSwapchain");
+    PFN_xrEnumerateSwapchainImages enumerate =
+        (PFN_xrEnumerateSwapchainImages)lookup(active_instance, "xrEnumerateSwapchainImages");
+    if (!space || !create || !enumerate) return 0;
+    XrReferenceSpaceCreateInfo sci = {XR_TYPE_REFERENCE_SPACE_CREATE_INFO, NULL, XR_REFERENCE_SPACE_TYPE_VIEW,
+                                      {{0, 0, 0, 1}, {0, 0, 0}}};
+    if (XR_FAILED(space(session, &sci, &fade.view))) return 0;
+    static const uint32_t sizes[] = {8, 64, 256};  // in case the runtime refuses tiny images
+    XrResult r = XR_ERROR_RUNTIME_FAILURE;
+    for (size_t i = 0; i < sizeof(sizes) / sizeof(sizes[0]); ++i) {
+        XrSwapchainCreateInfo ci = {XR_TYPE_SWAPCHAIN_CREATE_INFO, NULL, 0,
+                                    XR_SWAPCHAIN_USAGE_COLOR_ATTACHMENT_BIT | XR_SWAPCHAIN_USAGE_TRANSFER_DST_BIT,
+                                    fade.gles ? 0x8C43 /* GL_SRGB8_ALPHA8 */ : 43 /* VK_FORMAT_R8G8B8A8_SRGB */,
+                                    1, sizes[i], sizes[i], 1, 1, 1};
+        r = create(session, &ci, &fade.swapchain);
+        LOG("fade_quad: xrCreateSwapchain %ux%u format=%lld result=%d", sizes[i], sizes[i], (long long)ci.format, r);
+        if (XR_SUCCEEDED(r)) { fade.size = sizes[i]; break; }
+    }
+    if (XR_FAILED(r)) { fade.swapchain = XR_NULL_HANDLE; return 0; }
+    for (int i = 0; i < 8; ++i) {
+        fade.vk_images[i] = (XrSwapchainImageVulkanKHR){XR_TYPE_SWAPCHAIN_IMAGE_VULKAN_KHR, NULL, VK_NULL_HANDLE};
+        fade.gl_images[i] = (emul_gles_image){FADE_GLES_IMAGE, NULL, 0};
+    }
+    r = enumerate(fade.swapchain, 8, &fade.image_count, fade.gles ? (XrSwapchainImageBaseHeader *)fade.gl_images
+                                                                    : (XrSwapchainImageBaseHeader *)fade.vk_images);
+    if (XR_FAILED(r) || !fade.image_count) { LOG("fade_quad: xrEnumerateSwapchainImages failed %d", r); return 0; }
+    return 1;
+}
+
+// Show `level` in the fade swapchain (a new image only when it changes).
+static int fade_show(int level) {
+    if (level == fade.shown) return 1;
+    PFN_xrAcquireSwapchainImage acquire = (PFN_xrAcquireSwapchainImage)lookup(active_instance, "xrAcquireSwapchainImage");
+    PFN_xrWaitSwapchainImage wait = (PFN_xrWaitSwapchainImage)lookup(active_instance, "xrWaitSwapchainImage");
+    PFN_xrReleaseSwapchainImage release = (PFN_xrReleaseSwapchainImage)lookup(active_instance, "xrReleaseSwapchainImage");
+    XrSwapchainImageAcquireInfo ai = {XR_TYPE_SWAPCHAIN_IMAGE_ACQUIRE_INFO, NULL};
+    XrSwapchainImageWaitInfo wi = {XR_TYPE_SWAPCHAIN_IMAGE_WAIT_INFO, NULL, 100000000};
+    XrSwapchainImageReleaseInfo ri = {XR_TYPE_SWAPCHAIN_IMAGE_RELEASE_INFO, NULL};
+    uint32_t index = 0;
+    if (!acquire || !wait || !release || XR_FAILED(acquire(fade.swapchain, &ai, &index)) || index >= fade.image_count)
+        return 0;
+    if (XR_FAILED(wait(fade.swapchain, &wi))) { release(fade.swapchain, &ri); return 0; }
+    float alpha = (float)level / FADE_LEVELS;
+    int ok = fade.gles ? fade_fill_gles(fade.gl_images[index].image, alpha)
+                       : fade_fill_vulkan(fade.vk_images[index].image, alpha);
+    release(fade.swapchain, &ri);
+    if (ok) fade.shown = level;
+    return ok;
+}
+
+// The fade level of a projection layer: 0 = none, else 1..FADE_LEVELS (black at level / FADE_LEVELS).
+static int fade_level(const XrCompositionLayerBaseHeader *layer) {
+    if (!layer || layer->type != XR_TYPE_COMPOSITION_LAYER_PROJECTION) return 0;
+    for (const XrBaseInStructure *n = (const XrBaseInStructure *)layer->next; n; n = n->next)
+        if (n->type == XR_TYPE_COMPOSITION_LAYER_COLOR_SCALE_BIAS_KHR) {
+            const XrCompositionLayerColorScaleBiasKHR *cb = (const XrCompositionLayerColorScaleBiasKHR *)n;
+            return fade_level_of(cb->colorScale.r, cb->colorScale.g, cb->colorScale.b);
+        }
+    return 0;
+}
+
+// The quad that shows `level` (filled into *out), or NULL when there is nothing to draw or the fade isn't available.
+static const XrCompositionLayerBaseHeader *fade_layer(XrSession session, int level, uint32_t layers_so_far,
+                                                      XrCompositionLayerQuad *out) {
+    if (!fade_quad || level <= 0) return NULL;
+    if (session != fade.session) { fade.session = session; fade.state = 0; }
+    if (!fade.state) {
+        fade.state = fade_setup(session) ? 1 : -1;
+        LOG("fade_quad: %s (%s, %d levels)", fade.state > 0 ? "drawing fades over the picture" : "unavailable",
+            fade.gles ? "GLES" : "Vulkan", FADE_LEVELS);
+    }
+    if (fade.state < 0) return NULL;
+    if (!fade_show(level)) {
+        fade.state = -1;
+        LOG("fade_quad: filling the fade image failed (%s); off for this session", fade.gles ? "GLES" : "Vulkan");
+        return NULL;
+    }
+    if (layers_so_far + 1 > runtime_max_layers) {
+        static int logged;
+        if (!logged++) LOG("fade_quad: no room for the fade layer (%u layers)", layers_so_far);
+        return NULL;
+    }
+    *out = (XrCompositionLayerQuad){XR_TYPE_COMPOSITION_LAYER_QUAD, NULL, XR_COMPOSITION_LAYER_BLEND_TEXTURE_SOURCE_ALPHA_BIT,
+                                    fade.view, XR_EYE_VISIBILITY_BOTH,
+                                    {fade.swapchain, {{0, 0}, {(int32_t)fade.size, (int32_t)fade.size}}, 0},
+                                    {{0, 0, 0, 1}, {0, 0, -1.0f}}, {6.0f, 6.0f}};
+    static int last = -1;
+    if (layer_debug && level != last) LOG("fade_quad: level %d/%d", level, FADE_LEVELS);
+    last = level;
+    return (const XrCompositionLayerBaseHeader *)out;
+}
@@ -35,6 +35,7 @@ static struct {
    PFN_vkResetCommandBuffer ResetCommandBuffer;
    PFN_vkCmdPipelineBarrier CmdPipelineBarrier;
    PFN_vkCmdBlitImage CmdBlitImage;
+    PFN_vkCmdClearColorImage CmdClearColorImage;  // fade_quad.c
    PFN_vkQueueSubmit QueueSubmit;
    PFN_vkCreateFence CreateFence;
    PFN_vkWaitForFences WaitForFences;
@@ -135,7 +136,7 @@ static int vk_ready(void) {
    if (!vk.GetDeviceProcAddr) return 0;
 #define DEV(name) vk.name = (PFN_vk##name)vk.GetDeviceProcAddr(vk.device, "vk" #name); if (!vk.name) return 0;
    DEV(GetDeviceQueue) DEV(CreateCommandPool) DEV(AllocateCommandBuffers) DEV(BeginCommandBuffer)
-    DEV(EndCommandBuffer) DEV(ResetCommandBuffer) DEV(CmdPipelineBarrier) DEV(CmdBlitImage) DEV(QueueSubmit)
+    DEV(EndCommandBuffer) DEV(ResetCommandBuffer) DEV(CmdPipelineBarrier) DEV(CmdBlitImage) DEV(CmdClearColorImage) DEV(QueueSubmit)
    DEV(CreateFence) DEV(WaitForFences) DEV(ResetFences)
 #undef DEV
    vk.GetDeviceQueue(vk.device, vk.family, vk.index, &vk.queue);
@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Copy the known prefix instead of writing into application-owned const chains.
+// The META node must reach the runtime without SUBSAMPLED before shared allocation.
+typedef struct FbVulkanSwapchainCreateInfo {
+    XrStructureType type;
+    const void *next;
+    uint32_t additionalCreateFlags;
+    uint32_t additionalUsageFlags;
+} FbVulkanSwapchainCreateInfo;
+
+typedef union FbStorageNode {
+    XrBaseInStructure base;
+    FbVulkanSwapchainCreateInfo vk;
+    XrSwapchainCreateInfoFoveationFB foveation;
+} FbStorageNode;
+
+// Returns 1 when changed, 0 when unnecessary, -1 for an unsupported prefix.
+static int fb_foveation_storage(XrSwapchainCreateInfo *info, FbStorageNode nodes[16]) {
+    const XrBaseInStructure *p = info->next;
+    unsigned n = 0;
+    while (p && n < 16) {
+        if (p->type == XR_TYPE_VULKAN_SWAPCHAIN_CREATE_INFO_META) {
+            const FbVulkanSwapchainCreateInfo *vk = (const void *)p;
+            if (!(vk->additionalCreateFlags & 0x4000u)) return 0;
+            nodes[n].vk = *vk;
+            nodes[n].vk.additionalCreateFlags &= ~0x4000u; // VK_IMAGE_CREATE_SUBSAMPLED_BIT_EXT
+            for (unsigned i = 0; i < n; ++i) nodes[i].base.next = &nodes[i + 1].base;
+            info->next = &nodes[0];
+            return 1;
+        }
+        if (p->type != XR_TYPE_SWAPCHAIN_CREATE_INFO_FOVEATION_FB) return -1;
+        nodes[n++].foveation = *(const XrSwapchainCreateInfoFoveationFB *)p;
+        p = p->next;
+    }
+    return p ? -1 : 0;
+}
@@ -91,10 +91,17 @@ static void surf_on_destroy(XrSwapchain handle);

 static float scale = 1.0f;
 static int foveation_fix = 1;
+static int foveation_storage_fix; // opt-in ordinary shared storage for native Vulkan foveation
+static int foveation_eye; // experimental profile upgrade; does not inject Vulkan gaze offsets
+static int foveation_eye_enabled, foveation_eye_supported;
+#include "foveation_storage.h"
 // hide XR_FB_space_warp: games then render every frame themselves (UE5 Application SpaceWarp flickered on the Frame,
 // e.g. Into The Radius 2; OVRPort's patch_disable_space_warp doesn't reach UE5's OpenXR plugin)
 static int hide_space_warp = 0;
 static int strip_color_bias = 0;
+// fade_quad.c: draw colour-scale fades (fade to black) as a black quad over the picture; 2 = also remove the scale
+static int fade_quad = 0;
+static uint32_t runtime_max_layers = 16;  // XrSystemGraphicsProperties::maxLayerCount (the Frame: 16)
 static int snapshot = 0;  // seconds between eye-image snapshots (snapshot_gl.c; 0 = off)
 static char snap_dir[256];
 static void snap_on_create(XrSwapchain handle, const XrSwapchainCreateInfo *info);
@@ -162,8 +169,11 @@ static void read_settings(const char *path) {
    while (fgets(line, sizeof(line), f)) {
        if (sscanf(line, "scale=%f", &value) == 1 && value >= 0.5f && value <= 2.0f) scale = value;
        if (sscanf(line, "foveation_fix=%f", &value) == 1) foveation_fix = value != 0;
+        if (sscanf(line, "foveation_storage_fix=%f", &value) == 1) foveation_storage_fix = value != 0;
+        if (sscanf(line, "foveation_eye=%f", &value) == 1) foveation_eye = value != 0;
        if (sscanf(line, "hide_space_warp=%f", &value) == 1) hide_space_warp = value != 0;
        if (sscanf(line, "strip_color_bias=%f", &value) == 1) strip_color_bias = (int)value;
+        if (sscanf(line, "fade_quad=%f", &value) == 1) fade_quad = value > 0 ? (int)value : 0;
        if (sscanf(line, "frame_balance=%f", &value) == 1) frame_balance = value != 0;
        if (sscanf(line, "snapshot=%f", &value) == 1) snapshot = value > 0 ? (int)value : 0;
        if (sscanf(line, "controller_fix=%f", &value) == 1) controller_fix = value != 0;
@@ -259,6 +269,8 @@ static void initialize(void) {
                            proximity_emul > 1 ? "thumb + index" : "thumb");
    if (hide_space_warp) LOG("per-game: hide_space_warp=1 (XR_FB_space_warp hidden, space warp info removed)");
    if (strip_color_bias) LOG("per-game: strip_color_bias=%d (layer color scale/bias removed)", strip_color_bias);
+    if (fade_quad) LOG("per-game: fade_quad=%d (colour-scale fades drawn as a black quad%s)", fade_quad,
+                       fade_quad > 1 ? "; the layer's own scale removed" : "");
    if (frame_balance) LOG("per-game: frame_balance=1 (an open frame is ended before the next one begins)");
    if (eye_debug || release_wait) LOG("per-game: eye_debug=%d release_wait=%d log_file=%s", eye_debug, release_wait,
                                       log_file ? path : "none");
@@ -317,7 +329,7 @@ XRAPI_ATTR XrResult XRAPI_CALL xrCreateInstance(const XrInstanceCreateInfo *info
    }

    XrInstanceCreateInfo fixed = *info;
-    const char **names = calloc(info->enabledExtensionCount + 3, sizeof(*names));
+    const char **names = calloc(info->enabledExtensionCount + 7, sizeof(*names));
    if (!names) { free(available); return XR_ERROR_OUT_OF_MEMORY; }
    uint32_t kept = 0;
    for (uint32_t i = 0; i < info->enabledExtensionCount; ++i) {
@@ -364,6 +376,34 @@ XRAPI_ATTR XrResult XRAPI_CALL xrCreateInstance(const XrInstanceCreateInfo *info
        for (uint32_t j = 0; available && j < available_count; ++j) offered |= !strcmp(available[j].extensionName, "XR_FB_display_refresh_rate");
        if (!requested && offered) { names[kept++] = "XR_FB_display_refresh_rate"; LOG("added XR_FB_display_refresh_rate (refresh_rate)"); }
    }
+    foveation_eye_enabled = 0;
+    if (foveation_eye && !foveation_fix) {
+        int fb = 0, config = 0, offered = 0;
+        for (uint32_t i = 0; i < kept; ++i) {
+            fb |= !strcmp(names[i], "XR_FB_foveation");
+            config |= !strcmp(names[i], "XR_FB_foveation_configuration");
+            foveation_eye_enabled |= !strcmp(names[i], "XR_META_foveation_eye_tracked");
+        }
+        for (uint32_t i = 0; available && i < available_count; ++i)
+            offered |= !strcmp(available[i].extensionName, "XR_META_foveation_eye_tracked");
+        if (!foveation_eye_enabled && fb && config && offered) {
+            names[kept++] = "XR_META_foveation_eye_tracked";
+            foveation_eye_enabled = 1;
+        }
+    }
+    // Adapter-owned video outputs need an explicit full-rate profile even when
+    // the shared injection layer enables foveation for application swapchains.
+    if (surface_emul) {
+        const char *video_extensions[] = {"XR_FB_foveation", "XR_FB_foveation_configuration",
+            "XR_FB_swapchain_update_state"};
+        for (unsigned e = 0; e < 3; ++e) {
+            int requested = 0, offered = 0;
+            for (uint32_t i = 0; i < kept; ++i) requested |= !strcmp(names[i], video_extensions[e]);
+            for (uint32_t i = 0; available && i < available_count; ++i)
+                offered |= !strcmp(available[i].extensionName, video_extensions[e]);
+            if (offered && !requested) names[kept++] = video_extensions[e];
+        }
+    }
    fixed.enabledExtensionNames = names;
    fixed.enabledExtensionCount = kept;
    {   // what the runtime gets (diagnostics: e.g. a graphics extension the app forgot)
@@ -535,12 +575,55 @@ static int known_swapchain(XrSwapchain handle) {
    return found;
 }

+XRAPI_ATTR XrResult XRAPI_CALL xrCreateFoveationProfileFB(XrSession session,
+        const XrFoveationProfileCreateInfoFB *info, XrFoveationProfileFB *profile) {
+    PFN_xrCreateFoveationProfileFB fn = (PFN_xrCreateFoveationProfileFB)lookup(active_instance, "xrCreateFoveationProfileFB");
+    if (!fn) return XR_ERROR_FUNCTION_UNSUPPORTED;
+    if (!info) return XR_ERROR_VALIDATION_FAILURE;
+    const XrBaseInStructure *p = info->next;
+    if (foveation_storage_fix || foveation_eye) LOG("foveation profile create: next_type=%d", p ? p->type : 0);
+    if (!p || p->type == XR_TYPE_FOVEATION_LEVEL_PROFILE_CREATE_INFO_FB) {
+        XrFoveationLevelProfileCreateInfoFB level = {XR_TYPE_FOVEATION_LEVEL_PROFILE_CREATE_INFO_FB};
+        if (p) level = *(const XrFoveationLevelProfileCreateInfoFB *)p;
+        if (foveation_storage_fix || foveation_eye)
+            LOG("foveation profile: level=%d dynamic=%d eye_requested=%d supported=%d", level.level, level.dynamic,
+                foveation_eye, foveation_eye_supported);
+        if (foveation_eye && !foveation_fix && foveation_eye_supported && !level.next && level.level != XR_FOVEATION_LEVEL_NONE_FB) {
+            XrFoveationEyeTrackedProfileCreateInfoMETA eye = {XR_TYPE_FOVEATION_EYE_TRACKED_PROFILE_CREATE_INFO_META};
+            XrFoveationProfileCreateInfoFB fixed = *info;
+            level.next = &eye;
+            fixed.next = &level;
+            XrResult result = fn(session, &fixed, profile);
+            LOG("foveation profile: eye-tracked upgrade result=%d", result);
+            if (XR_SUCCEEDED(result)) return result;
+        }
+    }
+    return fn(session, info, profile);
+}
+
+XRAPI_ATTR XrResult XRAPI_CALL xrGetFoveationEyeTrackedStateMETA(XrSession session, XrFoveationEyeTrackedStateMETA *state) {
+    PFN_xrGetFoveationEyeTrackedStateMETA fn = (PFN_xrGetFoveationEyeTrackedStateMETA)lookup(active_instance, "xrGetFoveationEyeTrackedStateMETA");
+    if (!fn) return XR_ERROR_FUNCTION_UNSUPPORTED;
+    XrResult result = fn(session, state);
+    static unsigned queries;
+    if (foveation_eye && state && XR_SUCCEEDED(result) && (++queries % 240 == 1))
+        LOG("foveation gaze consumed by app: valid=%llu left=%.3f,%.3f right=%.3f,%.3f", (unsigned long long)state->flags,
+            state->foveationCenter[0].x, state->foveationCenter[0].y, state->foveationCenter[1].x, state->foveationCenter[1].y);
+    return result;
+}
+
 XRAPI_ATTR XrResult XRAPI_CALL xrCreateSwapchain(XrSession session, const XrSwapchainCreateInfo *info,
        XrSwapchain *swapchain) {
    PFN_xrCreateSwapchain fn = (PFN_xrCreateSwapchain)lookup(active_instance, "xrCreateSwapchain");
    if (!fn) return XR_ERROR_FUNCTION_UNSUPPORTED;
    if (!info) return XR_ERROR_VALIDATION_FAILURE;
    XrSwapchainCreateInfo fixed = *info;
+    FbStorageNode storage_nodes[16];
+    if (!foveation_fix && foveation_storage_fix) {
+        int changed = fb_foveation_storage(&fixed, storage_nodes);
+        LOG("foveation_storage_fix: shared allocation %s", changed > 0 ? "SUBSAMPLED cleared" :
+            changed < 0 ? "unchanged (unsupported chain prefix)" : "already ordinary or no META node");
+    }
    if (foveation_fix) {
        // Drop leading foveation structs; the chain is const so only a prefix can be skipped.
        const XrBaseInStructure *p = (const XrBaseInStructure *)fixed.next;
@@ -768,6 +851,8 @@ XRAPI_ATTR XrResult XRAPI_CALL xrGetSystemProperties(XrInstance instance, XrSyst
    PFN_xrGetSystemProperties fn = (PFN_xrGetSystemProperties)lookup(instance, "xrGetSystemProperties");
    if (!fn) return XR_ERROR_FUNCTION_UNSUPPORTED;
    XrResult result = fn(instance, system, properties);
+    if (XR_SUCCEEDED(result) && properties && properties->graphicsProperties.maxLayerCount)
+        runtime_max_layers = properties->graphicsProperties.maxLayerCount;
    if (XR_SUCCEEDED(result) && properties && layer_debug)
        LOG("layer_debug: system '%s' maxLayerCount=%u max swapchain %ux%u", properties->systemName,
            properties->graphicsProperties.maxLayerCount, properties->graphicsProperties.maxSwapchainImageWidth,
@@ -881,6 +966,7 @@ XRAPI_ATTR XrResult XRAPI_CALL xrDestroySpace(XrSpace space) {
 #include "cube_standin.c"
 #include "snapshot_gl.c"
 #include "surface_swapchain.c"
+#include "fade_quad.c"

 // GPU video buffers need explicit external-memory support on the app's device.
 // Preserve the runtime's extension list and both Vulkan-enable entry points.
@@ -1017,11 +1103,21 @@ XRAPI_ATTR XrResult XRAPI_CALL xrCreateSession(XrInstance instance, const XrSess
    if (result == XR_ERROR_GRAPHICS_REQUIREMENTS_CALL_MISSING && ask_graphics_requirements(instance, info))
        result = fn(instance, info, session);
    if (XR_SUCCEEDED(result)) {
+        foveation_eye_supported = 0;
+        if (foveation_eye_enabled) {
+            PFN_xrGetSystemProperties properties = (PFN_xrGetSystemProperties)lookup(instance, "xrGetSystemProperties");
+            XrSystemFoveationEyeTrackedPropertiesMETA eye = {XR_TYPE_SYSTEM_FOVEATION_EYE_TRACKED_PROPERTIES_META};
+            XrSystemProperties sys = {XR_TYPE_SYSTEM_PROPERTIES, &eye};
+            if (properties && XR_SUCCEEDED(properties(instance, info->systemId, &sys)))
+                foveation_eye_supported = eye.supportsFoveationEyeTracked;
+            LOG("foveation eye capability: %d", foveation_eye_supported);
+        }
        flip_emul = flip_emul_setting;
        flip_on_create_session(info);
        scene_on_create_session(*session);
        session_fixes_on_create_session(*session);
        emul_on_create_session(*session, info);
+        fade_on_create_session(*session, info);
    }
    return result;
 }
@@ -1465,7 +1561,7 @@ XRAPI_ATTR XrResult XRAPI_CALL xrEndFrame(XrSession session, const XrFrameEndInf
            frames = 0; drift_sum = drift_max = 0;
        }
    }
-    if ((!layer_fix && !swap_eyes && !emulate_passthrough && !flip_quads && !flip_emul && !strip_depth) || !info || !info->layerCount ||
+    if ((!layer_fix && !swap_eyes && !emulate_passthrough && !flip_quads && !flip_emul && !strip_depth && !fade_quad) || !info || !info->layerCount ||
        info->layerCount > 64)
        return fn(session, info);
    if (layer_debug) {  // the submitted layer list (order, flags, eyes, chained structs) whenever its shape changes
@@ -1504,6 +1600,8 @@ XRAPI_ATTR XrResult XRAPI_CALL xrEndFrame(XrSession session, const XrFrameEndInf
    XrCompositionLayerProjection projections[64];
    XrCompositionLayerProjectionView views[64][2];
    XrCompositionLayerQuad quads[64];
+    XrCompositionLayerQuad fade_out;  // fade_quad: at most one fade layer per frame
+    int faded = 0;
    uint32_t count = 0, dropped = 0, swapped = 0, passthrough = 0;
    const XrCompositionLayerBaseHeader *surface_projections[SURF_MAX];
    int surface_projection_count = 0;
@@ -1643,8 +1741,9 @@ XRAPI_ATTR XrResult XRAPI_CALL xrEndFrame(XrSession session, const XrFrameEndInf
                    memcpy(last, now, sizeof(now));
                }
            }
-            if (cb && strip_color_bias && (layer->type == XR_TYPE_COMPOSITION_LAYER_PROJECTION ||
-                                           layer->type == XR_TYPE_COMPOSITION_LAYER_QUAD)) {
+            if (cb && ((strip_color_bias && (layer->type == XR_TYPE_COMPOSITION_LAYER_PROJECTION ||
+                                             layer->type == XR_TYPE_COMPOSITION_LAYER_QUAD)) ||
+                       (fade_quad > 1 && layer->type == XR_TYPE_COMPOSITION_LAYER_PROJECTION))) {
                const XrBaseInStructure *rest = head;  // skip leading color structs; one further down drops the chain
                while (rest && rest->type == XR_TYPE_COMPOSITION_LAYER_COLOR_SCALE_BIAS_KHR) rest = rest->next;
                for (const XrBaseInStructure *n = rest; n; n = n->next)
@@ -1753,7 +1852,31 @@ XRAPI_ATTR XrResult XRAPI_CALL xrEndFrame(XrSession session, const XrFrameEndInf
                }
            }
        }
+        // SteamVR ignores Batman's projection colour-scale blackout. An opaque
+        // frame has a black background, so omit a fully black primary scene;
+        // later loading UI layers keep their order. Never do this for passthrough,
+        // alpha-blended projections, partial fades, or an already composed video.
+        if(surface_native && i==0 && count==0 &&
+           info->environmentBlendMode==XR_ENVIRONMENT_BLEND_MODE_OPAQUE &&
+           layer->type==XR_TYPE_COMPOSITION_LAYER_PROJECTION &&
+           !(layer->layerFlags&XR_COMPOSITION_LAYER_BLEND_TEXTURE_SOURCE_ALPHA_BIT)) {
+            const XrCompositionLayerColorScaleBiasKHR *black=NULL;
+            for(const XrBaseInStructure *n=layer->next;n;n=n->next)
+                if(n->type==XR_TYPE_COMPOSITION_LAYER_COLOR_SCALE_BIAS_KHR)black=(const void*)n;
+            if(black && black->colorScale.r==0 && black->colorScale.g==0 && black->colorScale.b==0 &&
+               black->colorScale.a==1 && black->colorBias.r==0 && black->colorBias.g==0 &&
+               black->colorBias.b==0 && black->colorBias.a==0) {
+                static int black_logged;
+                if(!black_logged++)LOG("loading blackout: omitted fully black primary projection; later UI retained");
+                ++dropped;continue;
+            }
+        }
        kept[count++] = layer;
+        // fade_quad: a dimmed projection layer gets the black quad right after it (the colour scale is read from
+        // the app's own layer: fade_quad=2 removed it from the copy submitted)
+        int level = fade_quad && !faded && count < 64 ? fade_level(info->layers[i]) : 0;
+        const XrCompositionLayerBaseHeader *fade_l = level ? fade_layer(session, level, count, &fade_out) : NULL;
+        if (fade_l) { kept[count++] = fade_l; faded = 1; ++swapped; }
    }
    XrFrameEndInfo fixed = *info;
    fixed.layers = kept;
@@ -1918,6 +2041,12 @@ XRAPI_ATTR XrResult XRAPI_CALL xrEnumerateApiLayerProperties(uint32_t capacity,
 // For native/xrshim: emulated functions that overport's dispatcher doesn't know (it never asks us for them).
 __attribute__((visibility("default"))) PFN_xrVoidFunction framebridge_extension_proc(const char *name) {
    pthread_once(&init_once, initialize);
+    if (name && !foveation_fix && (foveation_storage_fix || foveation_eye)) {
+        if (!strcmp(name, "xrCreateFoveationProfileFB")) return (PFN_xrVoidFunction)xrCreateFoveationProfileFB;
+        if (!strcmp(name, "xrGetFoveationEyeTrackedStateMETA")) return (PFN_xrVoidFunction)xrGetFoveationEyeTrackedStateMETA;
+        if (!strcmp(name, "xrDestroyFoveationProfileFB") || !strcmp(name, "xrUpdateSwapchainFB") ||
+            !strcmp(name, "xrGetSwapchainStateFB")) return lookup(active_instance, name);
+    }
    if(surface_native && name){
 #define NATIVE_PROC(fn) if(!strcmp(name,#fn))return (PFN_xrVoidFunction)fn;
        NATIVE_PROC(xrGetVulkanGraphicsDeviceKHR)
@@ -1967,6 +2096,8 @@ XRAPI_ATTR XrResult XRAPI_CALL xrGetInstanceProcAddr(XrInstance instance, const
    HOOK(xrCreateInstance)
    HOOK(xrEnumerateViewConfigurationViews)
    HOOK(xrCreateSwapchain)
+    HOOK(xrCreateFoveationProfileFB)
+    HOOK(xrGetFoveationEyeTrackedStateMETA)
    HOOK(xrDestroySwapchain)
    HOOK(xrEndFrame)
    HOOK(xrBeginFrame)
@@ -189,6 +189,7 @@ static int sc_setup(XrSession session,surf_projection *p,surf_composite *c) {
        XR_SWAPCHAIN_USAGE_TRANSFER_DST_BIT|XR_SWAPCHAIN_USAGE_COLOR_ATTACHMENT_BIT,
        VK_FORMAT_R8G8B8A8_SRGB,1,2*p->size,p->size,1,1,1};
    if(!create || !enumerate || XR_FAILED(create(session,&ci,&c->output)))goto fail;
+    surf_video_full_rate(session,c->output);
    XrSwapchainImageVulkanKHR images[MAX_IMAGES];
    for(int i=0;i<MAX_IMAGES;i++)images[i]=(XrSwapchainImageVulkanKHR){XR_TYPE_SWAPCHAIN_IMAGE_VULKAN_KHR};
    if(XR_FAILED(enumerate(c->output,MAX_IMAGES,&c->count,(void*)images)) || !c->count || c->count>MAX_IMAGES) {
@@ -258,7 +259,7 @@ static int sc_setup(XrSession session,surf_projection *p,surf_composite *c) {
    VkResult result=spvk.CreateGraphicsPipelines(vk.device,VK_NULL_HANDLE,1,&pci,NULL,&c->pipeline);
    for(int k=0;k<2;k++)spvk.DestroyShaderModule(vk.device,modules[k],NULL);
    if(result!=VK_SUCCESS)goto fail;
-    LOG("surface_composite: one primary stereo scene, %ux%u per eye",p->size,p->size);return 1;
+    LOG("surface_composite: one primary full-rate raster stereo scene, %ux%u per eye",p->size,p->size);return 1;
 fail:
    surf_composite_destroy(p);c->failed=1;
    LOG("surface_composite: setup failed; retaining ordinary composition");return 0;
@@ -305,8 +306,9 @@ static const XrCompositionLayerBaseHeader *surf_composite_frame(XrSession sessio
        {{0,0},{2*p->size,p->size}},0,NULL};
    spvk.CmdBeginRenderPass(cmd,&rbi,VK_SUBPASS_CONTENTS_INLINE);
    spvk.CmdBindPipeline(cmd,VK_PIPELINE_BIND_POINT_GRAPHICS,c->pipeline);
+    VkImageView video_view=s->native_current>=0?s->native_slots[s->native_current].srgb_view:p->video_cache_view;
    for(int e=0;e<2;e++) {
-        VkDescriptorImageInfo di[2]={{c->sampler,p->video_cache_view,VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL},
+        VkDescriptorImageInfo di[2]={{c->sampler,video_view,VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL},
            {c->sampler,sources[e]->view,VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL}};
        VkWriteDescriptorSet writes[2];
        for(int k=0;k<2;k++)writes[k]=(VkWriteDescriptorSet){VK_STRUCTURE_TYPE_WRITE_DESCRIPTOR_SET,NULL,c->sets[index][e],k,0,1,
@@ -11,10 +11,6 @@ layout(push_constant) uniform Params {
 } p;
 vec3 rotate(vec4 q,vec3 v){return v+2.0*cross(q.xyz,cross(q.xyz,v)+q.w*v);}
 void main(){
- vec2 scenePixel=0.5/vec2(textureSize(sceneImage,0).xy);
- vec2 sceneCoord=vec2(uv.x,p.sceneOptions.z>0 ? 1-uv.y : uv.y);
- vec2 sceneUV=clamp(p.sceneRect.xy+sceneCoord*p.sceneRect.zw,p.sceneRect.xy+scenePixel,p.sceneRect.xy+p.sceneRect.zw-scenePixel);
- vec4 scene=textureLod(sceneImage,vec3(sceneUV,p.options.y),0);
 // Projection rows follow Vulkan/OpenXR's top-to-bottom convention.
 vec3 ray=rotate(p.rotation,vec3(mix(p.outputTans.x,p.outputTans.y,uv.x),mix(p.outputTans.w,p.outputTans.z,uv.y),-1));
 vec2 vuv=(ray.xy/-ray.z-p.videoTans.xz)/(p.videoTans.yw-p.videoTans.xz); vuv.y=1-vuv.y;
@@ -28,6 +24,12 @@ void main(){
 }
 float alpha=p.options.z>0 ? video.a : 1;
 vec3 rgb=p.options.w>0 ? video.rgb*alpha : video.rgb;
+ // Opaque video completely covers the scene: avoid its texture fetch and colour transform.
+ if(alpha==1.0){outputColor=vec4(rgb,1);return;}
+ vec2 scenePixel=0.5/vec2(textureSize(sceneImage,0).xy);
+ vec2 sceneCoord=vec2(uv.x,p.sceneOptions.z>0 ? 1-uv.y : uv.y);
+ vec2 sceneUV=clamp(p.sceneRect.xy+sceneCoord*p.sceneRect.zw,p.sceneRect.xy+scenePixel,p.sceneRect.xy+p.sceneRect.zw-scenePixel);
+ vec4 scene=textureLod(sceneImage,vec3(sceneUV,p.options.y),0);
 float sceneAlpha=p.sceneOptions.x>0 ? scene.a : 1;
 vec3 sceneRGB=p.sceneOptions.y>0 ? scene.rgb*sceneAlpha : scene.rgb;
 // OpenXR colour transforms act on straight colour, then restore premultiplication.
@@ -1,300 +1,198 @@
-// SPDX-License-Identifier: GPL-3.0-only
-// Generated by glslc; Vulkan 1.0.
-static const uint32_t surface_composite_vert_spv[]={
-    0x07230203,0x00010000,0x000d000a,0x0000002e,0x00000000,0x00020011,0x00000001,0x0006000b,
+// Generated from surface_composite.vert and surface_composite.frag.
+static const uint32_t surface_composite_vert_spv[] = {
+    0x07230203,0x00010000,0x000d000a,0x0000002f,0x00000000,0x00020011,0x00000001,0x0006000b,
    0x00000001,0x4c534c47,0x6474732e,0x3035342e,0x00000000,0x0003000e,0x00000000,0x00000001,
    0x0008000f,0x00000000,0x00000004,0x6e69616d,0x00000000,0x0000000c,0x00000018,0x00000020,
-    0x00030003,0x00000002,0x000001c2,0x000a0004,0x475f4c47,0x4c474f4f,0x70635f45,0x74735f70,
-    0x5f656c79,0x656e696c,0x7269645f,0x69746365,0x00006576,0x00080004,0x475f4c47,0x4c474f4f,
-    0x6e695f45,0x64756c63,0x69645f65,0x74636572,0x00657669,0x00040005,0x00000004,0x6e69616d,
-    0x00000000,0x00030005,0x00000009,0x00000070,0x00060005,0x0000000c,0x565f6c67,0x65747265,
-    0x646e4978,0x00007865,0x00030005,0x00000018,0x00007675,0x00060005,0x0000001e,0x505f6c67,
-    0x65567265,0x78657472,0x00000000,0x00060006,0x0000001e,0x00000000,0x505f6c67,0x7469736f,
-    0x006e6f69,0x00070006,0x0000001e,0x00000001,0x505f6c67,0x746e696f,0x657a6953,0x00000000,
-    0x00070006,0x0000001e,0x00000002,0x435f6c67,0x4470696c,0x61747369,0x0065636e,0x00070006,
-    0x0000001e,0x00000003,0x435f6c67,0x446c6c75,0x61747369,0x0065636e,0x00030005,0x00000020,
-    0x00000000,0x00040047,0x0000000c,0x0000000b,0x0000002a,0x00040047,0x00000018,0x0000001e,
-    0x00000000,0x00050048,0x0000001e,0x00000000,0x0000000b,0x00000000,0x00050048,0x0000001e,
-    0x00000001,0x0000000b,0x00000001,0x00050048,0x0000001e,0x00000002,0x0000000b,0x00000003,
-    0x00050048,0x0000001e,0x00000003,0x0000000b,0x00000004,0x00030047,0x0000001e,0x00000002,
-    0x00020013,0x00000002,0x00030021,0x00000003,0x00000002,0x00030016,0x00000006,0x00000020,
-    0x00040017,0x00000007,0x00000006,0x00000002,0x00040020,0x00000008,0x00000007,0x00000007,
-    0x00040015,0x0000000a,0x00000020,0x00000001,0x00040020,0x0000000b,0x00000001,0x0000000a,
-    0x0004003b,0x0000000b,0x0000000c,0x00000001,0x0004002b,0x0000000a,0x0000000e,0x00000001,
-    0x0004002b,0x0000000a,0x00000010,0x00000002,0x00040020,0x00000017,0x00000003,0x00000007,
-    0x0004003b,0x00000017,0x00000018,0x00000003,0x00040017,0x0000001a,0x00000006,0x00000004,
-    0x00040015,0x0000001b,0x00000020,0x00000000,0x0004002b,0x0000001b,0x0000001c,0x00000001,
-    0x0004001c,0x0000001d,0x00000006,0x0000001c,0x0006001e,0x0000001e,0x0000001a,0x00000006,
-    0x0000001d,0x0000001d,0x00040020,0x0000001f,0x00000003,0x0000001e,0x0004003b,0x0000001f,
-    0x00000020,0x00000003,0x0004002b,0x0000000a,0x00000021,0x00000000,0x0004002b,0x00000006,
-    0x00000023,0x40000000,0x0004002b,0x00000006,0x00000025,0x3f800000,0x0004002b,0x00000006,
-    0x00000028,0x00000000,0x00040020,0x0000002c,0x00000003,0x0000001a,0x00050036,0x00000002,
-    0x00000004,0x00000000,0x00000003,0x000200f8,0x00000005,0x0004003b,0x00000008,0x00000009,
-    0x00000007,0x0004003d,0x0000000a,0x0000000d,0x0000000c,0x000500c4,0x0000000a,0x0000000f,
-    0x0000000d,0x0000000e,0x000500c7,0x0000000a,0x00000011,0x0000000f,0x00000010,0x0004006f,
-    0x00000006,0x00000012,0x00000011,0x0004003d,0x0000000a,0x00000013,0x0000000c,0x000500c7,
-    0x0000000a,0x00000014,0x00000013,0x00000010,0x0004006f,0x00000006,0x00000015,0x00000014,
-    0x00050050,0x00000007,0x00000016,0x00000012,0x00000015,0x0003003e,0x00000009,0x00000016,
-    0x0004003d,0x00000007,0x00000019,0x00000009,0x0003003e,0x00000018,0x00000019,0x0004003d,
-    0x00000007,0x00000022,0x00000009,0x0005008e,0x00000007,0x00000024,0x00000022,0x00000023,
-    0x00050050,0x00000007,0x00000026,0x00000025,0x00000025,0x00050083,0x00000007,0x00000027,
-    0x00000024,0x00000026,0x00050051,0x00000006,0x00000029,0x00000027,0x00000000,0x00050051,
+    0x00040047,0x0000000c,0x0000000b,0x0000002a,0x00040047,0x00000018,0x0000001e,0x00000000,
+    0x00050048,0x0000001e,0x00000000,0x0000000b,0x00000000,0x00050048,0x0000001e,0x00000001,
+    0x0000000b,0x00000001,0x00050048,0x0000001e,0x00000002,0x0000000b,0x00000003,0x00050048,
+    0x0000001e,0x00000003,0x0000000b,0x00000004,0x00030047,0x0000001e,0x00000002,0x00020013,
+    0x00000002,0x00030021,0x00000003,0x00000002,0x00030016,0x00000006,0x00000020,0x00040017,
+    0x00000007,0x00000006,0x00000002,0x00040015,0x0000000a,0x00000020,0x00000001,0x00040020,
+    0x0000000b,0x00000001,0x0000000a,0x0004003b,0x0000000b,0x0000000c,0x00000001,0x0004002b,
+    0x0000000a,0x0000000e,0x00000001,0x0004002b,0x0000000a,0x00000010,0x00000002,0x00040020,
+    0x00000017,0x00000003,0x00000007,0x0004003b,0x00000017,0x00000018,0x00000003,0x00040017,
+    0x0000001a,0x00000006,0x00000004,0x00040015,0x0000001b,0x00000020,0x00000000,0x0004002b,
+    0x0000001b,0x0000001c,0x00000001,0x0004001c,0x0000001d,0x00000006,0x0000001c,0x0006001e,
+    0x0000001e,0x0000001a,0x00000006,0x0000001d,0x0000001d,0x00040020,0x0000001f,0x00000003,
+    0x0000001e,0x0004003b,0x0000001f,0x00000020,0x00000003,0x0004002b,0x0000000a,0x00000021,
+    0x00000000,0x0004002b,0x00000006,0x00000023,0x40000000,0x0004002b,0x00000006,0x00000025,
+    0x3f800000,0x0004002b,0x00000006,0x00000028,0x00000000,0x00040020,0x0000002c,0x00000003,
+    0x0000001a,0x0005002c,0x00000007,0x0000002e,0x00000025,0x00000025,0x00050036,0x00000002,
+    0x00000004,0x00000000,0x00000003,0x000200f8,0x00000005,0x0004003d,0x0000000a,0x0000000d,
+    0x0000000c,0x000500c4,0x0000000a,0x0000000f,0x0000000d,0x0000000e,0x000500c7,0x0000000a,
+    0x00000011,0x0000000f,0x00000010,0x0004006f,0x00000006,0x00000012,0x00000011,0x000500c7,
+    0x0000000a,0x00000014,0x0000000d,0x00000010,0x0004006f,0x00000006,0x00000015,0x00000014,
+    0x00050050,0x00000007,0x00000016,0x00000012,0x00000015,0x0003003e,0x00000018,0x00000016,
+    0x0005008e,0x00000007,0x00000024,0x00000016,0x00000023,0x00050083,0x00000007,0x00000027,
+    0x00000024,0x0000002e,0x00050051,0x00000006,0x00000029,0x00000027,0x00000000,0x00050051,
    0x00000006,0x0000002a,0x00000027,0x00000001,0x00070050,0x0000001a,0x0000002b,0x00000029,
    0x0000002a,0x00000028,0x00000025,0x00050041,0x0000002c,0x0000002d,0x00000020,0x00000021,
    0x0003003e,0x0000002d,0x0000002b,0x000100fd,0x00010038,
 };
-static const uint32_t surface_composite_frag_spv[]={
-    0x07230203,0x00010000,0x000d000a,0x00000153,0x00000000,0x00020011,0x00000001,0x00020011,
+static const uint32_t surface_composite_frag_spv[] = {
+    0x07230203,0x00010000,0x000d000a,0x0000018a,0x00000000,0x00020011,0x00000001,0x00020011,
    0x00000032,0x0006000b,0x00000001,0x4c534c47,0x6474732e,0x3035342e,0x00000000,0x0003000e,
-    0x00000000,0x00000001,0x0007000f,0x00000004,0x00000004,0x6e69616d,0x00000000,0x0000003a,
-    0x00000151,0x00030010,0x00000004,0x00000007,0x00030003,0x00000002,0x000001c2,0x000a0004,
-    0x475f4c47,0x4c474f4f,0x70635f45,0x74735f70,0x5f656c79,0x656e696c,0x7269645f,0x69746365,
-    0x00006576,0x00080004,0x475f4c47,0x4c474f4f,0x6e695f45,0x64756c63,0x69645f65,0x74636572,
-    0x00657669,0x00040005,0x00000004,0x6e69616d,0x00000000,0x00060005,0x0000000e,0x61746f72,
-    0x76286574,0x763b3466,0x003b3366,0x00030005,0x0000000c,0x00000071,0x00030005,0x0000000d,
-    0x00000076,0x00050005,0x00000027,0x6e656373,0x78695065,0x00006c65,0x00050005,0x0000002c,
-    0x6e656373,0x616d4965,0x00006567,0x00050005,0x00000038,0x6e656373,0x6f6f4365,0x00006472,
-    0x00030005,0x0000003a,0x00007675,0x00040005,0x0000003f,0x61726150,0x0000736d,0x00060006,
-    0x0000003f,0x00000000,0x61746f72,0x6e6f6974,0x00000000,0x00060006,0x0000003f,0x00000001,
-    0x7074756f,0x61547475,0x0000736e,0x00060006,0x0000003f,0x00000002,0x65646976,0x6e61546f,
-    0x00000073,0x00060006,0x0000003f,0x00000003,0x6e656373,0x63655265,0x00000074,0x00050006,
-    0x0000003f,0x00000004,0x6974706f,0x00736e6f,0x00070006,0x0000003f,0x00000005,0x6e656373,
-    0x74704f65,0x736e6f69,0x00000000,0x00060006,0x0000003f,0x00000006,0x6e656373,0x61635365,
-    0x0000656c,0x00060006,0x0000003f,0x00000007,0x6e656373,0x61694265,0x00000073,0x00030005,
-    0x00000041,0x00000070,0x00040005,0x00000057,0x6e656373,0x00565565,0x00040005,0x00000072,
-    0x6e656373,0x00000065,0x00030005,0x0000007c,0x00796172,0x00040005,0x0000008e,0x61726170,
-    0x0000006d,0x00040005,0x00000091,0x61726170,0x0000006d,0x00030005,0x00000093,0x00767576,
-    0x00040005,0x000000ac,0x65646976,0x0000006f,0x00050005,0x000000c2,0x65646976,0x7869506f,
-    0x00006c65,0x00050005,0x000000c6,0x65646976,0x616d496f,0x00006567,0x00050005,0x000000cd,
-    0x65646976,0x6365526f,0x00000074,0x00040005,0x000000d2,0x65646976,0x0056556f,0x00040005,
-    0x000000e9,0x68706c61,0x00000061,0x00030005,0x000000f4,0x00626772,0x00050005,0x00000103,
-    0x6e656373,0x706c4165,0x00006168,0x00050005,0x0000010e,0x6e656373,0x42475265,0x00000000,
-    0x00060005,0x0000011d,0x6e656373,0x72745365,0x68676961,0x00000074,0x00040005,0x0000013f,
-    0x75736572,0x0000746c,0x00050005,0x00000151,0x7074756f,0x6f437475,0x00726f6c,0x00040047,
-    0x0000002c,0x00000022,0x00000000,0x00040047,0x0000002c,0x00000021,0x00000001,0x00040047,
-    0x0000003a,0x0000001e,0x00000000,0x00050048,0x0000003f,0x00000000,0x00000023,0x00000000,
-    0x00050048,0x0000003f,0x00000001,0x00000023,0x00000010,0x00050048,0x0000003f,0x00000002,
-    0x00000023,0x00000020,0x00050048,0x0000003f,0x00000003,0x00000023,0x00000030,0x00050048,
-    0x0000003f,0x00000004,0x00000023,0x00000040,0x00050048,0x0000003f,0x00000005,0x00000023,
-    0x00000050,0x00050048,0x0000003f,0x00000006,0x00000023,0x00000060,0x00050048,0x0000003f,
-    0x00000007,0x00000023,0x00000070,0x00030047,0x0000003f,0x00000002,0x00040047,0x000000c6,
-    0x00000022,0x00000000,0x00040047,0x000000c6,0x00000021,0x00000000,0x00040047,0x00000151,
-    0x0000001e,0x00000000,0x00020013,0x00000002,0x00030021,0x00000003,0x00000002,0x00030016,
-    0x00000006,0x00000020,0x00040017,0x00000007,0x00000006,0x00000004,0x00040020,0x00000008,
-    0x00000007,0x00000007,0x00040017,0x00000009,0x00000006,0x00000003,0x00040020,0x0000000a,
-    0x00000007,0x00000009,0x00050021,0x0000000b,0x00000009,0x00000008,0x0000000a,0x0004002b,
+    0x00000000,0x00000001,0x0007000f,0x00000004,0x00000004,0x6e69616d,0x00000000,0x00000035,
+    0x000000c6,0x00030010,0x00000004,0x00000007,0x00050048,0x00000026,0x00000000,0x00000023,
+    0x00000000,0x00050048,0x00000026,0x00000001,0x00000023,0x00000010,0x00050048,0x00000026,
+    0x00000002,0x00000023,0x00000020,0x00050048,0x00000026,0x00000003,0x00000023,0x00000030,
+    0x00050048,0x00000026,0x00000004,0x00000023,0x00000040,0x00050048,0x00000026,0x00000005,
+    0x00000023,0x00000050,0x00050048,0x00000026,0x00000006,0x00000023,0x00000060,0x00050048,
+    0x00000026,0x00000007,0x00000023,0x00000070,0x00030047,0x00000026,0x00000002,0x00040047,
+    0x00000035,0x0000001e,0x00000000,0x00040047,0x00000082,0x00000022,0x00000000,0x00040047,
+    0x00000082,0x00000021,0x00000000,0x00040047,0x000000c6,0x0000001e,0x00000000,0x00040047,
+    0x000000d1,0x00000022,0x00000000,0x00040047,0x000000d1,0x00000021,0x00000001,0x00020013,
+    0x00000002,0x00030021,0x00000003,0x00000002,0x00030016,0x00000006,0x00000020,0x00040017,
+    0x00000007,0x00000006,0x00000004,0x00040017,0x00000009,0x00000006,0x00000003,0x0004002b,
    0x00000006,0x00000011,0x40000000,0x00040015,0x00000018,0x00000020,0x00000000,0x0004002b,
-    0x00000018,0x00000019,0x00000003,0x00040020,0x0000001a,0x00000007,0x00000006,0x00040017,
-    0x00000025,0x00000006,0x00000002,0x00040020,0x00000026,0x00000007,0x00000025,0x0004002b,
-    0x00000006,0x00000028,0x3f000000,0x00090019,0x00000029,0x00000006,0x00000001,0x00000000,
-    0x00000001,0x00000000,0x00000001,0x00000000,0x0003001b,0x0000002a,0x00000029,0x00040020,
-    0x0000002b,0x00000000,0x0000002a,0x0004003b,0x0000002b,0x0000002c,0x00000000,0x00040015,
-    0x0000002e,0x00000020,0x00000001,0x0004002b,0x0000002e,0x0000002f,0x00000000,0x00040017,
-    0x00000031,0x0000002e,0x00000003,0x00040017,0x00000033,0x0000002e,0x00000002,0x00040020,
-    0x00000039,0x00000001,0x00000025,0x0004003b,0x00000039,0x0000003a,0x00000001,0x0004002b,
-    0x00000018,0x0000003b,0x00000000,0x00040020,0x0000003c,0x00000001,0x00000006,0x000a001e,
-    0x0000003f,0x00000007,0x00000007,0x00000007,0x00000007,0x00000007,0x00000007,0x00000007,
-    0x00000007,0x00040020,0x00000040,0x00000009,0x0000003f,0x0004003b,0x00000040,0x00000041,
-    0x00000009,0x0004002b,0x0000002e,0x00000042,0x00000005,0x0004002b,0x00000018,0x00000043,
-    0x00000002,0x00040020,0x00000044,0x00000009,0x00000006,0x0004002b,0x00000006,0x00000047,
-    0x00000000,0x00020014,0x00000048,0x0004002b,0x00000006,0x0000004d,0x3f800000,0x0004002b,
-    0x00000018,0x0000004e,0x00000001,0x0004002b,0x0000002e,0x00000058,0x00000003,0x00040020,
-    0x00000059,0x00000009,0x00000007,0x0004002b,0x0000002e,0x00000075,0x00000004,0x0004002b,
-    0x0000002e,0x0000007d,0x00000001,0x0004002b,0x00000006,0x0000008c,0xbf800000,0x0004002b,
-    0x0000002e,0x0000009b,0x00000002,0x0007002c,0x00000007,0x000000ad,0x00000047,0x00000047,
-    0x00000047,0x00000047,0x0005002c,0x00000025,0x000000b4,0x00000047,0x00000047,0x00040017,
-    0x000000b5,0x00000048,0x00000002,0x0005002c,0x00000025,0x000000bc,0x0000004d,0x0000004d,
-    0x00090019,0x000000c3,0x00000006,0x00000001,0x00000000,0x00000000,0x00000000,0x00000001,
-    0x00000000,0x0003001b,0x000000c4,0x000000c3,0x00040020,0x000000c5,0x00000000,0x000000c4,
-    0x0004003b,0x000000c5,0x000000c6,0x00000000,0x0006002c,0x00000009,0x00000128,0x00000047,
-    0x00000047,0x00000047,0x0004002b,0x0000002e,0x00000130,0x00000006,0x0004002b,0x0000002e,
-    0x00000135,0x00000007,0x00040020,0x00000150,0x00000003,0x00000007,0x0004003b,0x00000150,
-    0x00000151,0x00000003,0x00050036,0x00000002,0x00000004,0x00000000,0x00000003,0x000200f8,
-    0x00000005,0x0004003b,0x00000026,0x00000027,0x00000007,0x0004003b,0x00000026,0x00000038,
-    0x00000007,0x0004003b,0x0000001a,0x0000004a,0x00000007,0x0004003b,0x00000026,0x00000057,
-    0x00000007,0x0004003b,0x00000008,0x00000072,0x00000007,0x0004003b,0x0000000a,0x0000007c,
-    0x00000007,0x0004003b,0x00000008,0x0000008e,0x00000007,0x0004003b,0x0000000a,0x00000091,
-    0x00000007,0x0004003b,0x00000026,0x00000093,0x00000007,0x0004003b,0x00000008,0x000000ac,
-    0x00000007,0x0004003b,0x00000026,0x000000c2,0x00000007,0x0004003b,0x00000008,0x000000cd,
-    0x00000007,0x0004003b,0x00000026,0x000000d2,0x00000007,0x0004003b,0x0000001a,0x000000e9,
-    0x00000007,0x0004003b,0x0000001a,0x000000ed,0x00000007,0x0004003b,0x0000000a,0x000000f4,
-    0x00000007,0x0004003b,0x0000000a,0x000000f8,0x00000007,0x0004003b,0x0000001a,0x00000103,
-    0x00000007,0x0004003b,0x0000001a,0x00000107,0x00000007,0x0004003b,0x0000000a,0x0000010e,
-    0x00000007,0x0004003b,0x0000000a,0x00000112,0x00000007,0x0004003b,0x00000008,0x0000011d,
-    0x00000007,0x0004003b,0x0000000a,0x00000120,0x00000007,0x0004003b,0x00000008,0x0000013f,
-    0x00000007,0x0004003d,0x0000002a,0x0000002d,0x0000002c,0x00040064,0x00000029,0x00000030,
-    0x0000002d,0x00050067,0x00000031,0x00000032,0x00000030,0x0000002f,0x0007004f,0x00000033,
-    0x00000034,0x00000032,0x00000032,0x00000000,0x00000001,0x0004006f,0x00000025,0x00000035,
-    0x00000034,0x00050050,0x00000025,0x00000036,0x00000028,0x00000028,0x00050088,0x00000025,
-    0x00000037,0x00000036,0x00000035,0x0003003e,0x00000027,0x00000037,0x00050041,0x0000003c,
-    0x0000003d,0x0000003a,0x0000003b,0x0004003d,0x00000006,0x0000003e,0x0000003d,0x00060041,
-    0x00000044,0x00000045,0x00000041,0x00000042,0x00000043,0x0004003d,0x00000006,0x00000046,
-    0x00000045,0x000500ba,0x00000048,0x00000049,0x00000046,0x00000047,0x000300f7,0x0000004c,
-    0x00000000,0x000400fa,0x00000049,0x0000004b,0x00000052,0x000200f8,0x0000004b,0x00050041,
-    0x0000003c,0x0000004f,0x0000003a,0x0000004e,0x0004003d,0x00000006,0x00000050,0x0000004f,
-    0x00050083,0x00000006,0x00000051,0x0000004d,0x00000050,0x0003003e,0x0000004a,0x00000051,
-    0x000200f9,0x0000004c,0x000200f8,0x00000052,0x00050041,0x0000003c,0x00000053,0x0000003a,
-    0x0000004e,0x0004003d,0x00000006,0x00000054,0x00000053,0x0003003e,0x0000004a,0x00000054,
-    0x000200f9,0x0000004c,0x000200f8,0x0000004c,0x0004003d,0x00000006,0x00000055,0x0000004a,
-    0x00050050,0x00000025,0x00000056,0x0000003e,0x00000055,0x0003003e,0x00000038,0x00000056,
-    0x00050041,0x00000059,0x0000005a,0x00000041,0x00000058,0x0004003d,0x00000007,0x0000005b,
-    0x0000005a,0x0007004f,0x00000025,0x0000005c,0x0000005b,0x0000005b,0x00000000,0x00000001,
-    0x0004003d,0x00000025,0x0000005d,0x00000038,0x00050041,0x00000059,0x0000005e,0x00000041,
-    0x00000058,0x0004003d,0x00000007,0x0000005f,0x0000005e,0x0007004f,0x00000025,0x00000060,
-    0x0000005f,0x0000005f,0x00000002,0x00000003,0x00050085,0x00000025,0x00000061,0x0000005d,
-    0x00000060,0x00050081,0x00000025,0x00000062,0x0000005c,0x00000061,0x00050041,0x00000059,
-    0x00000063,0x00000041,0x00000058,0x0004003d,0x00000007,0x00000064,0x00000063,0x0007004f,
-    0x00000025,0x00000065,0x00000064,0x00000064,0x00000000,0x00000001,0x0004003d,0x00000025,
-    0x00000066,0x00000027,0x00050081,0x00000025,0x00000067,0x00000065,0x00000066,0x00050041,
-    0x00000059,0x00000068,0x00000041,0x00000058,0x0004003d,0x00000007,0x00000069,0x00000068,
-    0x0007004f,0x00000025,0x0000006a,0x00000069,0x00000069,0x00000000,0x00000001,0x00050041,
-    0x00000059,0x0000006b,0x00000041,0x00000058,0x0004003d,0x00000007,0x0000006c,0x0000006b,
-    0x0007004f,0x00000025,0x0000006d,0x0000006c,0x0000006c,0x00000002,0x00000003,0x00050081,
-    0x00000025,0x0000006e,0x0000006a,0x0000006d,0x0004003d,0x00000025,0x0000006f,0x00000027,
-    0x00050083,0x00000025,0x00000070,0x0000006e,0x0000006f,0x0008000c,0x00000025,0x00000071,
-    0x00000001,0x0000002b,0x00000062,0x00000067,0x00000070,0x0003003e,0x00000057,0x00000071,
-    0x0004003d,0x0000002a,0x00000073,0x0000002c,0x0004003d,0x00000025,0x00000074,0x00000057,
-    0x00060041,0x00000044,0x00000076,0x00000041,0x00000075,0x0000004e,0x0004003d,0x00000006,
-    0x00000077,0x00000076,0x00050051,0x00000006,0x00000078,0x00000074,0x00000000,0x00050051,
-    0x00000006,0x00000079,0x00000074,0x00000001,0x00060050,0x00000009,0x0000007a,0x00000078,
-    0x00000079,0x00000077,0x00070058,0x00000007,0x0000007b,0x00000073,0x0000007a,0x00000002,
-    0x00000047,0x0003003e,0x00000072,0x0000007b,0x00060041,0x00000044,0x0000007e,0x00000041,
-    0x0000007d,0x0000003b,0x0004003d,0x00000006,0x0000007f,0x0000007e,0x00060041,0x00000044,
-    0x00000080,0x00000041,0x0000007d,0x0000004e,0x0004003d,0x00000006,0x00000081,0x00000080,
-    0x00050041,0x0000003c,0x00000082,0x0000003a,0x0000003b,0x0004003d,0x00000006,0x00000083,
-    0x00000082,0x0008000c,0x00000006,0x00000084,0x00000001,0x0000002e,0x0000007f,0x00000081,
-    0x00000083,0x00060041,0x00000044,0x00000085,0x00000041,0x0000007d,0x00000019,0x0004003d,
-    0x00000006,0x00000086,0x00000085,0x00060041,0x00000044,0x00000087,0x00000041,0x0000007d,
-    0x00000043,0x0004003d,0x00000006,0x00000088,0x00000087,0x00050041,0x0000003c,0x00000089,
-    0x0000003a,0x0000004e,0x0004003d,0x00000006,0x0000008a,0x00000089,0x0008000c,0x00000006,
-    0x0000008b,0x00000001,0x0000002e,0x00000086,0x00000088,0x0000008a,0x00060050,0x00000009,
-    0x0000008d,0x00000084,0x0000008b,0x0000008c,0x00050041,0x00000059,0x0000008f,0x00000041,
-    0x0000002f,0x0004003d,0x00000007,0x00000090,0x0000008f,0x0003003e,0x0000008e,0x00000090,
-    0x0003003e,0x00000091,0x0000008d,0x00060039,0x00000009,0x00000092,0x0000000e,0x0000008e,
-    0x00000091,0x0003003e,0x0000007c,0x00000092,0x0004003d,0x00000009,0x00000094,0x0000007c,
-    0x0007004f,0x00000025,0x00000095,0x00000094,0x00000094,0x00000000,0x00000001,0x00050041,
-    0x0000001a,0x00000096,0x0000007c,0x00000043,0x0004003d,0x00000006,0x00000097,0x00000096,
-    0x0004007f,0x00000006,0x00000098,0x00000097,0x00050050,0x00000025,0x00000099,0x00000098,
-    0x00000098,0x00050088,0x00000025,0x0000009a,0x00000095,0x00000099,0x00050041,0x00000059,
-    0x0000009c,0x00000041,0x0000009b,0x0004003d,0x00000007,0x0000009d,0x0000009c,0x0007004f,
-    0x00000025,0x0000009e,0x0000009d,0x0000009d,0x00000000,0x00000002,0x00050083,0x00000025,
-    0x0000009f,0x0000009a,0x0000009e,0x00050041,0x00000059,0x000000a0,0x00000041,0x0000009b,
-    0x0004003d,0x00000007,0x000000a1,0x000000a0,0x0007004f,0x00000025,0x000000a2,0x000000a1,
-    0x000000a1,0x00000001,0x00000003,0x00050041,0x00000059,0x000000a3,0x00000041,0x0000009b,
-    0x0004003d,0x00000007,0x000000a4,0x000000a3,0x0007004f,0x00000025,0x000000a5,0x000000a4,
-    0x000000a4,0x00000000,0x00000002,0x00050083,0x00000025,0x000000a6,0x000000a2,0x000000a5,
-    0x00050088,0x00000025,0x000000a7,0x0000009f,0x000000a6,0x0003003e,0x00000093,0x000000a7,
-    0x00050041,0x0000001a,0x000000a8,0x00000093,0x0000004e,0x0004003d,0x00000006,0x000000a9,
-    0x000000a8,0x00050083,0x00000006,0x000000aa,0x0000004d,0x000000a9,0x00050041,0x0000001a,
-    0x000000ab,0x00000093,0x0000004e,0x0003003e,0x000000ab,0x000000aa,0x0003003e,0x000000ac,
-    0x000000ad,0x00050041,0x0000001a,0x000000ae,0x0000007c,0x00000043,0x0004003d,0x00000006,
-    0x000000af,0x000000ae,0x000500b8,0x00000048,0x000000b0,0x000000af,0x00000047,0x000300f7,
-    0x000000b2,0x00000000,0x000400fa,0x000000b0,0x000000b1,0x000000b2,0x000200f8,0x000000b1,
-    0x0004003d,0x00000025,0x000000b3,0x00000093,0x000500be,0x000000b5,0x000000b6,0x000000b3,
-    0x000000b4,0x0004009b,0x00000048,0x000000b7,0x000000b6,0x000200f9,0x000000b2,0x000200f8,
-    0x000000b2,0x000700f5,0x00000048,0x000000b8,0x000000b0,0x0000004c,0x000000b7,0x000000b1,
-    0x000300f7,0x000000ba,0x00000000,0x000400fa,0x000000b8,0x000000b9,0x000000ba,0x000200f8,
-    0x000000b9,0x0004003d,0x00000025,0x000000bb,0x00000093,0x000500bc,0x000000b5,0x000000bd,
-    0x000000bb,0x000000bc,0x0004009b,0x00000048,0x000000be,0x000000bd,0x000200f9,0x000000ba,
-    0x000200f8,0x000000ba,0x000700f5,0x00000048,0x000000bf,0x000000b8,0x000000b2,0x000000be,
-    0x000000b9,0x000300f7,0x000000c1,0x00000000,0x000400fa,0x000000bf,0x000000c0,0x000000c1,
-    0x000200f8,0x000000c0,0x0004003d,0x000000c4,0x000000c7,0x000000c6,0x00040064,0x000000c3,
-    0x000000c8,0x000000c7,0x00050067,0x00000033,0x000000c9,0x000000c8,0x0000002f,0x0004006f,
-    0x00000025,0x000000ca,0x000000c9,0x00050050,0x00000025,0x000000cb,0x00000028,0x00000028,
-    0x00050088,0x00000025,0x000000cc,0x000000cb,0x000000ca,0x0003003e,0x000000c2,0x000000cc,
-    0x00060041,0x00000044,0x000000ce,0x00000041,0x00000075,0x0000003b,0x0004003d,0x00000006,
-    0x000000cf,0x000000ce,0x00050085,0x00000006,0x000000d0,0x000000cf,0x00000028,0x00070050,
-    0x00000007,0x000000d1,0x000000d0,0x00000047,0x00000028,0x0000004d,0x0003003e,0x000000cd,
-    0x000000d1,0x0004003d,0x00000007,0x000000d3,0x000000cd,0x0007004f,0x00000025,0x000000d4,
-    0x000000d3,0x000000d3,0x00000000,0x00000001,0x0004003d,0x00000025,0x000000d5,0x00000093,
-    0x0004003d,0x00000007,0x000000d6,0x000000cd,0x0007004f,0x00000025,0x000000d7,0x000000d6,
-    0x000000d6,0x00000002,0x00000003,0x00050085,0x00000025,0x000000d8,0x000000d5,0x000000d7,
-    0x00050081,0x00000025,0x000000d9,0x000000d4,0x000000d8,0x0004003d,0x00000007,0x000000da,
-    0x000000cd,0x0007004f,0x00000025,0x000000db,0x000000da,0x000000da,0x00000000,0x00000001,
-    0x0004003d,0x00000025,0x000000dc,0x000000c2,0x00050081,0x00000025,0x000000dd,0x000000db,
-    0x000000dc,0x0004003d,0x00000007,0x000000de,0x000000cd,0x0007004f,0x00000025,0x000000df,
-    0x000000de,0x000000de,0x00000000,0x00000001,0x0004003d,0x00000007,0x000000e0,0x000000cd,
-    0x0007004f,0x00000025,0x000000e1,0x000000e0,0x000000e0,0x00000002,0x00000003,0x00050081,
-    0x00000025,0x000000e2,0x000000df,0x000000e1,0x0004003d,0x00000025,0x000000e3,0x000000c2,
-    0x00050083,0x00000025,0x000000e4,0x000000e2,0x000000e3,0x0008000c,0x00000025,0x000000e5,
-    0x00000001,0x0000002b,0x000000d9,0x000000dd,0x000000e4,0x0003003e,0x000000d2,0x000000e5,
-    0x0004003d,0x000000c4,0x000000e6,0x000000c6,0x0004003d,0x00000025,0x000000e7,0x000000d2,
-    0x00070058,0x00000007,0x000000e8,0x000000e6,0x000000e7,0x00000002,0x00000047,0x0003003e,
-    0x000000ac,0x000000e8,0x000200f9,0x000000c1,0x000200f8,0x000000c1,0x00060041,0x00000044,
-    0x000000ea,0x00000041,0x00000075,0x00000043,0x0004003d,0x00000006,0x000000eb,0x000000ea,
-    0x000500ba,0x00000048,0x000000ec,0x000000eb,0x00000047,0x000300f7,0x000000ef,0x00000000,
-    0x000400fa,0x000000ec,0x000000ee,0x000000f2,0x000200f8,0x000000ee,0x00050041,0x0000001a,
-    0x000000f0,0x000000ac,0x00000019,0x0004003d,0x00000006,0x000000f1,0x000000f0,0x0003003e,
-    0x000000ed,0x000000f1,0x000200f9,0x000000ef,0x000200f8,0x000000f2,0x0003003e,0x000000ed,
-    0x0000004d,0x000200f9,0x000000ef,0x000200f8,0x000000ef,0x0004003d,0x00000006,0x000000f3,
-    0x000000ed,0x0003003e,0x000000e9,0x000000f3,0x00060041,0x00000044,0x000000f5,0x00000041,
-    0x00000075,0x00000019,0x0004003d,0x00000006,0x000000f6,0x000000f5,0x000500ba,0x00000048,
-    0x000000f7,0x000000f6,0x00000047,0x000300f7,0x000000fa,0x00000000,0x000400fa,0x000000f7,
-    0x000000f9,0x000000ff,0x000200f8,0x000000f9,0x0004003d,0x00000007,0x000000fb,0x000000ac,
-    0x0008004f,0x00000009,0x000000fc,0x000000fb,0x000000fb,0x00000000,0x00000001,0x00000002,
-    0x0004003d,0x00000006,0x000000fd,0x000000e9,0x0005008e,0x00000009,0x000000fe,0x000000fc,
-    0x000000fd,0x0003003e,0x000000f8,0x000000fe,0x000200f9,0x000000fa,0x000200f8,0x000000ff,
-    0x0004003d,0x00000007,0x00000100,0x000000ac,0x0008004f,0x00000009,0x00000101,0x00000100,
-    0x00000100,0x00000000,0x00000001,0x00000002,0x0003003e,0x000000f8,0x00000101,0x000200f9,
-    0x000000fa,0x000200f8,0x000000fa,0x0004003d,0x00000009,0x00000102,0x000000f8,0x0003003e,
-    0x000000f4,0x00000102,0x00060041,0x00000044,0x00000104,0x00000041,0x00000042,0x0000003b,
-    0x0004003d,0x00000006,0x00000105,0x00000104,0x000500ba,0x00000048,0x00000106,0x00000105,
-    0x00000047,0x000300f7,0x00000109,0x00000000,0x000400fa,0x00000106,0x00000108,0x0000010c,
-    0x000200f8,0x00000108,0x00050041,0x0000001a,0x0000010a,0x00000072,0x00000019,0x0004003d,
-    0x00000006,0x0000010b,0x0000010a,0x0003003e,0x00000107,0x0000010b,0x000200f9,0x00000109,
-    0x000200f8,0x0000010c,0x0003003e,0x00000107,0x0000004d,0x000200f9,0x00000109,0x000200f8,
-    0x00000109,0x0004003d,0x00000006,0x0000010d,0x00000107,0x0003003e,0x00000103,0x0000010d,
-    0x00060041,0x00000044,0x0000010f,0x00000041,0x00000042,0x0000004e,0x0004003d,0x00000006,
-    0x00000110,0x0000010f,0x000500ba,0x00000048,0x00000111,0x00000110,0x00000047,0x000300f7,
-    0x00000114,0x00000000,0x000400fa,0x00000111,0x00000113,0x00000119,0x000200f8,0x00000113,
-    0x0004003d,0x00000007,0x00000115,0x00000072,0x0008004f,0x00000009,0x00000116,0x00000115,
-    0x00000115,0x00000000,0x00000001,0x00000002,0x0004003d,0x00000006,0x00000117,0x00000103,
-    0x0005008e,0x00000009,0x00000118,0x00000116,0x00000117,0x0003003e,0x00000112,0x00000118,
-    0x000200f9,0x00000114,0x000200f8,0x00000119,0x0004003d,0x00000007,0x0000011a,0x00000072,
-    0x0008004f,0x00000009,0x0000011b,0x0000011a,0x0000011a,0x00000000,0x00000001,0x00000002,
-    0x0003003e,0x00000112,0x0000011b,0x000200f9,0x00000114,0x000200f8,0x00000114,0x0004003d,
-    0x00000009,0x0000011c,0x00000112,0x0003003e,0x0000010e,0x0000011c,0x0004003d,0x00000006,
-    0x0000011e,0x00000103,0x000500ba,0x00000048,0x0000011f,0x0000011e,0x00000047,0x000300f7,
-    0x00000122,0x00000000,0x000400fa,0x0000011f,0x00000121,0x00000127,0x000200f8,0x00000121,
-    0x0004003d,0x00000009,0x00000123,0x0000010e,0x0004003d,0x00000006,0x00000124,0x00000103,
-    0x00060050,0x00000009,0x00000125,0x00000124,0x00000124,0x00000124,0x00050088,0x00000009,
-    0x00000126,0x00000123,0x00000125,0x0003003e,0x00000120,0x00000126,0x000200f9,0x00000122,
-    0x000200f8,0x00000127,0x0003003e,0x00000120,0x00000128,0x000200f9,0x00000122,0x000200f8,
-    0x00000122,0x0004003d,0x00000009,0x00000129,0x00000120,0x0004003d,0x00000006,0x0000012a,
-    0x00000103,0x00050051,0x00000006,0x0000012b,0x00000129,0x00000000,0x00050051,0x00000006,
-    0x0000012c,0x00000129,0x00000001,0x00050051,0x00000006,0x0000012d,0x00000129,0x00000002,
-    0x00070050,0x00000007,0x0000012e,0x0000012b,0x0000012c,0x0000012d,0x0000012a,0x0003003e,
-    0x0000011d,0x0000012e,0x0004003d,0x00000007,0x0000012f,0x0000011d,0x00050041,0x00000059,
-    0x00000131,0x00000041,0x00000130,0x0004003d,0x00000007,0x00000132,0x00000131,0x0007000c,
-    0x00000007,0x00000133,0x00000001,0x00000028,0x00000132,0x000000ad,0x00050085,0x00000007,
-    0x00000134,0x0000012f,0x00000133,0x00050041,0x00000059,0x00000136,0x00000041,0x00000135,
-    0x0004003d,0x00000007,0x00000137,0x00000136,0x00050081,0x00000007,0x00000138,0x00000134,
-    0x00000137,0x0003003e,0x0000011d,0x00000138,0x00050041,0x0000001a,0x00000139,0x0000011d,
-    0x00000019,0x0004003d,0x00000006,0x0000013a,0x00000139,0x0003003e,0x00000103,0x0000013a,
-    0x0004003d,0x00000007,0x0000013b,0x0000011d,0x0008004f,0x00000009,0x0000013c,0x0000013b,
-    0x0000013b,0x00000000,0x00000001,0x00000002,0x0004003d,0x00000006,0x0000013d,0x00000103,
-    0x0005008e,0x00000009,0x0000013e,0x0000013c,0x0000013d,0x0003003e,0x0000010e,0x0000013e,
-    0x0004003d,0x00000009,0x00000140,0x000000f4,0x0004003d,0x00000009,0x00000141,0x0000010e,
-    0x0004003d,0x00000006,0x00000142,0x000000e9,0x00050083,0x00000006,0x00000143,0x0000004d,
-    0x00000142,0x0005008e,0x00000009,0x00000144,0x00000141,0x00000143,0x00050081,0x00000009,
-    0x00000145,0x00000140,0x00000144,0x0004003d,0x00000006,0x00000146,0x000000e9,0x0004003d,
-    0x00000006,0x00000147,0x00000103,0x0004003d,0x00000006,0x00000148,0x000000e9,0x00050083,
-    0x00000006,0x00000149,0x0000004d,0x00000148,0x00050085,0x00000006,0x0000014a,0x00000147,
-    0x00000149,0x00050081,0x00000006,0x0000014b,0x00000146,0x0000014a,0x00050051,0x00000006,
-    0x0000014c,0x00000145,0x00000000,0x00050051,0x00000006,0x0000014d,0x00000145,0x00000001,
-    0x00050051,0x00000006,0x0000014e,0x00000145,0x00000002,0x00070050,0x00000007,0x0000014f,
-    0x0000014c,0x0000014d,0x0000014e,0x0000014b,0x0003003e,0x0000013f,0x0000014f,0x0004003d,
-    0x00000007,0x00000152,0x0000013f,0x0003003e,0x00000151,0x00000152,0x000100fd,0x00010038,
-    0x00050036,0x00000009,0x0000000e,0x00000000,0x0000000b,0x00030037,0x00000008,0x0000000c,
-    0x00030037,0x0000000a,0x0000000d,0x000200f8,0x0000000f,0x0004003d,0x00000009,0x00000010,
-    0x0000000d,0x0004003d,0x00000007,0x00000012,0x0000000c,0x0008004f,0x00000009,0x00000013,
-    0x00000012,0x00000012,0x00000000,0x00000001,0x00000002,0x0004003d,0x00000007,0x00000014,
-    0x0000000c,0x0008004f,0x00000009,0x00000015,0x00000014,0x00000014,0x00000000,0x00000001,
-    0x00000002,0x0004003d,0x00000009,0x00000016,0x0000000d,0x0007000c,0x00000009,0x00000017,
-    0x00000001,0x00000044,0x00000015,0x00000016,0x00050041,0x0000001a,0x0000001b,0x0000000c,
-    0x00000019,0x0004003d,0x00000006,0x0000001c,0x0000001b,0x0004003d,0x00000009,0x0000001d,
-    0x0000000d,0x0005008e,0x00000009,0x0000001e,0x0000001d,0x0000001c,0x00050081,0x00000009,
-    0x0000001f,0x00000017,0x0000001e,0x0007000c,0x00000009,0x00000020,0x00000001,0x00000044,
-    0x00000013,0x0000001f,0x0005008e,0x00000009,0x00000021,0x00000020,0x00000011,0x00050081,
-    0x00000009,0x00000022,0x00000010,0x00000021,0x000200fe,0x00000022,0x00010038,
+    0x00000018,0x00000019,0x00000003,0x000a001e,0x00000026,0x00000007,0x00000007,0x00000007,
+    0x00000007,0x00000007,0x00000007,0x00000007,0x00000007,0x00040020,0x00000027,0x00000009,
+    0x00000026,0x0004003b,0x00000027,0x00000028,0x00000009,0x00040015,0x00000029,0x00000020,
+    0x00000001,0x0004002b,0x00000029,0x0000002a,0x00000000,0x0004002b,0x00000029,0x0000002b,
+    0x00000001,0x0004002b,0x00000018,0x0000002c,0x00000000,0x00040020,0x0000002d,0x00000009,
+    0x00000006,0x0004002b,0x00000018,0x00000030,0x00000001,0x00040017,0x00000033,0x00000006,
+    0x00000002,0x00040020,0x00000034,0x00000001,0x00000033,0x0004003b,0x00000034,0x00000035,
+    0x00000001,0x00040020,0x00000036,0x00000001,0x00000006,0x0004002b,0x00000018,0x0000003c,
+    0x00000002,0x0004002b,0x00000006,0x00000042,0xbf800000,0x00040020,0x00000045,0x00000009,
+    0x00000007,0x0004002b,0x00000029,0x00000053,0x00000002,0x0004002b,0x00000006,0x00000060,
+    0x3f800000,0x0004002b,0x00000006,0x00000066,0x00000000,0x0007002c,0x00000007,0x00000067,
+    0x00000066,0x00000066,0x00000066,0x00000066,0x00020014,0x00000068,0x0005002c,0x00000033,
+    0x0000006f,0x00000066,0x00000066,0x00040017,0x00000070,0x00000068,0x00000002,0x0005002c,
+    0x00000033,0x00000077,0x00000060,0x00000060,0x0004002b,0x00000006,0x0000007e,0x3f000000,
+    0x00090019,0x0000007f,0x00000006,0x00000001,0x00000000,0x00000000,0x00000000,0x00000001,
+    0x00000000,0x0003001b,0x00000080,0x0000007f,0x00040020,0x00000081,0x00000000,0x00000080,
+    0x0004003b,0x00000081,0x00000082,0x00000000,0x00040017,0x00000085,0x00000029,0x00000002,
+    0x0004002b,0x00000029,0x0000008b,0x00000004,0x00040020,0x000000c5,0x00000003,0x00000007,
+    0x0004003b,0x000000c5,0x000000c6,0x00000003,0x00090019,0x000000ce,0x00000006,0x00000001,
+    0x00000000,0x00000001,0x00000000,0x00000001,0x00000000,0x0003001b,0x000000cf,0x000000ce,
+    0x00040020,0x000000d0,0x00000000,0x000000cf,0x0004003b,0x000000d0,0x000000d1,0x00000000,
+    0x00040017,0x000000d4,0x00000029,0x00000003,0x0004002b,0x00000029,0x000000dd,0x00000005,
+    0x0004002b,0x00000029,0x000000ed,0x00000003,0x0006002c,0x00000009,0x00000134,0x00000066,
+    0x00000066,0x00000066,0x0004002b,0x00000029,0x0000013c,0x00000006,0x0004002b,0x00000029,
+    0x00000141,0x00000007,0x0005002c,0x00000033,0x00000189,0x0000007e,0x0000007e,0x00050036,
+    0x00000002,0x00000004,0x00000000,0x00000003,0x000200f8,0x00000005,0x000300f7,0x0000015d,
+    0x00000000,0x000300fb,0x0000002c,0x0000015e,0x000200f8,0x0000015e,0x00060041,0x0000002d,
+    0x0000002e,0x00000028,0x0000002b,0x0000002c,0x0004003d,0x00000006,0x0000002f,0x0000002e,
+    0x00060041,0x0000002d,0x00000031,0x00000028,0x0000002b,0x00000030,0x0004003d,0x00000006,
+    0x00000032,0x00000031,0x00050041,0x00000036,0x00000037,0x00000035,0x0000002c,0x0004003d,
+    0x00000006,0x00000038,0x00000037,0x0008000c,0x00000006,0x00000039,0x00000001,0x0000002e,
+    0x0000002f,0x00000032,0x00000038,0x00060041,0x0000002d,0x0000003a,0x00000028,0x0000002b,
+    0x00000019,0x0004003d,0x00000006,0x0000003b,0x0000003a,0x00060041,0x0000002d,0x0000003d,
+    0x00000028,0x0000002b,0x0000003c,0x0004003d,0x00000006,0x0000003e,0x0000003d,0x00050041,
+    0x00000036,0x0000003f,0x00000035,0x00000030,0x0004003d,0x00000006,0x00000040,0x0000003f,
+    0x0008000c,0x00000006,0x00000041,0x00000001,0x0000002e,0x0000003b,0x0000003e,0x00000040,
+    0x00060050,0x00000009,0x00000043,0x00000039,0x00000041,0x00000042,0x00050041,0x00000045,
+    0x00000046,0x00000028,0x0000002a,0x0004003d,0x00000007,0x00000047,0x00000046,0x0008004f,
+    0x00000009,0x00000167,0x00000047,0x00000047,0x00000000,0x00000001,0x00000002,0x0007000c,
+    0x00000009,0x0000016b,0x00000001,0x00000044,0x00000167,0x00000043,0x00050051,0x00000006,
+    0x0000016d,0x00000047,0x00000003,0x0005008e,0x00000009,0x0000016f,0x00000043,0x0000016d,
+    0x00050081,0x00000009,0x00000170,0x0000016b,0x0000016f,0x0007000c,0x00000009,0x00000171,
+    0x00000001,0x00000044,0x00000167,0x00000170,0x0005008e,0x00000009,0x00000172,0x00000171,
+    0x00000011,0x00050081,0x00000009,0x00000173,0x00000043,0x00000172,0x0007004f,0x00000033,
+    0x0000004d,0x00000173,0x00000173,0x00000000,0x00000001,0x00050051,0x00000006,0x0000004f,
+    0x00000173,0x00000002,0x0004007f,0x00000006,0x00000050,0x0000004f,0x00050050,0x00000033,
+    0x00000051,0x00000050,0x00000050,0x00050088,0x00000033,0x00000052,0x0000004d,0x00000051,
+    0x00050041,0x00000045,0x00000054,0x00000028,0x00000053,0x0004003d,0x00000007,0x00000055,
+    0x00000054,0x0007004f,0x00000033,0x00000056,0x00000055,0x00000055,0x00000000,0x00000002,
+    0x00050083,0x00000033,0x00000057,0x00000052,0x00000056,0x0007004f,0x00000033,0x0000005a,
+    0x00000055,0x00000055,0x00000001,0x00000003,0x00050083,0x00000033,0x0000005e,0x0000005a,
+    0x00000056,0x00050088,0x00000033,0x0000005f,0x00000057,0x0000005e,0x00050051,0x00000006,
+    0x00000062,0x0000005f,0x00000001,0x00050083,0x00000006,0x00000063,0x00000060,0x00000062,
+    0x00060052,0x00000033,0x00000178,0x00000063,0x0000005f,0x00000001,0x000500b8,0x00000068,
+    0x0000006b,0x0000004f,0x00000066,0x000300f7,0x0000006d,0x00000000,0x000400fa,0x0000006b,
+    0x0000006c,0x0000006d,0x000200f8,0x0000006c,0x000500be,0x00000070,0x00000071,0x00000178,
+    0x0000006f,0x0004009b,0x00000068,0x00000072,0x00000071,0x000200f9,0x0000006d,0x000200f8,
+    0x0000006d,0x000700f5,0x00000068,0x00000073,0x0000006b,0x0000015e,0x00000072,0x0000006c,
+    0x000300f7,0x00000075,0x00000000,0x000400fa,0x00000073,0x00000074,0x00000075,0x000200f8,
+    0x00000074,0x000500bc,0x00000070,0x00000078,0x00000178,0x00000077,0x0004009b,0x00000068,
+    0x00000079,0x00000078,0x000200f9,0x00000075,0x000200f8,0x00000075,0x000700f5,0x00000068,
+    0x0000007a,0x00000073,0x0000006d,0x00000079,0x00000074,0x000300f7,0x0000007c,0x00000000,
+    0x000400fa,0x0000007a,0x0000007b,0x0000007c,0x000200f8,0x0000007b,0x0004003d,0x00000080,
+    0x00000083,0x00000082,0x00040064,0x0000007f,0x00000084,0x00000083,0x00050067,0x00000085,
+    0x00000086,0x00000084,0x0000002a,0x0004006f,0x00000033,0x00000087,0x00000086,0x00050088,
+    0x00000033,0x00000089,0x00000189,0x00000087,0x00060041,0x0000002d,0x0000008c,0x00000028,
+    0x0000008b,0x0000002c,0x0004003d,0x00000006,0x0000008d,0x0000008c,0x00050085,0x00000006,
+    0x0000008e,0x0000008d,0x0000007e,0x00070050,0x00000007,0x0000008f,0x0000008e,0x00000066,
+    0x0000007e,0x00000060,0x0007004f,0x00000033,0x00000092,0x0000008f,0x0000008f,0x00000000,
+    0x00000001,0x0007004f,0x00000033,0x00000095,0x0000008f,0x0000008f,0x00000002,0x00000003,
+    0x0008000c,0x00000033,0x00000097,0x00000001,0x00000032,0x00000178,0x00000095,0x00000092,
+    0x00050081,0x00000033,0x0000009b,0x00000092,0x00000089,0x00050081,0x00000033,0x000000a0,
+    0x00000092,0x00000095,0x00050083,0x00000033,0x000000a2,0x000000a0,0x00000089,0x0008000c,
+    0x00000033,0x000000a3,0x00000001,0x0000002b,0x00000097,0x0000009b,0x000000a2,0x00070058,
+    0x00000007,0x000000a6,0x00000083,0x000000a3,0x00000002,0x00000066,0x000200f9,0x0000007c,
+    0x000200f8,0x0000007c,0x000700f5,0x00000007,0x0000017d,0x00000067,0x00000075,0x000000a6,
+    0x0000007b,0x00060041,0x0000002d,0x000000a8,0x00000028,0x0000008b,0x0000003c,0x0004003d,
+    0x00000006,0x000000a9,0x000000a8,0x000500ba,0x00000068,0x000000aa,0x000000a9,0x00000066,
+    0x000300f7,0x000000ad,0x00000000,0x000400fa,0x000000aa,0x000000ac,0x000000b0,0x000200f8,
+    0x000000ac,0x00050051,0x00000006,0x000000af,0x0000017d,0x00000003,0x000200f9,0x000000ad,
+    0x000200f8,0x000000b0,0x000200f9,0x000000ad,0x000200f8,0x000000ad,0x000700f5,0x00000006,
+    0x00000180,0x000000af,0x000000ac,0x00000060,0x000000b0,0x00060041,0x0000002d,0x000000b3,
+    0x00000028,0x0000008b,0x00000019,0x0004003d,0x00000006,0x000000b4,0x000000b3,0x000500ba,
+    0x00000068,0x000000b5,0x000000b4,0x00000066,0x000300f7,0x000000b8,0x00000000,0x000400fa,
+    0x000000b5,0x000000b7,0x000000bd,0x000200f8,0x000000b7,0x0008004f,0x00000009,0x000000ba,
+    0x0000017d,0x0000017d,0x00000000,0x00000001,0x00000002,0x0005008e,0x00000009,0x000000bc,
+    0x000000ba,0x00000180,0x000200f9,0x000000b8,0x000200f8,0x000000bd,0x0008004f,0x00000009,
+    0x000000bf,0x0000017d,0x0000017d,0x00000000,0x00000001,0x00000002,0x000200f9,0x000000b8,
+    0x000200f8,0x000000b8,0x000700f5,0x00000009,0x00000182,0x000000bc,0x000000b7,0x000000bf,
+    0x000000bd,0x000500b4,0x00000068,0x000000c2,0x00000180,0x00000060,0x000300f7,0x000000c4,
+    0x00000000,0x000400fa,0x000000c2,0x000000c3,0x000000c4,0x000200f8,0x000000c3,0x00050051,
+    0x00000006,0x000000c8,0x00000182,0x00000000,0x00050051,0x00000006,0x000000c9,0x00000182,
+    0x00000001,0x00050051,0x00000006,0x000000ca,0x00000182,0x00000002,0x00070050,0x00000007,
+    0x000000cb,0x000000c8,0x000000c9,0x000000ca,0x00000060,0x0003003e,0x000000c6,0x000000cb,
+    0x000200f9,0x0000015d,0x000200f8,0x000000c4,0x0004003d,0x000000cf,0x000000d2,0x000000d1,
+    0x00040064,0x000000ce,0x000000d3,0x000000d2,0x00050067,0x000000d4,0x000000d5,0x000000d3,
+    0x0000002a,0x0007004f,0x00000085,0x000000d6,0x000000d5,0x000000d5,0x00000000,0x00000001,
+    0x0004006f,0x00000033,0x000000d7,0x000000d6,0x00050088,0x00000033,0x000000d9,0x00000189,
+    0x000000d7,0x00060041,0x0000002d,0x000000de,0x00000028,0x000000dd,0x0000003c,0x0004003d,
+    0x00000006,0x000000df,0x000000de,0x000500ba,0x00000068,0x000000e0,0x000000df,0x00000066,
+    0x000300f7,0x000000e3,0x00000000,0x000400fa,0x000000e0,0x000000e2,0x000000e7,0x000200f8,
+    0x000000e2,0x00050083,0x00000006,0x000000e6,0x00000060,0x00000040,0x000200f9,0x000000e3,
+    0x000200f8,0x000000e7,0x000200f9,0x000000e3,0x000200f8,0x000000e3,0x000700f5,0x00000006,
+    0x00000183,0x000000e6,0x000000e2,0x00000040,0x000000e7,0x00050050,0x00000033,0x000000eb,
+    0x00000038,0x00000183,0x00050041,0x00000045,0x000000ee,0x00000028,0x000000ed,0x0004003d,
+    0x00000007,0x000000ef,0x000000ee,0x0007004f,0x00000033,0x000000f0,0x000000ef,0x000000ef,
+    0x00000000,0x00000001,0x0007004f,0x00000033,0x000000f4,0x000000ef,0x000000ef,0x00000002,
+    0x00000003,0x0008000c,0x00000033,0x000000f6,0x00000001,0x00000032,0x000000eb,0x000000f4,
+    0x000000f0,0x00050081,0x00000033,0x000000fb,0x000000f0,0x000000d9,0x00050081,0x00000033,
+    0x00000102,0x000000f0,0x000000f4,0x00050083,0x00000033,0x00000104,0x00000102,0x000000d9,
+    0x0008000c,0x00000033,0x00000105,0x00000001,0x0000002b,0x000000f6,0x000000fb,0x00000104,
+    0x00060041,0x0000002d,0x00000109,0x00000028,0x0000008b,0x00000030,0x0004003d,0x00000006,
+    0x0000010a,0x00000109,0x00050051,0x00000006,0x0000010b,0x00000105,0x00000000,0x00050051,
+    0x00000006,0x0000010c,0x00000105,0x00000001,0x00060050,0x00000009,0x0000010d,0x0000010b,
+    0x0000010c,0x0000010a,0x00070058,0x00000007,0x0000010e,0x000000d2,0x0000010d,0x00000002,
+    0x00000066,0x00060041,0x0000002d,0x00000110,0x00000028,0x000000dd,0x0000002c,0x0004003d,
+    0x00000006,0x00000111,0x00000110,0x000500ba,0x00000068,0x00000112,0x00000111,0x00000066,
+    0x000300f7,0x00000115,0x00000000,0x000400fa,0x00000112,0x00000114,0x00000118,0x000200f8,
+    0x00000114,0x00050051,0x00000006,0x00000117,0x0000010e,0x00000003,0x000200f9,0x00000115,
+    0x000200f8,0x00000118,0x000200f9,0x00000115,0x000200f8,0x00000115,0x000700f5,0x00000006,
+    0x00000184,0x00000117,0x00000114,0x00000060,0x00000118,0x00060041,0x0000002d,0x0000011b,
+    0x00000028,0x000000dd,0x00000030,0x0004003d,0x00000006,0x0000011c,0x0000011b,0x000500ba,
+    0x00000068,0x0000011d,0x0000011c,0x00000066,0x000300f7,0x00000120,0x00000000,0x000400fa,
+    0x0000011d,0x0000011f,0x00000125,0x000200f8,0x0000011f,0x0008004f,0x00000009,0x00000122,
+    0x0000010e,0x0000010e,0x00000000,0x00000001,0x00000002,0x0005008e,0x00000009,0x00000124,
+    0x00000122,0x00000184,0x000200f9,0x00000120,0x000200f8,0x00000125,0x0008004f,0x00000009,
+    0x00000127,0x0000010e,0x0000010e,0x00000000,0x00000001,0x00000002,0x000200f9,0x00000120,
+    0x000200f8,0x00000120,0x000700f5,0x00000009,0x00000185,0x00000124,0x0000011f,0x00000127,
+    0x00000125,0x000500ba,0x00000068,0x0000012b,0x00000184,0x00000066,0x000300f7,0x0000012e,
+    0x00000000,0x000400fa,0x0000012b,0x0000012d,0x00000133,0x000200f8,0x0000012d,0x00060050,
+    0x00000009,0x00000131,0x00000184,0x00000184,0x00000184,0x00050088,0x00000009,0x00000132,
+    0x00000185,0x00000131,0x000200f9,0x0000012e,0x000200f8,0x00000133,0x000200f9,0x0000012e,
+    0x000200f8,0x0000012e,0x000700f5,0x00000009,0x00000187,0x00000132,0x0000012d,0x00000134,
+    0x00000133,0x00050051,0x00000006,0x00000137,0x00000187,0x00000000,0x00050051,0x00000006,
+    0x00000138,0x00000187,0x00000001,0x00050051,0x00000006,0x00000139,0x00000187,0x00000002,
+    0x00070050,0x00000007,0x0000013a,0x00000137,0x00000138,0x00000139,0x00000184,0x00050041,
+    0x00000045,0x0000013d,0x00000028,0x0000013c,0x0004003d,0x00000007,0x0000013e,0x0000013d,
+    0x0007000c,0x00000007,0x0000013f,0x00000001,0x00000028,0x0000013e,0x00000067,0x00050041,
+    0x00000045,0x00000142,0x00000028,0x00000141,0x0004003d,0x00000007,0x00000143,0x00000142,
+    0x0008000c,0x00000007,0x00000144,0x00000001,0x00000032,0x0000013a,0x0000013f,0x00000143,
+    0x00050051,0x00000006,0x00000146,0x00000144,0x00000003,0x0008004f,0x00000009,0x00000148,
+    0x00000144,0x00000144,0x00000000,0x00000001,0x00000002,0x0005008e,0x00000009,0x0000014a,
+    0x00000148,0x00000146,0x00050083,0x00000006,0x0000014f,0x00000060,0x00000180,0x0005008e,
+    0x00000009,0x00000150,0x0000014a,0x0000014f,0x00050081,0x00000009,0x00000151,0x00000182,
+    0x00000150,0x0008000c,0x00000006,0x00000157,0x00000001,0x00000032,0x00000146,0x0000014f,
+    0x00000180,0x00050051,0x00000006,0x00000158,0x00000151,0x00000000,0x00050051,0x00000006,
+    0x00000159,0x00000151,0x00000001,0x00050051,0x00000006,0x0000015a,0x00000151,0x00000002,
+    0x00070050,0x00000007,0x0000015b,0x00000158,0x00000159,0x0000015a,0x00000157,0x0003003e,
+    0x000000c6,0x0000015b,0x000200f9,0x0000015d,0x000200f8,0x0000015d,0x000100fd,0x00010038,
 };
@@ -75,13 +75,15 @@ static int surf_native_load(void) {
    return sn.client && sn.create && sn.destroy && sn.bind;
 }
 static void surf_native_slot_destroy(surf_native_slot *slot) {
+    if(slot->srgb_view)sn.destroy_view(vk.device,slot->srgb_view,NULL);
+    slot->srgb_view=VK_NULL_HANDLE;
    if(slot->view)sn.destroy_view(vk.device,slot->view,NULL);
    if(slot->image)sn.destroy_image(vk.device,slot->image,NULL);
    if(slot->memory)sn.free_memory(vk.device,slot->memory,NULL);
    if(slot->buffer)sn.release(slot->buffer);
    slot->view=VK_NULL_HANDLE;slot->image=VK_NULL_HANDLE;slot->memory=VK_NULL_HANDLE;slot->buffer=NULL;
 }
-static int surf_native_allocate(surf_native_slot *slot,EGLDisplay display,uint32_t width,uint32_t height) {
+static int surf_native_allocate(surf_native_slot *slot,EGLDisplay display,uint32_t width,uint32_t height,int projected) {
    AHardwareBuffer_Desc desc={.width=width,.height=height,.layers=1,
        .format=AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM,
        .usage=AHARDWAREBUFFER_USAGE_GPU_SAMPLED_IMAGE|AHARDWAREBUFFER_USAGE_GPU_COLOR_OUTPUT};
@@ -91,11 +93,14 @@ static int surf_native_allocate(surf_native_slot *slot,EGLDisplay display,uint32
    if(sn.properties(vk.device,slot->buffer,&props)!=VK_SUCCESS || format.format!=VK_FORMAT_R8G8B8A8_UNORM)goto fail;
    VkExternalMemoryImageCreateInfo external={VK_STRUCTURE_TYPE_EXTERNAL_MEMORY_IMAGE_CREATE_INFO,NULL,
        VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID};
-    VkImageCreateInfo image={VK_STRUCTURE_TYPE_IMAGE_CREATE_INFO,&external,0,VK_IMAGE_TYPE_2D,format.format,
+    VkImageCreateInfo image={VK_STRUCTURE_TYPE_IMAGE_CREATE_INFO,&external,projected?VK_IMAGE_CREATE_MUTABLE_FORMAT_BIT:0,VK_IMAGE_TYPE_2D,format.format,
        {width,height,1},1,1,VK_SAMPLE_COUNT_1_BIT,VK_IMAGE_TILING_OPTIMAL,
        VK_IMAGE_USAGE_SAMPLED_BIT|VK_IMAGE_USAGE_COLOR_ATTACHMENT_BIT|VK_IMAGE_USAGE_TRANSFER_SRC_BIT,
        VK_SHARING_MODE_EXCLUSIVE,0,NULL,VK_IMAGE_LAYOUT_UNDEFINED};
-    if(sn.create_image(vk.device,&image,NULL,&slot->image)!=VK_SUCCESS)goto fail;
+    if(sn.create_image(vk.device,&image,NULL,&slot->image)!=VK_SUCCESS) {
+        image.flags=0;projected=0;
+        if(sn.create_image(vk.device,&image,NULL,&slot->image)!=VK_SUCCESS)goto fail;
+    }
    uint32_t type=0;while(type<32 && !(props.memoryTypeBits&(1u<<type)))type++;
    if(type==32)goto fail;
    VkImportAndroidHardwareBufferInfoANDROID imported={VK_STRUCTURE_TYPE_IMPORT_ANDROID_HARDWARE_BUFFER_INFO_ANDROID,NULL,slot->buffer};
@@ -106,6 +111,10 @@ static int surf_native_allocate(surf_native_slot *slot,EGLDisplay display,uint32
    VkImageViewCreateInfo view={VK_STRUCTURE_TYPE_IMAGE_VIEW_CREATE_INFO,NULL,0,slot->image,VK_IMAGE_VIEW_TYPE_2D,
        format.format,{0,0,0,0},{VK_IMAGE_ASPECT_COLOR_BIT,0,1,0,1}};
    if(sn.create_view(vk.device,&view,NULL,&slot->view)!=VK_SUCCESS)goto fail;
+    if(projected) {
+        view.format=VK_FORMAT_R8G8B8A8_SRGB;
+        if(sn.create_view(vk.device,&view,NULL,&slot->srgb_view)!=VK_SUCCESS)slot->srgb_view=VK_NULL_HANDLE;
+    }
    slot->egl_image=sn.create(display,EGL_NO_CONTEXT,EGL_NATIVE_BUFFER_ANDROID,sn.client(slot->buffer),NULL);
    if(slot->egl_image==EGL_NO_IMAGE_KHR)goto fail;
    p_glGenTextures(1,&slot->texture);p_glBindTexture(GL_TEXTURE_2D,slot->texture);
@@ -239,7 +248,7 @@ static void surf_native_worker(surf_swapchain *s,JNIEnv *env,EGLDisplay display)
            if(slot->texture)p_glDeleteTextures(1,&slot->texture);
            if(slot->egl_image)sn.destroy(display,slot->egl_image);
            slot->texture=0;slot->egl_image=EGL_NO_IMAGE_KHR;surf_native_slot_destroy(slot);
-            if(!surf_native_allocate(slot,display,width,height))goto fail;
+            if(!surf_native_allocate(slot,display,width,height,s->native_project))goto fail;
            LOG("surface_native: %ux%u decoded input -> %ux%u shared view",desc.width,desc.height,width,height);
        }
        p_glBindFramebuffer(GL_FRAMEBUFFER,fbo);
@@ -295,11 +304,12 @@ done:
 static void surf_native_complete(surf_swapchain *s) {
    pthread_mutex_lock(&surf_lock);
    if(s->native_pending>=0)s->native_slots[s->native_pending].state=0;
+    for(int i=0;i<SURF_NATIVE_SLOTS;i++)if(s->native_slots[i].state==4)s->native_slots[i].state=0;
    s->native_pending=-1;pthread_mutex_unlock(&surf_lock);
 }
 static void surf_native_ownership(VkCommandBuffer command,surf_native_slot *slot,int acquire) {
-    VkAccessFlags access=slot->projected?VK_ACCESS_TRANSFER_READ_BIT:VK_ACCESS_SHADER_READ_BIT;
-    VkImageLayout layout=slot->projected?VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL:VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL;
+    VkAccessFlags access=slot->projected && !slot->sampled?VK_ACCESS_TRANSFER_READ_BIT:VK_ACCESS_SHADER_READ_BIT;
+    VkImageLayout layout=slot->projected && !slot->sampled?VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL:VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL;
    VkImageMemoryBarrier barrier={VK_STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER,NULL,
        acquire?0:access,acquire?access:0,
        acquire?VK_IMAGE_LAYOUT_GENERAL:layout,
@@ -112,6 +112,25 @@ static void surf_projection_destroy(surf_swapchain *s) {
    }
    memset(p,0,sizeof(*p));
 }
+// Only adapter-owned video swapchains receive this profile. Application eye
+// buffers retain their selected foveation and gaze tracking.
+static void surf_video_full_rate(XrSession session, XrSwapchain output) {
+    PFN_xrCreateFoveationProfileFB create = (PFN_xrCreateFoveationProfileFB)lookup(active_instance,"xrCreateFoveationProfileFB");
+    PFN_xrDestroyFoveationProfileFB destroy = (PFN_xrDestroyFoveationProfileFB)lookup(active_instance,"xrDestroyFoveationProfileFB");
+    PFN_xrUpdateSwapchainFB update = (PFN_xrUpdateSwapchainFB)lookup(active_instance,"xrUpdateSwapchainFB");
+    if (!create || !destroy || !update) return;
+    XrFoveationLevelProfileCreateInfoFB level = {XR_TYPE_FOVEATION_LEVEL_PROFILE_CREATE_INFO_FB,
+        NULL,XR_FOVEATION_LEVEL_NONE_FB,0,XR_FOVEATION_DYNAMIC_DISABLED_FB};
+    XrFoveationProfileCreateInfoFB ci = {XR_TYPE_FOVEATION_PROFILE_CREATE_INFO_FB,&level};
+    XrFoveationProfileFB profile = XR_NULL_HANDLE;
+    XrResult result = create(session,&ci,&profile);
+    if (XR_SUCCEEDED(result)) {
+        XrSwapchainStateFoveationFB state = {XR_TYPE_SWAPCHAIN_STATE_FOVEATION_FB,NULL,0,profile};
+        result = update(output,(const XrSwapchainStateBaseHeaderFB *)&state);
+        destroy(profile);
+    }
+    LOG("surface_video: full-rate runtime profile result=%d",result);
+}
 static int surf_projection_setup(XrSession session,surf_swapchain *s,surf_projection *p,uint32_t width,uint32_t height) {
    if(p->pipeline || (s->native_project && p->output))return 1;
    if(!surf_vk_ready() || !surf_staging(s) || !surf_projection_functions())return 0;
@@ -131,6 +150,7 @@ static int surf_projection_setup(XrSession session,surf_swapchain *s,surf_projec
        if(create_failures++<5)LOG("surface_projection: swapchain creation result=%d",xr_result);
        goto fail;
    }
+    surf_video_full_rate(session,p->output);
    stage="runtime image enumeration";
    XrSwapchainImageVulkanKHR images[MAX_IMAGES];
    for(int i=0;i<MAX_IMAGES;i++)images[i]=(XrSwapchainImageVulkanKHR){XR_TYPE_SWAPCHAIN_IMAGE_VULKAN_KHR,NULL,VK_NULL_HANDLE};
@@ -322,6 +342,8 @@ static const XrCompositionLayerBaseHeader *surf_video_present(XrSession session,
    PFN_xrReleaseSwapchainImage release=(PFN_xrReleaseSwapchainImage)lookup(active_instance,"xrReleaseSwapchainImage");
    int compose=surf_composite_candidate(info,layer);
    int cached_only=compose && surf_composite_cached_only(info,p,&native->video,&current);
+    int direct=cached_only && native->srgb_view;
+    int previous=s->native_current;
    XrSwapchainImageAcquireInfo ai={XR_TYPE_SWAPCHAIN_IMAGE_ACQUIRE_INFO};
    XrSwapchainImageWaitInfo wi={XR_TYPE_SWAPCHAIN_IMAGE_WAIT_INFO,NULL,0};
    XrSwapchainImageReleaseInfo ri={XR_TYPE_SWAPCHAIN_IMAGE_RELEASE_INFO};uint32_t index;
@@ -338,25 +360,32 @@ static const XrCompositionLayerBaseHeader *surf_video_present(XrSession session,
    if(!cached_only && index>=p->count){release(p->output,&ri);p->acquired=0;goto unused;}
    VkCommandBufferBeginInfo begin={VK_STRUCTURE_TYPE_COMMAND_BUFFER_BEGIN_INFO,NULL,VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT};
    vk.ResetCommandBuffer(s->cmd,0);vk.BeginCommandBuffer(s->cmd,&begin);
+    native->sampled=direct;
    surf_native_ownership(s->cmd,native,1);
    if(!cached_only)surf_barrier(s->cmd,p->images[index],VK_IMAGE_LAYOUT_UNDEFINED,VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL,0,VK_ACCESS_TRANSFER_WRITE_BIT);
    VkImageCopy copy={{VK_IMAGE_ASPECT_COLOR_BIT,0,0,1},{0,0,0},{VK_IMAGE_ASPECT_COLOR_BIT,0,0,1},{0,0,0},{2*p->size,p->size,1}};
    if(!cached_only)spvk.CmdCopyImage(s->cmd,native->image,VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL,p->images[index],VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL,1,&copy);
-    if(compose){
+    if(compose && !direct){
        surf_barrier(s->cmd,p->video_cache,p->cache_ready?VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL:VK_IMAGE_LAYOUT_UNDEFINED,
        VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL,p->cache_ready?VK_ACCESS_SHADER_READ_BIT:0,VK_ACCESS_TRANSFER_WRITE_BIT);
    spvk.CmdCopyImage(s->cmd,native->image,VK_IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL,p->video_cache,VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL,1,&copy);
    surf_barrier(s->cmd,p->video_cache,VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL,VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL,
        VK_ACCESS_TRANSFER_WRITE_BIT,VK_ACCESS_SHADER_READ_BIT);
    }
-    surf_native_ownership(s->cmd,native,0);
+    if(!direct)surf_native_ownership(s->cmd,native,0);
+    if(previous>=0)surf_native_ownership(s->cmd,&s->native_slots[previous],0);
    if(!cached_only)surf_barrier(s->cmd,p->images[index],VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL,VK_IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL,
        VK_ACCESS_TRANSFER_WRITE_BIT,VK_ACCESS_COLOR_ATTACHMENT_READ_BIT|VK_ACCESS_COLOR_ATTACHMENT_WRITE_BIT);
    vk.EndCommandBuffer(s->cmd);
    VkSubmitInfo submit={VK_STRUCTURE_TYPE_SUBMIT_INFO,NULL,0,NULL,NULL,1,&s->cmd};
    int ok=vk.QueueSubmit(vk.queue,1,&submit,s->fence)==VK_SUCCESS;
    if(!cached_only){release(p->output,&ri);p->acquired=0;}if(!ok)goto unused;
-    s->native_pending=slot;s->in_flight=1;s->uploads++;if(compose){p->cache_ready=1;p->cached_job=native->video;}
+    pthread_mutex_lock(&surf_lock);
+    if(previous>=0)s->native_slots[previous].state=4; // reusable only after the handoff fence
+    s->native_current=direct?slot:-1;
+    pthread_mutex_unlock(&surf_lock);
+    s->native_pending=direct?-1:slot;s->in_flight=1;s->uploads++;
+    if(direct && s->uploads%300==2)LOG("surface_video: direct shared-buffer sampling; cache copy skipped");if(compose){p->cache_ready=1;p->cached_job=native->video;}
    p->width=native->source_width;p->height=native->source_height;p->source_seq=native->seq;p->source_ready=1;
    for(int eye=0;eye<2;eye++)p->eyes[eye]=(XrCompositionLayerProjectionView){XR_TYPE_COMPOSITION_LAYER_PROJECTION_VIEW,NULL,
        native->video.views[eye].pose,native->video.views[eye].fov,
@@ -24,17 +24,17 @@
 typedef struct {
    AHardwareBuffer *buffer;
    VkImage image;
-    VkImageView view;
+    VkImageView view, srgb_view;
    VkDeviceMemory memory;
    EGLImageKHR egl_image;
    GLuint texture;
    uint32_t width,height;
-    int state; // 0 reusable, 1 worker writing, 2 published, 3 current/pending Vulkan sampler
+    int state; // 0 reusable, 1 worker writing, 2 published, 3 current/pending Vulkan sampler, 4 awaiting release fence
    uint64_t seq;
    uint32_t source_width,source_height;
    int64_t source_time;
    surf_video_job video;
-    int projected;
+    int projected, sampled;
 } surf_native_slot;

 #define SURF_MAX 8
@@ -10,7 +10,7 @@ timefix OpenXR layer for Proton games (linux-arm64, glibc; the NDK's clang build
 OculusHMDConnected helper for Rift games under Proton (win-x64 PE; the NDK's clang + lld-link, no Windows SDK), the
 live view's hardware H.264 encoder fp_venc (linux-arm64-bin, static freestanding executable), and rewrites artifacts/SHA256SUMS. Run `frameport parity` afterwards to see which games change.

-    python native/build.py [--only adapter,bridge,compat,langpack,glshim,eglfmt,glmv,ovrtrace,dex,xrlayer,oculushmd,xrshim,vkshim,zinkfix,ovrpshim,vrsettings,venc,vroverlay_probe] [--ndk PATH]
+    python native/build.py [--only adapter,bridge,compat,langpack,glshim,eglfmt,glmv,ovrtrace,dex,xrlayer,oculushmd,xrshim,vkshim,zinkfix,foveation,ovrpshim,tlskeys,vrsettings,venc,vroverlay_probe] [--ndk PATH]
 """
 from __future__ import annotations

@@ -21,6 +21,7 @@ import platform
 import re
 import shutil
 import subprocess
+import struct
 import sys
 import urllib.request
 import zipfile
@@ -133,6 +134,20 @@ def exe(tc: Path, name: str) -> Path:

 def build_adapter(tc: Path):
    src = HERE / "adapter"
+    shader_tools = tc.parents[3] / "shader-tools" / tc.name
+    suffix = ".exe" if os.name == "nt" else ""
+    sections = ["// Generated from surface_composite.vert and surface_composite.frag.\n"]
+    for stage in ("vert", "frag"):
+        binary = CACHE / f"surface_composite_{stage}.spv"
+        run([shader_tools / ("glslc" + suffix), "--target-env=vulkan1.0", "-O",
+             src / f"surface_composite.{stage}", "-o", binary])
+        run([shader_tools / ("spirv-val" + suffix), "--target-env", "vulkan1.0", binary])
+        data = binary.read_bytes()
+        words = struct.unpack(f"<{len(data)//4}I", data)
+        sections.append(f"static const uint32_t surface_composite_{stage}_spv[] = {{\n" +
+                        "\n".join("    " + ",".join(f"0x{v:08x}" for v in words[i:i+8]) + ","
+                                  for i in range(0, len(words), 8)) + "\n};\n")
+    (src / "surface_composite_spv.h").write_text("".join(sections), encoding="utf-8")
    run([sys.executable, src / "gen_forwarders.py"])
    inc = openxr_include("adapter")
    common = ["-shared", "-fPIC", "-O2", "-Wall", "-Wextra", "-Werror", "-Wno-gnu-conditional-omitted-operand",
@@ -246,7 +261,7 @@ def build_vroverlay_probe(tc: Path):
         f"/out:{work / 'fp_vroverlay_probe.exe'}"])


-def build_bridge(tc: Path):
+def build_bridge(tc: Path, output="libvrapi.so"):
    src = HERE / "vrapi-bridge"
    inc = openxr_include("bridge")
    run([tc / "bin/clang++", "--target=aarch64-linux-android29", f"--sysroot={tc / 'sysroot'}", "-std=c++17", "-O2", "-g",
@@ -257,7 +272,7 @@ def build_bridge(tc: Path):
         "-DXR_USE_GRAPHICS_API_VULKAN", "-DXR_USE_GRAPHICS_API_OPENGL_ES", "-DXR_USE_TIMESPEC", f"-I{inc}", "-shared",
         "-static-libstdc++", "runtime.cpp", "graphics.cpp", "input.cpp", "-Wl,--no-undefined",
         "-Wl,-z,max-page-size=16384", "-Wl,--version-script=exports.map", "-llog", "-landroid", "-lvulkan", "-lEGL",
-         "-lGLESv3", "-ldl", "-o", ART / "arm64-v8a/libvrapi.so"], cwd=src)
+         "-lGLESv3", "-ldl", "-o", ART / f"arm64-v8a/{output}"], cwd=src)


 def build_compat(tc: Path):
@@ -339,6 +354,16 @@ def build_zinkfix(tc: Path):
         "-ldl", "-llog", "-o", ART / "arm64-v8a/libVkLayer_fp_shaderfix.so"], cwd=src)


+def build_foveation(tc: Path):
+    """Optional coarse-fragment visualization, injected into a game's renderer."""
+    build_bridge(tc, "libvrapi_foveation.so")
+    src = HERE / "foveation"
+    run([exe(tc, "aarch64-linux-android29-clang"), "-shared", "-fPIC", "-O2", "-Wall", "-Wextra", "-Werror",
+         "-fvisibility=hidden", f"-ffile-prefix-map={src}=native/foveation",
+         "-Wl,-soname,libVkLayer_fdm_darken.so", "-Wl,-z,max-page-size=16384", "darken.c",
+         "-ldl", "-llog", "-o", ART / "arm64-v8a/libVkLayer_fdm_darken.so"], cwd=src)
+
+
 def build_ovrpshim(tc: Path):
    """OVRPlugin frame-loop shim (see ovrpshim/ovrpshim.c) for Unity 2017-2018 built-in Oculus support."""
    src = HERE / "ovrpshim"
@@ -347,6 +372,14 @@ def build_ovrpshim(tc: Path):
         "-llog", "-o", ART / "arm64-v8a/libfp_ovrp.so"], cwd=src)


+def build_tlskeys(tc: Path):
+    """Thread-key pool for Unity (see tlskeys/tlskeys.c, patch frame.unity_tls_key_pool)."""
+    src = HERE / "tlskeys"
+    run([exe(tc, "aarch64-linux-android29-clang"), "-shared", "-fPIC", "-O2", "-Wall", "-Wextra", "-Werror",
+         "-fvisibility=hidden", f"-ffile-prefix-map={HERE}=native", "-Wl,-soname,libfp_tkeys.so",
+         "-Wl,-z,max-page-size=16384", "tlskeys.c", "-llog", "-o", ART / "arm64-v8a/libfp_tkeys.so"], cwd=src)
+
+
 def build_dex():
    javac = shutil.which("javac")
    if not javac:
@@ -391,7 +424,7 @@ def write_sums():

 def main():
    ap = argparse.ArgumentParser()
-    ap.add_argument("--only", default="adapter,bridge,compat,langpack,glshim,eglfmt,glmv,ovrtrace,dex,xrlayer,oculushmd,xrshim,vkshim,zinkfix,ovrpshim,vrsettings,venc")
+    ap.add_argument("--only", default="adapter,bridge,compat,langpack,glshim,eglfmt,glmv,ovrtrace,dex,xrlayer,oculushmd,xrshim,vkshim,zinkfix,foveation,ovrpshim,tlskeys,vrsettings,venc")
    ap.add_argument("--ndk")
    args = ap.parse_args()
    parts = set(args.only.split(","))
@@ -403,10 +436,11 @@ def main():
             "glshim": lambda: build_glshim(tc), "eglfmt": lambda: build_eglfmt(tc), "glmv": lambda: build_glmv(tc), "ovrtrace": lambda: build_ovrtrace(tc), "xrshim": lambda: build_xrshim(tc), "dex": build_dex, "xrlayer": lambda: build_xrlayer(tc),
             "oculushmd": lambda: build_oculushmd(tc), "vkshim": lambda: build_vkshim(tc),
             "zinkfix": lambda: build_zinkfix(tc),
-             "ovrpshim": lambda: build_ovrpshim(tc),
+             "foveation": lambda: build_foveation(tc),
+             "ovrpshim": lambda: build_ovrpshim(tc), "tlskeys": lambda: build_tlskeys(tc),
             "vrsettings": lambda: build_vrsettings(tc), "venc": lambda: build_venc(tc),
             "vroverlay_probe": lambda: build_vroverlay_probe(tc)}
-    for name in ("adapter", "bridge", "compat", "langpack", "glshim", "eglfmt", "glmv", "ovrtrace", "xrshim", "vkshim", "zinkfix", "ovrpshim", "dex", "xrlayer", "oculushmd", "vrsettings", "venc",
+    for name in ("adapter", "bridge", "compat", "langpack", "glshim", "eglfmt", "glmv", "ovrtrace", "xrshim", "vkshim", "zinkfix", "foveation", "ovrpshim", "tlskeys", "dex", "xrlayer", "oculushmd", "vrsettings", "venc",
                 "vroverlay_probe"):
        if name in parts:
            log(f"build {name}")
@@ -0,0 +1,58 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Climb-only workaround for the verified renderer and Valve layer, never a global driver edit.
+#include <sys/mman.h>
+#include <unistd.h>
+#include "sha256.h"
+static void climb_disable_foveation(const char *reason) {
+    unsetenv("ENABLE_VULKAN_FDM_INJECTION_LAYER");
+    setenv("DISABLE_VULKAN_FDM_INJECTION_LAYER", "1", 1);
+    unsetenv("FDM_DEBUG");
+    LOG("CLIMB foveation disabled: %s", reason);
+}
+static void climb_stereo_fix(void) {
+    const char *enabled=getenv("FRAMEPORT_CLIMB_STEREO_OFFSETS");
+    if (!enabled || strcmp(enabled,"1")) return;
+    char process[128] = {0};
+    FILE *cmd = fopen("/proc/self/cmdline", "rb");
+    if (!cmd) return;
+    size_t n = fread(process, 1, sizeof(process)-1, cmd); fclose(cmd);
+    if (!n || strcmp(process, "com.crytek.climb2")) return;
+    void *h=dlopen("libVkLayer_VALVE_fdm_injection.so",RTLD_NOW|RTLD_LOCAL);
+    void *sym=h?dlsym(h,"vkGetInstanceProcAddr"):NULL;
+    Dl_info di;
+    if (!sym || !dladdr(sym,&di)) { climb_disable_foveation("layer not found");return; }
+    // Exact verified Valve binary. Never guess offsets after a SteamOS update.
+    FILE *file = fopen(di.dli_fname, "rb");
+    unsigned char digest[32];
+    int verified = 0;
+    if (file && !fseek(file, 0, SEEK_END)) {
+        long size = ftell(file);
+        if (size > 0 && size <= 16*1024*1024 && !fseek(file, 0, SEEK_SET)) {
+            unsigned char *bytes = malloc((size_t)size);
+            if (bytes && fread(bytes, 1, (size_t)size, file) == (size_t)size) {
+                sha256(bytes, (size_t)size, digest);
+                static const unsigned char expected[32] = {0x55,0x76,0x28,0x8e,0x08,0x20,0x5d,0xea,0xfd,0xe2,0x20,0x3d,0xbe,0xe2,0x5e,0x77,0x16,0x9c,0x5e,0xe4,0x8f,0xb6,0xaf,0xdb,0xe1,0xb5,0x76,0x11,0xbb,0x2a,0x48,0xb4};
+                verified = !memcmp(digest, expected, 32);
+            }
+            free(bytes);
+        }
+    }
+    if (file) fclose(file);
+    if (!verified) { climb_disable_foveation("unsupported Valve library"); return; }
+    unsigned char *base=di.dli_fbase;
+    uint32_t *count=(void*)(base+0x1abdc), *mask=(void*)(base+0x1b6e4);
+    uint32_t *next1=(void*)(base+0x1ada0), *next2=(void*)(base+0x1ae48);
+    if (*count!=0xb9403a89u || *mask!=0xb9403e75u || *next1!=0xb40000cau || *next2!=0xb40000cau) {climb_disable_foveation("instruction mismatch");return;}
+    long page=sysconf(_SC_PAGESIZE);
+    if (page <= 0) { climb_disable_foveation("invalid page size"); return; }
+    uintptr_t lo=(uintptr_t)count&~((uintptr_t)page-1);
+    uintptr_t hi=((uintptr_t)mask+4+page-1)&~((uintptr_t)page-1);
+    if(mprotect((void*)lo,hi-lo,PROT_READ|PROT_WRITE|PROT_EXEC)) {climb_disable_foveation("mprotect failed");return;}
+    *count=0x52800049u; // mov w9, #2: one offset for each FDM array layer
+    *next1=0x14000006u; // skip invalid mask-table read; stereo end mask is explicit
+    *next2=0x14000006u;
+    *mask=0x52800075u;  // mov w21, #3: calculate offsets for both eyes
+    __builtin___clear_cache((char*)lo,(char*)hi);
+    mprotect((void*)lo,hi-lo,PROT_READ|PROT_EXEC);
+    LOG("CLIMB stereo fix: two density-map offsets + safe subpass bookkeeping enabled in this process");
+}
@@ -0,0 +1,258 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Optional actual-fragment-density visualization. Loaded only by test-mode APKs.
+#define _GNU_SOURCE
+#include <vulkan/vulkan.h>
+#include <vulkan/vk_layer.h>
+extern int __android_log_print(int,const char*,const char*,...);
+#define ANDROID_LOG_INFO 4
+#include <dlfcn.h>
+#include <errno.h>
+#include <pthread.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <sys/stat.h>
+
+#define TAG "FoveationDarken"
+#define EXPORT __attribute__((visibility("default")))
+#define LOG(...) __android_log_print(ANDROID_LOG_INFO, TAG, __VA_ARGS__)
+#define LAYER_NAME "VK_LAYER_FRAMEPORT_fdm_darken"
+
+
+#include "fdm_darken.h"
+static int lock,nfixes,dump;
+static void take_lock(int*p){while(__atomic_exchange_n(p,1,__ATOMIC_ACQUIRE)){}}
+static void drop_lock(int*p){__atomic_store_n(p,0,__ATOMIC_RELEASE);}
+#define MAX_HANDLES 16
+static struct { void *key; VkInstance instance; PFN_vkGetInstanceProcAddr gipa; } instances[MAX_HANDLES];
+static struct { void *key; VkDevice device; PFN_vkGetDeviceProcAddr gdpa; PFN_vkCreateShaderModule create_shader; } devices[MAX_HANDLES];
+
+static void *key_of(const void *handle) { return handle ? *(void *const *)handle : NULL; }
+
+static PFN_vkGetInstanceProcAddr instance_gipa(const void *handle, VkInstance *instance) {
+    void *key = key_of(handle);
+    PFN_vkGetInstanceProcAddr found = NULL, last = NULL;
+    take_lock(&lock);
+    for (int i = 0; i < MAX_HANDLES; i++) {
+        if (!instances[i].gipa) continue;
+        last = instances[i].gipa;
+        if (instance) *instance = instances[i].instance;
+        if (instances[i].key == key) { found = instances[i].gipa; break; }
+    }
+    drop_lock(&lock);
+    return found ? found : last;  // a physical device: its instance (or the only one there is)
+}
+
+static VKAPI_ATTR VkResult VKAPI_CALL layer_CreateInstance(const VkInstanceCreateInfo *ci, const VkAllocationCallbacks *a,
+                                                           VkInstance *instance) {
+    VkLayerInstanceCreateInfo *link = (VkLayerInstanceCreateInfo *)ci->pNext;
+    while (link && !(link->sType == VK_STRUCTURE_TYPE_LOADER_INSTANCE_CREATE_INFO && link->function == VK_LAYER_LINK_INFO))
+        link = (VkLayerInstanceCreateInfo *)link->pNext;
+    if (!link || !link->u.pLayerInfo) return VK_ERROR_INITIALIZATION_FAILED;
+    PFN_vkGetInstanceProcAddr next = link->u.pLayerInfo->pfnNextGetInstanceProcAddr;
+    link->u.pLayerInfo = link->u.pLayerInfo->pNext;
+    PFN_vkCreateInstance create = (PFN_vkCreateInstance)next(VK_NULL_HANDLE, "vkCreateInstance");
+    if (!create) return VK_ERROR_INITIALIZATION_FAILED;
+    VkResult r = create(ci, a, instance);
+    if (r != VK_SUCCESS) return r;
+    take_lock(&lock);
+    int slot = 0;
+    for (int i = 0; i < MAX_HANDLES; i++)
+        if (!instances[i].gipa || instances[i].key == key_of(*instance)) { slot = i; break; }
+    instances[slot].key = key_of(*instance);
+    instances[slot].instance = *instance;
+    instances[slot].gipa = next;
+    drop_lock(&lock);
+    static int logged;
+    if (logged++ < 4) LOG("foveation diagnostic: active on instance %p (%d fix(es))", (void *)*instance, nfixes);
+    return r;
+}
+
+static VKAPI_ATTR VkResult VKAPI_CALL layer_CreateDevice(VkPhysicalDevice pd, const VkDeviceCreateInfo *ci,
+                                                         const VkAllocationCallbacks *a, VkDevice *device) {
+    VkLayerDeviceCreateInfo *link = (VkLayerDeviceCreateInfo *)ci->pNext;
+    while (link && !(link->sType == VK_STRUCTURE_TYPE_LOADER_DEVICE_CREATE_INFO && link->function == VK_LAYER_LINK_INFO))
+        link = (VkLayerDeviceCreateInfo *)link->pNext;
+    if (!link || !link->u.pLayerInfo) return VK_ERROR_INITIALIZATION_FAILED;
+    PFN_vkGetInstanceProcAddr next_gipa = link->u.pLayerInfo->pfnNextGetInstanceProcAddr;
+    PFN_vkGetDeviceProcAddr next_gdpa = link->u.pLayerInfo->pfnNextGetDeviceProcAddr;
+    link->u.pLayerInfo = link->u.pLayerInfo->pNext;
+    VkInstance instance = VK_NULL_HANDLE;
+    instance_gipa(pd, &instance);
+    PFN_vkCreateDevice create = (PFN_vkCreateDevice)next_gipa(instance, "vkCreateDevice");
+    if (!create) return VK_ERROR_INITIALIZATION_FAILED;
+    for(const VkBaseInStructure*b=ci->pNext;b;b=b->pNext)if(b->sType==VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_FEATURES_EXT){const VkPhysicalDeviceFragmentDensityMapFeaturesEXT*q=(void*)b;LOG("REQUEST FDM=%u dynamic=%u nonsubsampled=%u",q->fragmentDensityMap,q->fragmentDensityMapDynamic,q->fragmentDensityMapNonSubsampledImages);}
+    PFN_vkGetPhysicalDeviceFeatures2 gf=(void*)next_gipa(instance,"vkGetPhysicalDeviceFeatures2");
+    VkPhysicalDeviceFragmentDensityMapFeaturesEXT fd={.sType=VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FRAGMENT_DENSITY_MAP_FEATURES_EXT};
+    VkPhysicalDeviceFeatures2 fs={.sType=VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2,.pNext=&fd};if(gf){gf(pd,&fs);LOG("SUPPORT FDM=%u dynamic=%u nonsubsampled=%u",fd.fragmentDensityMap,fd.fragmentDensityMapDynamic,fd.fragmentDensityMapNonSubsampledImages);}
+    VkResult r = create(pd, ci, a, device);
+    if (r != VK_SUCCESS) return r;
+    take_lock(&lock);
+    int slot = 0;
+    for (int i = 0; i < MAX_HANDLES; i++)
+        if (!devices[i].gdpa || devices[i].key == key_of(*device)) { slot = i; break; }
+    devices[slot].key = key_of(*device);
+    devices[slot].device=*device;
+    devices[slot].gdpa = next_gdpa;
+    devices[slot].create_shader = (PFN_vkCreateShaderModule)next_gdpa(*device, "vkCreateShaderModule");
+    drop_lock(&lock);
+    return r;
+}
+
+static void *device_entry(VkDevice device, int shader) {
+    void *key = key_of(device), *fn = NULL;
+    take_lock(&lock);
+    for (int i = 0; i < MAX_HANDLES && !fn; i++)
+        if (devices[i].gdpa && devices[i].key == key) fn = shader ? (void *)devices[i].create_shader : (void *)devices[i].gdpa;
+    drop_lock(&lock);
+    return fn;
+}
+
+static VKAPI_ATTR VkResult VKAPI_CALL layer_CreateShaderModule(VkDevice device, const VkShaderModuleCreateInfo *ci,
+                                                               const VkAllocationCallbacks *a, VkShaderModule *module) {
+    PFN_vkCreateShaderModule next = (PFN_vkCreateShaderModule)device_entry(device, 1);
+    if (!next) return VK_ERROR_INITIALIZATION_FAILED;
+    size_t words=0;
+    uint32_t *code=fdm_darken(ci->pCode,ci->codeSize/4,&words);
+    VkShaderModuleCreateInfo patched=*ci;
+    if(code){patched.pCode=code;patched.codeSize=words*4;}
+    VkResult r=next(device,&patched,a,module);
+    static int count;
+    if(code && __atomic_fetch_add(&count,1,__ATOMIC_RELAXED)<12)LOG("DARKEN shader %zu -> %zu bytes result=%d",ci->codeSize,words*4,r);
+    free(code);return r;
+}
+
+
+static PFN_vkVoidFunction own(const char *name);
+
+static VKAPI_ATTR PFN_vkVoidFunction VKAPI_CALL layer_GetDeviceProcAddr(VkDevice device, const char *name) {
+    PFN_vkVoidFunction fn = own(name);
+    if (fn) return fn;
+    PFN_vkGetDeviceProcAddr next = (PFN_vkGetDeviceProcAddr)device_entry(device, 0);
+    return next ? next(device, name) : NULL;
+}
+
+static VKAPI_ATTR PFN_vkVoidFunction VKAPI_CALL layer_GetInstanceProcAddr(VkInstance instance, const char *name) {
+    PFN_vkVoidFunction fn = own(name);
+    if (fn) return fn;
+    PFN_vkGetInstanceProcAddr next = instance ? instance_gipa(instance, NULL) : NULL;
+    return next ? next(instance, name) : NULL;
+}
+
+// ---------------------------------------------------------------- layer enumeration (what the loader asks for)
+
+static const VkLayerProperties properties = {LAYER_NAME, VK_MAKE_VERSION(1, 1, 0), 1, "FramePort coarse-fragment darkening"};
+
+EXPORT VKAPI_ATTR VkResult VKAPI_CALL vkEnumerateInstanceLayerProperties(uint32_t *count, VkLayerProperties *props) {
+    if (!props) { *count = 1; return VK_SUCCESS; }
+    if (*count < 1) return VK_INCOMPLETE;
+    props[0] = properties;
+    *count = 1;
+    return VK_SUCCESS;
+}
+
+EXPORT VKAPI_ATTR VkResult VKAPI_CALL vkEnumerateInstanceExtensionProperties(const char *layer, uint32_t *count,
+                                                                             VkExtensionProperties *props) {
+    (void)props;
+    if (!layer || strcmp(layer, LAYER_NAME)) return VK_ERROR_LAYER_NOT_PRESENT;
+    *count = 0;
+    return VK_SUCCESS;
+}
+
+EXPORT VKAPI_ATTR VkResult VKAPI_CALL vkEnumerateDeviceLayerProperties(VkPhysicalDevice pd, uint32_t *count,
+                                                                       VkLayerProperties *props) {
+    (void)pd;
+    return vkEnumerateInstanceLayerProperties(count, props);
+}
+
+EXPORT VKAPI_ATTR VkResult VKAPI_CALL vkEnumerateDeviceExtensionProperties(VkPhysicalDevice pd, const char *layer,
+                                                                           uint32_t *count, VkExtensionProperties *props) {
+    (void)pd;
+    return vkEnumerateInstanceExtensionProperties(layer, count, props);
+}
+
+EXPORT VKAPI_ATTR PFN_vkVoidFunction VKAPI_CALL VK_LAYER_FRAMEPORT_fdm_darkenGetInstanceProcAddr(VkInstance i, const char *n) {
+    return layer_GetInstanceProcAddr(i, n);
+}
+
+EXPORT VKAPI_ATTR PFN_vkVoidFunction VKAPI_CALL VK_LAYER_FRAMEPORT_fdm_darkenGetDeviceProcAddr(VkDevice d, const char *n) {
+    return layer_GetDeviceProcAddr(d, n);
+}
+
+static PFN_vkVoidFunction own(const char *name) {
+    if (!name) return NULL;
+#define OWN(fn, impl) if (!strcmp(name, fn)) return (PFN_vkVoidFunction)impl;
+    OWN("vkGetInstanceProcAddr", layer_GetInstanceProcAddr)
+    OWN("vkGetDeviceProcAddr", layer_GetDeviceProcAddr)
+    OWN("vkCreateInstance", layer_CreateInstance)
+    OWN("vkCreateDevice", layer_CreateDevice)
+    OWN("vkCreateShaderModule", layer_CreateShaderModule)
+    OWN("vkEnumerateInstanceLayerProperties", vkEnumerateInstanceLayerProperties)
+    OWN("vkEnumerateInstanceExtensionProperties", vkEnumerateInstanceExtensionProperties)
+    OWN("vkEnumerateDeviceLayerProperties", vkEnumerateDeviceLayerProperties)
+#undef OWN
+    return NULL;
+}
+
+// ---------------------------------------------------------------- activation (GraphicsEnv debug layers)
+
+// libc++ std::string as Android 11's platform libc++ lays it out (little endian, short-string flag in bit 0)
+struct cxx_string { size_t cap; size_t size; char *data; };
+
+static const char *cxx_chars(const void *s, size_t *len) {
+    const unsigned char *b = s;
+    if (b[0] & 1) {
+        const struct cxx_string *l = s;
+        *len = l->size;
+        return l->data;
+    }
+    *len = b[0] >> 1;
+    return (const char *)b + 1;
+}
+
+#define GET_INSTANCE "_ZN7android11GraphicsEnv11getInstanceEv"
+#define GET_LAYERS "_ZN7android11GraphicsEnv14getDebugLayersEv"
+#define SET_LAYERS "_ZN7android11GraphicsEnv14setDebugLayersENSt3__112basic_stringIcNS1_11char_traitsIcEENS1_9allocatorIcEEEE"
+
+#include "climb_compat.h"
+
+__attribute__((constructor)) static void activate(void) {
+    climb_stereo_fix();
+    const char *enabled = getenv("FRAMEPORT_FOVEATION_TEST");
+    if (!enabled || strcmp(enabled, "1")) return;
+    /* This library is added only when device.foveation.test is selected. */
+    /* The launcher opt-in also keeps imported test builds dormant during normal play. */
+    void *vk = dlopen("libvulkan.so", RTLD_NOW | RTLD_LOCAL);
+    void *(*get_instance)(void) = vk ? (void *(*)(void))dlsym(vk, GET_INSTANCE) : NULL;
+    const void *(*get_layers)(void *) = vk ? (const void *(*)(void *))dlsym(vk, GET_LAYERS) : NULL;
+    void (*set_layers)(void *, struct cxx_string *) = vk ? (void (*)(void *, struct cxx_string *))dlsym(vk, SET_LAYERS) : NULL;
+    if (!get_instance || !get_layers || !set_layers) {
+        LOG("foveation diagnostic: NOT active, Android's GraphicsEnv functions not found (%s%s%s)", get_instance ? "" : "getInstance ",
+            get_layers ? "" : "getDebugLayers ", set_layers ? "" : "setDebugLayers");
+        return;
+    }
+    void *env = get_instance();
+    size_t len = 0;
+    const char *current = env ? cxx_chars(get_layers(env), &len) : NULL;
+    if (!env || (len && !current) || len > 4096) {
+        LOG("foveation diagnostic: NOT active, unexpected GraphicsEnv state");
+        return;
+    }
+    char old[4097];
+    memcpy(old, current ? current : "", len);
+    old[len] = 0;
+    if (strstr(old, LAYER_NAME)) return;  // loaded twice (the loader's own dlopen): already in the list
+    size_t n = strlen(LAYER_NAME) + (len ? 1 + len : 0);
+    size_t cap = (n + 16) & ~(size_t)15;
+    char *data = malloc(cap);
+    if (!data) return;
+    snprintf(data, cap, "%s%s%s", LAYER_NAME, len ? ":" : "", old);
+    // passed by value: the callee gets a pointer to our temporary and copies it; freed below unless it was moved
+    struct cxx_string tmp = {cap | 1, n, data};
+    set_layers(env, &tmp);
+    if ((tmp.cap & 1) && tmp.data == data) free(data);
+    const char *now = cxx_chars(get_layers(env), &len);
+    LOG("foveation diagnostic: debug layers now \"%.*s\" (%d fix(es)%s)", (int)len, now ? now : "", nfixes,
+        dump ? ", dumping modules" : "");
+}
@@ -0,0 +1,77 @@
+// SPDX-License-Identifier: GPL-3.0-only
+#include <stdint.h>
+#include <stdlib.h>
+#include <string.h>
+/* Diagnostic only: dim location-0 vec4 RGB where FragSizeEXT != (1,1).
+ * Unsupported interfaces pass through; alpha and all other outputs are retained. */
+static uint32_t *fdm_darken(const uint32_t *w,size_t n,size_t *out_n) {
+ if(n<5||n>4000000||w[0]!=0x07230203||!w[3]||w[3]>1000000)return NULL;
+ uint32_t bound=w[3],output=0,ptr=0,vec=0,flt=0; int entries=0,stores=0;
+ size_t cap_at=0,ext_at=0,ann_at=0,fn_at=0;
+ for(size_t i=5;i<n;) {uint32_t len=w[i]>>16,op=w[i]&65535;if(!len||i+len>n)return NULL;
+  if(op==17)cap_at=i+len;
+  if(op==10)ext_at=i+len;
+  if(op==15){if(w[i+1]!=4)return NULL;entries++;}
+  if(op==71||op==72)ann_at=i+len;
+  if(op==71&&len==4&&w[i+2]==30&&w[i+3]==0){
+   /* Location zero can also decorate an input; choose only the output variable. */
+   for(size_t j=5;j<n;){uint32_t l=w[j]>>16;if(!l||j+l>n)return NULL;
+    if((w[j]&65535)==59&&l>=4&&w[j+2]==w[i+1]&&w[j+3]==3)output=w[i+1];
+    j+=l;
+   }
+  }
+  if(op==54&&!fn_at)fn_at=i;
+  i+=len;
+ }
+ if(entries!=1||!output||!cap_at||!ann_at||!fn_at)return NULL;
+ for(size_t i=5;i<n;i+=w[i]>>16)if((w[i]&65535)==59&&w[i+2]==output&&w[i+3]==3)ptr=w[i+1];
+ for(size_t i=5;i<n;i+=w[i]>>16)if((w[i]&65535)==32&&w[i+1]==ptr&&w[i+2]==3)vec=w[i+3];
+ for(size_t i=5;i<n;i+=w[i]>>16)if((w[i]&65535)==23&&w[i+1]==vec&&w[i+3]==4)flt=w[i+2];
+ int is_float=0;
+ for(size_t i=5;i<n;i+=w[i]>>16){if((w[i]&65535)==22&&w[i+1]==flt&&w[i+2]==32)is_float=1;
+  if((w[i]&65535)==62&&w[i+1]==output)stores++;
+  if((w[i]&65535)==71&&(w[i]>>16)>=4&&w[i+2]==11&&w[i+3]==5292)return NULL;
+ }
+ if(!is_float||!stores)return NULL;
+ /* Reuse scalar/vector/pointer types: Vulkan validation prohibits duplicates. */
+ uint32_t ui=0,bv=0,v2=0,ip=0;
+ for(size_t i=5;i<n;i+=w[i]>>16){uint32_t op=w[i]&65535;
+  if(op==21&&w[i+2]==32&&w[i+3]==0)ui=w[i+1];
+  if(op==20)bv=w[i+1];
+ }
+ for(size_t i=5;i<n;i+=w[i]>>16)if((w[i]&65535)==23&&w[i+2]==ui&&w[i+3]==2)v2=w[i+1];
+ for(size_t i=5;i<n;i+=w[i]>>16)if((w[i]&65535)==32&&w[i+2]==1&&w[i+3]==v2)ip=w[i+1];
+ int nui=!ui,nbv=!bv,nv2=!v2,nip=!ip;
+ if(nui)ui=bound++;if(nbv)bv=bound++;if(nv2)v2=bound++;if(nip)ip=bound++;
+ uint32_t frag=bound++,one=bound++,bright=bound++,dark=bound++;
+ uint32_t *out=calloc(n+200+stores*64,sizeof(uint32_t));if(!out)return NULL;size_t k=0;
+#define EMIT(...) do{const uint32_t a[]={__VA_ARGS__};memcpy(out+k,a,sizeof a);k+=sizeof a/4;}while(0)
+ memcpy(out,w,20);k=5;if(!ext_at)ext_at=cap_at;
+ for(size_t i=5;i<=n;) {
+  if(i==cap_at)EMIT((2u<<16)|17,5291);
+  if(i==ext_at){const char s[]="SPV_EXT_fragment_invocation_density";size_t z=(sizeof s+3)/4;out[k++]=((uint32_t)(1+z)<<16)|10;memcpy(out+k,s,sizeof s);k+=z;}
+  if(i==ann_at){EMIT((4u<<16)|71,frag,11,5292);EMIT((3u<<16)|71,frag,14);}
+  if(i==fn_at){
+   if(nui)EMIT((4u<<16)|21,ui,32,0);if(nbv)EMIT((2u<<16)|20,bv);
+   if(nv2)EMIT((4u<<16)|23,v2,ui,2);if(nip)EMIT((4u<<16)|32,ip,1,v2);
+   EMIT((4u<<16)|43,ui,one,1);EMIT((4u<<16)|43,flt,bright,0x3f800000);
+   EMIT((4u<<16)|43,flt,dark,0x3e4ccccd); /* 0.2 RGB, alpha unchanged */
+   EMIT((4u<<16)|59,ip,frag,1);
+  }
+  if(i==n)break;uint32_t len=w[i]>>16,op=w[i]&65535;
+  if(op==15){out[k++]=((len+1)<<16)|15;memcpy(out+k,w+i+1,(len-1)*4);k+=len-1;out[k++]=frag;}
+  else if(op==62&&w[i+1]==output){
+   uint32_t sz=bound++,x=bound++,y=bound++,area=bound++,low=bound++,factor=bound++,factors=bound++,color=bound++;
+   EMIT((4u<<16)|61,v2,sz,frag);EMIT((5u<<16)|81,ui,x,sz,0);EMIT((5u<<16)|81,ui,y,sz,1);
+   EMIT((5u<<16)|132,ui,area,x,y);EMIT((5u<<16)|171,bv,low,area,one);
+   EMIT((6u<<16)|169,flt,factor,low,dark,bright);
+   EMIT((7u<<16)|80,vec,factors,factor,factor,factor,bright);
+   EMIT((5u<<16)|133,vec,color,w[i+2],factors);
+   memcpy(out+k,w+i,len*4);out[k+2]=color;k+=len;
+  }else{memcpy(out+k,w+i,len*4);k+=len;}
+  i+=len;
+ }
+ out[3]=bound;*out_n=k;
+#undef EMIT
+ return out;
+}
@@ -0,0 +1,45 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// SHA-256 shared with native/zinkfix; bounded file verification for compatibility patches.
+static const uint32_t K[64] = {
+    0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5, 0xd807aa98, 0x12835b01,
+    0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, 0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc,
+    0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da, 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147,
+    0x06ca6351, 0x14292967, 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
+    0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070, 0x19a4c116, 0x1e376c08,
+    0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3, 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208,
+    0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2};
+#define ROR(x, n) (((x) >> (n)) | ((x) << (32 - (n))))
+
+static void sha256_block(uint32_t h[8], const uint8_t *p) {
+    uint32_t w[64];
+    for (int i = 0; i < 16; i++) w[i] = (uint32_t)p[4 * i] << 24 | (uint32_t)p[4 * i + 1] << 16 | (uint32_t)p[4 * i + 2] << 8 | p[4 * i + 3];
+    for (int i = 16; i < 64; i++) {
+        uint32_t s0 = ROR(w[i - 15], 7) ^ ROR(w[i - 15], 18) ^ (w[i - 15] >> 3);
+        uint32_t s1 = ROR(w[i - 2], 17) ^ ROR(w[i - 2], 19) ^ (w[i - 2] >> 10);
+        w[i] = w[i - 16] + s0 + w[i - 7] + s1;
+    }
+    uint32_t a = h[0], b = h[1], c = h[2], d = h[3], e = h[4], f = h[5], g = h[6], hh = h[7];
+    for (int i = 0; i < 64; i++) {
+        uint32_t t1 = hh + (ROR(e, 6) ^ ROR(e, 11) ^ ROR(e, 25)) + ((e & f) ^ (~e & g)) + K[i] + w[i];
+        uint32_t t2 = (ROR(a, 2) ^ ROR(a, 13) ^ ROR(a, 22)) + ((a & b) ^ (a & c) ^ (b & c));
+        hh = g; g = f; f = e; e = d + t1; d = c; c = b; b = a; a = t1 + t2;
+    }
+    h[0] += a; h[1] += b; h[2] += c; h[3] += d; h[4] += e; h[5] += f; h[6] += g; h[7] += hh;
+}
+
+static void sha256(const uint8_t *data, size_t len, uint8_t out[32]) {
+    uint32_t h[8] = {0x6a09e667, 0xbb67ae85, 0x3c6ef372, 0xa54ff53a, 0x510e527f, 0x9b05688c, 0x1f83d9ab, 0x5be0cd19};
+    size_t i = 0;
+    for (; i + 64 <= len; i += 64) sha256_block(h, data + i);
+    uint8_t tail[128] = {0};
+    size_t rest = len - i;
+    memcpy(tail, data + i, rest);
+    tail[rest] = 0x80;
+    size_t blocks = rest + 9 > 64 ? 2 : 1;
+    uint64_t bits = (uint64_t)len * 8;
+    for (int b = 0; b < 8; b++) tail[blocks * 64 - 1 - b] = (uint8_t)(bits >> (8 * b));
+    for (size_t b = 0; b < blocks; b++) sha256_block(h, tail + 64 * b);
+    for (int b = 0; b < 8; b++) {
+        out[4 * b] = h[b] >> 24; out[4 * b + 1] = h[b] >> 16; out[4 * b + 2] = h[b] >> 8; out[4 * b + 3] = h[b];
+    }
+}
@@ -0,0 +1,109 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// FramePort thread-key pool for Unity (patch frame.unity_tls_key_pool, GitHub #198).
+//
+// Bionic gives a process 128 pthread keys. Unity 6 takes about 40 of them (most without a destructor), and on the
+// Frame the libraries Lepton and FramePort add (Mesa/Zink, FrameBridge, OVRPort's dispatcher, Valve's Vulkan layers)
+// take more than on a Quest. Games with many other native libraries then run out: Wander 0.3570 (Gecko, avatar
+// libraries, Firebase) aborted in Firestore's start with "cannot create thread specific key for __cxa_get_globals()".
+//
+// FramePort renames libunity.so's imports pthread_key_create/_delete and pthread_get/setspecific to the fp_tkey_*
+// functions below (same strings, shorter, NUL-padded) and adds this library to its DT_NEEDED. Keys without a
+// destructor become slots in one per-thread table that lives under a single real key; keys with a destructor, and
+// every other library, keep using real keys. Approach and the original helper: Klownicle (GitHub #198), verified in
+// the headset; this is FramePort's own implementation of it.
+//
+// Pooled keys are TAG + slot (bionic's own keys have bit 31 set, so the ranges can't meet). A slot's generation
+// changes at every create, so a value stored under a deleted key isn't seen through a new key that reuses the slot.
+// Using a key after deleting it is undefined in POSIX; here it just reads NULL / fails with EINVAL.
+#include <android/log.h>
+#include <errno.h>
+#include <pthread.h>
+#include <stdatomic.h>
+#include <stdint.h>
+#include <stdlib.h>
+
+#define TAG_LOG "FrameBridge"
+#define EXPORT __attribute__((visibility("default")))
+#define LOG(...) __android_log_print(ANDROID_LOG_INFO, TAG_LOG, __VA_ARGS__)
+
+#define SLOTS 512
+#define TAG 0x40000000u
+
+struct table {
+    void *value[SLOTS];
+    uint32_t generation[SLOTS];
+};
+
+static pthread_once_t once = PTHREAD_ONCE_INIT;
+static pthread_key_t storage;
+static int storage_error;
+static _Atomic uint32_t used[SLOTS];       // 0 free, 1 taken
+static _Atomic uint32_t generation[SLOTS];  // never 0 for a taken slot
+static _Atomic int pooled, logged_full;
+
+static void setup(void) {
+    storage_error = pthread_key_create(&storage, free);  // the table goes with its thread
+    if (storage_error) LOG("fp_tkeys: no real key for the pool (%d): Unity's keys stay real ones", storage_error);
+}
+
+static int slot_of(pthread_key_t key, unsigned *slot) {
+    uint32_t k = (uint32_t)key;
+    if (k < TAG || k >= TAG + SLOTS) return 0;
+    *slot = k - TAG;
+    return 1;
+}
+
+EXPORT int fp_tkey_create(pthread_key_t *key, void (*destructor)(void *)) {
+    if (destructor) return pthread_key_create(key, destructor);
+    pthread_once(&once, setup);
+    if (storage_error) return pthread_key_create(key, NULL);
+    for (unsigned i = 0; i < SLOTS; i++) {
+        uint32_t expected = 0;
+        if (atomic_compare_exchange_strong(&used[i], &expected, 1)) {
+            uint32_t g = atomic_fetch_add(&generation[i], 1) + 1;
+            if (!g) atomic_fetch_add(&generation[i], 1);  // skip 0: "never set" in a fresh table
+            *key = (pthread_key_t)(TAG + i);
+            if (atomic_fetch_add(&pooled, 1) == 0) LOG("fp_tkeys: pooling Unity's thread keys without destructor");
+            return 0;
+        }
+    }
+    if (!atomic_exchange(&logged_full, 1)) LOG("fp_tkeys: all %d pooled keys taken, using real keys", SLOTS);
+    return pthread_key_create(key, NULL);
+}
+
+EXPORT int fp_tkey_delete(pthread_key_t key) {
+    unsigned i;
+    if (!slot_of(key, &i)) return pthread_key_delete(key);
+    uint32_t expected = 1;
+    if (!atomic_compare_exchange_strong(&used[i], &expected, 0)) return EINVAL;
+    atomic_fetch_sub(&pooled, 1);
+    return 0;
+}
+
+EXPORT void *fp_tkey_get(pthread_key_t key) {
+    unsigned i;
+    if (!slot_of(key, &i)) return pthread_getspecific(key);
+    struct table *t = pthread_getspecific(storage);
+    if (!t || !atomic_load_explicit(&used[i], memory_order_acquire)) return NULL;
+    return t->generation[i] == atomic_load_explicit(&generation[i], memory_order_relaxed) ? t->value[i] : NULL;
+}
+
+EXPORT int fp_tkey_set(pthread_key_t key, const void *value) {
+    unsigned i;
+    if (!slot_of(key, &i)) return pthread_setspecific(key, value);
+    if (!atomic_load_explicit(&used[i], memory_order_acquire)) return EINVAL;
+    struct table *t = pthread_getspecific(storage);
+    if (!t) {
+        if (!value) return 0;  // nothing stored yet: NULL is what get answers anyway
+        t = calloc(1, sizeof(*t));
+        if (!t) return ENOMEM;
+        int rc = pthread_setspecific(storage, t);
+        if (rc) {
+            free(t);
+            return rc;
+        }
+    }
+    t->value[i] = (void *)value;
+    t->generation[i] = atomic_load_explicit(&generation[i], memory_order_relaxed);
+    return 0;
+}
@@ -8,6 +8,7 @@
 #include <array>
 #include <cmath>
 #include <cstdint>
+#include <cstdlib>
 #include <limits>
 #include <new>

@@ -26,6 +27,8 @@ constexpr int32_t kTexture2DArray = 2;
 constexpr int32_t kProjectionLayer = 1;
 constexpr uint32_t kLayerChromatic = 1u << 1;
 constexpr uint32_t kFrameFlush = 1u << 1;
+constexpr uint32_t kFrameInhibitVolume = 1u << 6;
+constexpr uint32_t kFrameShowTextureDensity = 1u << 8;  // obsolete Quest compositor debug overlay
 constexpr uint32_t kLayerFixedToView = 1u << 2;
 constexpr uint32_t kLayerClipRect = 1u << 4;
 constexpr uint32_t kLayerInhibitSrgb = 1u << 8;
@@ -263,10 +266,20 @@ bool ensureFullRateImage(ovrTextureSwapChain* chain) {
        image.arrayLayers = chain->arrayLayers;
        image.samples = VK_SAMPLE_COUNT_1_BIT;
        image.tiling = VK_IMAGE_TILING_OPTIMAL;
-        image.usage = VK_IMAGE_USAGE_SAMPLED_BIT | VK_IMAGE_USAGE_TRANSFER_DST_BIT;
+        image.usage = VK_IMAGE_USAGE_SAMPLED_BIT | VK_IMAGE_USAGE_TRANSFER_DST_BIT |
+                      VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT;
+        // Some engines bind this resource as a fragment-density attachment even when our VrApi capability says
+        // foveation is off (The Climb, GitHub #238). Turnip samples density maps on the CPU: this usage makes it
+        // choose linear storage and map the backing memory at bind time. An ordinary sampled image has a NULL
+        // image->map and crashes in vkCmdEndRenderPass. Keep the constant full-rate contents in either case.
+        // This API supplies a density attachment, so never substitute an ordinary sampled image when a layer
+        // filters the advertised format features. vkCreateImage can reject unsupported usage without publishing it.
        image.sharingMode = VK_SHARING_MODE_EXCLUSIVE;
        image.initialLayout = VK_IMAGE_LAYOUT_UNDEFINED;
-        if (vkCreateImage(s.vk.Device, &image, nullptr, &resource.image) != VK_SUCCESS) return false;
+        const VkResult created = vkCreateImage(s.vk.Device, &image, nullptr, &resource.image);
+        OVP_LOG("Full-rate image: format features=0x%x usage=0x%x create=%d",
+                properties.optimalTilingFeatures, image.usage, created);
+        if (created != VK_SUCCESS) return false;
        VkMemoryRequirements requirements{};
        vkGetImageMemoryRequirements(s.vk.Device, resource.image, &requirements);
        uint32_t memoryType = 0;
@@ -299,9 +312,7 @@ bool ensureFullRateImage(ovrTextureSwapChain* chain) {
    barrier.subresourceRange = {VK_IMAGE_ASPECT_COLOR_BIT, 0, 1, 0, chain->arrayLayers};
    vkCmdPipelineBarrier(gCopy.command, VK_PIPELINE_STAGE_TOP_OF_PIPE_BIT,
                        VK_PIPELINE_STAGE_TRANSFER_BIT, 0, 0, nullptr, 0, nullptr, 1, &barrier);
-    // Constant (1,1) density means full-rate shading. This ordinary sampled
-    // texture supports consumers which query the resource even with VRS off;
-    // it is not a hardware fragment-density attachment or an enabled feature.
+    // Constant (1,1) density means full-rate shading, including when the engine binds it as a density attachment.
    const VkClearColorValue fullRate{{1.0f, 1.0f, 1.0f, 1.0f}};
    vkCmdClearColorImage(gCopy.command, resource.image, VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL,
                        &fullRate, 1, &barrier.subresourceRange);
@@ -436,6 +447,17 @@ bool ensureOutput(ovrTextureSwapChain* chain) {
    create.faceCount = 1;
    create.arraySize = chain->arrayLayers;
    create.mipCount = chain->levels;
+    // Per-game opt-in: Valve's injection caches density maps by maximum extent.
+    // Keep mono overlays from replacing the stereo map at the same extent.
+    // Only output storage is padded; copies and submitted subrects retain the
+    // original dimensions, and all application-owned images remain unchanged.
+    const char* isolate = std::getenv("FRAMEPORT_VRAPI_FDM_ISOLATE_MONO");
+    if (isolate && std::strcmp(isolate, "1") == 0 && chain->arrayLayers == 1) {
+        create.width += 32;
+        create.height += 32;
+        OVP_LOG("Foveation separate mono output %ux%u -> %ux%u", chain->width, chain->height,
+                create.width, create.height);
+    }
    result = s.xr.xrCreateSwapchain(s.session, &create, &chain->output);
    if (XR_FAILED(result)) {
        ovp::xrOk(result, "xrCreateSwapchain");
@@ -1090,8 +1112,12 @@ VRAPI ovrResult vrapi_SubmitFrame2(ovrMobile* mobile,
        (description->LayerCount != 0 && !description->Layers)) {
        return failFrame(InvalidParameter);
    }
-    if ((description->Flags & ~kFrameFlush) != 0 || description->SwapInterval != 1) {
-        OVP_ERROR("Unsupported frame flags or swap interval");
+    // Volume suppression and the old texture-density visualization only affect Quest's compositor overlays.
+    // OpenXR has neither overlay; accepting those flags must still submit the application's actual layers.
+    if ((description->Flags & ~(kFrameFlush | kFrameInhibitVolume | kFrameShowTextureDensity)) != 0 ||
+        description->SwapInterval != 1) {
+        OVP_ERROR("Unsupported frame flags or swap interval: flags=0x%x interval=%u",
+                  description->Flags, description->SwapInterval);
        return failFrame(Unsupported);
    }

@@ -1191,10 +1217,21 @@ VRAPI ovrResult vrapi_SubmitFrame2(ovrMobile* mobile,
    if (!ovp::ensureSession(s.queue) || !ovp::beginFrame(static_cast<int64_t>(description->FrameIndex))) {
        return failFrame(DeviceUnavailable);
    }
-    if (!s.frame.shouldRender) {
+    // A short runtime visibility dip can be held by FrameBridge's focus_hold.
+    // Continue supplying the real image while the application still has focus;
+    // otherwise an empty submission replaces it with the runtime's black image.
+    // shouldRender is an advisory; actual focus loss keeps the ordinary path.
+    const char* keepFocused = std::getenv("FRAMEPORT_VRAPI_KEEP_FOCUSED_IMAGE");
+    const bool retainImage = keepFocused && std::strcmp(keepFocused, "1") == 0 &&
+                             s.sessionState == XR_SESSION_STATE_FOCUSED;
+    if (!s.frame.shouldRender && !retainImage) {
        const XrResult result = ovp::endFrame(nullptr, 0);
        return XR_SUCCEEDED(result) ? Success : DeviceUnavailable;
    }
+    if (!s.frame.shouldRender && retainImage) {
+        static unsigned held = 0;
+        if (held++ % 72 == 0) OVP_LOG("CLIMB visibility: retaining image during held focus dip (%u)", held);
+    }

    std::array<CopyJob, kMaxCopyJobs> jobs{};
    uint32_t jobCount = 0;
@@ -76,6 +76,13 @@ static void saveLiveFov() {
    const float saved[2] = {s.savedFovDegrees[0], s.savedFovDegrees[1]};
    if (!s.locatedFovValid || !fovcache::plausible(now[0], now[1]) || !fovcache::changed(s.savedFovValid, saved, now))
        return;
+    // Only the private foveation bridge opts in; ordinary games retain their cache policy.
+    static double lastCacheWrite = -10.0;
+    const double cacheTime = secondsNow();
+    const char* limitCache = std::getenv("FRAMEPORT_VRAPI_KEEP_FOCUSED_IMAGE");
+    if (limitCache && std::strcmp(limitCache, "1") == 0 && s.savedFovValid && cacheTime - lastCacheWrite < 10.0)
+        return;
+    lastCacheWrite = cacheTime;
    s.savedFovDegrees = {now[0], now[1]};  // also when it can't be written: tried once per change, not every frame
    s.savedFovValid = true;
    char path[512], tmp[540], text[96];
@@ -10,7 +10,16 @@
 #include <algorithm>
 #include <array>
 #include <cmath>
-@@ -54,6 +57,13 @@
+@@ -23,6 +26,8 @@ constexpr int32_t kTexture2DArray = 2;
+ constexpr int32_t kProjectionLayer = 1;
+ constexpr uint32_t kLayerChromatic = 1u << 1;
+ constexpr uint32_t kFrameFlush = 1u << 1;
+constexpr uint32_t kFrameInhibitVolume = 1u << 6;
+constexpr uint32_t kFrameShowTextureDensity = 1u << 8;  // obsolete Quest compositor debug overlay
+ constexpr uint32_t kLayerFixedToView = 1u << 2;
+ constexpr uint32_t kLayerClipRect = 1u << 4;
+ constexpr uint32_t kLayerInhibitSrgb = 1u << 8;
+@@ -54,6 +59,13 @@ struct ovrTextureSwapChain {
     uint32_t outputImageCount = 0;
     std::array<XrSwapchainImageVulkanKHR, kMaxBuffers> outputImages{};
     std::array<bool, kMaxBuffers> outputInitialized{};
@@ -24,7 +33,7 @@
 };
 
 namespace {
-@@ -121,6 +131,11 @@
+@@ -121,6 +133,11 @@ void destroyAppImage(AppImage& image) {
 }
 
 void destroyAppImages(ovrTextureSwapChain* chain) {
@@ -36,7 +45,41 @@
     for (uint32_t i = 0; i < chain->bufferCount; ++i) destroyAppImage(chain->appImages[i]);
     destroyAppImage(chain->fullRateImage);
     chain->fullRateInitialized = false;
-@@ -313,10 +328,65 @@
+@@ -248,10 +265,20 @@ bool ensureFullRateImage(ovrTextureSwapChain* chain) {
+         image.arrayLayers = chain->arrayLayers;
+         image.samples = VK_SAMPLE_COUNT_1_BIT;
+         image.tiling = VK_IMAGE_TILING_OPTIMAL;
+-        image.usage = VK_IMAGE_USAGE_SAMPLED_BIT | VK_IMAGE_USAGE_TRANSFER_DST_BIT;
+        image.usage = VK_IMAGE_USAGE_SAMPLED_BIT | VK_IMAGE_USAGE_TRANSFER_DST_BIT |
+                      VK_IMAGE_USAGE_FRAGMENT_DENSITY_MAP_BIT_EXT;
+        // Some engines bind this resource as a fragment-density attachment even when our VrApi capability says
+        // foveation is off (The Climb, GitHub #238). Turnip samples density maps on the CPU: this usage makes it
+        // choose linear storage and map the backing memory at bind time. An ordinary sampled image has a NULL
+        // image->map and crashes in vkCmdEndRenderPass. Keep the constant full-rate contents in either case.
+        // This API supplies a density attachment, so never substitute an ordinary sampled image when a layer
+        // filters the advertised format features. vkCreateImage can reject unsupported usage without publishing it.
+         image.sharingMode = VK_SHARING_MODE_EXCLUSIVE;
+         image.initialLayout = VK_IMAGE_LAYOUT_UNDEFINED;
+-        if (vkCreateImage(s.vk.Device, &image, nullptr, &resource.image) != VK_SUCCESS) return false;
+        const VkResult created = vkCreateImage(s.vk.Device, &image, nullptr, &resource.image);
+        OVP_LOG("Full-rate image: format features=0x%x usage=0x%x create=%d",
+                properties.optimalTilingFeatures, image.usage, created);
+        if (created != VK_SUCCESS) return false;
+         VkMemoryRequirements requirements{};
+         vkGetImageMemoryRequirements(s.vk.Device, resource.image, &requirements);
+         uint32_t memoryType = 0;
+@@ -284,9 +311,7 @@ bool ensureFullRateImage(ovrTextureSwapChain* chain) {
+     barrier.subresourceRange = {VK_IMAGE_ASPECT_COLOR_BIT, 0, 1, 0, chain->arrayLayers};
+     vkCmdPipelineBarrier(gCopy.command, VK_PIPELINE_STAGE_TOP_OF_PIPE_BIT,
+                         VK_PIPELINE_STAGE_TRANSFER_BIT, 0, 0, nullptr, 0, nullptr, 1, &barrier);
+-    // Constant (1,1) density means full-rate shading. This ordinary sampled
+-    // texture supports consumers which query the resource even with VRS off;
+-    // it is not a hardware fragment-density attachment or an enabled feature.
+    // Constant (1,1) density means full-rate shading, including when the engine binds it as a density attachment.
+     const VkClearColorValue fullRate{{1.0f, 1.0f, 1.0f, 1.0f}};
+     vkCmdClearColorImage(gCopy.command, resource.image, VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL,
+                         &fullRate, 1, &barrier.subresourceRange);
+@@ -313,10 +338,65 @@ bool ensureFullRateImage(ovrTextureSwapChain* chain) {
     return true;
 }
 
@@ -102,7 +145,7 @@
 
     uint32_t formatCount = 0;
     XrResult result = s.xr.xrEnumerateSwapchainFormats(s.session, 0, &formatCount, nullptr);
-@@ -331,12 +401,29 @@
+@@ -331,12 +411,29 @@ bool ensureOutput(ovrTextureSwapChain* chain) {
         ovp::xrOk(result, "xrEnumerateSwapchainFormats");
         return false;
     }
@@ -138,7 +181,7 @@
     }
 
     XrSwapchainCreateInfo create{XR_TYPE_SWAPCHAIN_CREATE_INFO};
-@@ -485,8 +572,104 @@
+@@ -485,8 +582,104 @@ bool projectionGeometry(const ovrMatrix4f& matrix, const ovrRectf& rect,
     return true;
 }
 
@@ -243,7 +286,7 @@
     bool black = false;
     XrCompositionLayerProjection projection{XR_TYPE_COMPOSITION_LAYER_PROJECTION};
     std::array<XrCompositionLayerProjectionView, 2> views{{
-@@ -547,7 +730,97 @@
+@@ -547,7 +740,97 @@ bool acquireJobs(std::array<CopyJob, kMaxCopyJobs>& jobs, uint32_t count) {
     return true;
 }
 
@@ -341,7 +384,21 @@
     if (!settleCopy(kFrameWaitNs, false)) return false;
     reapRetired();
     if (count == 0) return true;
-@@ -826,6 +1099,28 @@
+@@ -817,7 +1100,11 @@ VRAPI ovrResult vrapi_SubmitFrame2(ovrMobile* mobile,
+         (description->LayerCount != 0 && !description->Layers)) {
+         return failFrame(InvalidParameter);
+     }
+-    if ((description->Flags & ~kFrameFlush) != 0 || description->SwapInterval != 1) {
+-        OVP_ERROR("Unsupported frame flags or swap interval");
+    // Volume suppression and the old texture-density visualization only affect Quest's compositor overlays.
+    // OpenXR has neither overlay; accepting those flags must still submit the application's actual layers.
+    if ((description->Flags & ~(kFrameFlush | kFrameInhibitVolume | kFrameShowTextureDensity)) != 0 ||
+        description->SwapInterval != 1) {
+        OVP_ERROR("Unsupported frame flags or swap interval: flags=0x%x interval=%u",
+                  description->Flags, description->SwapInterval);
+         return failFrame(Unsupported);
+     }
+@@ -826,6 +1113,28 @@ VRAPI ovrResult vrapi_SubmitFrame2(ovrMobile* mobile,
     for (uint32_t i = 0; i < description->LayerCount; ++i) {
         const ovrLayerHeader2* header = description->Layers[i];
         if (!header) return failFrame(InvalidParameter);
@@ -370,7 +427,7 @@
         if (header->Type != kProjectionLayer) {
             OVP_ERROR("Unsupported VrApi layer type %d", header->Type);
             return failFrame(Unsupported);
-@@ -910,6 +1205,56 @@
+@@ -910,6 +1219,56 @@ VRAPI ovrResult vrapi_SubmitFrame2(ovrMobile* mobile,
     for (uint32_t i = 0; i < description->LayerCount; ++i) {
         PreparedLayer& output = prepared[i];
         if (output.black) continue;
@@ -427,7 +484,7 @@
         const bool headLocked = (output.source->Header.Flags & kLayerFixedToView) != 0;
         if (headLocked && !haveHeadLockedViews) {
             XrViewLocateInfo locate{XR_TYPE_VIEW_LOCATE_INFO};
-@@ -951,6 +1296,9 @@
+@@ -951,6 +1310,9 @@ VRAPI ovrResult vrapi_SubmitFrame2(ovrMobile* mobile,
                           rect.x, rect.y, rect.width, rect.height);
                 return failFrame(InvalidParameter);
             }
@@ -437,7 +494,7 @@
             output.views[eye].subImage.swapchain = chain->output;
             output.views[eye].subImage.imageArrayIndex =
                 chain->type == kTexture2DArray ? eye : 0;
-@@ -1007,3 +1355,74 @@
+@@ -1007,3 +1369,74 @@ void shutdown() {
     destroyCopyContext();
 }
 } // namespace ovp::graphics
@@ -25,6 +25,9 @@

 #define TAG "FrameBridge"
 #define EXPORT __attribute__((visibility("default")))
+#ifndef FRAMEBRIDGE_DISPATCH_LIBRARY
+#define FRAMEBRIDGE_DISPATCH_LIBRARY "libopenxr_loader.so"
+#endif

 typedef PFN_xrVoidFunction (*PFN_extension_proc)(const char *name);

@@ -32,8 +35,8 @@ static PFN_xrGetInstanceProcAddr overport_gipa;
 static pthread_once_t once = PTHREAD_ONCE_INIT;

 static void resolve_overport(void) {
-    void *h = dlopen("libopenxr_loader.so", RTLD_NOW | RTLD_NOLOAD);
-    if (!h) h = dlopen("libopenxr_loader.so", RTLD_NOW);
+    void *h = dlopen(FRAMEBRIDGE_DISPATCH_LIBRARY, RTLD_NOW | RTLD_NOLOAD);
+    if (!h) h = dlopen(FRAMEBRIDGE_DISPATCH_LIBRARY, RTLD_NOW);
    if (h) overport_gipa = (PFN_xrGetInstanceProcAddr)dlsym(h, "xrGetInstanceProcAddr");
    __android_log_print(ANDROID_LOG_INFO, TAG, "extension shim: overport xrGetInstanceProcAddr %s",
                        overport_gipa ? "OK" : "MISSING");
@@ -56,6 +56,9 @@ def from_data() -> dict:
        for t in (p.title, p.description, p.summary):
            if t:
                texts[t] = ""
+        for attr in ("CHOICES", "RADIUS_CHOICES"):
+            for _, label in getattr(p, attr, ()):
+                texts[label] = ""
    for _, title in GROUPS:  # the Game settings dialog
        texts[title] = ""
    for ui in UI.values():
@@ -149,6 +149,7 @@ def main() -> int:
                  ("transit-activity", lambda a: a.show_activity(True))]
        if args.fake_frame:  # GitHub #90: the Move to… dialog (drives load in the background)
            steps.append(("move-dialog", lambda a: (a.page.pop_dialog(), a.move_game(game))))
+            steps.append(("uninstall-dialog", lambda a: (a.page.pop_dialog(), a.uninstall(game))))
        # last: the right-click menu stays open over whatever comes next
        steps.append(("library-menu", lambda a: (a.show_activity(False), a.navigate(0), time.sleep(3),
                                                 a.library_view.open_menu(game))))
@@ -0,0 +1,136 @@
+"""Upload speed to the Frame by method (GitHub discussion #242: paramiko capped at ~23 MB/s on a reporter's PC).
+
+    uv run python scripts/upload_bench.py [--mib 512] [--host <addr>] [--methods app,paramiko-tuned,ssh,ssh-gcm,sftp]
+
+Methods, each sending the same random file to ~/frameport-bench on the Frame (removed afterwards):
+- app             FramePort's own upload (Frame.put: pipelined SFTP, 1 MiB writes)
+- paramiko-tuned  the same through a paramiko transport/SFTP with a 64 MiB window
+- ssh             the system's OpenSSH: `ssh … "cat > file"` (default cipher)
+- ssh-gcm         the same with aes128-gcm@openssh.com
+- ssh-chacha      the same with chacha20-poly1305@openssh.com
+- sftp            OpenSSH's sftp in batch mode
+Prints MB/s, wall time and the CPU time spent on this PC (this process + children). Dev tool, not part of the app.
+"""
+from __future__ import annotations
+
+import argparse
+import os
+import shutil
+import socket
+import stat
+import subprocess
+import sys
+import tempfile
+import time
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
+
+import paramiko  # noqa: E402
+
+from frameport.frame.connection import Frame, app_key, saved_targets, ssh_dir  # noqa: E402
+
+REMOTE = "frameport-bench"
+
+
+def cpu() -> float:
+    t = os.times()
+    return t.user + t.system + t.children_user + t.children_system
+
+
+def private_key() -> str:
+    """OpenSSH refuses a key file others can read (the Windows data folder under /mnt/c shows 0777): a 0600 copy."""
+    key = ssh_dir() / "id_ed25519"
+    if os.name == "nt" or stat.S_IMODE(key.stat().st_mode) & 0o077 == 0:
+        return str(key)
+    tmp = Path(tempfile.mkdtemp()) / "id_ed25519"
+    shutil.copy(key, tmp)
+    tmp.chmod(0o600)
+    return str(tmp)
+
+
+def ssh_base(frame: Frame, key: str, port_flag: str = "-p") -> list[str]:
+    return ["-i", key, "-o", "BatchMode=yes", "-o", "IdentitiesOnly=yes",
+            "-o", f"UserKnownHostsFile={ssh_dir() / 'known_hosts'}", "-o", "StrictHostKeyChecking=yes",
+            port_flag, str(frame.target.port)]
+
+
+def m_app(frame, local, remote, key):
+    frame.put(local, remote, resume=False)
+
+
+def m_paramiko_tuned(frame, local, remote, key):
+    sock = socket.create_connection((frame.target.host, frame.target.port), timeout=10)
+    t = paramiko.Transport(sock, default_window_size=64 << 20, default_max_packet_size=32768)
+    try:
+        t.connect(username=frame.target.user, pkey=app_key())
+        sftp = paramiko.SFTPClient.from_transport(t, window_size=64 << 20, max_packet_size=32768)
+        with open(local, "rb") as src, sftp.open(remote, "wb") as dst:
+            dst.set_pipelined(True)
+            while chunk := src.read(4 << 20):
+                dst.write(chunk)
+    finally:
+        t.close()
+
+
+def _ssh_cat(cipher):
+    def run(frame, local, remote, key):
+        extra = ["-c", cipher] if cipher else []
+        with open(local, "rb") as src:
+            subprocess.run(["ssh", *ssh_base(frame, key), *extra, f"{frame.target.user}@{frame.target.host}",
+                            f"cat > {remote}"], stdin=src, check=True)
+    return run
+
+
+def m_sftp(frame, local, remote, key):
+    subprocess.run(["sftp", *ssh_base(frame, key, "-P"), "-b", "-", f"{frame.target.user}@{frame.target.host}"],
+                   input=f'put "{local}" "{remote}"\n'.encode(), check=True, stdout=subprocess.DEVNULL)
+
+
+METHODS = {"app": m_app, "paramiko-tuned": m_paramiko_tuned, "ssh": _ssh_cat(None),
+           "ssh-gcm": _ssh_cat("aes128-gcm@openssh.com"), "ssh-chacha": _ssh_cat("chacha20-poly1305@openssh.com"),
+           "sftp": m_sftp}
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    ap.add_argument("--mib", type=int, default=512)
+    ap.add_argument("--host", help="the Frame's address (default: the remembered Frame)")
+    ap.add_argument("--methods", default="app,paramiko-tuned,ssh,ssh-gcm,ssh-chacha,sftp")
+    a = ap.parse_args()
+    target = saved_targets()[0]
+    if a.host:
+        target.host = a.host
+    frame = Frame(target).connect()
+    remote = f"{frame.home}/{REMOTE}"
+    key = private_key()
+    with tempfile.NamedTemporaryFile(delete=False) as f:
+        block = os.urandom(1 << 20)
+        for _ in range(a.mib):
+            f.write(block)
+        local = f.name
+    size = a.mib << 20
+    print(f"{a.mib} MiB to {target.host} ({sys.platform}, paramiko {paramiko.__version__})")
+    try:
+        for name in a.methods.split(","):
+            if name.startswith(("ssh", "sftp")) and not shutil.which(name.split("-")[0]):
+                print(f"{name:15} skipped: no {name.split('-')[0]} on PATH")
+                continue
+            c0, t0 = cpu(), time.monotonic()
+            try:
+                METHODS[name](frame, local, remote, key)
+            except Exception as exc:  # noqa: BLE001
+                print(f"{name:15} failed: {exc}")
+                continue
+            wall, used = time.monotonic() - t0, cpu() - c0
+            got = int(frame.run(f"stat -c %s {remote}")[1].strip() or 0)
+            frame.run(f"rm -f {remote}")
+            ok = "" if got == size else f"  (size {got} != {size})"
+            print(f"{name:15} {size / wall / 1e6:7.1f} MB/s  {wall:6.1f} s  CPU here {used:5.1f} s{ok}")
+    finally:
+        os.remove(local)
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
@@ -182,7 +182,7 @@ const ICON: Record<string, string> = {
  .view :global(.ok) { color: var(--ok); font-style: normal; } .view :global(.warn) { color: var(--warn); font-style: normal; }
  .view :global(.cplay) { position: absolute; right: 8px; bottom: 30px; width: 34px; height: 34px; border-radius: 50%; display: grid; place-items: center;
    color: var(--text); background: rgba(22, 24, 30, .6); backdrop-filter: blur(6px); border: 1px solid rgba(237, 238, 242, .25);
-    opacity: 0; transform: scale(.9); transition: opacity 220ms, transform 220ms var(--ease-back), background-color 220ms; }
+    opacity: 0; transform: scale(.9); transition: opacity 220ms, transform 220ms var(--ease-spring), background-color 220ms; }
  .view :global(.card:hover .cplay) { opacity: 1; transform: none; }
  .view :global(.cplay:hover) { background: var(--accent); color: var(--on-accent); }

@@ -246,7 +246,7 @@ const ICON: Record<string, string> = {
  .view :global(.sw input) { position: absolute; opacity: 0; pointer-events: none; }
  .view :global(.sw i) { flex: none; width: 36px; height: 20px; border-radius: 999px; background: var(--surface-3); position: relative; transition: background-color 150ms; }
  .view :global(.sw i::after) { content: ""; position: absolute; left: 3px; top: 3px; width: 14px; height: 14px; border-radius: 50%; background: var(--text-2);
-    transition: transform 220ms var(--ease-back), background-color 150ms; }
+    transition: transform 220ms var(--ease-spring), background-color 150ms; }
  .view :global(.sw input:checked + i) { background: var(--secondary); }
  .view :global(.sw input:checked + i::after) { transform: translateX(16px); background: #fff; }
  .view :global(.sw input:focus-visible + i) { outline: 2px solid var(--accent); outline-offset: 2px; }
@@ -445,7 +445,7 @@ const ICON: Record<string, string> = {
  .ctx :global(button[disabled]) { color: var(--text-3); cursor: default; }
  .toasts { position: absolute; right: 14px; bottom: 14px; z-index: 45; display: grid; gap: 8px; justify-items: end; pointer-events: none; }
  .toasts :global(.toast) { max-width: 320px; padding: 10px 14px; border-radius: var(--radius-sm); background: var(--surface-2); border: 1px solid var(--border-strong);
-    border-left: 3px solid var(--ok); box-shadow: 0 12px 30px rgba(0, 0, 0, .5); font-size: 13px; animation: toastin .3s var(--ease-back) both;
+    border-left: 3px solid var(--ok); box-shadow: 0 12px 30px rgba(0, 0, 0, .5); font-size: 13px; animation: toastin .3s var(--ease-spring) both;
    transition: opacity 300ms, transform 300ms; }
  .toasts :global(.toast.info) { border-left-color: var(--secondary); }
  .toasts :global(.toast.out) { opacity: 0; transform: translateY(8px); }
@@ -36,18 +36,21 @@ const videos = [
 <section class="section tour" id="tour">
  <div class="wrap">
    <div class="head reveal">
-      <p class="label"><b>02</b> The app</p>
-      <h2>Try it before you download it</h2>
+      <p class="label">Try the app</p>
+      <h2>Click through FramePort before you download it</h2>
    </div>

    <div class="reveal"><AppMock games={games} /></div>

-    <div class="shots reveal">
+    <details class="disclose more">
+      <summary>Screenshots and videos of the real app <i aria-hidden="true">▾</i></summary>
+
+    <div class="shots">
      <p class="watch-k">The real app, screenshot by screenshot</p>
      <Carousel slides={shots} />
    </div>

-    <div class="watch reveal">
+    <div class="watch">
      <p class="watch-k">Prefer to watch? The real app on video</p>
      <div class="vids">
        {videos.map((v) => (
@@ -60,6 +63,7 @@ const videos = [
        ))}
      </div>
    </div>
+    </details>
  </div>


@@ -127,6 +131,7 @@ const videos = [
    place-items: center; font-size: 24px; color: var(--text); background: rgba(22, 24, 30, .7); cursor: pointer; }
  .player .close:hover { background: var(--accent); color: var(--on-accent); }

-  .shots { margin-top: clamp(40px, 6vw, 64px); display: grid; grid-template-columns: minmax(0, 1fr); gap: 14px; }
+  .more { margin-top: 20px; }
+  .shots { margin-top: 28px; display: grid; grid-template-columns: minmax(0, 1fr); gap: 14px; }
  .watch { margin-top: clamp(40px, 6vw, 64px); }
 </style>
@@ -145,7 +145,7 @@ const { slides } = Astro.props;
  .contain .zoom :global(img) { object-fit: contain; }
  .nav { all: unset; position: absolute; top: 50%; width: 46px; height: 46px; margin-top: -23px; border-radius: 50%; display: grid; place-items: center;
    cursor: pointer; color: var(--text); background: rgba(13, 14, 18, .6); backdrop-filter: blur(8px); border: 1px solid rgba(237, 238, 242, .2);
-    opacity: 0; transition: opacity 220ms, background-color 220ms, transform 320ms var(--ease-back); font-size: 28px; line-height: 1; }
+    opacity: 0; transition: opacity 220ms, background-color 220ms, transform 320ms var(--ease-spring); font-size: 28px; line-height: 1; }
  .prev { left: 14px; } .next { right: 14px; }
  .stage:hover .nav, .nav:focus-visible, .car:focus-within .nav { opacity: 1; }
  .nav:hover { background: var(--accent); color: var(--on-accent); transform: scale(1.08); }
@@ -6,20 +6,14 @@ import { REPORT_PROBLEM } from '../data/site';

 const SYMBOL = { yes: '✓', no: '–', part: '◐', unknown: '?' } as const;
 const LABEL = { yes: 'Yes', no: 'No', part: 'Partly', unknown: 'Not stated' } as const;
-const ICON = {
-  code: '<path d="m8 8-4 4 4 4M16 8l4 4-4 4M13.5 5l-3 14"/>',
-  game: '<path d="M3 9.5A3.5 3.5 0 0 1 6.5 6h11A3.5 3.5 0 0 1 21 9.5v4a3.5 3.5 0 0 1-3.5 3.5h-2.2a2 2 0 0 1-1.7-.95l-.75-1.2a1 1 0 0 0-1.7 0l-.75 1.2A2 2 0 0 1 8.7 17H6.5A3.5 3.5 0 0 1 3 13.5z"/>',
-  pc: '<rect x="3" y="4" width="18" height="12" rx="2"/><path d="M12 16v4M8 20h8"/>',
-  link: '<path d="M5 12.5a9 9 0 0 1 14 0M8 15.5a5 5 0 0 1 8 0M12 19h.01"/><path d="M19 3v4M17 5h4" opacity=".6"/>',
-} as const;
 ---
 <section class="section" id="compare">
  <div class="wrap">
    <div class="head reveal">
-      <p class="label"><b>04</b> Compared</p>
-      <h2>Open source, and it patches the games that don't just work</h2>
-      <p class="lead">Other tools install an app as it is. FramePort also patches Quest games that wouldn't run on the
-        Frame.</p>
+      <p class="label">Compare the tools</p>
+      <h2>FramePort patches the games that don't run as they are</h2>
+      <p class="lead">Other tools install an app unchanged. FramePort also converts and patches it, and it's free and
+        open source (GPL-3.0).</p>
    </div>

    <div class="cmp" data-cmp data-with="1">
@@ -31,10 +25,7 @@ const ICON = {

      <ul class="heads reveal">
        {HEADLINES.map((h, i) => (
-          <li class:list={['hcard', { foss: i === 0 }]} data-tilt>
-            <span class="hicon" aria-hidden="true">
-              <svg viewBox="0 0 24 24" width="22" height="22" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" set:html={ICON[h.icon]} />
-            </span>
+          <li class:list={['hcard', { foss: i === 0 }]}>
            <h3>{h.title}</h3>
            <p class="fp"><span class="who">FramePort</span>{h.frameport}</p>
            <p class="other o1"><span class="who">FrameDrop</span>{h.others[0]}</p>
@@ -82,20 +73,6 @@ const ICON = {
    cmp.dataset.with = b.dataset.withBtn!;
    cmp.querySelectorAll('[data-with-btn]').forEach((o) => o.setAttribute('aria-pressed', String(o === b)));
  }));
-  // the cards lean toward the pointer and a light follows it
-  if (!matchMedia('(prefers-reduced-motion: reduce)').matches && matchMedia('(pointer: fine)').matches) {
-    document.querySelectorAll<HTMLElement>('[data-tilt]').forEach((card) => {
-      card.addEventListener('pointermove', (e) => {
-        const r = card.getBoundingClientRect();
-        const x = (e.clientX - r.left) / r.width, y = (e.clientY - r.top) / r.height;
-        card.style.setProperty('--tx', `${((x - 0.5) * 10).toFixed(2)}deg`);
-        card.style.setProperty('--ty', `${((0.5 - y) * 8).toFixed(2)}deg`);
-        card.style.setProperty('--mx', `${(x * 100).toFixed(1)}%`);
-        card.style.setProperty('--my', `${(y * 100).toFixed(1)}%`);
-      });
-      card.addEventListener('pointerleave', () => { card.style.setProperty('--tx', '0deg'); card.style.setProperty('--ty', '0deg'); });
-    });
-  }
 </script>

 <style>
@@ -106,25 +83,22 @@ const ICON = {
  .with button[aria-pressed="true"] { color: var(--text); border-color: transparent; background: linear-gradient(90deg, rgba(58, 168, 255, .22), rgba(255, 138, 31, .22)); }
  .with button:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }

-  .heads { list-style: none; margin: 0; padding: 0; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 14px;
-    perspective: 1000px; }
+  .heads { list-style: none; margin: 0; padding: 0; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 14px; }
  .hcard { position: relative; display: grid; gap: 10px; align-content: start; padding: 22px; border-radius: var(--radius-md);
-    background: radial-gradient(260px circle at var(--mx, 50%) var(--my, 0%), rgba(255, 138, 31, .10), transparent 70%), var(--surface);
-    border: 1px solid var(--border); transform: rotateY(var(--tx, 0deg)) rotateX(var(--ty, 0deg));
-    transition: transform 300ms var(--ease-out), border-color 220ms; }
+    background: var(--surface); border: 1px solid var(--border); transition: border-color 220ms var(--ease-out); }
  .hcard:hover { border-color: rgba(255, 138, 31, .45); }
-  .hcard.foss { grid-column: 1 / -1; grid-template-columns: auto minmax(0, 1fr) minmax(0, 1fr); column-gap: 24px; align-items: start; background: radial-gradient(320px circle at var(--mx, 30%) var(--my, 0%), rgba(61, 214, 140, .14), transparent 70%),
-    linear-gradient(135deg, rgba(58, 168, 255, .08), rgba(255, 138, 31, .08)), var(--surface); border-color: rgba(61, 214, 140, .35); }
+  /* the one that matters most: free and open source gets the wide card, a green edge and the portal's light */
+  .hcard.foss { grid-column: 1 / -1; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); column-gap: 24px; align-items: start;
+    background: radial-gradient(420px circle at 22% 0%, rgba(61, 214, 140, .12), transparent 70%),
+      linear-gradient(135deg, rgba(58, 168, 255, .07), rgba(255, 138, 31, .07)), var(--surface); border-color: rgba(61, 214, 140, .35); }
+  .hcard.foss:hover { border-color: rgba(61, 214, 140, .6); }
  .hcard.foss h3 { font-size: clamp(24px, 3vw, 34px); }
-  .hcard.foss .hicon { grid-row: span 2; width: 56px; height: 56px; }
-  .hcard.foss h3 { grid-column: 2 / -1; }
+  .hcard.foss h3 { grid-column: 1 / -1; }
  .hcard.foss .other { border-top: 0; padding-top: 0; border-left: 1px dashed var(--border-strong); padding-left: 20px; }
-  .hicon { width: 42px; height: 42px; border-radius: 12px; display: grid; place-items: center; color: var(--secondary); background: rgba(58, 168, 255, .12); }
-  .foss .hicon { color: var(--ok); background: rgba(61, 214, 140, .14); }
  .hcard h3 { font-size: 19px; }
  .fp { color: var(--text); font-size: 15px; }
  .other { color: var(--text-2); font-size: 13.5px; padding-top: 8px; border-top: 1px dashed var(--border-strong); }
-  .who { display: block; font: 600 10.5px/1 var(--font-mono); letter-spacing: .12em; text-transform: uppercase; margin-bottom: 5px; }
+  .who { display: block; font: 600 11px/1 var(--font-mono); letter-spacing: .12em; text-transform: uppercase; margin-bottom: 5px; }
  .fp .who { color: var(--accent); }
  .other .who { color: var(--text-2); }
  [data-with="1"] .o2, [data-with="2"] .o1 { display: none; }
@@ -165,9 +139,6 @@ const ICON = {
  @media (max-width: 760px) {
    .heads { grid-template-columns: minmax(0, 1fr); }
    .hcard.foss { grid-template-columns: minmax(0, 1fr); }
-    .hcard.foss .hicon { grid-row: auto; }
-    /* one column: the title's "2 / -1" from the wide layout would add a second, implicit column and squeeze
-       FramePort's text into the first */
    .hcard.foss h3 { grid-column: auto; }
    .hcard.foss .other { border-left: 0; padding-left: 0; border-top: 1px dashed var(--border-strong); padding-top: 8px; }
    th, td { padding: 10px 12px; }
@@ -14,7 +14,7 @@ const latest = latestCheck(games);
 <section class="section" id="games">
  <div class="wrap">
    <div class="head reveal">
-      <p class="label"><b>03</b> Games</p>
+      <p class="label">See what runs</p>
      <h2>Tested on a Steam Frame</h2>
      <p class="lead">
        <span data-n="works" data-count>{n.works}</span> games work, <span data-n="issues" data-count>{n.issues}</span> work with issues and
@@ -79,7 +79,7 @@ const latest = latestCheck(games);
 <script type="application/json" data-snapshot set:html={JSON.stringify(snapshot).replaceAll('<', '\\u003c')} />

 <script>
-  import { counts, engines, latestCheck, rowsHtml, sortGames, type Snapshot } from '../scripts/catalog';
+  import { counts, engines, latestCheck, rowsHtml, shuffleGames, type Game, type Snapshot } from '../scripts/catalog';
  import { patchHref } from '../scripts/patchlinks';
  import { refreshCatalog } from '../scripts/catalog-live';

@@ -139,6 +139,11 @@ const latest = latestCheck(games);
      apply();
    });
    search.addEventListener('input', apply);
+    // a random order on every visit (working games still first); the built page lists them alphabetically
+    const rank = new Map<string, number>();
+    const built = Object.values((JSON.parse(document.querySelector('[data-snapshot]')?.textContent || '{"files":{}}') as
+      Snapshot).files).map((f) => f.game).filter((g): g is Game => !!g);
+    if (built.length) list.innerHTML = rowsHtml(shuffleGames(built, rank), patchHref);
    apply();

    // bring the board up to date with the catalog on GitHub
@@ -152,7 +157,7 @@ const latest = latestCheck(games);
      src.title = `The catalog on GitHub's main branch, as of ${when}`;
      src.classList.add('live');
      if (!live.changed) return;
-      const games = sortGames(live.games);
+      const games = shuffleGames(live.games, rank);
      list.innerHTML = rowsHtml(games, patchHref);
      const n = counts(games);
      for (const s of ['works', 'issues', 'unsupported'] as const) set(`[data-n="${s}"]`, String(n[s]));
@@ -221,7 +226,7 @@ const latest = latestCheck(games);
  .rows :global(.more[hidden]) { display: none; }
  .rows :global(.more p) { max-width: 100ch; line-height: 1.55; }
  .rows :global(.pt) { display: flex; flex-wrap: wrap; gap: 6px; align-items: center; }
-  .rows :global(.pt span) { font: 600 10.5px/1 var(--font-mono); letter-spacing: .12em; text-transform: uppercase; color: var(--text-2); margin-right: 4px; }
+  .rows :global(.pt span) { font: 600 11px/1 var(--font-mono); letter-spacing: .12em; text-transform: uppercase; color: var(--text-2); margin-right: 4px; }
  .rows :global(.pt code) { font-size: 12px; padding: 3px 8px; border-radius: 6px; background: rgba(58, 168, 255, .1); color: var(--secondary); }
  .rows :global(.pt a) { text-decoration: none; border-radius: 6px; }
  .rows :global(.pt a code) { transition: background 160ms; }
@@ -88,7 +88,7 @@ const reports = people.filter((p) => p.issues).length;
  .cf button:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
  .cl { margin-top: 6px; color: var(--text-2); font-size: 14px; }
  .wall { list-style: none; margin: 22px 0 6px; padding: 10px 0; display: flex; flex-wrap: wrap; gap: 10px; }
-  .wall li { transition: opacity 300ms, filter 300ms; animation: rise .5s var(--ease-back) both; animation-delay: calc(var(--i) * 18ms); }
+  .wall li { transition: opacity 300ms, filter 300ms; animation: rise .5s var(--ease-spring) both; animation-delay: calc(var(--i) * 18ms); }
  .wall li.dim { opacity: .18; filter: grayscale(1); }
  .wall a { --m: 1; display: block; width: 48px; height: 48px; border-radius: 50%; transform: scale(var(--m)); transform-origin: center bottom;
    transition: transform 160ms var(--ease-out), box-shadow 200ms; box-shadow: 0 0 0 2px var(--surface), 0 0 0 3px var(--border-strong); }
@@ -37,7 +37,7 @@ const id = big ? 'docsearch-big' : 'docsearch';
  .results :global(p) { margin: 6px 10px; font-size: 12px; color: var(--text-3); }
  .results :global(a) { display: grid; gap: 3px; padding: 9px 10px; border-radius: var(--radius-sm); text-decoration: none; color: var(--text); }
  .results :global(a.on) { background: linear-gradient(90deg, rgba(58, 168, 255, .16), rgba(255, 138, 31, .12)); }
-  .results :global(small) { font: 500 10.5px/1.2 var(--font-mono); letter-spacing: .06em; text-transform: uppercase; color: var(--secondary); }
+  .results :global(small) { font: 500 11px/1.2 var(--font-mono); letter-spacing: .06em; text-transform: uppercase; color: var(--secondary); }
  .results :global(b) { font-size: 14px; font-weight: 600; }
  .results :global(span) { font-size: 12.5px; line-height: 1.45; color: var(--text-2); }
  .results :global(mark) { background: transparent; color: var(--accent); font-weight: 600; }
@@ -34,7 +34,7 @@ const joiner = (i: number, n: number) => (i === 0 ? '' : i === n - 1 ? ' and ' :
  <section class="section credits" id="credits">
    <div class="wrap">
      <div class="head reveal">
-        <p class="label"><b>07</b> Built on</p>
+        <p class="label">Credits</p>
        <h2>Built on open source, by its users</h2>
        <p class="lead">FramePort brings these projects together and adds what the Frame needs.
          <a href={url('docs/architecture/')}>What FramePort adds</a></p>
@@ -9,7 +9,6 @@ const { games } = Astro.props;
 <section class="hero">
  <div class="hero-in wrap">
    <div class="copy">
-      <p class="eyebrow">For the Steam Frame</p>
      <h1>Your <span class="q">VR games</span>, on the <span class="f">Steam Frame</span></h1>
      <p class="lead">
        FramePort puts Quest games, PC VR games and Android apps on the Steam Frame and in your Steam library. Connect the
@@ -41,9 +40,6 @@ const { games } = Astro.props;
    background: var(--portal-glow); }
  .hero-in { display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1.05fr); gap: clamp(24px, 4vw, 64px);
    align-items: center; }
-  .eyebrow { font: 600 12px/1 var(--font-mono); letter-spacing: .16em; text-transform: uppercase; color: var(--text-2);
-    margin-bottom: 22px; display: flex; align-items: center; gap: 12px; }
-  .eyebrow::before { content: ""; width: 28px; height: 2px; background: var(--portal); }
  h1 { font-size: clamp(42px, 6.4vw, 76px); line-height: 1.0; font-weight: 800; letter-spacing: -0.035em; }
  h1 .q { color: var(--secondary); }
  h1 .f { color: var(--accent); }
@@ -51,7 +47,7 @@ const { games } = Astro.props;
  .ctas { display: flex; flex-wrap: wrap; gap: 12px; margin-top: 32px; }
  .platforms { list-style: none; display: flex; flex-wrap: wrap; gap: 4px 16px; padding: 0; margin: 18px 0 0;
    font: 500 13px/20px var(--font-sans); }
-  .platforms a { color: var(--text-2); text-decoration: none; }
+  .platforms a { display: inline-block; padding-block: 10px; margin-block: -10px; color: var(--text-2); text-decoration: none; }
  .platforms a:hover { color: var(--text); text-decoration: underline; }
  .platforms a[aria-current] { color: var(--accent); }
  .facts { margin-top: 28px; padding-top: 16px; border-top: 1px solid var(--border); font: 400 12px/1.6 var(--font-mono);
@@ -13,7 +13,7 @@ const snippet = `<a href="${pageUrl}?manifest=https%3A%2F%2Fexample.com%2Fmy-gam
 <section class="section" id="install">
  <div class="wrap">
    <div class="head reveal">
-      <p class="label"><b>05</b> Install</p>
+      <p class="label">Get started</p>
      <h2>From the download to your first game</h2>
    </div>

@@ -26,14 +26,20 @@ const snippet = `<a href="${pageUrl}?manifest=https%3A%2F%2Fexample.com%2Fmy-gam
        <h3>An "Install with FramePort" button</h3>
        <p class="muted">Put it on your download page. A click opens FramePort, which installs your game on the
          visitor's Frame.</p>
-        <div class="badge-row"><InstallBadge id="makers" href={url('install/?manifest=https%3A%2F%2Fframeport.app%2Fdemo%2Fcool-game.json')}
-          label="Try it: a demo install link (nothing is downloaded)" /><span class="try">← try it</span></div>
        <a class="small" href={url('docs/install-button/')}>How to add the button</a>
      </div>
-      <div class="snippet">
-        <div class="snippet-bar"><span>HTML</span><button type="button" class="btn btn-ghost btn-small" data-copy>Copy</button></div>
-        <pre><code data-snippet>{snippet}</code></pre>
+      <div class="makers-demo">
+        <InstallBadge id="makers" href={url('install/?manifest=https%3A%2F%2Fframeport.app%2Fdemo%2Fcool-game.json')}
+          label="Try it: a demo install link (nothing is downloaded)" />
+        <span class="try">Try it: a demo link, nothing is downloaded</span>
      </div>
+      <details class="disclose makers-code">
+        <summary>Show the HTML <i aria-hidden="true">▾</i></summary>
+        <div class="snippet">
+          <div class="snippet-bar"><span>HTML</span><button type="button" class="btn btn-ghost btn-small" data-copy>Copy</button></div>
+          <pre><code data-snippet>{snippet}</code></pre>
+        </div>
+      </details>
    </div>
  </div>
 </section>
@@ -51,17 +57,21 @@ const snippet = `<a href="${pageUrl}?manifest=https%3A%2F%2Fexample.com%2Fmy-gam
 <style>
  .others { margin-top: 14px; font-size: 14px; color: var(--text-2); }
  .small { font-size: 14px; }
-  .makers { margin-top: clamp(48px, 7vw, 80px); display: grid; grid-template-columns: minmax(0, 0.9fr) minmax(0, 1.1fr); gap: 32px;
-    padding: 32px; border-radius: var(--radius-md); border: 1px dashed var(--border-strong); background: var(--portal-glow); }
-  .makers-copy { display: grid; gap: 14px; align-content: start; }
+  /* the game-maker panel: what it is on the left, the button itself on a small stage on the right, the HTML behind a click */
+  .makers { margin-top: clamp(48px, 7vw, 80px); display: grid; grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); gap: 24px 32px;
+    padding: clamp(22px, 3vw, 32px); border-radius: var(--radius-md); border: 1px dashed var(--border-strong); background: var(--portal-glow); }
+  .makers-copy { display: grid; gap: 12px; align-content: start; }
  .makers-copy .label { margin-bottom: 0; }
  .makers-copy h3 { font-size: 24px; }
-  .badge-row { display: flex; align-items: center; gap: 14px; margin-block: 6px; }
-  .try { font: 500 13px/1 var(--font-mono); color: var(--text-2); }
-  .snippet { min-width: 0; border-radius: var(--radius-sm); background: var(--surface-2); border: 1px solid var(--border);
-    overflow: hidden; align-self: start; }
+  .makers-copy .muted { max-width: 52ch; }
+  .makers-demo { display: grid; place-items: center; align-content: center; gap: 14px; padding: 28px 20px; border-radius: var(--radius-md);
+    background: rgba(5, 6, 8, .45); border: 1px solid var(--border); }
+  .try { font: 500 12.5px/1.3 var(--font-mono); color: var(--text-2); text-align: center; }
+  .makers-code { grid-column: 1 / -1; }
+  .makers-code[open] > summary { margin-bottom: 12px; }
+  .snippet { min-width: 0; border-radius: var(--radius-sm); background: var(--surface-2); border: 1px solid var(--border); overflow: hidden; }
  .snippet-bar { display: flex; align-items: center; justify-content: space-between; padding: 6px 8px 6px 16px;
    border-bottom: 1px solid var(--border); font: 600 11px/1 var(--font-mono); letter-spacing: .12em; color: var(--text-2); }
  .snippet pre { margin: 0; padding: 16px; overflow-x: auto; font-size: 13px; line-height: 1.6; color: var(--text); }
-  @media (max-width: 760px) { .makers { grid-template-columns: 1fr; padding: 22px 18px; } }
+  @media (max-width: 760px) { .makers { grid-template-columns: minmax(0, 1fr); } }
 </style>
@@ -34,7 +34,7 @@ const logo = readFileSync(join(process.cwd(), '..', 'src/frameport/ui/icons/logo
 <style>
  .ib { --mx: 56%; --my: 65%; position: relative; display: inline-flex; align-items: center; gap: 10px; width: 216px; height: 60px; padding: 0 14px 0 10px;
    box-sizing: border-box; border-radius: 12px; overflow: hidden; text-decoration: none; isolation: isolate;
-    background: #0d0e12; border: 1px solid #2a2d37; transition: transform 320ms var(--ease-back), border-color 220ms, box-shadow 220ms; }
+    background: #0d0e12; border: 1px solid #2a2d37; transition: transform 320ms var(--ease-spring), border-color 220ms, box-shadow 220ms; }
  .ib:hover { transform: translateY(-2px) scale(1.03); border-color: rgba(255, 138, 31, .6); box-shadow: 0 10px 30px rgba(0, 0, 0, .5), 0 0 24px rgba(255, 138, 31, .25); }
  .ib:active { transform: scale(.97); }
  .ib:focus-visible { outline: 2px solid var(--accent); outline-offset: 3px; }
@@ -46,7 +46,7 @@ const logo = readFileSync(join(process.cwd(), '..', 'src/frameport/ui/icons/logo
  .ib:hover .ib-core { opacity: 1; }
  .ib.pressed::after { content: ""; position: absolute; left: var(--mx); top: var(--my); width: 20px; height: 20px; margin: -10px; border-radius: 50%;
    border: 2px solid var(--secondary); animation: ibring .6s var(--ease-out) forwards; pointer-events: none; }
-  .ib :global(.ib-logo) { width: 40px; height: 40px; flex: none; transition: transform 600ms var(--ease-back); }
+  .ib :global(.ib-logo) { width: 40px; height: 40px; flex: none; transition: transform 600ms var(--ease-spring); }
  .ib:hover :global(.ib-logo) { transform: rotate(-8deg) scale(1.06); }
  .ib-text { display: grid; gap: 2px; line-height: 1; }
  .ib-text small { font: 700 9.5px/1 var(--font-sans); letter-spacing: .14em; text-transform: uppercase; color: #a7abb7; }
@@ -6,6 +6,8 @@ import HeadsetModel from './HeadsetModel.astro';
 import { DOWNLOADS, RELEASES, downloadPage, url } from '../data/site';

 const FIRST = Object.fromEntries(DOWNLOADS.map((d) => [d.os, d.first]));
+// what the unpacked folder holds to start, per platform (the Downloads scene shows it)
+const RUN: Record<string, string> = { windows: 'FramePort.exe', macos: 'FramePort.app', linux: 'FramePort', 'linux-arm64': 'FramePort' };
 const LINE = 'curl -fsSL https://frameport.app/s | bash';
 const steps = [
  { side: 'pc', where: 'On your PC', title: 'Download FramePort' },
@@ -35,7 +37,7 @@ const steps = [
        <p>Windows, macOS or Linux. Unpack it anywhere and start it. No installer; it updates itself.</p>
        <div class="dls">
          {DOWNLOADS.map((d) => (
-            <a class="dl" href={downloadPage(d.os)} data-os={d.os} data-first={FIRST[d.os]}>
+            <a class="dl" href={downloadPage(d.os)} data-os={d.os} data-first={FIRST[d.os]} data-asset={d.asset} data-run={RUN[d.os]}>
              <strong>{d.label}</strong><span>{d.detail}</span>
            </a>
          ))}
@@ -45,8 +47,8 @@ const steps = [
      </div>
      <div class="scene pcwin" aria-hidden="true">
        <div class="wbar"><i></i><i></i><i></i><span>Downloads</span></div>
-        <div class="dlrow"><span class="zip">ZIP</span><div><b data-zip>FramePort-windows-x64.zip</b><span class="bar"><i></i></span></div></div>
-        <div class="folder"><span class="fico"></span><b>FramePort</b><span class="exe">FramePort.exe</span></div>
+        <div class="dlrow"><span class="zip" data-kind>ZIP</span><div><b data-zip>FramePort-windows-x64.zip</b><span class="bar"><i></i></span></div></div>
+        <div class="folder"><span class="fico"></span><b>FramePort</b><span class="exe" data-run-out>FramePort.exe</span></div>
      </div>
    </section>

@@ -88,6 +90,8 @@ const steps = [
          <p>Open Konsole: SteamVR dashboard → <b>Launch a program → Desktop</b>, then app menu → <b>System → Konsole</b>.
            Run this line:</p>
          <div class="cmd"><code><span class="prompt">$</span>{LINE}</code><button type="button" class="btn btn-ghost btn-small" data-copy-line={LINE}>Copy</button></div>
+          <p class="calm">It finds FramePort on your PC and waits: nothing changes on the Frame until you click
+            <b>Allow</b>. Then it turns on Developer Mode. No password, no root. <a href={url('setup.sh')}>Read the script</a></p>
          <p class="small">No keyboard? Open <a href={url('setup/')}>the setup page</a> in Chromium on the Frame (Steam's
            <b>+</b> on the taskbar installs it) and copy the line.</p>
        </div>
@@ -267,9 +271,14 @@ const steps = [
    const setFirst = (d?: HTMLElement) => {
      if (!d) return;
      if (firstOut) firstOut.textContent = d.dataset.first!;
+      // the real file for that platform (the link itself is the download page, /download/?os=…)
+      const asset = d.dataset.asset ?? 'FramePort-windows-x64.zip';
      const zip = wt.querySelector('[data-zip]');
-      const a = d.getAttribute('href') ?? '';
-      if (zip) zip.textContent = a.split('/').pop() || 'FramePort.zip';
+      if (zip) zip.textContent = asset;
+      const kind = wt.querySelector('[data-kind]');
+      if (kind) kind.textContent = asset.endsWith('.tar.gz') ? 'TAR.GZ' : 'ZIP';
+      const run = wt.querySelector('[data-run-out]');
+      if (run) run.textContent = d.dataset.run ?? 'FramePort';
    };
    requestAnimationFrame(() => setFirst(mine()));
    dls.forEach((d) => {
@@ -294,7 +303,7 @@ const steps = [
  .pip .k { flex: none; width: 28px; height: 28px; border-radius: 50%; display: grid; place-items: center; font: 800 14px/1 var(--font-display);
    background: var(--surface-3); color: var(--text-2); transition: background-color 220ms, color 220ms; }
  .pip .t { display: grid; gap: 1px; min-width: 0; font: 600 13px/1.2 var(--font-sans); color: var(--text-2); }
-  .pip .t small { font: 500 10.5px/1.2 var(--font-mono); letter-spacing: .06em; text-transform: uppercase; color: var(--text-3); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+  .pip .t small { font: 500 11px/1.2 var(--font-mono); letter-spacing: .06em; text-transform: uppercase; color: var(--text-3); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
  .pip[aria-selected="true"] { border-color: rgba(255, 138, 31, .55); background: linear-gradient(90deg, rgba(58, 168, 255, .1), rgba(255, 138, 31, .1)); }
  .pip[aria-selected="true"] .t { color: var(--text); }
  .pip.pc[aria-selected="true"] .k, .pip.pc.past .k { background: var(--secondary); color: var(--on-accent); }
@@ -306,12 +315,15 @@ const steps = [
  .pane.on { animation: slide .45s var(--ease-out); }
  @keyframes slide { from { opacity: 0; transform: translateX(calc(var(--dir) * 24px)); } to { opacity: 1; transform: none; } }
  .txt { display: grid; gap: 12px; align-content: start; min-width: 0; }
+  .way-line:not([hidden]) { display: grid; gap: 12px; }
  .txt h3 { font-size: clamp(22px, 2.6vw, 28px); }
  .txt p { color: var(--text-2); }
  .txt b { color: var(--text); font-weight: 600; }
  .ey { font: 600 11px/1 var(--font-mono); letter-spacing: .14em; text-transform: uppercase; }
  .ey.pc { color: var(--secondary); } .ey.fr { color: var(--accent); }
  .small { font-size: 14px; }
+  /* the reassurance next to the one command that changes the Frame: brighter than the hints around it */
+  .txt p.calm { font-size: 14px; color: var(--text); }
  .first { font-size: 14px; min-height: 3em; }
  .dls { display: flex; flex-wrap: wrap; gap: 8px; }
  .dl { display: grid; gap: 2px; padding: 9px 14px; min-width: 130px; border-radius: var(--radius-sm); text-decoration: none;
@@ -334,7 +346,7 @@ const steps = [
  .wbar i { width: 9px; height: 9px; border-radius: 50%; background: var(--surface-3); }
  .wbar span { margin-left: 6px; }
  .dlrow { display: flex; gap: 12px; align-items: center; padding: 18px; }
-  .zip { flex: none; width: 40px; height: 48px; border-radius: 6px; display: grid; place-items: center; font: 800 11px/1 var(--font-display);
+  .zip { flex: none; min-width: 40px; padding-inline: 5px; height: 48px; border-radius: 6px; display: grid; place-items: center; font: 800 11px/1 var(--font-display);
    background: linear-gradient(160deg, var(--secondary-soft), var(--surface-3)); color: var(--secondary); }
  .dlrow > div { display: grid; gap: 8px; flex: 1; min-width: 0; }
  .dlrow b { font-size: 13px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
@@ -403,7 +415,7 @@ const steps = [
  .run .ticks li:nth-child(1) { animation-delay: .3s; } .run .ticks li:nth-child(2) { animation-delay: 1s; }
  .run .ticks li:nth-child(3) { animation-delay: 1.7s; } .run .ticks li:nth-child(4) { animation-delay: 2.4s; }
  @keyframes tick { to { opacity: 1; border-color: rgba(61, 214, 140, .35); } }
-  .run .ticks li::before { animation: tickdot .4s var(--ease-back) forwards; animation-delay: inherit; }
+  .run .ticks li::before { animation: tickdot .4s var(--ease-spring) forwards; animation-delay: inherit; }
  @keyframes tickdot { to { background: var(--ok); transform: scale(1.1); } }
  .conn-card { display: flex; align-items: center; gap: 12px; padding: 12px 14px; border-radius: 10px; background: var(--sidebar);
    border: 1px solid var(--border); opacity: 0; transform: translateY(8px); font-size: 13px; }
@@ -424,7 +436,7 @@ const steps = [
  .run .inst .bar i { animation: grow 2.2s var(--ease-out) .3s forwards; }
  .playb { justify-self: start; padding: 9px 14px; border-radius: 8px; background: var(--accent); color: var(--on-accent); font: 600 13px/1 var(--font-sans);
    opacity: 0; transform: scale(.9); }
-  .run .playb { animation: pop .4s var(--ease-back) 2.6s forwards; }
+  .run .playb { animation: pop .4s var(--ease-spring) 2.6s forwards; }
  @keyframes pop { to { opacity: 1; transform: none; } }
  .video { position: relative; display: block; border-radius: var(--radius-sm); overflow: hidden; border: 1px solid var(--border); text-decoration: none;
    max-width: 420px; transition: transform 220ms var(--ease-out); }
@@ -5,6 +5,16 @@ import { REPO, downloadPage, url } from '../data/site';
 interface Props { home?: boolean }
 const { home = true } = Astro.props;
 const at = (hash: string) => (home ? hash : url(hash));
+const links = [
+  { href: at('#how'), label: 'How it works' },
+  { href: at('#games'), label: 'Games' },
+  { href: at('#compare'), label: 'Compare' },
+  { href: at('#install'), label: 'Get started' },
+  { href: url('setup/'), label: 'Setup' },
+  { href: url('changelog/'), label: "What's new" },
+  { href: url('docs/'), label: 'Docs' },
+  { href: REPO, label: 'GitHub' },
+];
 ---
 <header class="nav">
  <div class="nav-in wrap">
@@ -12,20 +22,30 @@ const at = (hash: string) => (home ? hash : url(hash));
      <img src={url('favicon.svg')} alt="" width="30" height="30" />
      <Wordmark id="nav" />
    </a>
-    <nav aria-label="Sections">
-      <a href={at('#how')}>How it works</a>
-      <a href={at('#games')}>Games</a>
-      <a href={at('#compare')}>Compared</a>
-      <a href={at('#install')}>Install</a>
-      <a href={url('setup/')}>Setup</a>
-      <a href={url('changelog/')}>What's new</a>
-      <a href={url('docs/')}>Docs</a>
-      <a href={REPO}>GitHub</a>
+    <nav class="links" aria-label="Sections">
+      {links.map((l) => <a href={l.href}>{l.label}</a>)}
    </nav>
-    <a class="btn btn-primary btn-small" href={downloadPage()} data-download><span data-download-label>Download FramePort</span></a>
+    <button type="button" class="menu-btn" popovertarget="site-menu" aria-controls="site-menu">
+      <svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true"><path d="M4 7h16M4 12h16M4 17h16" /></svg>
+      Menu
+    </button>
+    <a class="btn btn-primary btn-small dl" href={downloadPage()} data-download><span data-download-label>Download FramePort</span></a>
+  </div>
+  <!-- narrow windows and phones: the same links in a panel under the bar (Esc or a click outside closes it) -->
+  <div id="site-menu" class="menu" popover>
+    <nav aria-label="Sections">
+      {links.map((l) => <a href={l.href}>{l.label}</a>)}
+    </nav>
+    <a class="btn btn-primary" href={downloadPage()} data-download><span data-download-label>Download FramePort</span></a>
  </div>
 </header>

+<script>
+  // a link inside the menu closes it (in-page links don't navigate away)
+  const menu = document.getElementById('site-menu');
+  menu?.addEventListener('click', (e) => { if ((e.target as Element).closest('a')) menu.hidePopover?.(); });
+</script>
+
 <style>
  .nav {
    position: sticky; top: 0; z-index: 50;
@@ -37,13 +57,36 @@ const at = (hash: string) => (home ? hash : url(hash));
  .nav-in { display: flex; align-items: center; gap: 24px; min-height: 64px; }
  .brand { display: inline-flex; align-items: center; gap: 10px; text-decoration: none; }
  .brand img { border-radius: 7px; }
-  nav { display: flex; gap: 2px; margin-left: auto; }
-  nav a { padding: 8px 12px; border-radius: var(--radius-sm); color: var(--text-2); text-decoration: none;
-    font: 500 14px/20px var(--font-sans); }
-  nav a:hover { color: var(--text); background: rgba(237, 238, 242, 0.06); }
+  .links { display: flex; gap: 2px; margin-left: auto; }
+  .links a, .menu a:not(.btn) { padding: 8px 12px; border-radius: var(--radius-sm); color: var(--text-2); text-decoration: none;
+    font: 500 14px/20px var(--font-sans); white-space: nowrap; }
+  .links a:hover, .menu a:not(.btn):hover { color: var(--text); background: rgba(237, 238, 242, 0.06); }
  [data-download-label] { font-size: 13px; }
-  @media (max-width: 760px) {
-    nav { display: none; }
-    .btn { margin-left: auto; }
+
+  .menu-btn { display: none; align-items: center; gap: 8px; margin-left: auto; min-height: 44px; padding: 0 14px;
+    border: 1px solid var(--border-strong); border-radius: var(--radius-sm); background: transparent; color: var(--text);
+    font: 600 14px/1 var(--font-sans); cursor: pointer; }
+  .menu-btn svg { fill: none; stroke: currentColor; stroke-width: 2; stroke-linecap: round; }
+  .menu-btn:hover { background: rgba(237, 238, 242, 0.06); }
+  .menu-btn:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+
+  .menu { position: fixed; inset: 66px 0 auto 0; margin: 0; width: 100%; max-height: calc(100dvh - 66px); overflow-y: auto;
+    padding: 8px var(--gutter) 20px; border: 0; border-bottom: 1px solid var(--border-strong); background: var(--sidebar);
+    color: var(--text); box-shadow: 0 18px 40px rgba(0, 0, 0, .55); }
+  .menu nav { display: grid; margin-bottom: 14px; }
+  .menu a:not(.btn) { display: flex; align-items: center; min-height: 48px; font-size: 16px; color: var(--text);
+    border-bottom: 1px solid var(--border); border-radius: 0; }
+  .menu .btn { width: 100%; }
+  .menu .btn [data-download-label] { font-size: 15px; }
+
+  /* the eight links fit one row only in wide windows; below that they move into the menu */
+  @media (max-width: 1120px) {
+    .links { display: none; }
+    .menu-btn { display: inline-flex; }
+    .nav-in { gap: 12px; }
+  }
+  /* phones: the bar keeps the brand and the menu; the download (for the PC) waits in the menu */
+  @media (max-width: 560px) {
+    .nav-in > .dl { display: none; }
  }
 </style>
@@ -12,12 +12,12 @@
 </aside>

 <style>
-  .notice-band { padding-block: 8px clamp(40px, 6vw, 72px); }
+  .notice-band { padding-block: clamp(24px, 3vw, 32px) clamp(40px, 6vw, 72px); }
  .notice-in { display: flex; gap: 16px; align-items: flex-start; padding: 18px 22px; border-radius: var(--radius-md);
    background: rgba(92, 208, 230, 0.06); border: 1px solid rgba(92, 208, 230, 0.3); }
  .mark { flex: none; width: 28px; height: 28px; border-radius: 50%; display: grid; place-items: center; font: 800 15px/1 var(--font-display);
    color: var(--bg); background: var(--info); }
  .notice-in { flex-wrap: wrap; }
-  p { flex: 1 1 calc(100% - 60px); font-size: 15px; line-height: 1.6; color: var(--text); max-width: 100ch; }
+  p { flex: 1 1 calc(100% - 60px); font-size: 15px; line-height: 1.6; color: var(--text); max-width: 64ch; }
  .poc { flex-basis: 100%; padding-left: 44px; font-size: 13px; color: var(--text-2); }
 </style>
@@ -39,8 +39,9 @@ const frame: Stage[] = [
 <section class="section" id="how">
  <div class="wrap">
    <div class="head reveal">
-      <p class="label"><b>01</b> How it works</p>
-      <h2>Ten stages between your PC and the Steam Frame<br /><span class="muted">You click once</span></h2>
+      <p class="label">See how it works</p>
+      <h2>What happens when you click Install on Frame</h2>
+      <p class="lead">Ten stages: seven on your PC, three on the Frame. You only click once.</p>
    </div>

    <div class="log reveal" data-log>
@@ -169,10 +170,12 @@ const frame: Stage[] = [
  .ok { font: 600 11px/1 var(--font-mono); color: var(--ok); text-transform: uppercase; justify-self: end; }

  /* scrolling completes the install line by line (scripts/interactions.ts marks .done), like the app's activity log */
-  .log.scrubbed .stage { opacity: .32; transition: opacity 450ms var(--ease-out), background-color 300ms; }
-  .log.scrubbed .stage.done { opacity: 1; }
-  .log.scrubbed .stage.done .g { animation: gpop .5s var(--ease-back); }
-  .log.scrubbed .ok { opacity: 0; transform: scale(.5); transition: opacity 300ms, transform 400ms var(--ease-back); }
+  /* a stage not reached yet: its mark and name wait, its text stays readable */
+  .log.scrubbed .stage .g { transition: opacity 450ms var(--ease-out); }
+  .log.scrubbed .stage:not(.done) .g { opacity: .4; }
+  .log.scrubbed .stage:not(.done) :is(.n, .t, .d) { color: var(--text-3); }
+  .log.scrubbed .stage.done .g { animation: gpop .5s var(--ease-spring); }
+  .log.scrubbed .ok { opacity: 0; transform: scale(.5); transition: opacity 300ms, transform 400ms var(--ease-spring); }
  .log.scrubbed .stage.done .ok { opacity: 1; transform: none; }
  .log.complete .log-title::after { content: "· done"; margin-left: 4px; color: var(--ok); font: 600 12px/1 var(--font-mono); }
  @keyframes gpop { 40% { transform: scale(1.25); } }
@@ -211,4 +214,6 @@ const frame: Stage[] = [
    .t { grid-column: 2 / 4; }
    .d { grid-column: 2 / 4; text-align: left; }
  }
+  /* phones: what each stage does is enough; the technical detail (file names, patch ids) stays on wider screens */
+  @media (max-width: 600px) { .d { display: none; } }
 </style>
@@ -1,7 +1,7 @@
 ---
-// The home page's look at the latest release (src/data/releases.ts): its first changes, the few releases before it
-// and the dev build in testing. The full list is the changelog page.
-import { LATEST, NEXT, RELEASES } from '../data/releases';
+// The home page's look at the latest release (src/data/releases.ts): its first changes and the three releases before
+// it. The full list (and the dev build in testing) is the changelog page.
+import { LATEST, RELEASES } from '../data/releases';
 import { url } from '../data/site';

 const before = RELEASES.slice(1, 4);
@@ -12,7 +12,7 @@ const more = LATEST ? LATEST.changes - LATEST.highlights.length : 0;
  <section class="section" id="whats-new">
    <div class="wrap">
      <div class="head reveal">
-        <p class="label"><b>06</b> What's new</p>
+        <p class="label">What's new</p>
        <h2>FramePort {LATEST.version}</h2>
      </div>

@@ -35,12 +35,6 @@ const more = LATEST ? LATEST.changes - LATEST.highlights.length : 0;
              </li>
            ))}
          </ol>
-          {NEXT && (
-            <a class="soon" href={url('changelog/#next')}>
-              <span class="pill pill-pc">In testing</span>
-              <span>Coming next: <b>{NEXT.version}</b></span>
-            </a>
-          )}
          <a class="btn btn-secondary btn-small all" href={page()}>All releases</a>
        </div>
      </div>
@@ -75,10 +69,6 @@ const more = LATEST ? LATEST.changes - LATEST.highlights.length : 0;
  .mini time { justify-self: end; align-self: center; }
  .mini .h { grid-column: 1 / -1; color: var(--text-2); font-size: 14px; line-height: 1.45;
    display: -webkit-box; -webkit-line-clamp: 1; line-clamp: 1; -webkit-box-orient: vertical; overflow: hidden; }
-  .soon { display: flex; align-items: center; gap: 10px; padding: 10px 14px; border-radius: var(--radius-md);
-    border: 1px dashed var(--secondary-line); color: var(--text-2); font-size: 14px; text-decoration: none; }
-  .soon b { color: var(--text); font: 500 13px var(--font-mono); }
-  .soon:hover { background: rgba(58, 168, 255, .06); text-decoration: none; }
  .all { justify-self: start; }
  @media (max-width: 860px) { .wn { grid-template-columns: 1fr; } }
  @media (prefers-reduced-motion: reduce) { .now { transition: none; } .now:hover { transform: none; } }
@@ -1,14 +1,23 @@
 {
- "updated": "2026-10-11",
+ "updated": "2026-10-12",
 "people": [
  {
   "login": "spoopyghosty0",
   "avatar": "https://avatars.githubusercontent.com/u/336754034?v=4",
   "url": "https://github.com/spoopyghosty0",
-   "commits": 523,
-   "issues": 4,
+   "commits": 542,
+   "issues": 5,
   "prs": 3,
-   "total": 550
+   "total": 572
+  },
+  {
+   "login": "Klownicle",
+   "avatar": "https://avatars.githubusercontent.com/u/6896081?v=4",
+   "url": "https://github.com/Klownicle",
+   "commits": 0,
+   "issues": 20,
+   "prs": 0,
+   "total": 60
  },
  {
   "login": "StevenPartridge",
@@ -29,13 +38,13 @@
   "total": 45
  },
  {
-   "login": "Klownicle",
-   "avatar": "https://avatars.githubusercontent.com/u/6896081?v=4",
-   "url": "https://github.com/Klownicle",
+   "login": "Sheebalove",
+   "avatar": "https://avatars.githubusercontent.com/u/176067652?v=4",
+   "url": "https://github.com/Sheebalove",
   "commits": 0,
-   "issues": 13,
+   "issues": 11,
   "prs": 0,
-   "total": 39
+   "total": 33
  },
  {
   "login": "inseend",
@@ -100,6 +109,15 @@
   "prs": 0,
   "total": 15
  },
+  {
+   "login": "Scoota23",
+   "avatar": "https://avatars.githubusercontent.com/u/27732436?v=4",
+   "url": "https://github.com/Scoota23",
+   "commits": 0,
+   "issues": 5,
+   "prs": 0,
+   "total": 15
+  },
  {
   "login": "eepykith",
   "avatar": "https://avatars.githubusercontent.com/u/338898488?v=4",
@@ -226,6 +244,15 @@
   "prs": 0,
   "total": 6
  },
+  {
+   "login": "ganona",
+   "avatar": "https://avatars.githubusercontent.com/u/112239200?v=4",
+   "url": "https://github.com/ganona",
+   "commits": 0,
+   "issues": 2,
+   "prs": 0,
+   "total": 6
+  },
  {
   "login": "GreySyntax",
   "avatar": "https://avatars.githubusercontent.com/u/242626?v=4",
@@ -244,6 +271,15 @@
   "prs": 0,
   "total": 6
  },
+  {
+   "login": "Minibattle",
+   "avatar": "https://avatars.githubusercontent.com/u/67839290?v=4",
+   "url": "https://github.com/Minibattle",
+   "commits": 0,
+   "issues": 2,
+   "prs": 0,
+   "total": 6
+  },
  {
   "login": "puppet-head",
   "avatar": "https://avatars.githubusercontent.com/u/8073775?v=4",
@@ -289,6 +325,15 @@
   "prs": 0,
   "total": 3
  },
+  {
+   "login": "Aryetis",
+   "avatar": "https://avatars.githubusercontent.com/u/4246001?v=4",
+   "url": "https://github.com/Aryetis",
+   "commits": 0,
+   "issues": 1,
+   "prs": 0,
+   "total": 3
+  },
  {
   "login": "bcain2005-gif",
   "avatar": "https://avatars.githubusercontent.com/u/258048498?v=4",
@@ -316,6 +361,15 @@
   "prs": 0,
   "total": 3
  },
+  {
+   "login": "DolphinOfficial",
+   "avatar": "https://avatars.githubusercontent.com/u/92276540?v=4",
+   "url": "https://github.com/DolphinOfficial",
+   "commits": 0,
+   "issues": 1,
+   "prs": 0,
+   "total": 3
+  },
  {
   "login": "dontstealthisplease-gif",
   "avatar": "https://avatars.githubusercontent.com/u/337959488?v=4",
@@ -343,6 +397,15 @@
   "prs": 0,
   "total": 3
  },
+  {
+   "login": "felis-lynx",
+   "avatar": "https://avatars.githubusercontent.com/u/106830854?v=4",
+   "url": "https://github.com/felis-lynx",
+   "commits": 0,
+   "issues": 1,
+   "prs": 0,
+   "total": 3
+  },
  {
   "login": "Froghut",
   "avatar": "https://avatars.githubusercontent.com/u/1702171?v=4",
@@ -370,6 +433,15 @@
   "prs": 0,
   "total": 3
  },
+  {
+   "login": "hokey1981",
+   "avatar": "https://avatars.githubusercontent.com/u/42741984?v=4",
+   "url": "https://github.com/hokey1981",
+   "commits": 0,
+   "issues": 1,
+   "prs": 0,
+   "total": 3
+  },
  {
   "login": "InsideCat02",
   "avatar": "https://avatars.githubusercontent.com/u/111202797?v=4",
@@ -398,9 +470,18 @@
   "total": 3
  },
  {
-   "login": "Minibattle",
-   "avatar": "https://avatars.githubusercontent.com/u/67839290?v=4",
-   "url": "https://github.com/Minibattle",
+   "login": "Mitchlett",
+   "avatar": "https://avatars.githubusercontent.com/u/46537377?v=4",
+   "url": "https://github.com/Mitchlett",
+   "commits": 0,
+   "issues": 1,
+   "prs": 0,
+   "total": 3
+  },
+  {
+   "login": "Momofier",
+   "avatar": "https://avatars.githubusercontent.com/u/13684228?v=4",
+   "url": "https://github.com/Momofier",
   "commits": 0,
   "issues": 1,
   "prs": 0,
@@ -415,6 +496,15 @@
   "prs": 0,
   "total": 3
  },
+  {
+   "login": "Obliviate28",
+   "avatar": "https://avatars.githubusercontent.com/u/341108069?v=4",
+   "url": "https://github.com/Obliviate28",
+   "commits": 0,
+   "issues": 1,
+   "prs": 0,
+   "total": 3
+  },
  {
   "login": "Puchor",
   "avatar": "https://avatars.githubusercontent.com/u/46112576?v=4",
@@ -433,6 +523,15 @@
   "prs": 0,
   "total": 3
  },
+  {
+   "login": "ssgod101",
+   "avatar": "https://avatars.githubusercontent.com/u/49173466?v=4",
+   "url": "https://github.com/ssgod101",
+   "commits": 0,
+   "issues": 1,
+   "prs": 0,
+   "total": 3
+  },
  {
   "login": "TainakaRitsu",
   "avatar": "https://avatars.githubusercontent.com/u/12560774?v=4",
@@ -69,6 +69,11 @@
  "title": "Per-eye diagnostics (log)",
  "group": "Game settings"
 },
+ "adapter.fade_quad": {
+  "anchor": "adapter-fade_quad",
+  "title": "Draw fades over the picture",
+  "group": "Game settings"
+ },
 "adapter.flip_emul": {
  "anchor": "adapter-flip_emul",
  "title": "Fix upside-down menus",
@@ -341,7 +346,7 @@
 },
 "device.foveation": {
  "anchor": "device-foveation",
-  "title": "Eye-tracked foveation (Valve)",
+  "title": "Foveated rendering (Valve)",
  "group": "Files and settings on the Frame"
 },
 "device.hide_navbar": {
@@ -379,11 +384,21 @@
  "title": "Skip Meta avatars",
  "group": "Steam Frame patches"
 },
+ "frame.bhaptics_permission": {
+  "anchor": "frame-bhaptics_permission",
+  "title": "bHaptics: skip the Bluetooth permission request",
+  "group": "Steam Frame patches"
+ },
 "frame.blazerush": {
  "anchor": "frame-blazerush",
  "title": "BlazeRush: controllers without Meta avatars, own shader cache",
  "group": "Steam Frame patches"
 },
+ "frame.eos_keychain_loop": {
+  "anchor": "frame-eos_keychain_loop",
+  "title": "Epic Online Services: stop the keychain retry loop",
+  "group": "Steam Frame patches"
+ },
 "frame.gl_multiview_fbo": {
  "anchor": "frame-gl_multiview_fbo",
  "title": "OpenGL ES: multiview shaders on flat panels (HUD, menus)",
@@ -529,6 +544,11 @@
  "title": "Make Unity text fields work",
  "group": "Steam Frame patches"
 },
+ "frame.unity_tls_key_pool": {
+  "anchor": "frame-unity_tls_key_pool",
+  "title": "Unity: share thread keys (games that run out of them)",
+  "group": "Steam Frame patches"
+ },
 "frame.unity_user_presence": {
  "anchor": "frame-unity_user_presence",
  "title": "Unity: headset always counts as worn",
@@ -539,6 +559,11 @@
  "title": "GL shim for Unreal (no multisampled render-to-texture)",
  "group": "Steam Frame patches"
 },
+ "frame.unreal_multiview_depth": {
+  "anchor": "frame-unreal_multiview_depth",
+  "title": "Unreal: match multiview depth to the eye size",
+  "group": "Steam Frame patches"
+ },
 "frame.unreal_ovrp_entrypoints": {
  "anchor": "frame-unreal_ovrp_entrypoints",
  "title": "Unreal: stand-ins for OVRPlugin functions OVRPort lacks",
@@ -559,11 +584,21 @@
  "title": "Unreal: start without the OBB check",
  "group": "Steam Frame patches"
 },
+ "frame.unreal_splash_bypass": {
+  "anchor": "frame-unreal_splash_bypass",
+  "title": "Unreal: bypass the stalled loading splash",
+  "group": "Steam Frame patches"
+ },
 "frame.unreal_thumb_touch": {
  "anchor": "frame-unreal_thumb_touch",
  "title": "Unreal: thumb follows the capacitive touches",
  "group": "Steam Frame patches"
 },
+ "frame.vermillion_scene_canvas": {
+  "anchor": "frame-vermillion_scene_canvas",
+  "title": "Vermillion: paint canvases in the scene",
+  "group": "Steam Frame patches"
+ },
 "frame.vivox_audio_route": {
  "anchor": "frame-vivox_audio_route",
  "title": "Vivox voice chat: skip Android 12 audio routing",
@@ -1,6 +1,30 @@
 {
- "updated": "2026-10-11",
+ "updated": "2026-10-12",
 "releases": [
+  {
+   "tag": "v1.0.4",
+   "name": "FramePort v1.0.4",
+   "date": "2026-10-11",
+   "url": "https://github.com/spoopyghosty0/frameport/releases/tag/v1.0.4",
+   "dev": false,
+   "notes": "FramePort v1.0.4: Windows (x64), macOS (Apple Silicon) and Linux (x64, ARM64).\n\n## What's new\n\n- **Launch tests no longer report \"Failed to launch\"** for games that run fine but crash once the test ends their VR session because no headset is worn (e.g. BlazeRush).\n\nAlready have FramePort? It offers this update itself (Library → **Update now**).\n\n## Install\n\nDownload the file for your PC, unpack it and start FramePort. Guide:\n[Install and first steps](https://frameport.app/docs/install/).\n"
+  },
+  {
+   "tag": "v1.0.3",
+   "name": "FramePort v1.0.3",
+   "date": "2026-10-11",
+   "url": "https://github.com/spoopyghosty0/frameport/releases/tag/v1.0.3",
+   "dev": false,
+   "notes": "FramePort v1.0.3: Windows (x64), macOS (Apple Silicon) and Linux (x64, ARM64).\n\n## What's new\n\n- **One FramePort at a time:** starting it again brings the open window to the front, and FramePort fully closes with its window.\n- **After an update, FramePort restarts with a working window** instead of a black one (Windows).\n- The update dialogs' \"All releases\" and \"Release page\" buttons work again.\n- When several play sessions are checked at once, one message lists them instead of one per game.\n\nAlready have FramePort? It offers this update itself (Library → **Update now**).\n\n## Install\n\nDownload the file for your PC, unpack it and start FramePort. Guide:\n[Install and first steps](https://frameport.app/docs/install/).\n"
+  },
+  {
+   "tag": "v1.0.2",
+   "name": "FramePort v1.0.2",
+   "date": "2026-10-11",
+   "url": "https://github.com/spoopyghosty0/frameport/releases/tag/v1.0.2",
+   "dev": false,
+   "notes": "FramePort v1.0.2: Windows (x64), macOS (Apple Silicon) and Linux (x64, ARM64).\n\n## What's new\n\n- **Progress is kept:** games that save under your Meta user (for example Walkabout Mini Golf) no longer start with an empty profile each time. Click **Update on Frame** on their page.\n- A new troubleshooting FAQ in the docs: where a game's settings are and what to try when a game misbehaves.\n\nAlready have FramePort? It offers this update itself (Library → **Update now**).\n\n## Install\n\nDownload the file for your PC, unpack it and start FramePort. Guide:\n[Install and first steps](https://frameport.app/docs/install/).\n"
+  },
  {
   "tag": "v1.0.1",
   "name": "FramePort v1.0.1",
@@ -67,16 +67,20 @@ const feed = new URL(url('changelog/feed.xml'), Astro.site);
          if (label) label.textContent = `Download for ${pick.label}`;
        }
        for (const el of document.querySelectorAll(`[data-os="${pick.os}"]`)) el.setAttribute('aria-current', 'true');
+      } else if (/Android|iPhone|iPad|Mobile/i.test(ua)) {
+        // FramePort runs on a PC: on a phone the buttons lead to the download page's "open this on your PC" state
+        for (const el of document.querySelectorAll('[data-download-label]')) el.textContent = 'Get it on your PC';
      }
    </script>
    <script>
      import { initInteractions } from '../scripts/interactions';
-      // Sections fade in once as they reach the viewport (not with reduced motion: CSS shows them at once).
+      // Sections settle in once as they reach the viewport: a short, small rise (with reduced motion: CSS shows them at
+      // once). Everything is visible without the script.
      const io = new IntersectionObserver((entries) => {
        for (const e of entries) {
          if (e.isIntersecting) { e.target.classList.add('in'); io.unobserve(e.target); }
        }
-      }, { rootMargin: '0px 0px -12% 0px' });
+      }, { rootMargin: '0px 0px -8% 0px' });
      document.querySelectorAll('.reveal').forEach((el) => io.observe(el));
      initInteractions();
    </script>
@@ -59,6 +59,8 @@ const builds = DOWNLOADS.map((d) => ({ os: d.os, label: d.label, detail: d.detai
        <span class="sha" data-sha-wrap hidden>SHA-256 <code data-sha></code><button type="button" data-copysha>Copy</button></span>
        <a href={RELEASES}>Release notes</a>
      </p>
+      <p class="trust">Windows and macOS warn the first time you open FramePort: it's signed by its developer, not with a
+        paid certificate. Each release lists every file's SHA-256 in SHA256SUMS.txt to check it.</p>
    </section>

    <section class="wrap next" aria-labelledby="next-h">
@@ -284,7 +286,7 @@ const builds = DOWNLOADS.map((d) => ({ os: d.os, label: d.label, detail: d.detai
  .arrive { position: absolute; left: 50%; top: 50%; width: 54px; height: 54px; margin: -27px; display: grid; place-items: center; border-radius: 50%;
    background: var(--accent); color: var(--on-accent); font: 800 24px/1 var(--font-display); box-shadow: 0 0 40px rgba(255, 138, 31, .7);
    transform: translateX(clamp(175px, 22vw, 300px)) scale(0); opacity: 0; z-index: 2; }
-  [data-state="sent"] .arrive { animation: arrive 700ms 780ms var(--ease-back) forwards; }
+  [data-state="sent"] .arrive { animation: arrive 700ms 780ms var(--ease-spring) forwards; }
  .flare { position: absolute; left: 50%; top: 50%; width: 30px; height: 30px; margin: -15px; border-radius: 50%; opacity: 0; z-index: 1;
    background: radial-gradient(circle, #fff, rgba(255, 138, 31, .8) 30%, transparent 70%); }
  [data-state="sent"] .flare { animation: flare 900ms 560ms ease-out forwards; }
@@ -327,6 +329,7 @@ const builds = DOWNLOADS.map((d) => ({ os: d.os, label: d.label, detail: d.detai
  [data-state="counting"] .builds, [data-state="sent"] .builds { opacity: .7; }
  .facts { display: flex; flex-wrap: wrap; justify-content: center; gap: 6px 16px; font-size: 13px; color: var(--text-3); margin: 0; }
  .facts[hidden], .sha[hidden] { display: none; }
+  .trust { max-width: 62ch; margin: 14px auto 0; text-align: center; font-size: 13.5px; line-height: 1.55; color: var(--text-2); }
  .facts > span:empty { display: none; }
  .sha code { font-size: 12px; color: var(--text-2); }
  .sha button { all: unset; cursor: pointer; margin-left: 6px; color: var(--secondary); }
@@ -147,7 +147,7 @@ const line = 'curl -fsSL https://frameport.app/s | bash';
  .small { font-size: 14px; }
  .cmd.big code { font-size: 15px; }
  .copy { all: unset; display: inline-flex; align-items: center; gap: 6px; padding: 8px 14px; border-radius: var(--radius-sm); cursor: pointer;
-    background: var(--accent); color: var(--on-accent); font: 600 14px/1 var(--font-sans); transition: filter 200ms, transform 300ms var(--ease-back); }
+    background: var(--accent); color: var(--on-accent); font: 600 14px/1 var(--font-sans); transition: filter 200ms, transform 300ms var(--ease-spring); }
  .copy:hover { filter: brightness(1.08); }
  .copy:active { transform: scale(.95); }
  .copy.done { background: var(--ok); }
@@ -1,6 +1,6 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
-import { rowHtml, short, sortGames, toGame } from './catalog.ts';
+import { rowHtml, short, shuffleGames, sortGames, toGame } from './catalog.ts';

 test('catalog entries become rows like docs/GAMES.md', () => {
  assert.equal(toGame({ title: 'x', status: 'maybe' }), null);
@@ -26,6 +26,21 @@ test('order: works, issues, unsupported, then title', () => {
  assert.deepEqual(sortGames(games).map((g) => g.title), ['a', 'z', 'a', 'b']);
 });

+test('shuffle: status groups stay in order, a random order inside, kept across calls', () => {
+  const games = ['unsupported:b', 'works:z', 'issues:a', 'works:a', 'works:m', 'issues:q'].map((s) => {
+    const [status, title] = s.split(':');
+    return toGame({ status, title, package: `p.${status}.${title}` });
+  });
+  const seq = [0.9, 0.1, 0.5, 0.3, 0.7, 0.2];
+  const rank = new Map();
+  const first = shuffleGames(games, rank, () => seq.shift());
+  assert.deepEqual(first.map((g) => g.status), ['works', 'works', 'works', 'issues', 'issues', 'unsupported']);
+  assert.deepEqual(first.filter((g) => g.status === 'works').map((g) => g.title), ['z', 'a', 'm']);
+  // the same page reorders the same way (the live refresh), new games get their own place
+  const again = shuffleGames([...games].reverse(), rank, () => 0.0);
+  assert.deepEqual(again.map((g) => g.title), first.map((g) => g.title));
+});
+
 test('rows escape what comes from GitHub', () => {
  const html = rowHtml(toGame({ title: '<img src=x onerror=alert(1)>', status: 'works', engine: '"x' }));
  assert.ok(!html.includes('<img'));
@@ -69,6 +69,14 @@ export function sortGames(games: Game[]): Game[] {
    || a.title.localeCompare(b.title, 'en', { sensitivity: 'base' }));
 }

+/** Working games first, then with issues, then not running; a random order inside each group, so every visit leads
+ * with other games. `rank` keeps each game's place for the page's lifetime (the live refresh doesn't reshuffle). */
+export function shuffleGames(games: Game[], rank = new Map<string, number>(), rand: () => number = Math.random): Game[] {
+  const key = (g: Game) => g.package || g.title;
+  for (const g of games) if (!rank.has(key(g))) rank.set(key(g), rand());
+  return [...games].sort((a, b) => ORDER[a.status] - ORDER[b.status] || rank.get(key(a))! - rank.get(key(b))!);
+}
+
 const esc = (s: string) => s.replace(/[&<>"']/g, (c) => `&#${c.charCodeAt(0)};`);

 /** Where a recipe chip links to (its entry in the patch reference), or null for none. */
@@ -68,9 +68,12 @@ export function initFrameSide(stage: HTMLElement, host: HTMLElement, firstTitle:
  }

  const webgl = hasWebGL();
+  // data saver or a slow connection: no three.js download, the CSS scene underneath stays
+  const conn = (navigator as Navigator & { connection?: { saveData?: boolean; effectiveType?: string } }).connection;
+  const lean = conn?.saveData === true || /(^|-)(2g|3g)$/.test(conn?.effectiveType ?? '');
  new IntersectionObserver((es) => {
    visible = es.some((e) => e.isIntersecting);
-    if (visible && !side && !loading && webgl) start();
+    if (visible && !side && !loading && webgl && !lean) start();
    kick();
  }, { rootMargin: '120px' }).observe(stage);
  document.addEventListener('visibilitychange', kick);
@@ -1,29 +1,9 @@
-// Small reactions all over the page (styles in global.css under "everything reacts"). None of them is needed to read
-// or use the page; with reduced motion only the ones that don't move stay (count-ups show their number at once).
+// Small reactions all over the page (styles in global.css under "small reactions"), kept quiet: a click ripple, labels
+// that decode once, headings whose words rise in, count-ups, the hero leaning away on scroll, the install log completing.
+// None of them is needed to read or use the page; with reduced motion only the ones that don't move stay (count-ups
+// show their number at once).

 const reduce = matchMedia('(prefers-reduced-motion: reduce)').matches;
-const fine = matchMedia('(pointer: fine)').matches;
-
-/** A soft portal light under the pointer. */
-function cursorLight() {
-  if (reduce || !fine) return;
-  const light = document.createElement('div');
-  light.className = 'cursor-light';
-  light.setAttribute('aria-hidden', 'true');
-  document.body.append(light);
-  let x = innerWidth / 2, y = innerHeight / 2, tx = x, ty = y, raf = 0;
-  const step = () => {
-    x += (tx - x) * 0.18; y += (ty - y) * 0.18;
-    light.style.transform = `translate(${x}px, ${y}px)`;
-    if (Math.abs(tx - x) + Math.abs(ty - y) > 0.5) raf = requestAnimationFrame(step); else raf = 0;
-  };
-  addEventListener('pointermove', (e) => {
-    tx = e.clientX; ty = e.clientY;
-    light.classList.add('on');
-    if (!raf) raf = requestAnimationFrame(step);
-  }, { passive: true });
-  document.addEventListener('pointerleave', () => light.classList.remove('on'));
-}

 /** Clicking empty space: the app's Play ripple, a blue ring then an orange one. Mouse (and pen) only: on a touch
 * screen every tap or scroll start would draw it. */
@@ -44,7 +24,7 @@ function clickRipples() {
  });
 }

-/** Headings: the portal's colours light the letters under the pointer; words rise in when the heading appears. */
+/** Headings: the words rise in when the heading appears. */
 function headings() {
  document.querySelectorAll<HTMLElement>('main h2, .prose h1').forEach((h) => {
    if (!reduce && !h.dataset.split) {
@@ -70,18 +50,10 @@ function headings() {
      wrap(h);
      h.classList.add('words');
    }
-    if (!fine) return;
-    h.addEventListener('pointermove', (e) => {
-      const r = h.getBoundingClientRect();
-      h.style.setProperty('--hx', `${e.clientX - r.left}px`);
-      h.style.setProperty('--hy', `${e.clientY - r.top}px`);
-      h.classList.add('lit');
-    });
-    h.addEventListener('pointerleave', () => h.classList.remove('lit'));
  });
 }

-/** Section labels unscramble the first time they show; hover scrambles them again. */
+/** Section labels decode the first time they show. */
 function labels() {
  const GLYPHS = '01<>/\\|=+*#%·-_';
  const scramble = (el: HTMLElement) => {
@@ -108,7 +80,6 @@ function labels() {
      } else if (n.nodeType === Node.ELEMENT_NODE) (n as Element).classList.add('scr');
    }
    io.observe(l);
-    l.addEventListener('pointerenter', () => l.querySelectorAll<HTMLElement>('.scr').forEach(scramble));
  });
 }

@@ -189,7 +160,6 @@ function logScroll() {
 }

 export function initInteractions() {
-  cursorLight();
  clickRipples();
  headings();
  labels();
Author	SHA1	Message	Date
spoopyghosty0	c8f399da57	Docs: update screenshots and videos	2026-10-13 03:22:34 +00:00
spoopyghosty0	81e33e7a26	Game menu: Update with a newer APK… (#161 ) Pick the new APK from the game's right-click or … menu: pipeline.replace_apk checks it's the same app (refuses another package, warns when its versionCode is older), points the entry at it and analyses it again; title, art, tags and the user's own recipe stay, the game data stays unless the new APK's folder has its own. The game page then offers Update on Frame.	2026-10-12 23:15:07 -04:00
spoopyghosty0	2a33c218b1	Merge branch 'worktree-agent-a259646b4d1d00ab3' into worktree-merge-pr240	2026-10-12 23:04:01 -04:00
spoopyghosty0	fbdeb700d0	A changed Frame SSH key gets its own message and a Trust the new key button; uninstall gives up its own lock - HostKeyChanged (paramiko BadHostKeyException): not treated as "can't reach" (jobs don't pause and retry); the Steam Frame page explains it and offers Trust the new key (forget_host_key + reconnect); CLI frameport frame trust-key. - Uninstall from the running app: instance.release() drops gui.lock before the data folder goes, and files still in use are reported as left over instead of stopping the uninstall (Windows). Both from Reddit reports (2026-10-12).	2026-10-12 22:57:54 -04:00
spoopyghosty0	26ef64ebf9	bHaptics: skip the Android 12 Bluetooth permission request (frame.bhaptics_permission, #235 ) bHaptics' vest SDK asks for BLUETOOTH_CONNECT at start; on Lepton's Android 11 the permission screen takes the foreground for a moment and the game pauses (Yupitergrad froze on its loading screen in the reporter's session). PermissionUtils.requestBluetoothPermission returns at once (Dex.return_early). Suggested by analysis bhaptics_permission (ANALYSIS_VERSION 14) and triage bhaptics-permission-prompt. On the dev Frame the prompt is gone; whether it was the whole cause of the freeze is for the reporter to confirm.	2026-10-12 22:40:49 -04:00
spoopyghosty0	43994d1c93	Artifacts: adapter, xrshim, VrApi bridges and the foveation darken layer rebuilt from #247 's sources (merged with main)	2026-10-12 22:02:42 -04:00
spoopyghosty0	8fead8387d	Merge PR #247 (experimental shared eye-tracked foveation, Batman video) # Conflicts: # artifacts/SHA256SUMS # artifacts/arm64-v8a/libopenxr_loader_generic.so # artifacts/armeabi-v7a/libopenxr_loader_generic.so # catalog/triage.yaml # tests/test_triage.py	2026-10-12 21:56:42 -04:00
spoopyghosty0	6419295a00	Merge PR #245 (Star Wars: Tales from the Galaxy's Edge: splash bypass, multiview depth, SideQuest layout) # Conflicts: # docs/PATCHES.md # src/frameport/sources/quest_dump.py # tests/test_quest_dump.py # tests/test_triage.py	2026-10-12 21:48:22 -04:00
spoopyghosty0	c29cef5f97	FrameBridge: fade_quad draws colour-scale fades as a black quad over the picture (#197 ) Opt-in game setting (Picture -> Draw fades over the picture). Batman: Arkham Shadow fades by dimming its projection layer with XR_KHR_composition_layer_color_scale_bias; with fade_quad=1 FrameBridge adds a black, alpha-blended quad right after the dimmed layer (VIEW space, 1 m ahead), opacity = 1 - scale in 16 steps. One 8x8 swapchain, refilled only when the step changes (Vulkan clear on the app's queue / GLES clear in its context); one swapchain per step hit XR_ERROR_LIMIT_REACHED. fade_quad=2 also removes the layer's own scale. Device (headless, Batman): swapchain created, level 16/16 on the first frame, no xrEndFrame errors, 72 fps.	2026-10-12 21:40:01 -04:00
spoopyghosty0	b678ce8967	Artifacts: libvrapi.so rebuilt from #244 's sources	2026-10-12 21:28:05 -04:00
spoopyghosty0	289d771cc9	Merge PR #244 (The Climb: CryEngine detection, VrApi frame flags)	2026-10-12 21:22:44 -04:00
spoopyghosty0	78ac1a2865	Agent: the cloud-saves line takes the package as given (the launcher template doesn't check names elsewhere); test template call updated (#240 )	2026-10-12 21:21:06 -04:00
spoopyghosty0	8a96b37df3	Merge branch 'pr240' into worktree-merge-pr240	2026-10-12 21:14:15 -04:00
Lucas-Mathieu	e1b153915e	Fix Ruff formatting checks for foveation changes	2026-10-13 02:31:35 +02:00
spoopyghosty0	ec552046eb	CLAUDE.md: what the 2026-10-12 issue round found (drive paths, thread keys, Cpp2IL v107, Vermillion, OLAR/FNAF/VR4, uploads)	2026-10-12 20:04:35 -04:00
Lucas-Mathieu	697e96c35f	Add experimental shared foveation and Batman video/loading fixes	2026-10-13 01:50:29 +02:00
Nick Leach	34d00efe0a	Fix The Climb CryEngine content detection and VrApi rendering	2026-10-12 16:28:22 -06:00
Nick Leach	d6c8315463	Fix Aftermath backup data detection and first-launch cloud saves	2026-10-12 16:25:43 -06:00
spoopyghosty0	7202d6ae41	Vermillion 1.7.2: canvases are painted in the scene, so the hand and brush stay visible (frame.vermillion_scene_canvas, #200 ) The game showed a canvas being painted as its own compositor layer, which the Frame draws in front of everything. PaintableMesh.HasCompositorLayerAvailable and ShouldUseCompositorOverlay return false (Cpp2IL), so the game's own fallback draws the canvas in the scene (Klownicle's finding). Catalog recipe, PLAYBOOK row, test.	2026-10-12 18:23:56 -04:00
Nick Leach	2fe932a50f	Fix Tales loading stall, clipped eye rendering, and missing backup assets	2026-10-12 16:21:23 -06:00
spoopyghosty0	1c02ebe1d3	Lint: line lengths, unused import; scripts/upload_bench.py (upload speed by method, discussion #242 )	2026-10-12 18:15:09 -04:00
spoopyghosty0	4cd7a2b5e8	Docs: patch list regenerated after merging the round's patches	2026-10-12 18:09:49 -04:00
spoopyghosty0	b8d5b3badc	Cpp2IL: Unity 6.5 games use the development build (metadata v107) No Cpp2IL release reads Unity 6.5's metadata yet ("We support 23-106, got 107"), so the text-field and MSAA fixes were skipped for Wander 0.3570 (#198). When the release reports an unsupported metadata version, the development branch's CI build (nightly.link, as Cpp2IL's README links it) is fetched into tools/cpp2il-nightly/ and used; cached errors of that kind get one retry with it. Checked with Wander 0.3570: it reads the v107 metadata and writes TMP_InputField, OVRDisplay and OculusLoader.	2026-10-12 18:07:00 -04:00
spoopyghosty0	375a9d9fe2	Wander 0.3570: Unity's thread keys share one real key (frame.unity_tls_key_pool, #198 ) Bionic allows 128 pthread keys per process. Unity 6 takes about 40, and with Gecko, Firebase and the Frame's own libraries Wander 0.3570 ran out: Firestore aborted at start ("cannot create thread specific key for __cxa_get_globals()", #198, #202). Opt-in patch, suggested for Unity 6 with Firebase C++ or Gecko: libunity.so's pthread_key_create/_delete and pthread_get/setspecific imports are renamed in place to fp_tkey_* (new elf.rename_imports: undefined symbols only, shared names refused, versions set global) and libfp_tkeys.so (native/tlskeys) is added to its DT_NEEDED; keys without a destructor become generation-tagged slots behind one real key, everything else keeps real keys. Approach and the first helper by Klownicle (#198), reimplemented here. Triage signature pthread-keys-exhausted, PLAYBOOK row, Wander's recipe updated to 0.3570.	2026-10-12 18:06:59 -04:00
spoopyghosty0	0c05f88c5e	Game menu: Update app only (discussion #180 ) Installs the new build and leaves the game data on the Frame as it is (the CLI's --apk-only): a normal update re-sends every OBB whose size differs from the PC's copy, which replaced OBBs changed on the Frame (mods). Asks first; Quest games on the Frame only. Resume after a failure keeps the kind of update.	2026-10-12 17:58:07 -04:00
spoopyghosty0	22a324764d	Space check before installs uses the drive each game goes to (#205 ) New games are checked against the drive chosen on the Frame page, installed ones against their own drive, from the drive list fetched at connect and after install jobs (app.frame_drives). Internal storage's free space only counts when no drive list is known. drives.target_drive/space_shortfalls are pure helpers with tests.	2026-10-12 17:58:06 -04:00
spoopyghosty0	62e28f655e	GUI: file pickers work without the desktop portal (#208 ) Flet's Linux picker asks the XDG desktop portal; window managers without one (IceWM, bare X11) answer NameHasNoOwner and every pick raised. C.pick_files / C.pick_dir now fall back to zenity or kdialog (kdialog first on KDE; core/pickers.py, run off the UI loop), and without either to a "type the full path" box. All twelve pickers go through them.	2026-10-12 17:58:06 -04:00
spoopyghosty0	d4ea0a27bb	Linux apps: the desktop icon has its own switch, and one deleted by hand stays deleted (#212 ) Agent 83: deployment.json desktop_icon (default on); refresh_desktop_entries only updates a desktop copy that is there; desktop_entry takes icon=. Game page: "In the app menu" and "On the desktop" switches.	2026-10-12 17:58:02 -04:00
spoopyghosty0	401fbed1d5	Games on drives with a space in their name start again; EOS keychain loop patch; Climb's CryEngine detected - Agent 83: Valve's Lepton pastes the game's paths unquoted into shell commands (liblepton mounting.sh), so a game on a card named "Steam Frame 512g" never got its internal storage (no saves, no SharedPreferences). The Quest launcher now links the game folder to ~/.local/share/frameport/lepton-paths/<pkg> at every start and gives Lepton that path; upgrade_launchers converts existing launchers, move and uninstall handle the link (#213, #214, #215, #221). - frame.eos_keychain_loop (opt-in, offered by triage): Epic Online Services' resetKeychain returns at once, so a keychain it can't write no longer loops forever (Beyond Sandbox, #214). - Triage lepton-data-link-failed and eos-keychain-loop. - CryEngine also from libAndroidLauncher.so + a .cryproject (Climb 1, #238); ANALYSIS_VERSION 12.	2026-10-12 17:55:03 -04:00
spoopyghosty0	9bfb2ddd3b	Catalog: 15 new working recipes, Beat Saber and Waltz of the Wizard re-verified Ladder, Munkr Funkr, MacacoVR, Vampire Survivors, Dance Central, NFL PRO ERA II, Swarm 2, Totally Baseball, Drunkn Bar Fight, Drunkn Bar Fight 2, Fruit Ninja, Kill It With Fire VR, Superfly, FrenzyVR, Dungeons of Eternity. Closes #243, closes #241, closes #236, closes #234, closes #228, closes #226, closes #224, closes #223, closes #222, closes #220, closes #207, closes #219, closes #218, closes #217, closes #216, closes #211, closes #210, closes #206	2026-10-12 17:09:20 -04:00
spoopyghosty0	ea2522a45d	Merge pull request #225 from spoopyghosty0/showcase/update Update docs screenshots and videos	2026-10-12 16:56:14 -04:00
spoopyghosty0	fa67b36d20	Docs: update screenshots and videos	2026-10-12 20:33:12 +00:00
spoopyghosty0	972f5c7147	Showcase: the install video hovers 'Quest games' (the Frame page's readiness rows lost '(Lepton)' in `c477070`)	2026-10-12 16:16:55 -04:00
spoopyghosty0	c477070772	GUI: plainer words, readable dim text, quieter empty tabs, one way to connect, portal switches - Plain words: patch titles lose bracketed internals unless Show technical details is on (C.patch_title); a passed launch test just says so, how far it got shows only when it fails (C.test_line); Frame page readiness says Quest games / PC VR games and storage drops the file system (reason in a tooltip); the failure pop-up says where it stopped, that Resume continues and that saves and signing keys are kept. Engine and VR API stay on the game page; the OpenXR runtime and game launch capacity checks stay; the first start still names its tools. - Readable dim text: TEXT_3 is #868A96 (Portal, Portal OLED) and #868B9C (Original), at least 4.5:1 on the window, sidebar, cards and raised panels (was 3.6-4.4:1); a test keeps the built-in themes there. - Quieter empty tabs: the not-connected Files, Screenshots, Live view, Type on Frame and Monitor tabs show one sentence and Connect above a faint sketch of the tab (C.ghost_preview) instead of three feature cards; the Live view shows one Start button and no feature cards. - The connect page has one way in: "Set up your Frame" up front (no password, nothing changes until you allow it), "Already set up?" below, the address and password behind "Connect by address…"; no 1/2/3 numbers. - Consistency: every switch is C.switch, with the portal gradient painted under a transparent track (the real Switch keeps keyboard, focus and semantics), a dark thumb with a check when on and a grey one with a cross when off (the same size); where a patch came from is blue information, not orange; the platform filter says "Quest/Android"; the welcome screen says "Set up your Frame". - Showcase: the live-view shot waits for "Ready when you are"; the install video clicks "Set up your Frame".	2026-10-12 15:46:14 -04:00
spoopyghosty0	2c1b901728	Site: less template, more FramePort - Section labels name what you do there ("See how it works", "See what runs", "Get started") instead of 01-07; plain headlines ("What happens when you click Install on Frame", "FramePort patches the games that don't run as they are"); the hero's eyebrow is gone; nav "Install" -> "Get started" (no clash with the /install/ link page) - Phones and narrow windows (below 1120 px) get a Menu panel instead of a hidden or wrapping nav; on phones the download buttons say "Get it on your PC"; no three.js on data saver or 2G/3G; the install log drops its detail column under 600 px - The download page says why Windows and macOS warn on first start (self-signed) and where the SHA-256 sums are; Get started step 3 says nothing changes on the Frame until you click Allow, with a link to the script - The app tour's screenshots and videos sit behind one disclosure; the game-maker panel shows the demo button on its own stage with the HTML behind "Show the HTML"; Compare without icon tiles, Free and open source stays the emphasized card - Quieter motion: no cursor light, pointer-lit heading gradient or film grain; sections settle in with a 10 px rise, heading words rise without the tilt, labels decode once, a faint click ripple, a gentler hero lean, a lighter spring (--ease-spring); the warp field, the contributor dock and the gradient changelog version stay - Readability: dim text #868a96 (4.77:1+), themed placeholders, pending install-log stages stay readable, no labels under 11px, the walkthrough shows each platform's real file and program (was "?os=linux" and FramePort.exe) - Impeccable design-tool files (PRODUCT.md, DESIGN.md, .impeccable/) are ignored: they stay local	2026-10-12 12:57:12 -04:00
spoopyghosty0	80ef9ca6a7	Site: release and contributor data refreshed (1.0.4)	2026-10-11 21:30:25 -04:00
spoopyghosty0	c744f8740b	Site: the games board lists games in a random order on every visit (working games first, then with issues, then not running)	2026-10-11 21:30:13 -04:00
spoopyghosty0	859f921361	Monitor: games Steam runs that FramePort didn't install count (e.g. Job Simulator from Steam's store, named from its appmanifest; End game = Steam's Exit game), overlay apps are never the game being played, and the newest game comes first (agent v81)	2026-10-11 17:27:10 -04:00
spoopyghosty0	6acf9d048e	App icon: all four corners rounded (only the top-left one was); source runs on Windows show FramePort's icon instead of Flet's (window.icon from an .ico made of it)	2026-10-11 14:40:32 -04:00
spoopyghosty0	cf18b30be9	Uninstall dialog: the delete-saves checkbox label wraps (it ran past the dialog; also the delete-files-on-this-PC, share-recipe and remove-FramePort checkboxes), games uninstalled from the Frame page show their name; Monitor: the agent's own workers aren't a running game (uninstalling showed the game as now playing while Steam restarted; agent v80)	2026-10-11 14:33:47 -04:00
spoopyghosty0	eec0218b1d	FramePort 1.0.4	2026-10-11 14:13:56 -04:00
spoopyghosty0	526ba0a684	Launch tests: a game that ran until the session ended for lack of a worn headset (VrApi bridge tracking deadline) passes, even when it crashes afterwards (BlazeRush 'Failed to launch' on install, GitHub #57 )	2026-10-11 14:12:04 -04:00
spoopyghosty0	23b6ff1b5e	Dev: WSL source runs can share the Windows copy's data folder (FRAMEPORT_WINDOWS_DATA=1): paths saved by the other side are translated on load, Java and Cpp2IL keep one copy per OS, and such runs leave the link handler alone	2026-10-11 13:59:37 -04:00