Keep opt-in OpenXR layer recommendations at full swapchain resolution (#406)

Route OVRPlugin recommendations through the existing extension shim, retain native loader hooks, and log projection rect changes once per second per eye. Enable the fix for Batman, document verification, and rebuild both adapter architectures.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HZSCqaPGwuUf4vdLQdVT4J

agent/frameport_agent.py

@@ -46,7 +46,7 @@ try:
 except ImportError:  # Windows: pc_revive loads this file for its VDF code only (GitHub #131)
     fcntl = None
 
-AGENT_VERSION = 103
+AGENT_VERSION = 102
 HOME = os.path.expanduser("~")
 STEAM = os.path.join(HOME, ".local/share/Steam")
 ANCHORS = os.path.join(HOME, "Applications/quest-frame")
@@ -3634,38 +3634,6 @@ axis 0x10 HAT_X
 axis 0x11 HAT_Y
 """
 BTN_SOUTH = 0x130  # BTN_A / BTN_GAMEPAD: Linux's gamepad button range starts here
-# A game's own button layout (device.steam_gamepad's options, GitHub #162: Steam Input's per-game remapping doesn't
-# reach a 2D app): its launcher exports FRAMEPORT_GAMEPAD_LAYOUT (comma list: swap_sticks = the right stick is
-# Android's main stick, which Android's own D-pad navigation follows; swap_ab) and FRAMEPORT_GAMEPAD_KEYS (Android .kl
-# lines separated by ';', each replacing the line for the same key code or axis), read by podman_run_args.
-KL_LINE = re.compile(r"(key [0-9]{1,4} [A-Z][A-Z0-9_]{0,40}( (FUNCTION|WAKE))?"
-                     r"|axis 0x[0-9a-f]{1,2} (invert )?[A-Z][A-Z0-9_]{0,40}( flat [0-9]{1,5})?)")
-
-
-def gamepad_kl(layout="", keys=""):
-    """GAMEPAD_KL with a game's layout options and own lines (invalid ones left out); the text and what was left out."""
-    lines = {}
-    for line in GAMEPAD_KL.splitlines()[1:]:
-        kind, code = line.split()[:2]
-        lines[(kind, code if kind == "axis" else str(int(code)))] = line
-    opts = {o.strip() for o in (layout or "").split(",") if o.strip()}
-    if "swap_sticks" in opts:
-        lines[("axis", "0x00")], lines[("axis", "0x03")] = "axis 0x00 Z flat 4096", "axis 0x03 X flat 4096"
-        lines[("axis", "0x01")], lines[("axis", "0x04")] = "axis 0x01 RZ flat 4096", "axis 0x04 Y flat 4096"
-    if "swap_ab" in opts:
-        lines[("key", "304")], lines[("key", "305")] = "key 304   BUTTON_B", "key 305   BUTTON_A"
-    skipped = []
-    for line in (keys or "").split(";"):
-        line = " ".join(line.split())
-        if not line:
-            continue
-        if not KL_LINE.fullmatch(line):
-            skipped.append(line)
-            continue
-        kind, code = line.split()[:2]
-        lines[(kind, code if kind == "axis" else str(int(code)))] = line
-    head = GAMEPAD_KL.splitlines()[0] + (f" Options: {layout or '-'}; own lines: {keys}" if opts or keys else "")
-    return "\n".join([head, *lines.values()]) + "\n", skipped
 
 
 def has_key_bit(caps, code):
@@ -3738,13 +3706,7 @@ def podman_run_args(args, env, sys_root="/sys", dev_root="/dev"):
     extra = []
     if PAD_DIR not in taken:
         extra += ["--mount", f"type=bind,source={os.path.join(dev_root, 'input')},destination={PAD_DIR},rw"]
-    text, skipped = gamepad_kl(env.get("FRAMEPORT_GAMEPAD_LAYOUT", ""), env.get("FRAMEPORT_GAMEPAD_KEYS", ""))
-    layout = gamepad_layout_file(text) if extra else ""
-    if skipped:
-        print(f"FramePort gamepad: key layout lines left out (not .kl syntax): {'; '.join(skipped)}", file=sys.stderr)
-    if text != GAMEPAD_KL:
-        print(f"FramePort gamepad: own button layout ({env.get('FRAMEPORT_GAMEPAD_LAYOUT') or '-'}"
-              f"{'; ' + env['FRAMEPORT_GAMEPAD_KEYS'] if env.get('FRAMEPORT_GAMEPAD_KEYS') else ''})", file=sys.stderr)
+    layout = gamepad_layout_file() if extra else ""
     for product in sorted({"11ff", *(p["product"] for p in pads)}):  # 11ff: Steam's pad, also when it comes later
         target = f"/system/usr/keylayout/Vendor_28de_Product_{product}.kl"
         if layout and target not in taken and re.fullmatch(r"[0-9a-f]{4}", product):
@@ -3792,21 +3754,18 @@ def gamepad_links(appid, parent, poll=1.0, refresh=15.0, exec_=None, pads=steam_
         time.sleep(poll)
 
 
-def gamepad_layout_file(text=GAMEPAD_KL):
-    """The key layout file for `text`: steam-gamepad.kl, or one per distinct own layout (steam-gamepad-<hash>.kl)."""
-    name = "steam-gamepad.kl" if text == GAMEPAD_KL else \
-        f"steam-gamepad-{hashlib.sha256(text.encode()).hexdigest()[:12]}.kl"
-    path = os.path.join(os.path.dirname(PODMAN_BIN), name)
+def gamepad_layout_file():
+    path = os.path.join(os.path.dirname(PODMAN_BIN), "steam-gamepad.kl")
     try:
         with open(path) as f:
-            if f.read() == text:
+            if f.read() == GAMEPAD_KL:
                 return path
     except OSError:
         pass
     os.makedirs(os.path.dirname(path), exist_ok=True)
     tmp = f"{path}.{os.getpid()}.tmp"
     with open(tmp, "w") as f:
-        f.write(text)
+        f.write(GAMEPAD_KL)
     os.replace(tmp, path)
     return path
 
@@ -6923,15 +6882,6 @@ def cmd_collect_diag(args):
         for i, part in enumerate(game_logs(base)):
             files[f"game-log-{i}.txt"] = part[-max_bytes:]
     logs = os.path.join(STEAM, "logs")
-    if dep.get("steam_gamepad"):  # which controller layout Steam activated, and the pads the container got (#162)
-        text = _tail(os.path.join(base, "gamepad.log"), max_bytes)
-        if text is not None:
-            files["gamepad.log"] = text
-        text = _tail(os.path.join(logs, "controller.txt"), 4 * max_bytes)
-        if text:
-            keep = [ln for ln in text.splitlines() if re.search(
-                r"Queueing activation|warmed config|Opted-in Controller|Loaded Config|virtual gamepad|xinput slot", ln)]
-            files["steam-controller.txt"] = "\n".join(keep[-400:]) + "\n"
     text = _tail(os.path.join(logs, f"lepton-steamlaunch-{appid}.log"), max_bytes)  # Lepton's launcher log
     if text is not None:
         files[f"lepton-steamlaunch-{appid}.log"] = text

artifacts/SHA256SUMS

@@ -13,11 +13,11 @@ e32f9b3222bfe2e58c193db809ac2cf54086df36fd2ec6651aa2e58308f6b39d  ./arm64-v8a/li
 4a13a33e112c9e4e3c5ff4337ed6e988a9e5b3602f48d654df148ef5fafbf426  ./arm64-v8a/libfpglmv.so
 36400eae4ba3807bcfcd54463daa217347032b07218792faa448d8cbbd086a0e  ./arm64-v8a/libframe_xrshim.so
 19ba5ed3c4b780f5ae46251f6958f552acfc5f13c8bb39f995579593fa8990c6  ./arm64-v8a/libglshim.so
-f0894d9cc08aed4c0f6468134e76909d583a208c3f5e528bc3ee795f51b19fcb  ./arm64-v8a/libopenxr_loader_generic.so
+b085db012dfcdf2690fc3c53e8c3fef0c5d2011e35d4307756b0c6347e29d219  ./arm64-v8a/libopenxr_loader_generic.so
 1feaeafad467c4cafdf2b018a4d84b0bee200c3f711697b4ce97e66a3ba256ca  ./arm64-v8a/libovrplatformcompat.so
 a4ed80ae45ca90758239f152ea5a2e8c127d491e1e697ea5680db6fd7f72db07  ./arm64-v8a/libvrapi.so
 a4ed80ae45ca90758239f152ea5a2e8c127d491e1e697ea5680db6fd7f72db07  ./arm64-v8a/libvrapi_foveation.so
-4e03a8389981ed5a27b4c159cc83168c4f93d0d75479a445b02e5669aa26a71b  ./armeabi-v7a/libopenxr_loader_generic.so
+fcd8f37b3acc3a2829f255c2f2fa16d20b975c8831d72518a659cb78ed6e3ae2  ./armeabi-v7a/libopenxr_loader_generic.so
 1871eae093432d277da4bc751bf5f3269dfcf11f9168260b0c3caadb0dedb19d  ./dex/oculusos-stubs.dex
 b634ab5640e258563c536e658cad87080553df6f34f62269a21d554844e58bfe  ./hevc/COPYING.FFmpeg
 141de01f0d40b97d4f9a720db5ab8ea442f6aa35db5272048899292884994a1c  ./hevc/libstagefrighthw.so

catalog/games/com.camouflaj.manta.yaml

@@ -16,6 +16,7 @@ frame:
 - frame.hw_video_decode
 - frame.unity_text_input
 adapter:
+  fixed_resolution: 1
   sync_guard: 1
   surface_native: 1
   fade_quad: 1
@@ -26,6 +27,6 @@ verified:
   overport_cli: 1.2.3
   overport_runtime: 3.4.3-23204ea
   known_good_sha256: 796d1cab08f614d72c50d9702974c719c0908f5de91183cfe02d1fd5eb09551a
-updated: '2026-10-15'
-min_app: 1.1.0
+updated: '2026-10-18'
+min_app: 1.2.2
 source_hint: Batman- Arkham Shadow

catalog/games/com.mrf.tvb.cubism.yaml

@@ -1,23 +0,0 @@
-package: com.mrf.tvb.cubism
-title: cubism
-status: works
-notes: works and passthrough play works also
-tested_version: 1.8.0
-engine: Unity
-xr: OpenXR
-frame:
-- frame.unity_text_input
-device:
-- device.text_input_window
-adapter:
-  haptic_fix: 1
-  scene_emul: 1
-verified:
-  date: '2026-10-17'
-  known_good_sha256: fd1ba8eae19efe0f2a17fc146847de677263125f9ec5437cea5c632f0cd88dcf
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 91
-  issue: 403
-source_hint: Cubism

catalog/games/com.team17.killerfrequency.yaml

@@ -1,26 +0,0 @@
-package: com.team17.killerfrequency
-title: KillerFrequency
-status: works
-tested_version: 1.0.767.38513
-engine: Unity
-xr: VrApi
-frame:
-- frame.unity_no_msaa
-- 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
-  scale: 1.4000000000000001
-verified:
-  date: '2026-10-18'
-  known_good_sha256: a11b008fcc0f5bc7aa5a3bb04d4267144d5ec60b26529a9b20e6499e12dcf079
-  app: 1.2.1
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 96
-  issue: 402
-source_hint: killer freq

catalog/triage.yaml

@@ -6,6 +6,13 @@
 # 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: dynamic-resolution-foveation
+    pattern: 'projection view [01](?: rect change)?:[^\r\n]*rect=(?:[1-9]\d*,\d+|0,[1-9]\d*) '
+    unless: 'fixed_resolution: recommended'
+    severity: info
+    diagnosis: The game submits an offset projection viewport. With Valve foveation, dynamic resolution can move the sharp centre or expose a white edge. Keeping full resolution may help; it increases GPU load and needs the updated adapter and OVRPlugin shim in a rebuilt APK.
+    question: With foveated rendering enabled, was the sharp centre misplaced or was there a white line at the picture edge?
+    suggest: [adapter.fixed_resolution]
   - id: quest2-headset-identity
     pattern: 'venderId[^\r\n]*systemName Oculus Quest2'
     severity: info
@@ -383,10 +390,8 @@ signatures:
     diagnosis: Frame controller models are on, but the converted models are missing from the game's files. The agent found no Frame controller render models in SteamVR at install time; see the install log, or run the agent's controller_models command.
     suggest: []
   - id: scene-missing
-    # not extension listings, which every Meta XR game prints: OVRPlugin's "Unavailable OpenXR extension:" and
-    # "Name=XR_FB_scene SpecVersion=1", OVRPort's "overportOXR: - XR_FB_scene 1", Unity's 'Meta XR Feature: ...
-    # Extensions="..."' (GitHub #404); XR_FB_scene_capture alone doesn't count either
-    pattern: '(?m)^(?!.*(?:Unavailable OpenXR extension: |Name=|overportOXR: - |Extensions=")).*XR_FB_scene\b|XR_FB_spatial_entity.*(not supported|UNSUPPORTED)|xrQuerySpacesFB'
+    # not OVRPlugin's routine "Unavailable OpenXR extension: XR_FB_scene" (printed by every OVRPlugin game)
+    pattern: '(?<!Unavailable OpenXR extension: )XR_FB_scene|XR_FB_spatial_entity.*(not supported|UNSUPPORTED)|xrQuerySpacesFB'
     severity: warning
     diagnosis: The game wants Meta's room data (scene API), which the Frame lacks. The adapter can emulate a room from the guardian bounds.
     suggest: [adapter.scene_emul]
@@ -561,12 +566,6 @@ signatures:
     severity: fatal
     diagnosis: 'Games can''t start until the Frame restarts: it ran out of kernel keys. Rootless podman leaks one session keyring per container start; the FramePort agent sets keyring=false in ~/.config/containers/containers.conf, and a reboot frees the leaked keys.'
     suggest: []
-  - id: app-separate-process
-    pattern: 'Start proc \d+:[\w.]+:\w+/\S+ for (pre-)?top-activity'
-    severity: error
-    diagnosis: The game's activity runs in an Android process of its own, while Lepton watches only the app's main process, which never starts. About a minute in, Lepton decides the app "did not start" and closes it, wherever the game is. Newer FramePort versions run the activity in the main process (patch "Start the game in the app's main process"); update FramePort and use Update on Frame.
-    suggest: []
-    supersedes: [app-not-started, force-quit]
   - id: app-not-started
     pattern: 'Target app \(.*\) did not start'
     severity: error

docs/DEVICE_NOTES.md

@@ -785,3 +785,45 @@ SteamVR's own Touch remap (`/opt/steamvr/drivers/frame_controller/resources/inpu
 layout `oculus_touch`) is the diagram's "SteamVR default": X -> d-pad down, Y -> d-pad left/right/up, A -> A,
 B -> B/X/Y, Menu -> View, plus trigger click -> bumper. Games with their own Valve binding file in that folder
 (Beat Saber, Batman, Accounting+, In Death, ...) use that file instead.
+
+
+## Fixed layer resolution / Batman (#406, #394)
+
+Batman: Arkham Shadow (`com.camouflaj.manta`, Unity + OVRPlugin, OpenXR/Vulkan) submits
+`2768x2768`, then corner-anchored `rect=0,32 2736x2736`, `rect=0,64 2704x2704` inside the
+same swapchain. On SteamOS 0.5.6 Valve's FDM injection covers the full swapchain: shrinking
+viewports can move the sharp centre towards the top right and expose a coarse white right edge.
+The runtime recommendation driving OVRPlugin's dynamic resolution remains unverified.
+
+`adapter.fixed_resolution=1` (default off, Batman recipe on) overrides
+`xrGetRecommendedLayerResolutionMETA`: tracked full swapchain dimensions, `isValid=XR_TRUE`.
+The existing rect_clamp size table already records successful xrCreateSwapchain calls and
+retires entries at destruction. Projection views must have matching sizes; quads are supported;
+unknown swapchains, mixed sizes and other layer types retain the runtime behavior. Submitted
+rectangles are never enlarged after rendering. Full resolution may increase GPU load.
+
+The cached OVRPort 3.4.3-aa54c3f dispatcher contains both the extension and function name
+(and a runtime-missing diagnostic). Its fixed routing table is not a guarantee that every
+version forwards the call unchanged. Enable the existing arm64 xrshim for this setting:
+OVRPlugin's loader lookup reaches `framebridge_extension_proc` directly, while native OpenXR
+loaders use the adapter's xrGetInstanceProcAddr hook. No extension hiding: keeping the
+recommendation API available avoids relying on an unverified OVRPlugin fallback. The adapter
+revision stays unchanged because the new setting is opt-in; the catalog requires 1.2.2 so older
+remote clients keep their bundled recipe (`recommend.catalog.unusable_reason`). Rebuild and
+reinstall Batman to receive the binary and shim routing; this is not a settings-only fix for
+an old APK. Device/headset verification is pending.
+
+Headless check: expect `extension shim: xrGetRecommendedLayerResolutionMETA -> FrameBridge`
+for OVRPlugin, then up to five `fixed_resolution: recommended WxH -> 2768x2768 (runtime=...)`
+lines. Compare the size to the actual eye swapchain creation log; scaling can change it.
+`projection view 0 rect change: ... rect=0,0 2768x2768` (and view 1) should remain full size
+through gameplay/loading transitions. Rect changes continue to log at most once per second
+per eye, comparing against the last logged state so a throttled final change is still shown.
+No recommendation logs means this API path was not exercised: do not claim the fix worked.
+Headset check: sharp region centred in both eyes, no white right edge, correct menus/loading
+fades, and acceptable pacing with full-resolution GPU load.
+
+This is separate from #303's `foveation_storage_fix` (clearing SUBSAMPLED allocation flags;
+see PLAYBOOK and FRAME_RUNTIME), which fixes black/coarse storage corruption. It also leaves
+#394's `FOVE_LEVEL=lo/med/hi` presets intact (commits 01ad5e6b, d7f0d514): those select the
+full-swapchain density pattern, not the game's dynamic viewport.

docs/GAMES.md

@@ -42,7 +42,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Creed | Quest | ✅ Works |  |
 | Crisis Zone VR | Quest | ✅ Works |  |
 | cubism | Quest | ✅ Works |  |
-| cubism | Quest | ✅ Works |  |
 | Dance Central | Quest | ✅ Works |  |
 | Deep Cuts | Quest | ✅ Works |  |
 | Demeo | Quest | ✅ Works |  |
@@ -78,7 +77,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Jurassic World Aftermath Collection | Quest | ✅ Works |  |
 | Keep Talking and Nobody Explodes | Quest | ✅ Works |  |
 | Kill It With Fire VR | Quest | ✅ Works |  |
-| KillerFrequency | Quest | ✅ Works |  |
 | Ladder | Quest | ✅ Works |  |
 | Lambda1VR | Quest | ✅ Works |  |
 | LEGO® Bricktales | Quest | ✅ Works |  |

docs/PATCHES.md

@@ -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) (62)
-- [Game settings](#group-adapter) (77)
+- [Steam Frame patches](#group-frame) (61)
+- [Game settings](#group-adapter) (78)
 - [Files and settings on the Frame](#group-device) (10)
 - [PC VR (Proton and Revive)](#group-pcvr) (13)
 
@@ -58,12 +58,11 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [GL shim (Mesa GLSL compatibility)](#frame-gl_shim) | `frame.gl_shim` | Steam Frame patches | 2 |
 | [Play services: Android 11 version checks](#frame-gms_platform_version) | `frame.gms_platform_version` | Steam Frame patches | 1 |
 | [Godot apps: start without a clipboard service](#frame-godot_clipboard) | `frame.godot_clipboard` | Steam Frame patches | 1 |
-| [Hardware video decoding (H.264, HEVC, VP9)](#frame-hw_video_decode) | `frame.hw_video_decode` | Steam Frame patches | 35 |
+| [Hardware video decoding (H.264, HEVC, VP9)](#frame-hw_video_decode) | `frame.hw_video_decode` | Steam Frame patches | 34 |
 | [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 |
 | [Fix Lua startup crashes on Frame](#frame-luajit_pointers) | `frame.luajit_pointers` | Steam Frame patches | 1 |
-| [Start the game in the app's main process](#frame-main_process) | `frame.main_process` | Steam Frame patches | default |
 | [Declare Meta-only permissions](#frame-meta_permissions) | `frame.meta_permissions` | Steam Frame patches | 4 |
 | [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 |
@@ -81,13 +80,13 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [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 |
 | [Unity App UI: no Android 12 vibrator](#frame-unity_appui_vibrator) | `frame.unity_appui_vibrator` | Steam Frame patches |  |
-| [GL shim for Unity (no multisampled render-to-texture)](#frame-unity_gl_shim) | `frame.unity_gl_shim` | Steam Frame patches | 27 |
+| [GL shim for Unity (no multisampled render-to-texture)](#frame-unity_gl_shim) | `frame.unity_gl_shim` | Steam Frame patches | 26 |
 | [Unity: render each eye separately (no multiview)](#frame-unity_multipass) | `frame.unity_multipass` | Steam Frame patches | 2 |
-| [Unity: disable MSAA](#frame-unity_no_msaa) | `frame.unity_no_msaa` | Steam Frame patches | 11 |
+| [Unity: disable MSAA](#frame-unity_no_msaa) | `frame.unity_no_msaa` | Steam Frame patches | 10 |
 | [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 | 14 |
-| [Unity: keep MSAA off at runtime (OVRManager)](#frame-unity_runtime_msaa_off) | `frame.unity_runtime_msaa_off` | Steam Frame patches | 33 |
-| [Make Unity text fields work](#frame-unity_text_input) | `frame.unity_text_input` | Steam Frame patches | 119 |
+| [Unity: keep MSAA off at runtime (OVRManager)](#frame-unity_runtime_msaa_off) | `frame.unity_runtime_msaa_off` | Steam Frame patches | 32 |
+| [Make Unity text fields work](#frame-unity_text_input) | `frame.unity_text_input` | Steam Frame patches | 118 |
 | [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 |
@@ -126,6 +125,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [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 | 2 |
 | [Colour space support](#adapter-fb_color_space) | `adapter.fb_color_space` | Game settings |  |
+| [Keep full resolution (no dynamic resolution)](#adapter-fixed_resolution) | `adapter.fixed_resolution` | Game settings | 1 |
 | [Upside-down panel images (diagnostics)](#adapter-flip_dump) | `adapter.flip_dump` | 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 |  |
@@ -138,7 +138,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 | 104 |
+| [Fix freezes when controllers vibrate](#adapter-haptic_fix) | `adapter.haptic_fix` | Game settings | 103 |
 | [Vibration strength](#adapter-haptic_scale) | `adapter.haptic_scale` | Game settings |  |
 | [Turn off Quest Vulkan foveation](#adapter-hide_fb_foveation) | `adapter.hide_fb_foveation` | Game settings |  |
 | [Turn off space warp](#adapter-hide_space_warp) | `adapter.hide_space_warp` | Game settings | 5 |
@@ -159,9 +159,9 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Refresh rate](#adapter-refresh_rate) | `adapter.refresh_rate` | Game settings | 3 |
 | [Wait for the game's GPU](#adapter-release_wait) | `adapter.release_wait` | Game settings |  |
 | [Re-create play space](#adapter-respace_kick) | `adapter.respace_kick` | Game settings |  |
-| [Render resolution (supersampling)](#adapter-scale) | `adapter.scale` | Game settings | 15 |
+| [Render resolution (supersampling)](#adapter-scale) | `adapter.scale` | Game settings | 14 |
 | [Room depth](#adapter-scene_depth) | `adapter.scene_depth` | Game settings |  |
-| [Pretend room layout](#adapter-scene_emul) | `adapter.scene_emul` | Game settings | 13 |
+| [Pretend room layout](#adapter-scene_emul) | `adapter.scene_emul` | Game settings | 12 |
 | [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 |  |
@@ -193,7 +193,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Game language](#device-language) | `device.language` | 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 | 122 |
+| [Show the app's Android window (for typing)](#device-text_input_window) | `device.text_input_window` | Files and settings on the Frame | 121 |
 | [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) |  |
@@ -694,7 +694,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 (35):** 4XVR Video Player, AugmentedEmpire, Batman: Arkham Shadow, Battlemarked, BattleTalent, Breathedge VR, Dance Central, Exploding Kittens VR and 27 more.
+- **Catalog games (34):** 4XVR Video Player, AugmentedEmpire, Batman: Arkham Shadow, Battlemarked, BattleTalent, Breathedge VR, Dance Central, Exploding Kittens VR and 26 more.
 - **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.
@@ -749,17 +749,6 @@ Lets games with a verified older Lua engine get past a startup crash on the Fram
 
 > Older xLua/LuaJIT engines reject native pointers outside their 47-bit range, causing a startup error and sometimes a second crash during Unity shutdown (e.g. BattleTalent). Uses a Lua engine that preserves full pointer values while keeping the game's original xLua bindings and native helpers. Applied only to the verified compatible library build.
 
-### <a id="frame-main_process"></a>Start the game in the app's main process
-
-Keeps the game from being closed about a minute after it starts (it runs in a separate Android process the Frame doesn't watch).
-
-- `frame.main_process` · on by default · also for 2D apps
-- **Changes:** Changes the APK (a rebuild and reinstall apply it).
-- **Suggested (on):** … runs in its own process, which Lepton doesn't watch: it would close the game about a minute in.
-- **Source:** [patches/frame/manifest_fixes.py](../src/frameport/patches/frame/manifest_fixes.py)
-
-> Some apps run their game activity in a process of its own (android:process, e.g. Halo CE VR's ":halo_game"), started from a 2D launcher activity. Lepton starts the game activity directly and watches only the app's main process, which then never exists: about a minute in, Lepton decides the app "did not start" and closes it, at whatever point the game has reached. This runs those activities in the main process (only their android:process value changes).
-
 ### <a id="frame-meta_permissions"></a>Declare Meta-only permissions
 
 Declares Meta's permissions some mixed-reality games ask for, so they don't stop.
@@ -993,7 +982,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 (27):** Audica, BattleSisters, Beat Saber, COMPOUND, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight, End Space and 19 more.
+- **Catalog games (26):** Audica, BattleSisters, Beat Saber, COMPOUND, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight, End Space and 18 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)
@@ -1020,7 +1009,7 @@ Turns off a smoothing setting that crashes some older Unity games on the Frame.
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Legacy VrApi Unity game on GLES with MSAA (… quality levels): multisampled render-to-texture hangs the Frame's GL driver (for example Sniper Elite VR).
 - **Offered (off):** GLES Unity game with MSAA on (… quality levels); enable if it hangs the GPU ('zink: DEVICE LOST').
-- **Catalog games (11):** Audica, BattleSisters, Eye of the Temple, I Expect You To Die 2, IEYTD3, Jurassic World Aftermath Collection, KillerFrequency, Mini Motor Racing X and 3 more.
+- **Catalog games (10):** Audica, BattleSisters, Eye of the Temple, I Expect You To Die 2, IEYTD3, Jurassic World Aftermath Collection, Mini Motor Racing X, Sniper Elite VR and 2 more.
 - **Suggested by launch-test signatures:**
   - `zink-device-lost` (fatal): The GPU hung, so the game froze or closed.
 - **Source:** [patches/frame/unity_no_msaa.py](../src/frameport/patches/frame/unity_no_msaa.py)
@@ -1062,7 +1051,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 (33):** Audica, BattleSisters, BattleTalent, Beat Saber, COMPOUND, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight and 25 more.
+- **Catalog games (32):** Audica, BattleSisters, BattleTalent, Beat Saber, COMPOUND, Cosmodread, Down the Rabbit Hole, Drunkn Bar Fight and 24 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.
@@ -1078,7 +1067,7 @@ 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 (119):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable, Audica and 111 more.
+- **Catalog games (118):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable, Audica and 110 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.
@@ -1619,6 +1608,23 @@ For games that stop at start because the headset reports no colour space (for ex
 
 > Offers Meta's colour-space extension when the Frame's runtime lacks it: the game is told the headset uses Rec.709 and may choose any colour space (no conversion is done). For games that quit before their VR session with "Rec.709 color space unavailable" (for example OutRun Quest VR, GitHub #336). Only reaches games that use their own OpenXR loader; OVRPort's dispatcher can't forward the new functions.
 
+### <a id="adapter-fixed_resolution"></a>Keep full resolution (no dynamic resolution)
+
+Prevents dynamic resolution from moving Valve foveation off-centre or leaving a white edge line. May increase GPU load. Used at the next launch.
+
+- `adapter.fixed_resolution`
+- **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 → "Keep full resolution (no dynamic resolution)" (advanced).
+- **Catalog games (1):** Batman: Arkham Shadow.
+- **Suggested by launch-test signatures:**
+  - `dynamic-resolution-foveation` (info): The game submits an offset projection viewport.
+- **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
+
+> Keeps OpenXR layer recommendations at the full swapchain size. Prevents dynamic resolution from moving Valve foveation off-centre or leaving a coarse white edge line. May increase GPU load.
+
 ### <a id="adapter-flip_dump"></a>Upside-down panel images (diagnostics)
 
 Saves a few UI panels before and after FrameBridge turns them upright, for testing without the headset.
@@ -1806,7 +1812,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 (104):** AgeOfJoy, Ancient_Dungeon, Attack on Titan VR: Unbreakable, Audica, AugmentedEmpire, Battlemarked, BattleSisters, BattleTalent and 96 more.
+- **Catalog games (103):** AgeOfJoy, Ancient_Dungeon, Attack on Titan VR: Unbreakable, Audica, AugmentedEmpire, Battlemarked, BattleSisters, BattleTalent and 95 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.
@@ -2114,7 +2120,7 @@ Changes the game's render resolution. Higher is sharper but slower; 1.0× is the
 - **Options:**
   - Value: float, default `1.0` (always written).
   - Game settings → Picture → "Render resolution (supersampling)": slider 0.5–2 in steps of 0.1.
-- **Catalog games (15):** 4XVR Video Player, BlazeRush, CrazyTaxiVR, cubism, FGO VR, I Expect You To Die 2, KillerFrequency, Spectre and 7 more.
+- **Catalog games (14):** 4XVR Video Player, BlazeRush, CrazyTaxiVR, cubism, FGO VR, I Expect You To Die 2, Spectre, Survival Nation and 6 more.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
 
 > Multiplies the recommended eye-buffer width and height (0.5–2.0). 1.5 ≈ 2.25× pixels.
@@ -2144,7 +2150,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 (13):** Arkio, AugmentedEmpire, Battlemarked, BattleTalent, cubism, Demeo, Demeter, Ghostbusters: Rise of the Ghost Lord and 5 more.
+- **Catalog games (12):** Arkio, AugmentedEmpire, Battlemarked, BattleTalent, Demeo, Demeter, Ghostbusters: Rise of the Ghost Lord, Neko Atsume Purrfect and 4 more.
 - **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)
@@ -2602,13 +2608,9 @@ Lets the game use your controllers as a gamepad instead of a pointer, for 2D gam
 - `device.steam_gamepad` · also for 2D apps
 - **Changes:** Install only: written on the Frame when the game is installed; the APK isn't changed.
 - **Suggested (on):** 2D app that declares gamepad support (android.hardware.gamepad or Android TV's launcher): pass the controllers to it as a gamepad.
-- **Options:**
-  - `swap_sticks`: bool, default `False` — Swap the sticks: the right stick moves through menus like the left one (for using one controller)
-  - `swap_ab`: bool, default `False` — Swap A and B
-  - `keys`: str, default empty — Own key layout lines (Android .kl), separated by ';', e.g. 'key 304 DPAD_DOWN' (A presses D-pad down) or 'key 305 BACK'
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
 
-> Lepton's Android only gets a keyboard, a pointer and touch from the Frame, so a 2D game never sees a controller (the controllers only move the pointer; SDL games show their touch controls). This passes Steam Input's virtual gamepad ("Microsoft X-Box 360 pad", made by Steam for the Frame's controllers and paired Bluetooth pads) into this app's container with an Xbox 360 key layout, and tells SDL games to use it (SDL_GAMECONTROLLER_ALLOW_STEAM_VIRTUAL_GAMEPAD). Steam Input must be on for the game's shortcut; the controllers must be on when the game starts (a pad Steam makes later isn't seen until the next start). The APK isn't changed. Off for one start: FRAMEPORT_NO_GAMEPAD=1 in the game's launch options. Steam Input's own per-game remapping may not reach the app (GitHub #162); the options below change the buttons inside the app instead (applied with Update on Frame).
+> Lepton's Android only gets a keyboard, a pointer and touch from the Frame, so a 2D game never sees a controller (the controllers only move the pointer; SDL games show their touch controls). This passes Steam Input's virtual gamepad ("Microsoft X-Box 360 pad", made by Steam for the Frame's controllers and paired Bluetooth pads) into this app's container with an Xbox 360 key layout, and tells SDL games to use it (SDL_GAMECONTROLLER_ALLOW_STEAM_VIRTUAL_GAMEPAD). Steam Input must be on for the game's shortcut; the controllers must be on when the game starts (a pad Steam makes later isn't seen until the next start). The APK isn't changed. Off for one start: FRAMEPORT_NO_GAMEPAD=1 in the game's launch options.
 
 ### <a id="device-text_input_window"></a>Show the app's Android window (for typing)
 
@@ -2617,7 +2619,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 (122):** AFFECTED: The Manor, AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable and 114 more.
+- **Catalog games (121):** AFFECTED: The Manor, AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable and 113 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".

docs/PLAYBOOK.md

@@ -13,6 +13,7 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 ## Startup failures (visible in launch.log)
 | Symptom | Cause | Fix |
 |---|---|---|
+| Valve foveation sharp centre moves to the top right or a white line appears at the right edge as Batman shrinks its projection rect (#406 / #394) | Dynamic resolution draws a corner-anchored subrect inside the full swapchain used by Valve FDM | Enable `adapter.fixed_resolution` (Game settings → Picture), rebuild/reinstall for the new adapter and OVRPlugin shim; verify `fixed_resolution: recommended ... -> ...` and full-size `projection view ... rect change` logs. Headset verification pending; more GPU load |
 | Quest 3-only options missing; OVRPlugin logs `venderId 10291, systemName Oculus Quest2` (#373, Asgard's Wrath 2) | OVRPort's dispatcher overwrites FrameBridge's name and supplies a Quest 2 `XR_META_headset_id`; OVRPlugin prioritizes that UUID | `device.headset_model`: Quest 3 by default, per-game Quest 3S / Quest Pro / Quest 2; rebuild the APK. Byte-checked dispatcher name + UUID edit; Quest 2 leaves the dispatcher unchanged. See DEVICE_NOTES 'Per-game headset identity' |
 | Startup exits through `libxlua.so (lj_err_throw)`, then Unity aborts in mutex cleanup; captured Lua error is `bad light userdata pointer` (GitHub #257, BattleTalent 4.7) | This older LuaJIT encodes lightuserdata in 47 bits; Frame supplies valid wider native pointers. Controlled tests with the unchanged library pass a real low-address allocation and fail its own high-address static pointer | `frame.luajit_pointers` automatically selects a full-pointer Lua engine only for the verified library SHA-256, retaining xLua bindings and custom helpers. The scoped patch reaches OpenXR startup for 60 s headless; rendering and gameplay remain unverified. A `lj_err_throw` cleanup stack without the original error message is insufficient to infer this cause |
 | A GL4ES Team Beef game draws stretched triangles or spikes across characters and the scene (GitHub #191, Lambda1VR) | The newer GL shim exports GLES draw functions that intercept GL4ES's desktop OpenGL calls, bypassing its client-array and immediate-mode translation | `frame.tbxr_vendor` keeps the shim's five draw symbols private when the APK bundles `libgl4es.so`. GL queries and single-sampled framebuffer fixes remain active; other games retain the draw hooks. A/B eye captures on SteamOS 0.4.5: old shim normal, current shim spikes, current shim with private draw symbols normal at ~72 fps. Worn-headset gameplay still needs confirmation |
@@ -60,7 +61,6 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | 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 |
-| The game closes about a minute after starting, at a different spot each time; `Start proc …:<pkg>:<name> for pre-top-activity`, then `Target app (<pkg>) did not start` (GitHub #178) | The started activity runs in its own process (`android:process`); Lepton watches only the main process (triage `app-separate-process`) | `frame.main_process` (automatic) |
 | `APP_ACTIVITY is empty`, nothing starts | Manifest has category INFO only; Lepton needs LAUNCHER | `frame.launcher` (automatic) |
 | PC VR game on the Frame shows as a flat window / Revive: `Unable to load LibOVRRT DLL` / `LoaderInstance::CreateInstance chained CreateInstance call failed` | Frame SteamVR runtime rejects OpenXR apiVersion 1.1 (`XR_ERROR_API_VERSION_UNSUPPORTED`), which Proton 11's VR helper requests | `pcvr.xr_timefix` (Frame OpenXR layer, default on): retries xrCreateInstance as 1.0 |
 | Unreal PC VR game on the Frame runs as a flat window although OpenXR works (no `LogHMD` OVRPlugin lines; Unreal logs nothing when it skips the Oculus plugin) / launch.log: `FramePort oculushmd: could not create the OculusHMDConnected event` | UE's OculusHMD (and LibOVR's `ovr_Detect`) only start when the Windows event `OculusHMDConnected` exists and is signaled; on a PC the Oculus service creates it. Revive hooks `OpenEventW` for it, but that relies on Detours patching Wine's (ARM64EC) kernelbase | `pcvr.oculus_unreal` (default for Unreal Rift games; PC VR counterpart of overport's `patch_oculus_unreal`): launch.sh runs the injector through `fp_oculushmd.exe`, which provides the real event until the game exits |

native/README.md

@@ -31,3 +31,9 @@ missing symbols (no compiler needed).
 
 After changing anything here: `python native/build.py`, commit artifacts + SHA256SUMS, then run `frameport parity`
 (the report marks updated binaries as "expected") and a device launch test.
+
+`adapter.fixed_resolution` (off by default, #406/#394) keeps META recommended layer
+resolution at tracked full swapchain size. Both adapter GIPA and xrshim's existing
+extension entry point serve it; the setting adds OVRPlugin shim routing. The extension
+stays visible, avoiding dependence on a plugin fallback. No adapter revision bump for
+this opt-in fix. See DEVICE_NOTES "Fixed layer resolution / Batman" for verification.

native/adapter/fixed_resolution.h

@@ -0,0 +1,22 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// swapchain_size is the adapter's mutex-protected table, shared with rect_clamp.
+static int fixed_layer_size(const XrCompositionLayerBaseHeader *layer, XrExtent2Di *full) {
+    if (!layer) return 0;
+    uint32_t w = 0, h = 0;
+    if (layer->type == XR_TYPE_COMPOSITION_LAYER_PROJECTION) {
+        const XrCompositionLayerProjection *p = (const XrCompositionLayerProjection *)layer;
+        if (!p->viewCount || !p->views) return 0;
+        for (uint32_t v = 0; v < p->viewCount; ++v) {
+            uint32_t vw, vh;
+            if (!swapchain_size(p->views[v].subImage.swapchain, &vw, &vh)) return 0;
+            if (v && (vw != w || vh != h)) return 0; // no single full size for this layer
+            w = vw; h = vh;
+        }
+    } else if (layer->type == XR_TYPE_COMPOSITION_LAYER_QUAD) {
+        const XrCompositionLayerQuad *q = (const XrCompositionLayerQuad *)layer;
+        if (!swapchain_size(q->subImage.swapchain, &w, &h)) return 0;
+    } else return 0; // preserve runtime behavior for other layer types
+    if (!w || !h || w > INT32_MAX || h > INT32_MAX) return 0;
+    full->width = (int32_t)w; full->height = (int32_t)h;
+    return 1;
+}

native/adapter/frame_adapter.c

@@ -131,6 +131,7 @@ static int swapchain_fix = 1;
 static int cube_quads = 1;
 static int cube_standin = 1;  // cube swapchains the runtime refuses: served by the adapter (cube_standin.c)
 static int rect_clamp = 1;
+static int fixed_resolution;
 static int fb_color_space;  // fb_color_space: offer XR_FB_color_space when the runtime lacks it (#336)
 static int action_dedup = 1;  // rename duplicate action names in a set (session_fixes.c; GitHub #323)
 static int pose_consistency = 0;  // repeat xrLocateViews queries for one display time get the same poses (GitHub #8)  // clamp submitted image rects to their swapchain (SteamVR rejects a 1 px overrun)
@@ -207,6 +208,7 @@ static void read_settings(const char *path) {
         if (sscanf(line, "swapchain_fix=%f", &value) == 1) swapchain_fix = value != 0;
         if (sscanf(line, "cube_quads=%f", &value) == 1) cube_quads = value != 0;
         if (sscanf(line, "cube_standin=%f", &value) == 1) cube_standin = value != 0;
+        if (sscanf(line, "fixed_resolution=%f", &value) == 1) fixed_resolution = value != 0;
         if (sscanf(line, "rect_clamp=%f", &value) == 1) rect_clamp = value != 0;
         if (sscanf(line, "fb_color_space=%f", &value) == 1) fb_color_space = value != 0;
         if (sscanf(line, "action_dedup=%f", &value) == 1) action_dedup = value != 0;
@@ -298,6 +300,7 @@ static void initialize(void) {
     if (input_diag) LOG("per-game: input_diag=1 (controller-input diagnostics)");
     if (proximity_emul) LOG("per-game: proximity_emul=%d (finger proximity from capacitive touch: %s)", proximity_emul,
                             proximity_emul > 1 ? "thumb + index" : "thumb");
+    if (fixed_resolution) LOG("per-game: fixed_resolution=1 (full swapchain recommendations)");
     if (hide_fb_foveation) LOG("per-game: hide_fb_foveation=1 (Quest Vulkan foveation suppressed)");
     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);
@@ -595,6 +598,29 @@ static int swapchain_size(XrSwapchain handle, uint32_t *w, uint32_t *h) {
     return found;
 }
 
+#include "fixed_resolution.h"
+
+static XRAPI_ATTR XrResult XRAPI_CALL fixed_recommended_resolution(XrSession session,
+        const XrRecommendedLayerResolutionGetInfoMETA *info, XrRecommendedLayerResolutionMETA *out) {
+    PFN_xrGetRecommendedLayerResolutionMETA fn = (PFN_xrGetRecommendedLayerResolutionMETA)
+        lookup(active_instance, "xrGetRecommendedLayerResolutionMETA");
+    if (!info || !out) return XR_ERROR_VALIDATION_FAILURE;
+    XrExtent2Di full;
+    if (!fixed_layer_size(info->layer, &full))
+        return fn ? fn(session, info, out) : XR_ERROR_FUNCTION_UNSUPPORTED;
+    // Read the runtime recommendation only for diagnostics. The override also works
+    // when the runtime lacks this function (OVRPort advertises it itself).
+    XrRecommendedLayerResolutionMETA old = {XR_TYPE_RECOMMENDED_LAYER_RESOLUTION_META};
+    XrResult result = fn ? fn(session, info, &old) : XR_ERROR_FUNCTION_UNSUPPORTED;
+    static unsigned logged;
+    if (logged++ < 5) LOG("fixed_resolution: recommended %dx%d -> %dx%d (runtime=%d)",
+        old.recommendedImageDimensions.width, old.recommendedImageDimensions.height,
+        full.width, full.height, result);
+    out->recommendedImageDimensions = full;
+    out->isValid = XR_TRUE;
+    return XR_SUCCESS;
+}
+
 // Clamp `r` to a w x h image; returns whether it changed (2 = it was empty and now covers the whole image).
 static int clamp_rect(XrRect2Di *r, uint32_t w, uint32_t h) {
     XrRect2Di c = *r;
@@ -2064,6 +2090,30 @@ XRAPI_ATTR XrResult XRAPI_CALL xrEndFrame(XrSession session, const XrFrameEndInf
     static int warned, failures, passthrough_logged;
     if (dropped && warned++ < 5) LOG("xrEndFrame: dropped %u unusable layer(s)", dropped);
     if (passthrough && !passthrough_logged++) LOG("xrEndFrame: passthrough layer -> ALPHA_BLEND environment");
+    static struct { XrSwapchain swapchain; XrRect2Di rect; uint32_t array; } last_rect[2];
+    static double last_rect_log[2];
+    struct timespec rect_now;
+    clock_gettime(CLOCK_MONOTONIC, &rect_now);
+    double rect_seconds = rect_now.tv_sec + rect_now.tv_nsec / 1e9;
+    for (uint32_t i = 0; i < info->layerCount; ++i) {
+        const XrCompositionLayerBaseHeader *l = info->layers[i];
+        if (!l || l->type != XR_TYPE_COMPOSITION_LAYER_PROJECTION) continue;
+        const XrCompositionLayerProjection *p = (const XrCompositionLayerProjection *)l;
+        for (uint32_t v = 0; v < p->viewCount && v < 2; ++v) {
+            const XrSwapchainSubImage *sub = &p->views[v].subImage;
+            if ((last_rect[v].swapchain != sub->swapchain || last_rect[v].array != sub->imageArrayIndex ||
+                 memcmp(&last_rect[v].rect, &sub->imageRect, sizeof(sub->imageRect))) &&
+                rect_seconds - last_rect_log[v] >= 1.0) {
+                LOG("projection view %u rect change: swapchain=%p rect=%d,%d %dx%d array=%u", v,
+                    (void *)(uintptr_t)sub->swapchain, sub->imageRect.offset.x, sub->imageRect.offset.y,
+                    sub->imageRect.extent.width, sub->imageRect.extent.height, sub->imageArrayIndex);
+                last_rect[v].swapchain = sub->swapchain;
+                last_rect[v].rect = sub->imageRect;
+                last_rect[v].array = sub->imageArrayIndex;
+                last_rect_log[v] = rect_seconds;
+            }
+        }
+    }
     static int views_logged;
     if (views_logged < 3) {  // describe the stereo layer layout a few times to debug eye/stereo problems
         for (uint32_t i = 0; i < info->layerCount; ++i) {
@@ -2250,6 +2300,8 @@ static XRAPI_ATTR XrResult XRAPI_CALL fb_hide_update_swapchain(XrSwapchain swapc
 // 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 (fixed_resolution && name && !strcmp(name, "xrGetRecommendedLayerResolutionMETA"))
+        return (PFN_xrVoidFunction)fixed_recommended_resolution;
     if (name && !strcmp(name, "framebridge_hide_fb_foveation"))
         return (PFN_xrVoidFunction)framebridge_hide_fb_foveation;
     if (hide_fb_foveation_vulkan && name) {
@@ -2302,6 +2354,10 @@ XRAPI_ATTR XrResult XRAPI_CALL xrGetInstanceProcAddr(XrInstance instance, const
         *function = (PFN_xrVoidFunction)fb_hide_update_swapchain;
         return XR_SUCCESS;
     }
+    if (fixed_resolution && !strcmp(name, "xrGetRecommendedLayerResolutionMETA")) {
+        *function = (PFN_xrVoidFunction)fixed_recommended_resolution;
+        return XR_SUCCESS;
+    }
     HOOK(xrGetSystemProperties)
     HOOK(xrApplyHapticFeedback)
     HOOK(xrCreateReferenceSpace)

site/src/data/patches.json

@@ -94,6 +94,11 @@
   "title": "Colour space support",
   "group": "Game settings"
  },
+ "adapter.fixed_resolution": {
+  "anchor": "adapter-fixed_resolution",
+  "title": "Keep full resolution (no dynamic resolution)",
+  "group": "Game settings"
+ },
  "adapter.flip_dump": {
   "anchor": "adapter-flip_dump",
   "title": "Upside-down panel images (diagnostics)",
@@ -524,11 +529,6 @@
   "title": "Fix Lua startup crashes on Frame",
   "group": "Steam Frame patches"
  },
- "frame.main_process": {
-  "anchor": "frame-main_process",
-  "title": "Start the game in the app's main process",
-  "group": "Steam Frame patches"
- },
  "frame.meta_permissions": {
   "anchor": "frame-meta_permissions",
   "title": "Declare Meta-only permissions",

src/frameport/analysis/detect.py

@@ -54,9 +54,7 @@ IL2CPP_METADATA = "assets/bin/Data/Managed/Metadata/global-metadata.dat"
 #     USB MIDI driver polls the missing USB service: frame.usb_midi_watcher, GitHub #297) (2026-10)
 # 22: unreal_binned3 (Unreal built with FMallocBinned3 reserves tens of GiB at load: frame.unreal_noreserve,
 #     GitHub #349) (2026-10)
-# 23: separate_process (MAIN activities in another process than the main one, which Lepton doesn't watch:
-#     frame.main_process, GitHub #178) (2026-10)
-ANALYSIS_VERSION = 23
+ANALYSIS_VERSION = 22
 
 
 # Android versions by API level (for messages); the Frame's Lepton container runs Android 11 (API 30)
@@ -464,8 +462,6 @@ def analyze(path: Path, deep: bool = True, data_bytes: int | None = None) -> Ana
             "unity_oculus_check": b"\0com.oculus.systemactivities\0" in lib_bytes.get("libunity.so", b""),
             # a 2D launcher activity that starts a separate VR activity (frame.start_activity)
             "vr_activity": axml.vr_activity(manifest),
-            # a MAIN activity in its own process: Lepton watches only the main one (frame.main_process)
-            "separate_process": axml.separate_process_activities(manifest),
             "unity_version": unity_version(ggm, lib_bytes.get("libunity.so")) if engine == "Unity" else None,
             # the minimum Android version the APK declares (read from the original: OVRPort lowers it to 29)
             "min_sdk": axml.min_sdk(manifest),

src/frameport/apk/axml.py

@@ -376,53 +376,6 @@ def vr_activity(manifest: bytes) -> str | None:
     return vr if vr and vr != launcher else None
 
 
-def _package(x: Axml) -> str | None:
-    return next((x.attr_str(el, "package") for el in x.elements() if el.name == "manifest"), None)
-
-
-def separate_process_activities(manifest: bytes) -> list[str]:
-    """Activities with a MAIN intent-filter that run in another process than the app's main one (android:process
-    ":name" or another package's name). Lepton only watches the main process: started directly, such an activity
-    leaves none, and Lepton closes the app about a minute later ("Target app ... did not start", GitHub #178)."""
-    x = Axml(manifest)
-    package = _package(x)
-    process = {}
-    for el in x.elements():
-        if el.name == "activity":
-            process[x.attr_str(el, "name") or ""] = x.attr_str(el, "process")
-    names = x.strings()
-    out = []
-    for el, name, items in component_filters(manifest):
-        proc = process.get(name) if el == "activity" else None
-        if proc and proc != package and any(k == "action" and i < len(names) and names[i] == MAIN
-                                            for k, _, i in items):
-            out.append(name)
-    return out
-
-
-def set_main_process(manifest: bytes, activities: list[str]) -> bytes | None:
-    """Run `activities` in the app's main process: their android:process becomes the package name (only those
-    elements' attribute values change). None when there is nothing to change."""
-    x = Axml(manifest)
-    package = _package(x)
-    if not package:
-        return None
-    hits = [(x.attr_str(el, "name"), el) for el in x.elements() if el.name == "activity"]
-    if not any(n in activities and x.attr_str(el, "process") not in (None, package) for n, el in hits):
-        return None
-    index = x.index(package)
-    if index is None:
-        index = x.append_string(package)
-    names = x.strings()
-    for el in x.elements():  # again: append_string moved the elements
-        if el.name != "activity" or x.attr_str(el, "name") not in activities:
-            continue
-        for a in el.attrs:
-            if a.name < len(names) and names[a.name] == "process":
-                _set_string_attr(x, a.offset, index)
-    return x.bytes()
-
-
 def set_start_activity(manifest: bytes, activity: str) -> bytes | None:
     """Make `activity` the one Lepton starts: its MAIN intent-filter gets category LAUNCHER (in place of its VR or
     DEFAULT category), every other component's LAUNCHER category becomes INFO. Only those attribute values change

src/frameport/locales/template.json

@@ -869,7 +869,6 @@
  "Keeps games running that use a 360° cube layer the Frame lacks (for example Budget Cuts Ultimate). Leave it on.": "",
  "Keeps one label so the title is stable.": "",
  "Keeps one name for the game, so it shows the same everywhere.": "",
- "Keeps the game from being closed about a minute after it starts (it runs in a separate Android process the Frame doesn't watch).": "",
  "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).": "",
  "Keeps the resolution the game saves in step with the headset's picture size (else the picture is shifted, with black borders, after a render resolution change).": "",
  "Keeps three snapshots per game on the Frame and copies new ones here when connected.": "",
@@ -908,7 +907,7 @@
  "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\".": "",
  "Lepton's Android has no clipboard service, and SDL's Java code (SDL2 and LÖVE games, for example Dramatic Shape) registers a clipboard listener at start without checking, so the app crashes with a NullPointerException in SDLClipboardHandler. That call is skipped (an in-place edit of classes.dex).": "",
  "Lepton's Android has no clipboard service, and the Android code of Godot 4.2-4.4 (for example EndoparasiticVR) casts the missing service to a ClipboardManager without checking, so the app crashes at start with a NullPointerException in Godot.<init>. That check is skipped and Godot's clipboard functions do nothing instead (an in-place edit of classes.dex).": "",
- "Lepton's Android only gets a keyboard, a pointer and touch from the Frame, so a 2D game never sees a controller (the controllers only move the pointer; SDL games show their touch controls). This passes Steam Input's virtual gamepad (\"Microsoft X-Box 360 pad\", made by Steam for the Frame's controllers and paired Bluetooth pads) into this app's container with an Xbox 360 key layout, and tells SDL games to use it (SDL_GAMECONTROLLER_ALLOW_STEAM_VIRTUAL_GAMEPAD). Steam Input must be on for the game's shortcut; the controllers must be on when the game starts (a pad Steam makes later isn't seen until the next start). The APK isn't changed. Off for one start: FRAMEPORT_NO_GAMEPAD=1 in the game's launch options. Steam Input's own per-game remapping may not reach the app (GitHub #162); the options below change the buttons inside the app instead (applied with Update on Frame).": "",
+ "Lepton's Android only gets a keyboard, a pointer and touch from the Frame, so a 2D game never sees a controller (the controllers only move the pointer; SDL games show their touch controls). This passes Steam Input's virtual gamepad (\"Microsoft X-Box 360 pad\", made by Steam for the Frame's controllers and paired Bluetooth pads) into this app's container with an Xbox 360 key layout, and tells SDL games to use it (SDL_GAMECONTROLLER_ALLOW_STEAM_VIRTUAL_GAMEPAD). Steam Input must be on for the game's shortcut; the controllers must be on when the game starts (a pad Steam makes later isn't seen until the next start). The APK isn't changed. Off for one start: FRAMEPORT_NO_GAMEPAD=1 in the game's launch options.": "",
  "Lets apps with a USB MIDI driver start on the Frame (they'd crash looking for USB devices); USB MIDI devices aren't available there.": "",
  "Lets games built on Meta's oldest VR interface run on the Frame.": "",
  "Lets games built with Unity's App UI start on the Frame (they'd quit at once on an Android 12 vibrator call).": "",
@@ -953,7 +952,7 @@
  "Live view": "",
  "Loading…": "",
  "Loads FramePort's OpenXR layer under Proton on the Frame. The Frame's SteamVR runtime only accepts OpenXR 1.0 apps, but Proton's VR helper asks for 1.1, so without the layer VR never starts (the game shows as a flat window, or Revive fails with 'Unable to load LibOVRRT DLL'); the layer retries as 1.0. It also emulates xrConvertTimespecTimeToTimeKHR if a runtime refuses it. Ignored on this PC.": "",
- "Loads FramePort's shader-fix Vulkan layer into an OpenGL ES game. On the Frame, OpenGL ES runs on Zink (Mesa's GL on Vulkan); the layer sits between Zink and the driver and inserts the words of the adapter setting zink_shader_fix into the SPIR-V modules whose size and SHA-256 match (every other module is untouched), for example stores that set loop counters and accumulators a shader reads before writing, which hang the GPU (Vader Immortal's lightspeed jump; found by Klownicle, GitHub #49). Does nothing without zink_shader_fix (or zink_shader_dump) in the recipe, and either setting brings it in by itself. The layer adds itself to Android's Vulkan debug layer list for the game's process only.": "",
+ "Loads FramePort's shader-fix Vulkan layer into an OpenGL ES game. On the Frame, OpenGL ES runs on Zink (Mesa's GL on Vulkan); the layer sits between Zink and the driver and inserts the words of the adapter setting zink_shader_fix into the SPIR-V modules whose size and SHA-256 match (every other module is untouched), for example stores that set loop counters and accumulators a shader reads before writing, which hang the GPU (Vader Immortal's lightspeed jump; found by Klownicle, GitHub #49). Does nothing without zink_shader_fix (or zink_shader_dump) in the recipe. The layer adds itself to Android's Vulkan debug layer list for the game's process only.": "",
  "Loads libglshim.so ahead of libEGL in every engine library that fetches GL through eglGetProcAddress. Fixes Quest-only leniency that Mesa/Zink rejects: #pragma before #extension, implicit int/float conversions (enables GL_EXT_shader_implicit_conversions), and multiview shaders used on single-view framebuffers (hides GL_OVR_multiview; gl_hide_multiview=0 turns that off). Logs every failed shader with its source lines (logcat tag GLShim). Symptom: black screen with working audio in a GLES game.": "",
  "Loads the GL shim into a Unity GLES game and hides GL_EXT_multisampled_render_to_texture (and the multiview variant). Some Unity games switch their eye buffer to 4x MSAA at runtime; the Frame only gives single-sampled swapchains, Unity then renders through multisampled render-to-texture and Mesa/Zink crashes (SIGSEGV in libgallium_dri.so on the render thread: gray or frozen screen, for example The Room VR). Hidden, Unity uses an ordinary MSAA buffer and resolves it. Unity's multiview stays on (gl_hide_multiview defaults to 0 here).": "",
  "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).": "",
@@ -1551,7 +1550,6 @@
  "Smooth as butter": "",
  "software encoder": "",
  "Some apps open a flat Android launcher that then starts a separate VR activity (for example WiiCompiled). Shown with Lepton's flat window, that window stays in view after the VR part starts. This makes the VR activity the one Lepton starts (its LAUNCHER category), so the app opens in VR with no flat window. Everything only the launcher does (choosing or importing content) is skipped: turn it off for a run when you need the launcher, and turn off \"Show the app's Android window\".": "",
- "Some apps run their game activity in a process of its own (android:process, e.g. Halo CE VR's \":halo_game\"), started from a 2D launcher activity. Lepton starts the game activity directly and watches only the app's main process, which then never exists: about a minute in, Lepton decides the app \"did not start\" and closes it, at whatever point the game has reached. This runs those activities in the main process (only their android:process value changes).": "",
  "Some engines contain assembly (for example OpenSSL's) that checks a return-address signature it never made. The Quest's CPU ignores those checks, the Steam Frame's enforces them: the game crashes with SIGILL as soon as it uses that code, for example on its first network connection (Star Wars Pinball VR). In a library with unpaired checks, the signing and checking instructions become no-ops.": "",
  "Some engines leave the pNext of unused Vulkan attachment references uninitialized. The Frame's driver never reads it, but Lepton always loads Steam's Fossilize shader-cache layer, which follows it and crashes on the first frame (SIGSEGV in libVkLayer_fossilize.so from FVulkanRenderPass, for example Deadpool VR). Loads Vulkan through a small shim that keeps valid pointers and drops only unreadable ones or ones pointing at the wrong structure type. It also drops a depth resolve named in a subpass without a depth attachment, which crashes the Frame's driver at the first render pass (for example Metro Awakening).": "",
  "Some game folders are already set up for SteamVR: a Revive copy (LibRevive64.dll) next to the game, started by a small loader DLL (for example xinput1_3.dll) that Windows loads from the game's folder. Then FramePort starts the game program directly — like double-clicking it — instead of through its own Revive (two Revives conflict; for example the Oculus Platform check then fails). On the Frame, Wine is told to use those loader DLLs from the game folder instead of its own.": "",
@@ -1578,7 +1576,6 @@
  "Start live view": "",
  "Start setup": "",
  "Start straight in VR (skip the 2D launcher)": "",
- "Start the game in the app's main process": "",
  "Start the live view to watch the headset here.": "",
  "Start the live view to watch the headset in an mpv window.": "",
  "Start the live view to watch the headset in your browser.": "",

src/frameport/patches/frame/manifest_fixes.py

@@ -146,43 +146,7 @@ class StartActivity(Patch):
         return [("Only the VR activity is a launcher", ok, ", ".join(starts))]
 
 
-class MainProcess(Patch):
-    id = "frame.main_process"
-    a32 = True
-    needs_vr = False
-    title = "Start the game in the app's main process"
-    description = ("Some apps run their game activity in a process of its own (android:process, e.g. Halo CE VR's "
-                   "\":halo_game\"), started from a 2D launcher activity. Lepton starts the game activity directly "
-                   "and watches only the app's main process, which then never exists: about a minute in, Lepton "
-                   "decides the app \"did not start\" and closes it, at whatever point the game has reached. This "
-                   "runs those activities in the main process (only their android:process value changes).")
-    order = 21
-    default_on = True
-
-    def applies(self, a):
-        return bool((a.extra or {}).get("separate_process"))
-
-    def detect(self, a):
-        found = (a.extra or {}).get("separate_process")
-        if not found:
-            return None
-        return Suggestion(True, f"{found[0].rsplit('.', 1)[-1]} runs in its own process, which Lepton doesn't "
-                                "watch: it would close the game about a minute in.")
-
-    def apply(self, ctx: ApkContext) -> bool:
-        manifest = ctx.ws.read(MANIFEST)
-        fixed = axml.set_main_process(manifest, axml.separate_process_activities(manifest))
-        if fixed:
-            ctx.ws.put(MANIFEST, fixed)
-        return bool(fixed)
-
-    def validate(self, ctx):
-        left = axml.separate_process_activities(ctx.ws.read(MANIFEST))
-        return [("Game activities run in the main process", not left, ", ".join(left) or "all")]
-
-
 register(Launcher)
 register(NoDebuggable)
 register(MetaPermissions)
 register(StartActivity)
-register(MainProcess)

src/frameport/patches/settings.py

@@ -16,6 +16,9 @@ BASE_SETTINGS = {"scale": 1.0, "foveation_fix": 1, "controller_fix": 1}
 
 # key, kind, default, title, description
 SETTINGS = [
+    ("fixed_resolution", "int", 0, "Keep full resolution (no dynamic resolution)",
+     "Keeps OpenXR layer recommendations at the full swapchain size. Prevents dynamic resolution from moving "
+     "Valve foveation off-centre or leaving a coarse white edge line. May increase GPU load."),
     ("scale", "float", 1.0, "Resolution scale",
      "Multiplies the recommended eye-buffer width and height (0.5–2.0). 1.5 ≈ 2.25× pixels."),
     ("foveation_fix", "int", 1, "Hide Quest foveation", "Hides Quest foveation extensions the Frame runtime lacks."),
@@ -325,6 +328,9 @@ FOVEATION_UI = {
 }
 
 UI: dict[str, dict] = {
+    "fixed_resolution": dict(group="picture", level="advanced", label="Keep full resolution (no dynamic resolution)",
+                help="Prevents dynamic resolution from moving Valve foveation off-centre or leaving a white edge line. "
+                     "May increase GPU load. Used at the next launch.", control=("switch",)),
     "scale": dict(group="picture", level="common", label="Render resolution (supersampling)",
                   help="Changes the game's render resolution. Higher is sharper but slower; 1.0× is the game's own "
                        "resolution.",
@@ -538,7 +544,7 @@ UI: dict[str, dict] = {
 # settings that need the xrshim (frame/adapter.py: OVRPlugin's own arm64 OpenXR lookups routed to the adapter), so
 # they don't work for 32-bit games on the bridge. surface_native: Batman's native video renderer hooks Vulkan
 # functions OVRPort's dispatcher doesn't know
-XRSHIM_SETTINGS = ("hide_fb_foveation", "controller_models", "haptic_fix", "surface_native")
+XRSHIM_SETTINGS = ("fixed_resolution", "hide_fb_foveation", "controller_models", "haptic_fix", "surface_native")
 # shown with an "experimental" pill (Game settings, game page, CLI): not proven in the headset on many games yet
 EXPERIMENTAL_SETTINGS = ("quest_buttons",)
 
@@ -625,6 +631,7 @@ class AdapterSetting(Patch):
                                            or "com.oculus.feature.PASSTHROUGH" in (a.extra.get("features") or {})),
             "alpha_blend_emul": lambda a: (a.extra.get("mr_only")
                                            or "com.oculus.feature.PASSTHROUGH" in (a.extra.get("features") or {})),
+            "fixed_resolution": lambda a: "libOVRPlugin.so" in a.libs or a.xr == "OpenXR",
             "hide_fb_foveation": ap.is_vulkan,
             "flip_emul": ap.is_vulkan,
             "flip_quads": ap.is_vulkan,
@@ -824,21 +831,10 @@ class SteamGamepad(Patch):
                    "tells SDL games to use it (SDL_GAMECONTROLLER_ALLOW_STEAM_VIRTUAL_GAMEPAD). Steam Input must be "
                    "on for the game's shortcut; the controllers must be on when the game starts (a pad Steam makes "
                    "later isn't seen until the next start). The APK isn't changed. Off for one start: "
-                   "FRAMEPORT_NO_GAMEPAD=1 in the game's launch options. Steam Input's own per-game remapping may "
-                   "not reach the app (GitHub #162); the options below change the buttons inside the app instead "
-                   "(applied with Update on Frame).")
+                   "FRAMEPORT_NO_GAMEPAD=1 in the game's launch options.")
     category = "device"
     needs_vr = False
     stage = "install"  # the agent reads it from the recipe at finalize (deployment.json steam_gamepad)
-    params = [
-        Param("swap_sticks", "bool", False, "Swap the sticks: the right stick moves through menus like the left one "
-                                            "(for using one controller)"),
-        Param("swap_ab", "bool", False, "Swap A and B"),
-        Param("keys", "str", "", "Own key layout lines (Android .kl), separated by ';', e.g. 'key 304 DPAD_DOWN' "
-                                 "(A presses D-pad down) or 'key 305 BACK'"),
-    ]
-    KL_LINE = re.compile(r"(key [0-9]{1,4} [A-Z][A-Z0-9_]{0,40}( (FUNCTION|WAKE))?"
-                         r"|axis 0x[0-9a-f]{1,2} (invert )?[A-Z][A-Z0-9_]{0,40}( flat [0-9]{1,5})?)")
 
     def applies(self, a):
         return a.vr_kind == "none"
@@ -850,17 +846,7 @@ class SteamGamepad(Patch):
         return None
 
     def install(self, ctx: InstallContext) -> None:
-        # the launcher line (agent: GAMEPAD_LINE) exports SDL's hint and puts the Podman wrapper on PATH; the wrapper
-        # builds the app's key layout from these (agent: gamepad_kl)
-        layout = ",".join(k for k in ("swap_sticks", "swap_ab") if ctx.params.get(k))
-        lines = [" ".join(ln.split()) for ln in str(ctx.params.get("keys") or "").split(";") if ln.strip()]
-        bad = [ln for ln in lines if not self.KL_LINE.fullmatch(ln)]
-        if bad:
-            raise ValueError(f"Not a key layout line: {bad[0]!r} (for example 'key 304 DPAD_DOWN')")
-        if layout:
-            ctx.env["FRAMEPORT_GAMEPAD_LAYOUT"] = layout
-        if lines:
-            ctx.env["FRAMEPORT_GAMEPAD_KEYS"] = "; ".join(lines)
+        pass  # the launcher line (agent: GAMEPAD_LINE) exports SDL's hint and puts the Podman wrapper on PATH
 
 
 def foveation_options(params):

src/frameport/patches/summaries.py

@@ -40,8 +40,6 @@ SUMMARIES = {
     "frame.adapter": "FramePort's layer between the game and the Steam Frame: fills in what the Frame lacks "
                      "(controllers, room, passthrough). Needed for every converted game.",
     "frame.launcher": "Makes the game start from the Frame's Steam library.",
-    "frame.main_process": "Keeps the game from being closed about a minute after it starts (it runs in a separate "
-                          "Android process the Frame doesn't watch).",
     "frame.start_activity": "Opens the app straight in VR, skipping its flat launcher screen. Turn off to use the "
                             "launcher, for example to import new content.",
     "frame.gl_multiview_fbo": "Experimental: shows HUDs, menus and other flat panels that stay black on the Frame "

src/frameport/ui/views/game.py

@@ -796,14 +796,6 @@ class GameView:
                 app.open_game(package, advanced=True, show_all=self.show_all)  # the switch shows it's on now
             return handler
 
-        def set_flag(pid, key):
-            def handler(e):
-                r = state["recipe"]
-                r.patches.setdefault(pid, {})[key] = bool(e.control.value)
-                r.reasons[pid] = r.reasons.get(pid) or tr("Set by you.")
-                save(r)
-            return handler
-
         sections = []
         for cat in ("pcvr", "frame", "overport", "adapter", "device"):
             if cat == "adapter":  # one row: the settings themselves are in the Game settings dialog (plain words)
@@ -863,15 +855,7 @@ class GameView:
                     ], spacing=T.S3), padding=ft.Padding(T.S4, T.px(10), T.S4, T.px(10)), border=ft.Border(
                         top=ft.BorderSide(1, T.BORDER))))
                     continue
-                flags = any(q.kind == "bool" for q in p.params)
-                if on and flags:  # a patch's own options (e.g. the gamepad's button layout), under it while it's on
-                    params = recipe.params(p.id)
-                    for q in p.params:
-                        sub.append(C.switch(tr(q.help), value=bool(params.get(q.key, q.default)),
-                                            on_change=set_flag(p.id, q.key)) if q.kind == "bool" else
-                                   C.field(value=str(params.get(q.key, q.default) or ""), hint_text=tr(q.help),
-                                           on_blur=set_param(p.id, q.key)))
-                if not technical or flags:
+                if not technical:
                     pass
                 elif cat == "adapter":
                     val = recipe.params(p.id).get("value", p.params[0].default)

tests/fixtures/src/fixed_resolution_test.c

@@ -0,0 +1,34 @@
+#include <assert.h>
+#include <stdint.h>
+#include <openxr/openxr.h>
+static int swapchain_size(XrSwapchain handle, uint32_t *w, uint32_t *h) {
+    if (!handle) return 0;
+    *w = handle == (XrSwapchain)(uintptr_t)2 ? 1024 : 2768; *h = *w;
+    return 1;
+}
+#include "fixed_resolution.h"
+int main(void) {
+    XrExtent2Di full = {0};
+    XrCompositionLayerProjectionView views[2] = {{XR_TYPE_COMPOSITION_LAYER_PROJECTION_VIEW},
+                                               {XR_TYPE_COMPOSITION_LAYER_PROJECTION_VIEW}};
+    XrCompositionLayerProjection p = {XR_TYPE_COMPOSITION_LAYER_PROJECTION};
+    p.views = views; p.viewCount = 2;
+    for (int i=0; i<2; ++i) {
+        views[i].subImage.swapchain = (XrSwapchain)(uintptr_t)1;
+        views[i].subImage.imageRect = (XrRect2Di){{0,64},{2704,2704}};
+    }
+    assert(fixed_layer_size((void *)&p, &full));
+    assert(full.width == 2768 && full.height == 2768);
+    assert(views[0].subImage.imageRect.extent.width == 2704); // never stretch a submitted subrect
+    views[1].subImage.swapchain = (XrSwapchain)(uintptr_t)2;
+    assert(!fixed_layer_size((void *)&p, &full));
+    views[1].subImage.swapchain = XR_NULL_HANDLE;
+    assert(!fixed_layer_size((void *)&p, &full));
+    p.viewCount=0; assert(!fixed_layer_size((void *)&p, &full));
+    assert(!fixed_layer_size(NULL, &full));
+    XrCompositionLayerQuad q = {XR_TYPE_COMPOSITION_LAYER_QUAD};
+    q.subImage.swapchain=(XrSwapchain)(uintptr_t)2;
+    assert(fixed_layer_size((void *)&q, &full) && full.width == 1024);
+    q.type=XR_TYPE_UNKNOWN; assert(!fixed_layer_size((void *)&q, &full));
+    return 0;
+}

tests/fixtures/src/fixed_resolution_wrapper_test.c

@@ -0,0 +1,45 @@
+#include <assert.h>
+#include <stdint.h>
+#include <stddef.h>
+#include <stdarg.h>
+#include <openxr/openxr.h>
+static int missing, valid_size=1, calls;
+static XrInstance active_instance;
+static XrResult XRAPI_CALL runtime(XrSession session, const XrRecommendedLayerResolutionGetInfoMETA *info,
+        XrRecommendedLayerResolutionMETA *out) {
+    (void)session; (void)info; ++calls;
+    out->recommendedImageDimensions=(XrExtent2Di){2704,2704};
+    out->isValid=XR_FALSE;
+    return XR_SUCCESS;
+}
+static PFN_xrVoidFunction lookup(XrInstance instance, const char *name) {
+    (void)instance; (void)name; return missing ? NULL : (PFN_xrVoidFunction)runtime;
+}
+static int swapchain_size(XrSwapchain handle, uint32_t *w, uint32_t *h) {
+    (void)handle; *w=2768; *h=2768; return valid_size;
+}
+static void log_stub(const char *fmt, ...) { (void)fmt; }
+#define LOG(...) log_stub(__VA_ARGS__)
+#include "fixed_resolution.h"
+/* WRAPPER */
+int main(void) {
+    XrCompositionLayerQuad layer={XR_TYPE_COMPOSITION_LAYER_QUAD};
+    XrRecommendedLayerResolutionGetInfoMETA info={XR_TYPE_RECOMMENDED_LAYER_RESOLUTION_GET_INFO_META};
+    info.layer=(void *)&layer;
+    XrRecommendedLayerResolutionMETA out={XR_TYPE_RECOMMENDED_LAYER_RESOLUTION_META};
+    int tail=42; out.next=&tail;
+    for (missing=0; missing<2; ++missing) {
+        assert(fixed_recommended_resolution(XR_NULL_HANDLE,&info,&out)==XR_SUCCESS);
+        assert(out.isValid==XR_TRUE && out.recommendedImageDimensions.width==2768);
+        assert(out.recommendedImageDimensions.height==2768 && out.next==&tail && tail==42);
+    }
+    assert(calls==1);
+    valid_size=0; missing=0;
+    assert(fixed_recommended_resolution(XR_NULL_HANDLE,&info,&out)==XR_SUCCESS);
+    assert(out.recommendedImageDimensions.width==2704 && !out.isValid);
+    missing=1;
+    assert(fixed_recommended_resolution(XR_NULL_HANDLE,&info,&out)==XR_ERROR_FUNCTION_UNSUPPORTED);
+    assert(fixed_recommended_resolution(XR_NULL_HANDLE,NULL,&out)==XR_ERROR_VALIDATION_FAILURE);
+    assert(fixed_recommended_resolution(XR_NULL_HANDLE,&info,NULL)==XR_ERROR_VALIDATION_FAILURE);
+    return 0;
+}

tests/fixtures/src/hide_fb_dispatcher_test.c

@@ -5,8 +5,15 @@
 #include <string.h>
 #include <openxr/openxr.h>
 static int enabled, requested;
+static XrResult XRAPI_CALL recommended(XrSession session, const XrRecommendedLayerResolutionGetInfoMETA *info,
+        XrRecommendedLayerResolutionMETA *out) {
+    (void)session; (void)info;
+    out->recommendedImageDimensions = (XrExtent2Di){2768,2768}; out->isValid = XR_TRUE;
+    return XR_SUCCESS;
+}
 static int query(void) { return enabled; }
 static PFN_xrVoidFunction extension(const char *name) {
+    if (enabled && !strcmp(name,"xrGetRecommendedLayerResolutionMETA")) return (PFN_xrVoidFunction)recommended;
     return !strcmp(name,"framebridge_hide_fb_foveation") ? (PFN_xrVoidFunction)query : NULL;
 }
 static XrResult XRAPI_CALL enumerate(const char *layer,uint32_t capacity,uint32_t *count,XrExtensionProperties *out) {
@@ -57,5 +64,13 @@ int main(void) {
         assert(((PFN_xrCreateInstance)fn)(&ci,NULL)==XR_SUCCESS);
         assert(requested==(enabled ? 1 : 2) && ci.enabledExtensionCount==2);
     }
+    enabled=0;
+    assert(xrGetInstanceProcAddr((XrInstance)(uintptr_t)1,"xrGetRecommendedLayerResolutionMETA",&fn)
+           == XR_ERROR_FUNCTION_UNSUPPORTED);
+    enabled=1;
+    assert(xrGetInstanceProcAddr((XrInstance)(uintptr_t)1,"xrGetRecommendedLayerResolutionMETA",&fn)==XR_SUCCESS);
+    XrRecommendedLayerResolutionMETA out={XR_TYPE_RECOMMENDED_LAYER_RESOLUTION_META};
+    assert(((PFN_xrGetRecommendedLayerResolutionMETA)fn)(XR_NULL_HANDLE,NULL,&out)==XR_SUCCESS);
+    assert(out.isValid && out.recommendedImageDimensions.width==2768);
     return 0;
 }

tests/test_a32_bridge.py

@@ -330,7 +330,7 @@ def test_which_patches_work_on_the_bridge():
 
     ok = {p.id for p in base.all_patches() if base.works_on_a32(p)}
     assert {p for p in ok if base.get(p).category in ("overport", "frame")} == {
-        "frame.a32_bridge", "frame.adapter", "frame.launcher", "frame.main_process"}  # manifest edits: any ABI
+        "frame.a32_bridge", "frame.adapter", "frame.launcher"}
     assert "adapter.scale" in ok and "device.text_input_window" in ok
     assert not {f"adapter.{k}" for k in XRSHIM_SETTINGS} & ok
     a = _analysis()

tests/test_fixed_resolution.py

@@ -0,0 +1,85 @@
+"""Full swapchain recommendations and opt-in OVRPlugin routing."""
+import os
+import shutil
+import subprocess
+from pathlib import Path
+
+import pytest
+from test_patches import _analysis
+from frameport.patches import base
+from frameport.patches.frame.adapter import needs_xrshim
+from frameport.patches.settings import adapter_settings, UI
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def test_setting_is_opt_in_and_routes_ovrplugin():
+    base.load_all()
+    patch = base.get("adapter.fixed_resolution")
+    assert patch.default == 0
+    assert patch.detect(_analysis()) is None
+    assert not adapter_settings({}).get("fixed_resolution")
+    assert needs_xrshim({patch.id: {"value": 1}})
+    assert not needs_xrshim({patch.id: {"value": 0}, "adapter.haptic_fix": {"value": 0}})
+    assert UI[patch.key]["group"] == "picture"
+    assert patch.applies(_analysis(xr="OpenXR", libs=[]))
+    assert patch.applies(_analysis(xr="VrApi", libs=["libOVRPlugin.so"]))
+    assert not patch.applies(_analysis(xr="VrApi", libs=[]))
+    assert not patch.applies(_analysis(abis=["armeabi-v7a"], xr="OpenXR"))
+
+
+@pytest.mark.native
+def test_layer_dimensions(tmp_path):
+    inc = next(iter((ROOT / "native/.cache").glob("openxr-*")), None)
+    cc = shutil.which("cc")
+    if not os.environ.get("FRAMEPORT_NATIVE_TESTS") or not inc or not cc:
+        pytest.skip("needs FRAMEPORT_NATIVE_TESTS=1, OpenXR headers and cc")
+    exe = tmp_path / "fixed-resolution"
+    subprocess.run([cc, "-std=c11", "-Wall", "-Wextra", "-Werror",
+                    "-Wno-missing-field-initializers", "-I", str(inc),
+                    "-I", str(ROOT / "native/adapter"),
+                    str(ROOT / "tests/fixtures/src/fixed_resolution_test.c"), "-o", str(exe)], check=True)
+    subprocess.run([str(exe)], check=True)
+
+
+def test_triage_only_offers_fix_for_offset_rects():
+    from frameport.validate.triage import triage
+    log = "projection view 0 rect change: swapchain=0x123 rect=0,32 2736x2736 array=0"
+    found = [f for f in triage(log).findings if f.id == "dynamic-resolution-foveation"]
+    assert found and found[0].suggest == ["adapter.fixed_resolution"] and found[0].question
+    assert not any(f.id == "dynamic-resolution-foveation" for f in
+                   triage(log.replace("rect=0,32", "rect=0,0")).findings)
+    assert not any(f.id == "dynamic-resolution-foveation" for f in
+                   triage(log + "\nfixed_resolution: recommended 2704x2704 -> 2768x2768").findings)
+
+
+def test_catalog_requires_app_with_the_fix(monkeypatch):
+    import frameport
+    import yaml
+    from frameport.recommend.catalog import unusable_reason
+    entry = yaml.safe_load((ROOT / "catalog/games/com.camouflaj.manta.yaml").read_text())
+    assert entry["adapter"]["fixed_resolution"] == 1
+    monkeypatch.setattr(frameport, "__version__", "1.2.1")
+    assert unusable_reason(entry) == "needs FramePort 1.2.2"
+    monkeypatch.setattr(frameport, "__version__", "1.2.2")
+    assert unusable_reason(entry) is None
+
+
+@pytest.mark.native
+def test_recommendation_wrapper(tmp_path):
+    inc = next(iter((ROOT / "native/.cache").glob("openxr-*")), None)
+    cc = shutil.which("cc")
+    if not os.environ.get("FRAMEPORT_NATIVE_TESTS") or not inc or not cc:
+        pytest.skip("needs FRAMEPORT_NATIVE_TESTS=1, OpenXR headers and cc")
+    # Compile the actual wrapper with a stand-in runtime and swapchain table.
+    source = (ROOT / "native/adapter/frame_adapter.c").read_text()
+    wrapper = source[source.index("static XRAPI_ATTR XrResult XRAPI_CALL fixed_recommended_resolution"):
+                     source.index("// Clamp `r` to a w x h image;")]
+    harness = (ROOT / "tests/fixtures/src/fixed_resolution_wrapper_test.c").read_text()
+    unit = tmp_path / "wrapper.c"
+    unit.write_text(harness.replace("/* WRAPPER */", wrapper))
+    exe = tmp_path / "wrapper"
+    subprocess.run([cc, "-std=c11", "-Wall", "-Wextra", "-Werror",
+                    "-Wno-missing-field-initializers", "-I", str(inc),
+                    "-I", str(ROOT / "native/adapter"), str(unit), "-o", str(exe)], check=True)
+    subprocess.run([str(exe)], check=True)

tests/test_gamepad_layout.py

@@ -1,51 +0,0 @@
-"""device.steam_gamepad's own button layout (GitHub #162: Steam Input's per-game remapping doesn't reach a 2D app):
-the patch's options become launcher env, the agent's Podman wrapper turns them into the app's key layout."""
-import pytest
-from test_steam_gamepad import ENV, NEEDS_POSIX, RUN, agent_module, frame_inputs
-
-from frameport.patches import base
-from frameport.patches.base import InstallContext
-
-
-def install_env(**params):
-    ctx = InstallContext(package="org.smarttube.stable", params=params, files={}, env={}, adapter_settings={})
-    base.get("device.steam_gamepad").install(ctx)
-    return ctx.env
-
-
-def test_options_become_launcher_env():
-    assert install_env() == {}
-    assert install_env(swap_sticks=True, swap_ab=True, keys=" key 304  DPAD_DOWN ;; key 305 BACK") == {
-        "FRAMEPORT_GAMEPAD_LAYOUT": "swap_sticks,swap_ab", "FRAMEPORT_GAMEPAD_KEYS": "key 304 DPAD_DOWN; key 305 BACK"}
-    with pytest.raises(ValueError):
-        install_env(keys="key 304 DPAD_DOWN; rm -rf /")
-
-
-def test_layout_options(monkeypatch, tmp_path):
-    agent = agent_module(monkeypatch, tmp_path)
-    assert agent.gamepad_kl() == (agent.GAMEPAD_KL, [])
-    text, skipped = agent.gamepad_kl("swap_sticks,swap_ab", "key 304 DPAD_DOWN; key 316 HOME; axis 0x10 HAT_X; nope")
-    lines = text.splitlines()
-    assert skipped == ["nope"]
-    assert "axis 0x00 Z flat 4096" in lines and "axis 0x03 X flat 4096" in lines  # right stick = main stick
-    assert "axis 0x01 RZ flat 4096" in lines and "axis 0x04 Y flat 4096" in lines
-    assert "key 305   BUTTON_A" in lines
-    assert "key 304 DPAD_DOWN" in lines and "key 304   BUTTON_B" not in lines  # own lines replace that key's line
-    assert "key 316 HOME" in lines and sum(ln.startswith("key 316") for ln in lines) == 1
-    assert len([ln for ln in lines if not ln.startswith("#")]) == len(agent.GAMEPAD_KL.splitlines()) - 1
-
-
-@NEEDS_POSIX
-def test_wrapper_mounts_the_games_own_layout(monkeypatch, tmp_path):
-    agent = agent_module(monkeypatch, tmp_path)
-    frame_inputs(tmp_path)
-    env = dict(ENV, FRAMEPORT_GAMEPAD_LAYOUT="swap_sticks", FRAMEPORT_GAMEPAD_KEYS="key 304 DPAD_DOWN")
-    out = agent.podman_run_args(RUN, env, str(tmp_path / "sys"), str(tmp_path / "dev"))
-    mount = next(a for a in out if "Vendor_28de_Product_11ff.kl" in a)
-    source = mount.split("source=")[1].split(",")[0]
-    assert source.endswith(".kl") and "steam-gamepad-" in source
-    text = open(source).read()
-    assert "key 304 DPAD_DOWN" in text and "axis 0x03 X flat 4096" in text
-    # the default layout keeps its shared file
-    out = agent.podman_run_args(RUN, ENV, str(tmp_path / "sys"), str(tmp_path / "dev"))
-    assert any("agent/steam-gamepad.kl," in a for a in out)

tests/test_main_process.py

@@ -1,74 +0,0 @@
-"""frame.main_process (GitHub #178): a game activity in its own process leaves no main process, which is the one
-Lepton watches; it closed Halo CE VR about a minute in ("Target app ... did not start")."""
-from conftest import build_axml
-
-from frameport.apk import axml
-from frameport.patches import base
-
-PKG = "com.halo.decomp.vr"
-
-
-def _activity(name, process=None, category=axml.LAUNCHER):
-    attrs = [("name", "str", name)] + ([("process", "str", process)] if process else [])
-    return [
-        ("start", "activity", attrs),
-        ("start", "intent-filter", []),
-        ("start", "action", [("name", "str", axml.MAIN)]), ("end", "action"),
-        ("start", "category", [("name", "str", category)]), ("end", "category"),
-        ("end", "intent-filter"),
-        ("end", "activity"),
-    ]
-
-
-def _halo_manifest():
-    """Halo CE VR's layout: the VR activity runs in ":halo_game", the 2D launcher starts it."""
-    return build_axml([
-        ("start", "manifest", [("package", "str", PKG)]),
-        ("start", "application", []),
-        *_activity("com.halo.decomp.HaloActivity", ":halo_game", axml.VR_CATEGORY),
-        *_activity("com.halo.decomp.LauncherActivity"),
-        ("start", "service", [("name", "str", "com.halo.decomp.Crash"), ("process", "str", ":crash")]),
-        ("end", "service"),
-        ("end", "application"),
-        ("end", "manifest"),
-    ])
-
-
-def _processes(manifest):
-    x = axml.Axml(manifest)
-    return {x.attr_str(e, "name"): x.attr_str(e, "process") for e in x.elements() if e.name in ("activity", "service")}
-
-
-def test_detects_and_moves_the_game_activity():
-    m = _halo_manifest()
-    assert axml.separate_process_activities(m) == ["com.halo.decomp.HaloActivity"]
-    fixed = axml.set_main_process(m, axml.separate_process_activities(m))
-    assert axml.separate_process_activities(fixed) == []
-    assert _processes(fixed) == {"com.halo.decomp.HaloActivity": PKG, "com.halo.decomp.LauncherActivity": None,
-                                 "com.halo.decomp.Crash": ":crash"}  # services keep their own process
-    assert len(fixed) == len(m)  # the package name is already in the pool: one value changes, nothing moves
-    assert axml.set_main_process(fixed, ["com.halo.decomp.HaloActivity"]) is None
-
-
-def test_main_process_activities_are_left_alone():
-    m = build_axml([
-        ("start", "manifest", [("package", "str", PKG)]),
-        ("start", "application", []),
-        *_activity("com.x.Game", PKG),  # explicitly the main process
-        *_activity("com.x.Other"),
-        ("end", "application"),
-        ("end", "manifest"),
-    ])
-    assert axml.separate_process_activities(m) == []
-    assert axml.set_main_process(m, ["com.x.Game"]) is None
-
-
-def test_patch_is_offered_only_when_detected():
-    patch = base.get("frame.main_process")
-    assert patch.default_on
-
-    class A:
-        extra = {"separate_process": ["com.halo.decomp.HaloActivity"]}
-    assert patch.applies(A()) and patch.detect(A()).recommended
-    A.extra = {}
-    assert not patch.applies(A()) and patch.detect(A()) is None

tests/test_triage.py

@@ -171,14 +171,6 @@ def test_tbxr_fdm_crash_is_identified_as_vr_teardown():
 def test_ovrplugin_extension_probe_is_not_a_scene_game():
     probe = LOG_OK + "09-28 17:39:02.200  1147  1174 I OVRPlugin: Unavailable OpenXR extension: XR_FB_scene\n"
     assert "scene-missing" not in {f.id for f in triage(probe, "RUNNING", "com.example.game").findings}
-    # extension listings (GitHub #404): OVRPlugin's enumeration, OVRPort's dispatcher, Unity's Meta XR feature
-    for listing in ("I OVRPlugin:  Name=XR_FB_scene SpecVersion=1", "I overportOXR: - XR_FB_scene 1",
-                    'I Unity   : Meta XR Feature: Extensions="XR_FB_passthrough XR_FB_scene XR_META_boundary"',
-                    "I overportOXR: - XR_FB_scene_capture 1"):
-        log = LOG_OK + f"09-28 17:39:02.200  1147  1174 {listing}\n"
-        assert "scene-missing" not in {f.id for f in triage(log, "RUNNING", "com.example.game").findings}, listing
-    wants = LOG_OK + "09-28 17:39:02.200  1147  1174 E Unity   : Required extension XR_FB_scene not available\n"
-    assert "scene-missing" in {f.id for f in triage(wants, "RUNNING", "com.example.game").findings}
     used = LOG_OK + "09-28 17:39:04.000  1147  1174 E Unity   : xrQuerySpacesFB failed: -12\n"
     assert "scene-missing" in {f.id for f in triage(used, "RUNNING", "com.example.game").findings}