FrameBridge profile_remap: leave Meta's detached-controller paths out (#328 )

Meta's Unity OpenXR features add Detached Touch/Touch Plus/Pro devices on /user/detached_controller_meta/left|right. Unity merges same-named actions of all devices, so the first such action (thumbstick) failed with XR_ERROR_PATH_UNSUPPORTED on the Frame (no XR_META_detached_controllers), Unity attached no action set and neither Unity nor OVRPlugin got controller input: hands on the floor (Spatial Zombies). Without the extension in the runtime, these paths are now left out of xrCreateAction subaction paths and suggested bindings, and xrGetCurrentInteractionProfile answers no profile for them. Headless: actions created, Touch bindings accepted, action spaces created, no ACTIONSET_NOT_ATTACHED.
FrameBridge profile_remap: report the game's own profile for remapped hands (#327 , #328 )
2026-10-16 20:01:52 +02:00 · 2026-10-15 23:55:29 -04:00 · 2026-10-15 20:32:52 -04:00
58 changed files with 506 additions and 2367 deletions
@@ -223,13 +223,6 @@ Rick and Morty runs on the Frame via its catalog recipe (OpenVR, no Revive),
    store matches and links then only update `auto_title`; a locked name gets no twin suffix); `sync_title` → Frame
    agent v77 `rename` (deployment.json title, same shortcut appid: upsert matches by Exe) + art + one Steam restart, PC
    `PcReviveTarget.rename`; an unreachable Frame → `steam_name_stale` (game page "Update name on Frame", next install).
-  - Newer versions (GitHub #161): game menu "Update with a newer APK…" (`pipeline.replace_apk`, outdated via
-    `build.source_version`) and, for Linux apps / PC VR games, "Update with a newer version…" (`replace_linux_app` /
-    `replace_rift_game` via `add_linux_app(replace=)` / `add_rift_game(replace=)`, CLI `frameport new-version`): the
-    entry keeps package, name, art, tags, switches, user recipe (a confirmed exe if the new folder has it); a new
-    `source_id` goes into the deployment's `recipe` dict at install (no agent change) → `C.source_replaced` = outdated
-    (Frame + `pc_outdated`); such an install re-sends same-size files changed after the last install (mtime/ctime,
-    `installer.changed_since`); the old Rift folder is in `replaced_dirs` (rescans skip it). Untested on the device.
  - `Recipe.as_is` = install unchanged (pre-patched libraries): `pipeline.prepare_as_is`; auto for APKs that already
    contain FrameBridge (`frame_patched`). For Rift it changes nothing (the dump is never modified; the Frame copy
    still gets launch fixes like the crash-reporter rename — `-nocrashreports` alone doesn't stop UE 4.23) — it does
@@ -274,15 +267,6 @@ Rick and Morty runs on the Frame via its catalog recipe (OpenVR, no Revive),
    `working-config.yml` issue → maintainer label `catalog-accepted` (a plain issue needs `working-config` added by
    hand) → `catalog-from-issue.yml` workflow (`scripts/catalog_from_issue.py` validates) opens a catalog PR. App log:
    `core/applog.py` (`<data>/logs/app.log`, finished GUI jobs in `<data>/logs/jobs/`).
-  - Announcements (2026-10-15, announcements/README.md; app only, the owner dropped the site pop-up): source of
-    truth `announcements/current.md` on `main` (front matter id/title/date + optional image/image_alt/button+url/
-    expires/active, Markdown body; ships `active: false`). `announcements.py` (no Flet; raw GitHub via
-    `cache.cached_text`, 6 h) + `ui/announcer.py` (pop-up 20 s after start / every 6 h when no dialog is open and not
-    on welcome; `C.dialog` with the portal edge, image downloaded + Pillow-checked into `<data>/announcements/`, shown
-    by asset URL). Shown only if the user was around before `date` (setting `announce.since`, set once at the GUI's
-    first start: 0 when `USED_BEFORE` settings exist, else now), once: any close (X, outside click, Escape, button)
-    stores the id (`announce.dismissed`, last 50). New announcement = new id; same id = typo fix.
-    `FRAMEPORT_NO_ANNOUNCEMENTS`; `ui_smoke.py --announcement` renders it.
  - Self-update (docs/ARCHITECTURE.md "Self-update", docs/INSTALL.md "Updating"): `_version.py` = the only version
    (`frameport.__version__`; pyproject reads it via hatch `dynamic`; app log, diagnostics, User-Agent, Settings use
    it — never `importlib.metadata`, bundles have no dist-info). `updates.py` (no Flet): `check()` = GitHub
@@ -920,13 +904,6 @@ hide_space_warp / vk_hide_fdm / no Valve layers; FNAF HW (#135) "freeze" = first
 on Zink (threads busy in zink/disk cache), not a hang; VR4 (#199) reporter's patch.203 OBB truncated. Upload benchmark
 (`scripts/upload_bench.py`, #242): home Wi-Fi caps every method at ~11 MB/s; paramiko uses ~3x OpenSSH's CPU; Windows
 OpenSSH refuses FramePort's key file (ACL "bad permissions") until its permissions are tightened.
-**OpenSSH uploads (2026-10-15, #324/#242):** sftp escapes `* ? [` inside double quotes itself (and undoes it for
-put's destination), so `native_upload.quote` escapes only `\\`/`"`; Win32 sftp turns every local backslash into `/`
-(escapes too) → local paths go as `C:/…`. Logins: `Frame.auth` = the attempt that worked (app_key / user_key = a key
-file from Settings → Installing → SSH keys, library `ssh.extra_keys`, CLI `frame ssh-keys` / agent / password).
-OpenSSH strict (FramePort + Settings keys, IdentitiesOnly) unless auth was "agent"; a refused strict login retries
-relaxed (+ private copies of ~/.ssh/id_{rsa,dsa,ecdsa,ed25519}: OpenSSH skips its defaults once any -i is given, + the
-agent); `-v` key lines go into the error. FramePort doesn't add its key to the Frame for this. Windows-tested.
 **Meta user id (GitHub #182, 2026-10-11):** OVRPort's platform loader (runtimes 3.4.3-23204ea and -aa54c3f) answers
 `ovr_GetLoggedInUserID` (and two other callers) without a Meta account with a made-up id from a helper (`stp; mov x29,
 sp; bl random; …; mov/movk x9 = 0x53444835ec580000 (6e18); add x0, x8, x9; ldp; ret`), kept only in memory → a new id
@@ -1,40 +0,0 @@
-# Announcements
-
-`current.md` is the one announcement FramePort shows as a pop-up in the app. Edit it on `main`: the app reads it
-from GitHub `main` (raw.githubusercontent.com) at most every 6 hours, so a push reaches everyone without a release.
-
-## Who sees it
-
- **Only people who already used FramePort before the announcement's `date`.** A new install never shows one, and
-  nor does an announcement published before FramePort was installed.
- **Once.** Closing it in any way (the X, a click outside it, Escape, or its button) dismisses it for good. The app
-  remembers dismissals in its settings (`announce.dismissed`).
- **A new announcement = a new `id`.** Fixing a typo with the same `id` doesn't show it again to anyone who closed it.
-  A new `id` shows to everyone who used FramePort before its `date`, whether they closed the earlier one or not.
-
-## The file
-
-```markdown
---
-active: true                    # false = nothing is shown (the fields are still checked)
-id: meetup-2026-11             # letters, digits, . _ -  — change it for every new announcement
-title: Steam Frame meetup on Discord  # required
-date: 2026-11-02T18:00:00Z      # required: when it was published (UTC; a bare date = midnight UTC)
-image: announcements/meetup.png # optional: a file in this folder, or an https URL (PNG, JPEG, WebP, GIF; ≤ 5 MiB)
-image_alt: The meetup poster    # optional: what the picture shows (screen readers)
-button: Join the meetup         # optional: an action button, with url
-url: https://example.com/meetup
-expires: 2026-11-30             # optional: not shown after this day (UTC, inclusive)
---
-The body, in Markdown: **bold**, *italic*, `code`, [links](https://frameport.app/), lists, headings.
-```
-
-The body is Markdown (no HTML). A `date` in the future works as a schedule: nobody sees it before then.
-
-Images look best at about 2:1 (e.g. 1200×600). The pop-up is 600 px wide and shows between 140 and 320 px of the
-picture's height.
-
-`pytest tests/test_announcements.py` checks this file, so a broken announcement fails CI instead of silently showing
-nothing.
-
-To turn announcements off for testing: `FRAMEPORT_NO_ANNOUNCEMENTS=1`.
@@ -1,16 +0,0 @@
---
-# The announcement FramePort shows once (announcements/README.md). Switched off: set active: true.
-active: false
-id: example-2026-10
-title: Example announcement
-date: 2026-10-15T12:00:00Z
-# image: announcements/example.png
-# image_alt: What the picture shows
-# button: Read more
-# url: https://frameport.app/changelog/
-# expires: 2026-11-30
---
-This is where the text goes, in **Markdown**: *emphasis*, `code`, [links](https://frameport.app/) and lists.
-
- Keep it short: one or two paragraphs.
- Change `id` for every new announcement.
@@ -13,11 +13,11 @@ e8c0965c188665a4e565e4a3af983ef1866d1cf9225665cc90d8df286bc96ef3  ./arm64-v8a/li
 5432674a59d02f411cd853a5dc57e3fa547d1ac518f25bf433fc54c43677177a  ./arm64-v8a/libfpglmv.so
 8a8f6b1da8952cb3933a5b53558424a5fc56043b2527a16bb6dd62a00d2de01a  ./arm64-v8a/libframe_xrshim.so
 19ba5ed3c4b780f5ae46251f6958f552acfc5f13c8bb39f995579593fa8990c6  ./arm64-v8a/libglshim.so
-0f058921e9c1f5b9ef5847cc9e6b80a23e75028c76c1d3bb02d1610b535f81c9  ./arm64-v8a/libopenxr_loader_generic.so
+1cc65695b223f7d56913275554c233f6b1d38a433068f26413fa97135f202a78  ./arm64-v8a/libopenxr_loader_generic.so
 1feaeafad467c4cafdf2b018a4d84b0bee200c3f711697b4ce97e66a3ba256ca  ./arm64-v8a/libovrplatformcompat.so
 a4ed80ae45ca90758239f152ea5a2e8c127d491e1e697ea5680db6fd7f72db07  ./arm64-v8a/libvrapi.so
 a4ed80ae45ca90758239f152ea5a2e8c127d491e1e697ea5680db6fd7f72db07  ./arm64-v8a/libvrapi_foveation.so
-9e8a7ce599b62a7c607b0d3637e4ec1b1ea1974c3373a7af3f5920ad2adc5e00  ./armeabi-v7a/libopenxr_loader_generic.so
+53a7d6340707766a7c7465f20084c520d259c76581f02a7e516a52cfeb624d51  ./armeabi-v7a/libopenxr_loader_generic.so
 1871eae093432d277da4bc751bf5f3269dfcf11f9168260b0c3caadb0dedb19d  ./dex/oculusos-stubs.dex
 b634ab5640e258563c536e658cad87080553df6f34f62269a21d554844e58bfe  ./hevc/COPYING.FFmpeg
 141de01f0d40b97d4f9a720db5ab8ea442f6aa35db5272048899292884994a1c  ./hevc/libstagefrighthw.so
@@ -1,20 +0,0 @@
-package: com.CreaTeam.Sclerosis
-title: Sclerosis
-status: works
-notes: Copy the "Amnesia The Dark Descent" folder from a Windows/Proton install to "FramePort/com.CreaTeam.Sclerosis/lepton-data/external".
-  Default hand positions are rather askew and should be amended via VR Controller Mappings in Steam itself. FOV
-  warping effects are EXTREMELY disorienting in VR, beware. Otherwise seems to work without issue.
-tested_version: 1.10.7
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
-device:
- device.text_input_window
-verified:
-  date: '2026-10-16'
-  known_good_sha256: e17421ad9894f5e57fb9b1b8110544715166756ef924b5a86831f6f20e70a6d5
-  app: 1.2.0
-  overport_cli: 1.2.5
-  issue: 339
-source_hint: Sclerosis_v1.10.7
@@ -1,24 +0,0 @@
-package: com.Curve.LawnMowingSimulatorVR
-title: Lawn Mowing Simulator VR
-status: issues
-notes: Left eye textures flicker only when mowing in specific areas.
-tested_version: 1.0.50
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-  pose_consistency: 1
-  hide_space_warp: 1
-verified:
-  date: '2026-10-16'
-  known_good_sha256: 2653e9b1dfbd11d607b5dd17b9c07ab19d9e98e1004ef9b14cb52867b5f959dc
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 91
-  issue: 344
-source_hint: com.Curve.LawnMowingSimulatorVR
@@ -1,22 +0,0 @@
-package: com.HypetrainDigitalLtd.Breathedge
-title: Breathedge VR
-status: works
-notes: Loading fade is broken and only shows a small square but the game works!
-tested_version: 1.0.7
-engine: Unreal
-xr: VrApi
-alt_overport:
- patch_remove_unreal_force_quit
-frame:
- frame.hw_video_decode
-adapter:
-  haptic_fix: 1
-verified:
-  date: '2026-10-16'
-  known_good_sha256: 4975a32fbf36b4d417142a944bf7d771c18a184dc0320b5937ac2c67bd013575
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 91
-  issue: 347
-source_hint: Breathadge
@@ -1,28 +0,0 @@
-package: com.Miragesoft.RealVrFishingQ
-title: Real VR Fishing
-status: issues
-notes: Seems to be almost 100% functional with meta permissions enabled.  In the new Mixed Reality mode, the room
-  scan doesn't seem to do anything and I can't seem to manually place anything either.
-tested_version: '3.06096'
-engine: Unity
-xr: OpenXR
-frame:
- frame.vivox_audio_route
- frame.unity_text_input
- frame.oculusos
- frame.meta_permissions
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-  scene_emul: 1
-  controller_models: 1
-verified:
-  date: '2026-10-16'
-  known_good_sha256: 8b17dd26ef0486618ec006f9d948a60dabea4d7763bbe6061db07ee8aad27c76
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 91
-  issue: 333
-source_hint: Real VR Fishing
@@ -1,22 +0,0 @@
-package: com.SchellGames.LostRecipes
-title: Lost Recipes
-status: works
-tested_version: 1.0.1+273175
-engine: Unreal
-xr: VrApi
-alt_overport:
- patch_remove_unreal_force_quit
-frame:
- frame.unreal_skip_obb_check
- frame.hw_video_decode
-adapter:
-  haptic_fix: 1
-verified:
-  date: '2026-10-16'
-  known_good_sha256: f071a1deea3e3b6dce0c3a923127f540a48b88532106536c1838f496e9d3e6c9
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 91
-  issue: 340
-source_hint: Lost Recipes
@@ -1,24 +1,22 @@
 package: com.UNIVRS.Freedom
-title: 'Attack on Titan VR: Unbreakable'
-status: works
-notes: Keep the extra files that come with the APK and OBB next to the OBB (they hold the audio). Cutscenes are
-  detached from the head but still viewable.
+title: Freedom
+status: issues
+notes: Volume can't be changed in the game.
 tested_version: 1.0.2950
 engine: Unity
 xr: OpenXR
 frame:
 - frame.unity_text_input
- frame.asset_files
 device:
 - device.text_input_window
 adapter:
  haptic_fix: 1
 verified:
-  date: '2026-10-16'
-  known_good_sha256: 1b3ced1a24b3b708f66aba6aa879863b667c0e502ef153d8a8cfa03e529d21fd
-  app: 1.2.0
+  date: '2026-10-10'
+  known_good_sha256: 24662272c4cbe5dc7c4f3c803bdb9dead9661ac3d59bf80cca2e260256acc4bc
+  app: 0.12.0
  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 91
-  issue: 337
-source_hint: Aot
+  frame_build: '20261007.6125817'
+  agent: 59
+  issue: 132
+source_hint: AOT VR
@@ -1,21 +0,0 @@
-package: com.crytek.climb
-title: The Climb
-status: works
-tested_version: '666.0'
-engine: CryEngine
-xr: VrApi
-frame:
- frame.vrapi_bridge
-device_files:
-  user.cfg: 'r_vr_foveated = 0
-
-    '
-verified:
-  date: '2026-10-16'
-  known_good_sha256: 3899967dd6d3ee0ce3409e94d543405c779e9c282ead29536abe93b3531ca285
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 91
-  issue: 341
-source_hint: TheClimb
@@ -1,22 +0,0 @@
-package: com.fasttravelgames.mascot
-title: 'Cities: VR'
-status: works
-notes: Loading screen Cities VR Logo doesn't load right.
-tested_version: 1.00.502
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
-device:
- device.text_input_window
-adapter:
-  haptic_fix: 1
-verified:
-  date: '2026-10-16'
-  known_good_sha256: 5537e4e9333a04eda8c1b2f96cdc9572c1bbed52a9d3af42269ba442ce9ba801
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 91
-  issue: 345
-source_hint: CitiesSkylines
@@ -1,22 +0,0 @@
-package: com.s3d.ExplodingKittensVR.TestRelease
-title: Exploding Kittens VR
-status: issues
-notes: Requires online for most modes. Practice lobby does work though.
-tested_version: 1.4.25779
-engine: Unreal
-xr: OpenXR
-alt_overport:
- patch_remove_unreal_force_quit
-frame:
- frame.hw_video_decode
-adapter:
-  haptic_fix: 1
-verified:
-  date: '2026-10-16'
-  known_good_sha256: 4b0a2348a5553851dcec820835e02c93a1a64927a30533d554943a9b81b3baa0
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 91
-  issue: 343
-source_hint: com.s3d.ExplodingKittensVR.TestRelease
@@ -1,24 +0,0 @@
-package: jp.co.hit_point.vneko
-title: Neko Atsume Purrfect
-status: works
-tested_version: 2.3.0
-engine: Unity
-xr: OpenXR
-frame:
- frame.unity_text_input
- frame.oculusos
-device:
- device.text_input_window
-adapter:
-  controller_models: 1
-  haptic_fix: 1
-  scene_emul: 1
-verified:
-  date: '2026-10-16'
-  known_good_sha256: da0196efa495d6ea7b34be2cea5b279acf23489134bb1dd1acef7cf54aa57da6
-  app: 1.2.0
-  overport_cli: 1.2.5
-  frame_build: '20261015.6141207'
-  agent: 91
-  issue: 338
-source_hint: jp.co.hit_point.vneko
@@ -1,18 +0,0 @@
-package: org.crisiszone.vr
-title: Crisis Zone VR
-status: works
-notes: Played the beginning of the first mission without issues.
-tested_version: 0.1.4
-engine: Other
-xr: OpenXR
-frame:
- frame.sdl_clipboard
-verified:
-  date: '2026-10-15'
-  known_good_sha256: 747d1e6613ae443ef03e509b509e4ec89039eec1aecf3689643db4057e53266a
-  app: 1.2.1.dev433
-  overport_cli: 1.2.5
-  frame_build: '20261007.6125817'
-  agent: 91
-  issue: 331
-source_hint: CrisisZoneVR-v0.1.4-quest3
@@ -1,9 +1,9 @@
 package: xyz.TheAviary.Vermillion
 title: Vermillion
-status: works
-notes: "The canvas used to hide the hand and brush while painting (the Frame draws the game's canvas layer in front
-  of everything); the recipe makes the game draw canvases in the scene instead (fix found by Klownicle, GitHub #200).
-  Confirmed in the headset by Klownicle."
+status: issues
+notes: Runs. The canvas used to hide the hand and brush while painting (the Frame draws the game's canvas layer in
+  front of everything); the recipe makes the game draw canvases in the scene instead (fix found by Klownicle, GitHub
+  #200). Not yet confirmed in the headset with this patch.
 tested_version: 1.7.2
 engine: Unity
 xr: OpenXR
@@ -16,10 +16,10 @@ adapter:
  haptic_fix: 1
  scene_emul: 1
 verified:
-  date: '2026-10-15'
+  date: '2026-10-11'
  app: 1.0.1
  frame_build: '20261007.6125817'
  agent: 79
  issue: 200
-updated: '2026-10-15'
+updated: '2026-10-12'
 source_hint: Vermillion - VR Painting
@@ -71,13 +71,6 @@ signatures:
    severity: fatal
    diagnosis: This app is a website, not a game, and it can't open on the Frame. It is a Trusted Web Activity that opens Meta's browser (com.oculus.browser), which the Frame doesn't have; open the website (TWALauncherActivity's "Using URL" line) in a browser instead.
    suggest: []
-  - id: gvr-not-supported
-    # GitHub #335 (Blade Runner: Revelations, Daydream, Unity 2017.4): Unity's "Google VR Error [Daydream]", the GVR
-    # library's Java side missing on the 32-bit bridge, or a bind to Daydream's VrCore service
-    pattern: 'Google VR Error \[(Daydream|Cardboard)\]|Google VR had a fatal issue while loading|class com/google/vr/sdk/base/CardboardViewNativeImpl not found|act=com\.google\.vr\.vrcore\.\S+ pkg=com\.google\.vr\.vrcore'
-    severity: fatal
-    diagnosis: This is a Google Daydream / Cardboard VR build (Google VR SDK), and its VR can't reach the Frame's headset. Daydream needs Google's VR services (VrCore) and Cardboard draws for a phone in a viewer; FramePort has no translation for either, so the game runs as a flat window at best, usually without working controls. An Oculus build of the same game (Meta Quest, Oculus Go or Gear VR) goes through FramePort's normal path.
-    suggest: []
  - id: unity-render-crash
    pattern: 'CRASH\s*:.*#\d+\s+pc [0-9a-f]+\s+\S*libgallium_dri\.so'
    severity: fatal
@@ -13,7 +13,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Arkio | Quest | ✅ Works |  |
 | Asgard's Wrath 2 | Quest | ✅ Works |  |
 | Assassin's Creed Nexus | Quest | ✅ Works |  |
-| Attack on Titan VR: Unbreakable | Quest | ✅ Works |  |
 | Audica | Quest | ✅ Works |  |
 | AugmentedEmpire | Quest | ✅ Works |  |
 | BAM | Quest | ✅ Works |  |
@@ -30,15 +29,12 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | BlazeRush | Quest | ✅ Works |  |
 | BodyCombat | Quest | ✅ Works |  |
 | BONELAB | Quest | ✅ Works |  |
-| Breathedge VR | Quest | ✅ Works |  |
 | Carve Snowboarding | Quest | ✅ Works |  |
 | Caves | Quest | ✅ Works |  |
-| Cities: VR | Quest | ✅ Works |  |
 | COMPOUND | Quest | ✅ Works |  |
 | Cook-Out | Quest | ✅ Works |  |
 | Cosmodread | Quest | ✅ Works |  |
 | Creed | Quest | ✅ Works |  |
-| Crisis Zone VR | Quest | ✅ Works |  |
 | cubism | Quest | ✅ Works |  |
 | Dance Central | Quest | ✅ Works |  |
 | Deep Cuts | Quest | ✅ Works |  |
@@ -76,7 +72,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Ladder | Quest | ✅ Works |  |
 | Lambda1VR | Quest | ✅ Works |  |
 | LEGO® Bricktales | Quest | ✅ Works |  |
-| Lost Recipes | Quest | ✅ Works |  |
 | Lucky's Tale | Quest | ✅ Works |  |
 | Maestro | Quest | ✅ Works |  |
 | Marvel's Deadpool VR | Quest | ✅ Works |  |
@@ -90,7 +85,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Moss: Book II | Quest | ✅ Works |  |
 | Munkr Funkr (The Legacy Days) | Quest | ✅ Works |  |
 | Nano | Quest | ✅ Works |  |
-| Neko Atsume Purrfect | Quest | ✅ Works |  |
 | NEX Player | Quest | ✅ Works |  |
 | NFL PRO ERA II | Quest | ✅ Works |  |
 | NOPE CHALLENGE | Quest | ✅ Works |  |
@@ -113,7 +107,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Riven | Quest | ✅ Works |  |
 | Robo Recall | Quest | ✅ Works |  |
 | RUINSMAGUS | Quest | ✅ Works |  |
-| Sclerosis | Quest | ✅ Works |  |
 | Shadow Point | Quest | ✅ Works |  |
 | Shoot The Zombirds VR | Quest | ✅ Works |  |
 | Shores of Loci | Quest | ✅ Works |  |
@@ -134,7 +127,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Tea For God | Quest | ✅ Works |  |
 | TetrisEffect | Quest | ✅ Works |  |
 | The Boys VR | Quest | ✅ Works |  |
-| The Climb | Quest | ✅ Works |  |
 | The Climb 2 | Quest | ✅ Works |  |
 | The Last Clockwinder | Quest | ✅ Works |  |
 | The Room VR | Quest | ✅ Works |  |
@@ -151,7 +143,6 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Vader Immortal: Episode III | Quest | ✅ Works |  |
 | Vampire Survivors | Quest | ✅ Works |  |
 | Vendetta Forever | Quest | ✅ Works |  |
-| Vermillion | Quest | ✅ Works |  |
 | VR HOT Quest | Quest | ✅ Works |  |
 | VR4 | Quest | ✅ Works |  |
 | Walkabout Mini Golf | Quest | ✅ Works |  |
@@ -165,11 +156,10 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Does it Stack? | Quest | ⚠️ Works with issues | Mixed reality mode does not work (works on Demeo), everything else seems to be OK |
 | Dungeons of Eternity | Quest | ⚠️ Works with issues | It can not connect to servers |
 | End Space | Quest | ⚠️ Works with issues | Controls stop responding after the first mission loads. |
-| Exploding Kittens VR | Quest | ⚠️ Works with issues | Requires online for most modes. |
 | ExploreVR | Quest | ⚠️ Works with issues | The 3D world warps and shifts with head movement (wrong perspective). |
 | Fisherman | Quest | ⚠️ Works with issues | Loading screens have corruption, but everything works otherwise. |
+| Freedom | Quest | ⚠️ Works with issues | Volume can't be changed in the game. |
 | Homeworld: Vast Reaches | Quest | ⚠️ Works with issues | The game starts but after selecting to start a new game it seems to crash. |
-| Lawn Mowing Simulator VR | Quest | ⚠️ Works with issues | Left eye textures flicker only when mowing in specific areas. |
 | MacacoVR | Quest | ⚠️ Works with issues | 2d loading screens are glitchy, otherwise main gameplay is fine |
 | Majora's Mask VR | Quest | ⚠️ Works with issues | Audio on the file select screen sounds crunchy. |
 | Myst | Quest | ⚠️ Works with issues | Minor graphical glitches on some objects. |
@@ -178,13 +168,13 @@ Generated from [catalog/games](../catalog/games) by `scripts/compat_list.py`.
 | Plezy | Quest | ⚠️ Works with issues | Some videos play with strong artifacts and wrong colours; the cause is unknown, possibly hardware video decoding. |
 | Quantum Void | Quest | ⚠️ Works with issues | no hands |
 | Ragnarock | Quest | ⚠️ Works with issues |  |
-| Real VR Fishing | Quest | ⚠️ Works with issues | Seems to be almost 100% functional with meta permissions enabled. |
 | Silhouette | Quest | ⚠️ Works with issues | Hand-tracking game; the Frame synthesizes hands from controllers, so it is janky. |
 | Spunky Dungeon | Quest | ⚠️ Works with issues | Gear VR / Oculus Go game (32-bit only), runs through FramePort's 32-bit bridge (experimental). |
 | Swarm 2 | Quest | ⚠️ Works with issues | MSAA creates visible seams around edge geometry and also the skybox edge |
 | The Light Brigade | Quest | ⚠️ Works with issues | Judder in weapons |
 | The Thrill Of The Fight | Quest | ⚠️ Works with issues | Right eye doesn't draw the opponent or the referee. |
 | Time Stall | Quest | ⚠️ Works with issues | Both eyes distort during movement (unresolved). |
+| Vermillion | Quest | ⚠️ Works with issues | Runs. |
 | WiiCompiled VR | Quest | ⚠️ Works with issues | To add a game: in FramePort's Files tab, upload your .wcgame file to this game's storage, folder Android/data/org.wiicompiled.quest/files/WiiCompiledOpenXRVR… |
 | Deadly Delivery | Quest | ❌ Doesn't run | Quits after Meta's entitlement check fails: it needs Meta's online services. |
 | Espire 1: VR Operative (Quest Edition) | Quest | ❌ Doesn't run | Mesa GL driver crash during texture upload. |
@@ -167,10 +167,6 @@ FramePort downloads it, checks it, restarts and keeps your games and settings. *
 - Settings → **Updates** turns the check off or turns on **Install updates automatically**.
 - **Recipes** (the tested patches and settings for each game) update by themselves. A game whose recipe changed shows
  **Update on Frame**.
- **A newer version of a game:** right-click it (or use **…** on its page) → **Update with a newer APK…** (Quest and
-  Android games) or **Update with a newer version…** (Linux apps: the new AppImage, archive or folder; PC VR games:
-  the new game folder). Its name, artwork, tags and your settings stay. Then click **Update on Frame** (or **on this
-  PC**).
 - **Dev builds:** if you're asked to test a change before its release, use Settings → Updates → **Install the latest
  dev build…**. The next release then arrives as a normal update.

@@ -259,7 +255,6 @@ option. The main ones:
 |---|---|
 | `scan <folder>` / `list` / `show <game>` | add games, list the library, show a game's patches |
 | `add-linux <path> [--exe <program>]` | add a Linux app (AppImage, folder or archive) |
-| `new-version <game> <path>` | point a game at its newer version (APK, Linux app file/folder, PC VR game folder) |
 | `recipe <game> --enable/--disable <patch>` | change a game's patches (`patches` lists them all) |
 | `build <game>` / `install <game>` / `test <game>` | build, install on the Frame (`--to pc` for this PC), launch test |
 | `frame discover` / `frame connect` / `frame info` | find, connect to and describe the Frame |
@@ -39,7 +39,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Patch Oculus detection for Unity](#patch_oculus_unity) | `patch_oculus_unity` | Patches from OVRPort | default |
 | [Patch Oculus detection for Unreal](#patch_oculus_unreal) | `patch_oculus_unreal` | Patches from OVRPort | default |
 | [Remove localized app names](#patch_remove_localized_names) | `patch_remove_localized_names` | Patches from OVRPort | default |
-| [Remove Unreal's ForceQuit](#patch_remove_unreal_force_quit) | `patch_remove_unreal_force_quit` | Patches from OVRPort | 41 |
+| [Remove Unreal's ForceQuit](#patch_remove_unreal_force_quit) | `patch_remove_unreal_force_quit` | Patches from OVRPort | 38 |
 | [Remove uses-library](#patch_remove_uses_library) | `patch_remove_uses_library` | Patches from OVRPort | default |
 | [Remove VrApi library](#patch_remove_vrapi) | `patch_remove_vrapi` | Patches from OVRPort |  |
 | [Replace application label and icon](#patch_replace_icon_label) | `patch_replace_icon_label` | Patches from OVRPort | default |
@@ -47,7 +47,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [VrApi → OpenXR adapter (OVRPort)](#patch_vrapi_openxr) | `patch_vrapi_openxr` | Patches from OVRPort |  |
 | [32-bit ARM bridge (Gear VR / Go games)](#frame-a32_bridge) | `frame.a32_bridge` | Steam Frame patches | 6 |
 | [FrameBridge OpenXR adapter](#frame-adapter) | `frame.adapter` | Steam Frame patches | default |
-| [Content files from the game's data](#frame-asset_files) | `frame.asset_files` | Steam Frame patches | 2 |
+| [Content files from the game's data](#frame-asset_files) | `frame.asset_files` | Steam Frame patches | 1 |
 | [Asset-file service bypass](#frame-asset_files_stub) | `frame.asset_files_stub` | Steam Frame patches |  |
 | [Skip Meta avatars](#frame-avatar_stub) | `frame.avatar_stub` | Steam Frame patches | 1 |
 | [bHaptics: skip the Bluetooth permission request](#frame-bhaptics_permission) | `frame.bhaptics_permission` | Steam Frame patches | 5 |
@@ -56,22 +56,22 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [OpenGL ES: multiview shaders on flat panels (HUD, menus)](#frame-gl_multiview_fbo) | `frame.gl_multiview_fbo` | Steam Frame patches | 1 |
 | [GL shim (Mesa GLSL compatibility)](#frame-gl_shim) | `frame.gl_shim` | Steam Frame patches | 2 |
 | [Godot apps: start without a clipboard service](#frame-godot_clipboard) | `frame.godot_clipboard` | Steam Frame patches |  |
-| [Hardware video decoding (H.264, HEVC, VP9)](#frame-hw_video_decode) | `frame.hw_video_decode` | Steam Frame patches | 22 |
+| [Hardware video decoding (H.264, HEVC, VP9)](#frame-hw_video_decode) | `frame.hw_video_decode` | Steam Frame patches | 19 |
 | [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 |  |
-| [Declare Meta-only permissions](#frame-meta_permissions) | `frame.meta_permissions` | Steam Frame patches | 3 |
+| [Declare Meta-only permissions](#frame-meta_permissions) | `frame.meta_permissions` | Steam Frame patches | 2 |
 | [Meta XR Audio: skip Quest telemetry class](#frame-metaxr_telemetry) | `frame.metaxr_telemetry` | Steam Frame patches | default |
 | [Clear android:debuggable](#frame-nodebug) | `frame.nodebug` | Steam Frame patches | 3 |
-| [Oculus OS telemetry class stubs](#frame-oculusos) | `frame.oculusos` | Steam Frame patches | 17 |
+| [Oculus OS telemetry class stubs](#frame-oculusos) | `frame.oculusos` | Steam Frame patches | 15 |
 | [Fix crash when the game prepares the microphone](#frame-ovr_microphone) | `frame.ovr_microphone` | Steam Frame patches |  |
 | [Keep the same Meta user between starts](#frame-ovr_stable_user) | `frame.ovr_stable_user` | Steam Frame patches | default |
 | [Trace Meta platform requests (diagnostics)](#frame-ovr_trace) | `frame.ovr_trace` | Steam Frame patches |  |
 | [Platform compat (ovrMessageType_ToString)](#frame-ovrplatformcompat) | `frame.ovrplatformcompat` | Steam Frame patches | default |
 | [Stub missing Meta platform functions](#frame-ovrstubs) | `frame.ovrstubs` | Steam Frame patches | default |
 | [Unpaired pointer-authentication checks](#frame-pac_hints) | `frame.pac_hints` | Steam Frame patches | 1 |
-| [SDL apps: start without a clipboard service](#frame-sdl_clipboard) | `frame.sdl_clipboard` | Steam Frame patches | 5 |
+| [SDL apps: start without a clipboard service](#frame-sdl_clipboard) | `frame.sdl_clipboard` | Steam Frame patches | 4 |
 | [Stress Level Zero: let Unity start Vulkan itself](#frame-slz_vulkan_hooks) | `frame.slz_vulkan_hooks` | Steam Frame patches | 1 |
 | [Start straight in VR (skip the 2D launcher)](#frame-start_activity) | `frame.start_activity` | Steam Frame patches |  |
 | [Allow swapchains larger than 4096 px](#frame-swapchain_limit) | `frame.swapchain_limit` | Steam Frame patches | default |
@@ -82,7 +82,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [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 | 12 |
 | [Unity: keep MSAA off at runtime (OVRManager)](#frame-unity_runtime_msaa_off) | `frame.unity_runtime_msaa_off` | Steam Frame patches | 28 |
-| [Make Unity text fields work](#frame-unity_text_input) | `frame.unity_text_input` | Steam Frame patches | 107 |
+| [Make Unity text fields work](#frame-unity_text_input) | `frame.unity_text_input` | Steam Frame patches | 102 |
 | [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 |
@@ -90,21 +90,21 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Unreal: stand-ins for OVRPlugin functions OVRPort lacks](#frame-unreal_ovrp_entrypoints) | `frame.unreal_ovrp_entrypoints` | Steam Frame patches | 2 |
 | [Unreal: Quest controller bindings (RPOC key map)](#frame-unreal_quest_keymap) | `frame.unreal_quest_keymap` | Steam Frame patches | 3 |
 | [Unreal: don't wait for the Quest shader precompile](#frame-unreal_quest_precompile) | `frame.unreal_quest_precompile` | Steam Frame patches | 3 |
-| [Unreal: start without the OBB check](#frame-unreal_skip_obb_check) | `frame.unreal_skip_obb_check` | Steam Frame patches | 6 |
+| [Unreal: start without the OBB check](#frame-unreal_skip_obb_check) | `frame.unreal_skip_obb_check` | Steam Frame patches | 5 |
 | [Unreal: skip the OBB delivery check](#frame-unreal_skip_obb_delivery) | `frame.unreal_skip_obb_delivery` | Steam Frame patches | 1 |
 | [Unreal: bypass the stalled loading splash](#frame-unreal_splash_bypass) | `frame.unreal_splash_bypass` | Steam Frame patches | 1 |
 | [Unreal: thumb follows the capacitive touches](#frame-unreal_thumb_touch) | `frame.unreal_thumb_touch` | Steam Frame patches | 7 |
 | [Vermillion: paint canvases in the scene](#frame-vermillion_scene_canvas) | `frame.vermillion_scene_canvas` | Steam Frame patches | 1 |
-| [Vivox voice chat: skip Android 12 audio routing](#frame-vivox_audio_route) | `frame.vivox_audio_route` | Steam Frame patches | 2 |
+| [Vivox voice chat: skip Android 12 audio routing](#frame-vivox_audio_route) | `frame.vivox_audio_route` | Steam Frame patches | 1 |
 | [Vulkan: drop invalid render-pass pointers](#frame-vk_sanitize) | `frame.vk_sanitize` | Steam Frame patches | default · 1 |
-| [VrApi → OpenXR bridge](#frame-vrapi_bridge) | `frame.vrapi_bridge` | Steam Frame patches | 4 |
+| [VrApi → OpenXR bridge](#frame-vrapi_bridge) | `frame.vrapi_bridge` | Steam Frame patches | 3 |
 | [Quiet Meta's VrApi loader (OpenXR games)](#frame-vrapi_stub) | `frame.vrapi_stub` | Steam Frame patches | 2 |
 | [OpenGL ES: shader fixes (Vulkan layer under Zink)](#frame-zink_shader_fix) | `frame.zink_shader_fix` | Steam Frame patches | 1 |
 | [Pointer start](#adapter-aim_forward) | `adapter.aim_forward` | Game settings |  |
 | [Pointer angle](#adapter-aim_pitch) | `adapter.aim_pitch` | Game settings |  |
 | [Pointer turn](#adapter-aim_yaw) | `adapter.aim_yaw` | Game settings |  |
 | [Use controllers](#adapter-controller_fix) | `adapter.controller_fix` | Game settings | 1 |
-| [Show Steam Frame controllers](#adapter-controller_models) | `adapter.controller_models` | Game settings | 6 |
+| [Show Steam Frame controllers](#adapter-controller_models) | `adapter.controller_models` | Game settings | 4 |
 | [Stand in for cube layers](#adapter-cube_standin) | `adapter.cube_standin` | Game settings |  |
 | [Show curved menus and screens](#adapter-cylinder_strips) | `adapter.cylinder_strips` | Game settings |  |
 | [Show 360° backgrounds and videos](#adapter-equirect_emul) | `adapter.equirect_emul` | Game settings | 5 |
@@ -127,9 +127,9 @@ 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 | 88 |
+| [Fix freezes when controllers vibrate](#adapter-haptic_fix) | `adapter.haptic_fix` | Game settings | 81 |
 | [Vibration strength](#adapter-haptic_scale) | `adapter.haptic_scale` | Game settings |  |
-| [Turn off space warp](#adapter-hide_space_warp) | `adapter.hide_space_warp` | Game settings | 5 |
+| [Turn off space warp](#adapter-hide_space_warp) | `adapter.hide_space_warp` | Game settings | 4 |
 | [Controller input diagnostics (log)](#adapter-input_diag) | `adapter.input_diag` | Game settings |  |
 | [Extra diagnostics (log)](#adapter-layer_debug) | `adapter.layer_debug` | Game settings |  |
 | [Drop broken layers](#adapter-layer_fix) | `adapter.layer_fix` | Game settings |  |
@@ -137,7 +137,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Unity frame loop: wait for skipped frames](#adapter-ovrp_begin_gate) | `adapter.ovrp_begin_gate` | Game settings | 1 |
 | [Steadier hands (older Unity)](#adapter-ovrp_hold_physics) | `adapter.ovrp_hold_physics` | Game settings | 1 |
 | [See your room](#adapter-passthrough_emul) | `adapter.passthrough_emul` | Game settings |  |
-| [Steadier head tracking](#adapter-pose_consistency) | `adapter.pose_consistency` | Game settings | 2 |
+| [Steadier head tracking](#adapter-pose_consistency) | `adapter.pose_consistency` | Game settings | 1 |
 | [Pose timing diagnostics (log)](#adapter-pose_debug) | `adapter.pose_debug` | Game settings |  |
 | [Fix hands lagging behind controllers](#adapter-pose_time_fix) | `adapter.pose_time_fix` | Game settings | 14 |
 | [Treat newer Quest controllers as Touch](#adapter-profile_remap) | `adapter.profile_remap` | Game settings |  |
@@ -148,7 +148,7 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [Re-create play space](#adapter-respace_kick) | `adapter.respace_kick` | Game settings |  |
 | [Sharpness](#adapter-scale) | `adapter.scale` | Game settings | 4 |
 | [Room depth](#adapter-scene_depth) | `adapter.scene_depth` | Game settings |  |
-| [Pretend room layout](#adapter-scene_emul) | `adapter.scene_emul` | Game settings | 11 |
+| [Pretend room layout](#adapter-scene_emul) | `adapter.scene_emul` | Game settings | 9 |
 | [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 |  |
@@ -170,12 +170,12 @@ Link to an entry with its id, dots replaced by dashes: `PATCHES.md#frame-unity_t
 | [OpenGL ES shader fixes](#adapter-zink_shader_fix) | `adapter.zink_shader_fix` | Game settings | 1 |
 | [Keep the game's saved resolution in step](#device-config_sync) | `device.config_sync` | Files and settings on the Frame | 1 |
 | [Show as VR or as a flat window](#device-display_mode) | `device.display_mode` | Files and settings on the Frame |  |
-| [Settings files for the game](#device-files) | `device.files` | Files and settings on the Frame | 3 |
+| [Settings files for the game](#device-files) | `device.files` | Files and settings on the Frame | 2 |
 | [Foveated rendering (Valve)](#device-foveation) | `device.foveation` | Files and settings on the Frame | 3 |
 | [Hide Android's navigation bar](#device-hide_navbar) | `device.hide_navbar` | Files and settings on the Frame |  |
 | [Extra Lepton settings](#device-lepton_env) | `device.lepton_env` | Files and settings on the Frame | 3 |
 | [Controllers as a gamepad (Steam Input)](#device-steam_gamepad) | `device.steam_gamepad` | Files and settings on the Frame |  |
-| [Show the app's Android window (for typing)](#device-text_input_window) | `device.text_input_window` | Files and settings on the Frame | 110 |
+| [Show the app's Android window (for typing)](#device-text_input_window) | `device.text_input_window` | Files and settings on the Frame | 105 |
 | [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) |  |
@@ -420,7 +420,7 @@ Stops some Unreal games from closing themselves right after starting.
 - `patch_remove_unreal_force_quit`
 - **Changes:** Changes the APK (during the OVRPort conversion).
 - **Offered (off):** Built as the alternate APK for Unreal games (use it if the game quits itself).
- **Catalog games (41):** Asgard's Wrath 2, BARTENDER VR SIMULATOR, Breathedge VR, Carve Snowboarding, Creed, Dance Central, Espire 1: VR Operative (Quest Edition), Espire 2 and 33 more.
+- **Catalog games (38):** Asgard's Wrath 2, BARTENDER VR SIMULATOR, Carve Snowboarding, Creed, Dance Central, Espire 1: VR Operative (Quest Edition), Espire 2, ExploreVR and 30 more.
 - **Suggested by launch-test signatures:**
  - `force-quit` (error): The game quit itself right after starting.
 - **Source:** [patches/overport.py](../src/frameport/patches/overport.py)
@@ -526,7 +526,7 @@ Lets the game find extra content it keeps next to its data (for example Star War
 - `frame.asset_files`
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** The game asks Meta's platform for asset files and its data has … content file(s) (*.pak) that OVRPort's loader doesn't report.
- **Catalog games (2):** Attack on Titan VR: Unbreakable, Star Wars: Tales from the Galaxy's Edge.
+- **Catalog games (1):** Star Wars: Tales from the Galaxy's Edge.
 - **Source:** [patches/frame/langpack.py](../src/frameport/patches/frame/langpack.py)

 > Some games keep content in separate files next to their OBB (for example Star Wars: Tales from the Galaxy's Edge: its seasons and sound banks) and ask Meta's platform for them as asset files. OVRPort's platform loader doesn't know them, so the game waits for content that never arrives (black screen after loading). Lists the content files shipped with the game's data (*.pak) as installed and answers their download request at once with the file's path; nothing is copied or downloaded. Shares the language-pack library.
@@ -645,7 +645,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 (22):** 4XVR Video Player, AugmentedEmpire, Batman: Arkham Shadow, Battlemarked, Breathedge VR, Dance Central, Exploding Kittens VR, Eye of the Temple and 14 more.
+- **Catalog games (19):** 4XVR Video Player, AugmentedEmpire, Batman: Arkham Shadow, Battlemarked, Dance Central, Eye of the Temple, Fruit Ninja, Ghost Town and 11 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.
@@ -706,7 +706,7 @@ Declares Meta's permissions some mixed-reality games ask for, so they don't stop
 - `frame.meta_permissions`
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Mixed-reality game that needs the room model: its 'use spatial data' permission must be granted (for example Demeter).
- **Catalog games (3):** Arkio, Demeter, Real VR Fishing.
+- **Catalog games (2):** Arkio, Demeter.
 - **Source:** [patches/frame/manifest_fixes.py](../src/frameport/patches/frame/manifest_fixes.py)

 > Declares com.oculus.permission.* / horizonos.permission.* that the app uses, so Android grants them at install (for example the 'use spatial data' permission of mixed-reality games like Demeter).
@@ -749,7 +749,7 @@ Provides stand-ins for Quest system calls some games make at start.
 - **Suggested (on):** The Unreal build of Meta XR Audio looks up com.oculus.os.AnalyticsEvent and aborts without it (for example NOPE Challenge).
 - **Suggested (on):** Several Meta SDK libraries look up com.oculus.os.AnalyticsEvent (…); games like this abort without the stub (for example Nano).
 - **Offered (off):** … references com.oculus.os.AnalyticsEvent; usually harmless (for example Batman: Arkham Shadow and LEGO Bricktales run without it). Enable if the game aborts with ClassNotFoundException.
- **Catalog games (17):** AgeOfJoy, AllInOneSports, Caves, Deep Cuts, Does it Stack?, Nano, Neko Atsume Purrfect, NOPE CHALLENGE and 9 more.
+- **Catalog games (15):** AgeOfJoy, AllInOneSports, Caves, Deep Cuts, Does it Stack?, Nano, NOPE CHALLENGE, RC Pilot Trainer and 7 more.
 - **Suggested by launch-test signatures:**
  - `oculus-os-class` (fatal): The game looks up a Quest-only system class and aborts.
 - **Source:** [patches/frame/telemetry.py](../src/frameport/patches/frame/telemetry.py)
@@ -838,7 +838,7 @@ Lets SDL and LÖVE games start on the Frame (they'd crash looking for a clipboar
 - `frame.sdl_clipboard` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** SDL app: it crashes at start in Lepton, which has no clipboard service.
- **Catalog games (5):** Crisis Zone VR, Majora's Mask VR, Time Crisis II VR (Test), Time Crisis VR (Experimental), WiiCompiled VR.
+- **Catalog games (4):** Majora's Mask VR, Time Crisis II VR (Test), Time Crisis VR (Experimental), WiiCompiled VR.
 - **Suggested by launch-test signatures:**
  - `sdl-no-clipboard` (fatal): The app crashed at start because the Frame's Android has no clipboard.
 - **Source:** [patches/frame/sdl_clipboard.py](../src/frameport/patches/frame/sdl_clipboard.py)
@@ -989,7 +989,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 (107):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable, Audica and 99 more.
+- **Catalog games (102):** AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Audica, AugmentedEmpire and 94 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.
@@ -1092,7 +1092,7 @@ Starts Unreal games without re-checking their data file (they'd seem to hang on
 - `frame.unreal_skip_obb_check` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Unreal checks the OBB's contents before starting (bVerifyOBBOnStartUp); on the Frame a failed or slow check can't be seen and the game seems to hang.
- **Catalog games (6):** Dance Central, Kill It With Fire VR, Lost Recipes, MacacoVR, Maestro, Ragnarock.
+- **Catalog games (5):** Dance Central, Kill It With Fire VR, MacacoVR, Maestro, Ragnarock.
 - **Suggested by launch-test signatures:**
  - `unreal-obb-check-stuck` (fatal): The game stays on Unreal's OBB check screen (DownloaderActivity), which the Frame doesn't show, and never starts VR (for example Contractors, GitHub #159).
 - **Source:** [patches/frame/unreal_obb_check.py](../src/frameport/patches/frame/unreal_obb_check.py)
@@ -1158,7 +1158,7 @@ Lets games with Vivox voice chat start on the Frame (they'd crash on an Android
 - `frame.vivox_audio_route` · also for 2D apps
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** Vivox voice chat: it calls Android 12 audio methods, which Lepton (Android 11) lacks, and crashes.
- **Catalog games (2):** Dungeons of Eternity, Real VR Fishing.
+- **Catalog games (1):** Dungeons of Eternity.
 - **Suggested by launch-test signatures:**
  - `vivox-api31` (fatal): The game's Vivox voice-chat SDK calls Android 12 audio-routing methods (AudioManager communication devices) without checking the Android version; Lepton runs Android 11, so the app crashes (for example Green Hell VR).
 - **Source:** [patches/frame/vivox_audio_route.py](../src/frameport/patches/frame/vivox_audio_route.py)
@@ -1189,7 +1189,7 @@ Lets games built on Meta's oldest VR interface run on the Frame.
 - **Changes:** Changes the APK (a rebuild and reinstall apply it).
 - **Suggested (on):** The engine calls libvrapi.so directly; OVRPort can't translate it.
 - **Conflicts with:** [`frame.vrapi_stub`](#frame-vrapi_stub)
- **Catalog games (4):** BlazeRush, Path of the Warrior, The Climb, The Climb 2.
+- **Catalog games (3):** BlazeRush, Path of the Warrior, The Climb 2.
 - **Suggested by launch-test signatures:**
  - `direct-vrapi` (warning): The game uses Meta's VrApi directly and needs the VrApi bridge.
  - `vrapi-frame-rejected` (fatal): The VrApi bridge rejected the game's frame options, so no picture reaches the headset even though frame pacing can appear in the log.
@@ -1295,7 +1295,7 @@ For games that show the headset's own controllers. Takes effect after a reinstal
 - **Options:**
  - Value: int, default `0`.
  - Game settings → Controllers → "Show Steam Frame controllers".
- **Catalog games (6):** Neko Atsume Purrfect, Ocean Rift, Real VR Fishing, SynthRiders, VR HOT Quest, Walkabout Mini Golf.
+- **Catalog games (4):** Ocean Rift, SynthRiders, VR HOT Quest, Walkabout Mini Golf.
 - **Suggested by launch-test signatures:**
  - `render-model-requested` (info): The game shows Quest controllers (or none) because the Frame doesn't provide controller models.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
@@ -1633,7 +1633,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 (88):** AgeOfJoy, Ancient_Dungeon, Attack on Titan VR: Unbreakable, Audica, AugmentedEmpire, Battlemarked, BattleSisters, Beat Saber and 80 more.
+- **Catalog games (81):** AgeOfJoy, Ancient_Dungeon, Audica, AugmentedEmpire, Battlemarked, BattleSisters, Beat Saber, Caves and 73 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.
@@ -1662,7 +1662,7 @@ For games whose picture flickers or smears (for example Into The Radius 2).
 - **Options:**
  - Value: int, default `0`.
  - Game settings → Troubleshooting → "Turn off space warp" (advanced).
- **Catalog games (5):** Into The Radius 2, Lawn Mowing Simulator VR, Metro Awakening, Pinball FX VR, The Boys VR.
+- **Catalog games (4):** Into The Radius 2, Metro Awakening, Pinball FX VR, The Boys VR.
 - **Suggested by launch-test signatures:**
  - `space-warp-used` (info): The game uses Meta's space warp (it renders half of its frames plus motion vectors, and the runtime makes up the rest).
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)
@@ -1781,7 +1781,7 @@ For games that judder or shimmer while you hold your head still (for example I A
 - **Options:**
  - Value: int, default `0`.
  - Game settings → Picture → "Steadier head tracking" (advanced).
- **Catalog games (2):** I Am Cat, Lawn Mowing Simulator VR.
+- **Catalog games (1):** I Am Cat.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Repeat xrLocateViews queries for the same display time get the first, fully tracked answer again. Games that ask several times per frame got slightly different poses and rendered parts of the frame with different heads: judder (for example I Am Cat; proposed by Klownicle, GitHub #8).
@@ -1828,7 +1828,7 @@ For apps that only know Quest 3/Pro controllers: without it they get no buttons.
  - Game settings → Controllers → "Treat newer Quest controllers as Touch" (advanced).
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

-> Apps that suggest controller bindings only for Meta's newer profiles (Touch Plus, Touch Pro), which the Frame's runtime rejects (XR_ERROR_PATH_UNSUPPORTED), get the same bindings as oculus/touch_controller instead (components Touch lacks are dropped). Without it such apps get no controller input.
+> Apps that suggest controller bindings only for Meta's newer profiles (Touch Plus, Touch Pro), which the Frame's runtime rejects (XR_ERROR_PATH_UNSUPPORTED), get the same bindings as oculus/touch_controller instead (components Touch lacks are dropped), and the runtime's answer for each hand is reported to them as their own profile (Unity's OpenXR input only connects controllers of a profile it knows). Meta's detached-controller paths (XR_META_detached_controllers, which the Frame lacks) are left out of the app's actions and bindings: one such path made Unity attach no controller input at all. Without it such apps get no controller input.

 ### <a id="adapter-proximity_emul"></a>Animate fingers from touch

@@ -1941,7 +1941,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 (11):** Arkio, AugmentedEmpire, Battlemarked, Demeo, Demeter, Ghostbusters: Rise of the Ghost Lord, Neko Atsume Purrfect, Ocean Rift and 3 more.
+- **Catalog games (9):** Arkio, AugmentedEmpire, Battlemarked, Demeo, Demeter, Ghostbusters: Rise of the Ghost Lord, Ocean Rift, Smash Drums and 1 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)
@@ -2272,7 +2272,7 @@ Puts settings files next to the game on the Frame, for example to turn off an un
 - **Changes:** Install only: written on the Frame when the game is installed; the APK isn't changed.
 - **Suggested (on):** CryEngine: variable-rate shading isn't supported on the Frame, so user.cfg turns it off (… = 0; The Climb / The Climb 2).
 - **Options:** `files`: text, default none — path relative to files/ -&gt; content
- **Catalog games (3):** SUPERHOT VR, The Climb, The Climb 2.
+- **Catalog games (2):** SUPERHOT VR, The Climb 2.
 - **Source:** [patches/settings.py](../src/frameport/patches/settings.py)

 > Writes config files into the game's Android/data/&lt;package&gt;/files/ on the Frame, to turn off engine features the Frame doesn't support (for example a CryEngine user.cfg with r_variable_rate_shading = 0, as The Climb 2 needs).
@@ -2335,7 +2335,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 (110):** AFFECTED: The Manor, AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Attack on Titan VR: Unbreakable and 102 more.
+- **Catalog games (105):** AFFECTED: The Manor, AgeOfJoy, AllInOneSports, Ancient_Dungeon, Arcsmith, Arkio, Assassin's Creed Nexus, Audica and 97 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".
@@ -63,8 +63,6 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | Un-cracked Oculus PC VR game: "Initializing OVR session" then exits / signature check on the runtime | Revive's hooks don't install on Proton-arm64; the Oculus shim rejects the unsigned Revive runtime | Not runnable on the Frame without the repack's crack extracted (not done by FramePort); use the PC version |
 | PC VR game: `Failed to initialize Oculus API (-3001)` / `Unable to load LibOVRRT DLL` | Revive's LoadLibrary hook doesn't work under Proton arm64 (ARM64EC kernelbase); the game's LibOVR shim finds no runtime DLL | Symlink `LibOVRRT64_1.dll` → Revive's DLL in the prefix's system32 (manual so far) → then -3021 (runtime signature check; open) |
 | Uploads to the Frame are slow | The link, storage or transfer backend can limit throughput | Check the job's "Transfer link"; try the Frame's hotspot or USB cable. Large install files prefer system OpenSSH SFTP, retaining paired-host checks and `.part` resume; unavailable or failed native uploads fall back to Paramiko. The log names the backend. Settings → Installing → Parallel uploads accepts 1–8 (default 3; saved preferences are preserved). More is not always faster. Measure the production path with `scripts/upload_bench.py --methods app-files-3 --check-resume` (three repetitions, checksum verification) |
-| Log: `OpenSSH SFTP failed (255): … Permission denied (publickey,password)`, then Paramiko | OpenSSH offered keys the Frame doesn't authorize (GitHub #242) | The log lists the keys OpenSSH offered (`Offering public key`) and its warnings. A connection that logged in with the PC's own keys/agent makes OpenSSH use them too (copies of `~/.ssh/id_*` + the agent); a refused FramePort key is retried that way once. A Frame that accepts only another key file: Settings → Installing → SSH keys (CLI `frameport frame ssh-keys --add <file>`); passphrase keys go through the SSH agent |
-| Log: `OpenSSH SFTP failed (1): stat C://…/[…: No such file or directory` | sftp got glob escapes inside its quotes (GitHub #324, fixed): `[` in a local folder name | Update FramePort; the native_upload `quote()` passes only `\\` and `\"` escapes, Windows paths with `/` |
 | PC VR game exits right away: `Unhandled Exception: 0xc06d007e` (after `FOnlineSubsystemOculus::InitWithWindowsPlatform`) | Delay-loaded `LibOVRPlatform64_1.dll` (Oculus Platform SDK, installed with the Oculus app) is missing | None on the Frame (entitlement check; FramePort doesn't replace it). PC mode with the Oculus app |
 | Unity PC VR game (Oculus + SteamVR build: `OVRPlugin.dll` and `openvr_api.dll` in `<Name>_Data/Plugins`) opens a window and quits after ~20 s; no VR Vulkan instance after the game's DXVK device in launch.log; Unity log (`unity log … Player.log`, agent v67): `OpenVR failed initialization` / `Initialization of device … failed` | Unity's built-in VR tries its SDKs in list order (Oculus first) unless `-vrmode` picks one; a catalog recipe verified with another build of the game (for example SUPERHOT VR's OpenXR build, GitHub #105) used to drop the build's own arguments | `pcvr.launch_args` = `-vrmode OpenVR` (detected for such builds; kept when the catalog's `xr` differs from the build's). A game's Electron launcher next to it (SHVR.exe) is ranked below the game |
 | Unreal PC VR game opens the crash reporter instead of closing | UE starts CrashReportClient.exe on a crash | `pcvr.no_crash_reporter` (default for Unreal Rift games): `-nocrashreports` + CrashReportClient.exe renamed `.disabled` in the Frame copy |
@@ -87,7 +85,6 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | 32-bit Unity game on the bridge: player stands in the floor (Spunky Dungeon) | Unity's floor-level tracking origin: `vrapi_SetTrackingSpace(1)` (LOCAL_FLOOR) was ignored | The VrApi bridge puts the origin on the STAGE floor for LOCAL_FLOOR/STAGE |
 | Crash at start: `NoClassDefFoundError: … Landroid/window/OnBackInvokedCallback;` or `NoSuchMethodError: No static method storeStoreFence()V in class Ljava/lang/invoke/VarHandle;` (GitHub #71/#72, triage `android-too-new`) | The APK needs Android 13+ (minSdk 33 or more; those were 34) and calls its classes at start; Lepton's Android is 11 (API 30). OVRPort lowers minSdk to 29, so it installs anyway. minSdk ≤ 32 (Quest's Android 12L) is fine: 16 working catalog games declare 32 | None (analysis `extra.min_sdk` > 32 → a warning on the game page/CLI and in the recipe notes; never unsupported from the manifest alone, the launch test's triage decides). Waits for Valve to update Lepton's Android |
 | Nothing opens; `TWALauncherActivity: Using URL from Manifest (https://…)`, `Creating TwaLauncher for com.oculus.browser`, `NameNotFoundException: com.oculus.browser` (GitHub #86 Mahjong Table VR, triage `web-wrapper`) | The APK is a Trusted Web Activity (Bubblewrap / Meta's PWA packaging): a website that opens in Meta's browser, which Lepton doesn't have | None: open the URL in a browser. Analysis `extra.web_wrapper` (manifest meta-data `android.support.customtabs.trusted.DEFAULT_URL`, resolved through resources.arsc, or androidbrowserhelper's LauncherActivity) → a warning with the URL (not unsupported: the manifest alone never decides) |
-| A flat window, no VR and no way to interact; `Google VR Error [Daydream]: Google VR had a fatal issue while loading`, `class com/google/vr/sdk/base/CardboardViewNativeImpl not found` (32-bit bridge), `Unable to start service Intent { act=com.google.vr.vrcore.… }` (GitHub #335 Blade Runner: Revelations, triage `gvr-not-supported`) | A Google Daydream / Cardboard build: Google's VR SDK (GVR, `libgvr.so`) or the Cardboard SDK. Daydream needs Google's VrCore service, Cardboard draws a distorted side-by-side image for a phone screen; neither reaches OpenXR, the Frame's only way into the headset | None: get the game's Oculus build (Quest, Go or Gear VR), which goes through the normal path. Analysis `extra.google_vr` (`daydream`/`cardboard`: manifest categories `com.google.intent.category.DAYDREAM`/`CARDBOARD`, `enableVrMode="com.google.vr.vrcore/…"`, `libgvr.so`/Cardboard SDK libraries, GVR Java classes, Unity `vr-device-list`; not `libgvraudio.so`, which Quest games ship too) → a warning on the game page/CLI and in the recipe notes, only when the APK has no Oculus support; never unsupported from the manifest alone. A GVR → OpenXR shim (like the VrApi bridge) is possible in principle but not built |
 | `UnsatisfiedLinkError` / `cannot locate symbol "ovr_…"` | overport's platform loader lacks Meta platform functions | `frame.ovrstubs` (automatic, generated stubs) |
 | missing `ovrMessageType_ToString` | same, but the game needs a real string | `frame.ovrplatformcompat` (automatic) |
 | The game stays in its built-in language or waits at start although its OBB / files hold language packs (`<tag>.lang`, for example `de.lang`) | overport's platform loader answers `ovr_LanguagePack_GetCurrent/SetCurrent` with request id 0, so the game never gets the pack's path | `frame.langpacks` (opt-in, experimental, shown for games whose data has `*.lang`; `native/langpack`, build it with `python native/build.py --only langpack`). Default pack: the one the game applies, else env `FRAMEPORT_LANGPACK=<tag>`, else the only pack; search path override `FRAMEPORT_LANGPACK_DIRS`. Unreal games (Deadpool VR) gray out a pack whose asset `Metadata` differs from the game's version string: the patch writes the APK's versionName as Metadata (env `FRAMEPORT_LANGPACK_META` overrides) and reports the pack under the `/storage/emulated/0/Android/obb/<pkg>/` spelling of its path; with `/sdcard/…` the text switched but the dialogue stayed silent (verified in the headset with Deadpool VR) |
@@ -142,6 +139,8 @@ version is `catalog/triage.yaml` (used by `frameport test` / the Job screen); ke
 | Unity game freezes on its loading screen ~10-15 s in (Yupitergrad, GitHub #235); launch.log has `GrantPermissionsActivity: Permission grant result … permission=android.permission.BLUETOOTH_CONNECT`, then OVRPlugin `SetupDisplayObjects(): Unable to find EGLConfig for configId 0` and no more frames; triage `bhaptics-permission-prompt` | bHaptics' vest SDK (`com.bhaptics.commons.PermissionUtils.requestBluetoothPermission`) asks for Android 12's BLUETOOTH_CONNECT; on Lepton's Android 11 it can't be granted at install, so Android's permission screen takes the foreground for a moment, the game pauses/resumes and OVRPlugin's GLES compositor stops drawing | `frame.bhaptics_permission` (suggested by analysis `bhaptics_permission`): the request returns at once (`Dex.return_early`) |
 | Unity game aborts at start: `Abort message: 'cannot create thread specific key for __cxa_get_globals()'` (SIGABRT in a library such as `libFirebaseCppApp-*.so`, for example Wander 0.3570, GitHub #198); triage `pthread-keys-exhausted` | Bionic allows 128 pthread keys per process; Unity 6 takes ~40 (most without a destructor), large native libraries (Gecko `libxul.so`, Firebase, avatar SDKs) and the Frame's own libraries (Mesa/Zink, FrameBridge, OVRPort, Valve's Vulkan layers) take the rest | `frame.unity_tls_key_pool` (opt-in; suggested for Unity 6 with Firebase C++ or Gecko): libunity.so's `pthread_key_*`/`pthread_get/setspecific` imports are renamed to `fp_tkey_*` (`elf.rename_imports`, versions set global) and `libfp_tkeys.so` (`native/tlskeys`) is added to its DT_NEEDED; destructor-less keys become slots behind one real key (logs `fp_tkeys: pooling Unity's thread keys`). Approach by Klownicle (#198) |
 | Controllers do nothing (for example stuck on a setup screen); log: `xrSuggestInteractionProfileBindings … XR_ERROR_PATH_UNSUPPORTED` | the game only suggests bindings for Meta's newer profiles (Touch Plus / Touch Pro); the Frame's Android runtime knows `oculus/touch_controller`, not those | adapter `profile_remap` (default on): the bindings are suggested again for Touch (log: `controller profile … -> oculus/touch_controller`) |
+| Controllers "don't sync": virtual hands/controllers lie on the floor below you, no buttons (Unity OpenXR games that only suggest Touch Plus/Pro, e.g. Hotel Infinity #327); log with `input_diag=1`: only `meta/touch_controller_plus` (or Pro) suggested, `controller profile … -> oculus/touch_controller` | the runtime then reports `oculus/touch_controller` for each hand, a profile the game never suggested: Unity's OpenXR input creates no device for it | adapter `profile_remap` (default on) reports the game's own profile for such hands (log: `profile_remap: /user/hand/left reported as meta/touch_controller_plus`) |
+| Controllers "don't sync": hands on the floor below you, no buttons, in a Unity OpenXR game with Meta's OpenXR features (e.g. Spatial Zombies #328); log: `xrCreateAction: XR_ERROR_PATH_UNSUPPORTED` (input_diag: `xrCreateAction -> XR_ERROR_PATH_UNSUPPORTED (thumbstick)`), then `xrGetCurrentInteractionProfile: XR_ERROR_ACTIONSET_NOT_ATTACHED` | Meta's "Detached … Controller" devices add `/user/detached_controller_meta/left|right` to Unity's merged actions; the Frame has no XR_META_detached_controllers, the action fails and Unity attaches no action set (OVRPlugin's input goes with it) | adapter `profile_remap` (default on) leaves those paths out of actions and bindings (log: `profile_remap: action thumbstick without 2 detached-controller path(s)`) |
 | Some buttons do nothing or the wrong thing (for example a Quest game's X/Y on the Frame's left controller) | the game binds only Quest Touch and SteamVR maps Touch onto the Frame controllers with its own remap (Touch left X/Y land on the d-pad, right X and Y repeat B), or the runtime rejected a profile or an input call | turn on adapter `input_diag` (diagnostics, off by default; `frameport settings <pkg> input_diag=1`) and look for `input_diag:` lines: `bindings: <profile> accepted` or `unsupported: interaction profile <profile> -> <result>` with the rejected paths, `bindings: /user/hand/<hand> uses <profile>`, `unsupported: function <name>`, `unsupported: xrCreateAction -> <result> (<action>)` |
 | Unity game hangs or the whole Frame restarts (for example in a menu); log: `The current MSAA level is 0, but the recommended MSAA level is 4. Switching to the recommended level.` (for example Lucky's Tale) | Meta's OVRManager (`useRecommendedMSAALevel`) turns 4x MSAA on at runtime, past QualitySettings; multisampled render-to-texture on GLES/Zink hangs the GPU | `frame.unity_runtime_msaa_off` (Cpp2IL: `OVRDisplay.get_recommendedMSAALevel` → 0) |
 | Unity game: one eye shows only effects or gray, the other is fine (for example I Am Cat, Oculus XR Plugin on GLES) | the game's single-pass multiview rendering goes wrong for array slice 1 (the adapter submits both slices correctly) | `frame.unity_multipass` (Cpp2IL: `OculusSettings.GetStereoRenderingMode` → MultiPass); `swap_eyes=1` tells whether the game or the adapter is at fault |
@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Included by session_fixes.c: Meta's detached controllers (XR_META_detached_controllers: a controller put down while
+// hand tracking runs) on a runtime without that extension. Uses profile_remap, runtime_has_detached_controllers,
+// active_instance, lookup and LOG.
+//
+// Meta's Unity OpenXR features add "Detached ... Controller" devices for /user/detached_controller_meta/left|right.
+// Unity merges same-named actions of every enabled device into one action, so the first action with such a subaction
+// path (e.g. "thumbstick") fails with XR_ERROR_PATH_UNSUPPORTED on the Frame's runtime, Unity attaches no action set
+// at all and neither Unity nor OVRPlugin get controller input: hands lying at the play-space origin on the floor, no
+// buttons (Spatial Zombies, GitHub #328). With profile_remap on and the runtime lacking the extension, these paths are
+// left out of the game's actions and suggested bindings, and xrGetCurrentInteractionProfile answers "no profile"
+// for them (a detached controller that never shows up) instead of XR_ERROR_PATH_UNSUPPORTED.
+
+#define DETACHED_PREFIX "/user/detached_controller_meta/"
+
+static int detached_filter_on(void) { return profile_remap && !runtime_has_detached_controllers && active_instance; }
+
+// 1 if `path` is a detached controller's top-level path or one of its input/output paths
+static int detached_path(XrPath path) {
+    PFN_xrPathToString to_string = (PFN_xrPathToString)lookup(active_instance, "xrPathToString");
+    char name[XR_MAX_PATH_LENGTH];
+    uint32_t size = 0;
+    return path && to_string && XR_SUCCEEDED(to_string(active_instance, path, sizeof(name), &size, name)) &&
+           !strncmp(name, DETACHED_PREFIX, strlen(DETACHED_PREFIX));
+}
+
+// xrCreateAction: `info` without the detached subaction paths, in *copy (paths in `kept`, room for all of them).
+// Returns `info` itself when there is nothing to leave out.
+static const XrActionCreateInfo *detached_strip_action(const XrActionCreateInfo *info, XrActionCreateInfo *copy,
+                                                       XrPath *kept) {
+    if (!info || !info->countSubactionPaths || !info->subactionPaths || !kept || !detached_filter_on()) return info;
+    uint32_t n = 0;
+    for (uint32_t i = 0; i < info->countSubactionPaths; ++i)
+        if (!detached_path(info->subactionPaths[i])) kept[n++] = info->subactionPaths[i];
+    if (n == info->countSubactionPaths) return info;
+    *copy = *info;
+    copy->countSubactionPaths = n;
+    copy->subactionPaths = kept;
+    static int logged;
+    if (logged++ < 3)
+        LOG("profile_remap: action %s without %u detached-controller path(s) (the runtime has no "
+            "XR_META_detached_controllers)", info->actionName, info->countSubactionPaths - n);
+    return copy;
+}
+
+// xrSuggestInteractionProfileBindings: `suggested` without bindings of detached controllers, in *copy (bindings in
+// `kept`, room for all of them). Returns `suggested` itself when there is nothing to leave out.
+static const XrInteractionProfileSuggestedBinding *detached_strip_bindings(
+        const XrInteractionProfileSuggestedBinding *suggested, XrInteractionProfileSuggestedBinding *copy,
+        XrActionSuggestedBinding *kept) {
+    if (!suggested || !suggested->countSuggestedBindings || !suggested->suggestedBindings || !kept ||
+        !detached_filter_on())
+        return suggested;
+    uint32_t n = 0;
+    for (uint32_t i = 0; i < suggested->countSuggestedBindings; ++i)
+        if (!detached_path(suggested->suggestedBindings[i].binding)) kept[n++] = suggested->suggestedBindings[i];
+    if (n == suggested->countSuggestedBindings) return suggested;
+    *copy = *suggested;
+    copy->countSuggestedBindings = n;
+    copy->suggestedBindings = kept;
+    static int logged;
+    if (logged++ < 8) {
+        PFN_xrPathToString to_string = (PFN_xrPathToString)lookup(active_instance, "xrPathToString");
+        char profile[XR_MAX_PATH_LENGTH] = "?";
+        uint32_t size = 0;
+        if (to_string) to_string(active_instance, suggested->interactionProfile, sizeof(profile), &size, profile);
+        LOG("profile_remap: %s bindings without %u detached-controller path(s)", profile,
+            suggested->countSuggestedBindings - n);
+    }
+    return copy;
+}
+
+// xrGetCurrentInteractionProfile: a detached controller's path the runtime doesn't know has no profile.
+static XrResult detached_current_profile(XrPath user, XrInteractionProfileState *state, XrResult result) {
+    if (result != XR_ERROR_PATH_UNSUPPORTED || !state || !detached_filter_on() || !detached_path(user)) return result;
+    state->interactionProfile = XR_NULL_PATH;
+    return XR_SUCCESS;
+}
@@ -147,6 +147,7 @@ static int sync_guard;       // xrSyncActions one at a time with xrPollEvent, pa
 static int profile_remap = 1; // Meta's newer controller profiles (rejected by the Frame) -> oculus/touch_controller
 static int proximity_emul;   // finger proximity from capacitive touch: 1 thumb, 2 thumb + index (session_fixes.c)
 static int runtime_has_proximity;  // the runtime has XR_FB_touch_controller_proximity itself
+static int runtime_has_detached_controllers;  // the runtime has XR_META_detached_controllers (detached_controllers.c)
 static int layer_debug;      // diagnostics: layers, swapchains, session states, spaces, aim/grip, refresh rates
 static int input_diag;       // diagnostics: controller profiles, bindings, missing functions, failing input calls
 static int stable_local;     // keep every LOCAL space the app creates on the session-start origin
@@ -422,6 +423,8 @@ XRAPI_ATTR XrResult XRAPI_CALL xrCreateInstance(const XrInstanceCreateInfo *info
    for (uint32_t j = 0; available && j < available_count; ++j)
        if (!strcmp(available[j].extensionName, "XR_FB_composition_layer_image_layout")) runtime_has_image_layout = 1;
        else if (!strcmp(available[j].extensionName, "XR_FB_touch_controller_proximity")) runtime_has_proximity = 1;
+        else if (!strcmp(available[j].extensionName, "XR_META_detached_controllers"))
+            runtime_has_detached_controllers = 1;
    // Layer types are only valid if their extension ends up enabled; some apps submit them regardless.
    int has_equirect = 0, has_equirect2 = 0, has_cylinder = 0, has_cube = 0;
    for (uint32_t i = 0; i < kept; ++i) {
@@ -2004,7 +2007,7 @@ XRAPI_ATTR XrResult XRAPI_CALL xrGetCurrentInteractionProfile(XrSession session,
    PFN_xrGetCurrentInteractionProfile fn =
        (PFN_xrGetCurrentInteractionProfile)lookup(active_instance, "xrGetCurrentInteractionProfile");
    if (!fn) return XR_ERROR_FUNCTION_UNSUPPORTED;
-    XrResult result = fn(session, user, state);
+    XrResult result = detached_current_profile(user, state, fn(session, user, state));
    if (input_diag && XR_SUCCEEDED(result) && state) input_diag_current_profile(user, state->interactionProfile);
    if (layer_debug && active_instance) {  // which device each hand has, as the runtime reports it
        PFN_xrPathToString str = (PFN_xrPathToString)lookup(active_instance, "xrPathToString");
@@ -2018,16 +2021,7 @@ XRAPI_ATTR XrResult XRAPI_CALL xrGetCurrentInteractionProfile(XrSession session,
        static int logged;
        if (logged++ < 40) LOG("layer_debug: interaction profile of %s: %s (result %d)", who, what, result);
    }
-    if (!controller_fix || XR_FAILED(result) || !state || !state->interactionProfile || !active_instance)
-        return result;
-    PFN_xrPathToString to_string = (PFN_xrPathToString)lookup(active_instance, "xrPathToString");
-    PFN_xrStringToPath to_path = (PFN_xrStringToPath)lookup(active_instance, "xrStringToPath");
-    char name[XR_MAX_PATH_LENGTH];
-    uint32_t size = 0;
-    if (to_string && to_path &&
-        XR_SUCCEEDED(to_string(active_instance, state->interactionProfile, sizeof(name), &size, name)) &&
-        (strstr(name, "/valve/") || strstr(name, "/khr/generic_controller")))
-        to_path(active_instance, "/interaction_profiles/oculus/touch_controller", &state->interactionProfile);
+    if (XR_SUCCEEDED(result) && state) current_profile_fix(user, state);
    return result;
 }

@@ -2199,7 +2193,7 @@ XRAPI_ATTR XrResult XRAPI_CALL xrGetInstanceProcAddr(XrInstance instance, const
    if (layer_debug) HOOK_AS(xrGetActionStateBoolean, hook_xrGetActionStateBoolean)
    if (layer_debug || aim_correction_on() || profile_remap || input_diag || proximity_emul)
        HOOK_AS(xrSuggestInteractionProfileBindings, hook_xrSuggestInteractionProfileBindings)
-    if (proximity_emul) HOOK_AS(xrCreateAction, hook_xrCreateAction)
+    if (proximity_emul || profile_remap) HOOK_AS(xrCreateAction, hook_xrCreateAction)
    if (layer_debug || aim_correction_on()) {
        HOOK_AS(xrCreateActionSpace, hook_xrCreateActionSpace)
    }
@@ -0,0 +1,38 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Included by session_fixes.c (after TOUCH_PROFILE and app_suggested_touch): what xrGetCurrentInteractionProfile
+// tells the game about each hand. Uses controller_fix, profile_remap, active_instance, lookup and LOG.
+//  * controller_fix: SteamVR's own profiles (valve/..., khr/generic_controller) are reported as oculus/touch_controller,
+//    the profile Quest games have bindings for.
+//  * profile_remap: when the game suggested bindings only for one of Meta's newer profiles (Touch Plus/Pro) and
+//    hook_xrSuggestInteractionProfileBindings suggested them again for Touch, the runtime reports
+//    oculus/touch_controller, a profile the game never suggested. Unity's OpenXR plugin creates its input devices by
+//    the reported profile, finds none for Touch and leaves the controllers unconnected: hands lying at the play-space
+//    origin on the floor, no buttons (e.g. Hotel Infinity, GitHub #327). Such a hand is reported with the game's own
+//    profile instead (the last one remapped: the Touch bindings the runtime uses are that profile's).
+
+static char remapped_profile[XR_MAX_PATH_LENGTH];  // set by hook_xrSuggestInteractionProfileBindings
+
+static void current_profile_fix(XrPath user, XrInteractionProfileState *state) {
+    if ((!controller_fix && !profile_remap) || !state->interactionProfile || !active_instance) return;
+    PFN_xrPathToString to_string = (PFN_xrPathToString)lookup(active_instance, "xrPathToString");
+    PFN_xrStringToPath to_path = (PFN_xrStringToPath)lookup(active_instance, "xrStringToPath");
+    char name[XR_MAX_PATH_LENGTH];
+    uint32_t size = 0;
+    if (!to_string || !to_path ||
+        XR_FAILED(to_string(active_instance, state->interactionProfile, sizeof(name), &size, name)))
+        return;
+    int touch = !strcmp(name, TOUCH_PROFILE);
+    if (controller_fix && (strstr(name, "/valve/") || strstr(name, "/khr/generic_controller")) &&
+        XR_SUCCEEDED(to_path(active_instance, TOUCH_PROFILE, &state->interactionProfile)))
+        touch = 1;
+    if (!touch || !profile_remap || !*remapped_profile || app_suggested_touch ||
+        XR_FAILED(to_path(active_instance, remapped_profile, &state->interactionProfile)))
+        return;
+    static int logged;
+    if (logged++ < 4) {
+        char who[XR_MAX_PATH_LENGTH] = "?";
+        to_string(active_instance, user, sizeof(who), &size, who);
+        LOG("profile_remap: %s reported as %s (the app's profile) instead of oculus/touch_controller", who,
+            remapped_profile + strlen("/interaction_profiles/"));
+    }
+}
@@ -296,6 +296,8 @@ static const char *const TOUCH_LEFT[] = {"input/x/click", "input/x/touch", "inpu
 static const char *const TOUCH_RIGHT[] = {"input/a/click", "input/a/touch", "input/b/click", "input/b/touch",
    "input/system/click"};
 static int app_suggested_touch;
+#include "profile_report.c"  // remapped_profile, current_profile_fix (xrGetCurrentInteractionProfile)
+#include "detached_controllers.c"  // detached controllers' paths on a runtime without them

 static int in_list(const char *s, const char *const *list, size_t n) {
    for (size_t i = 0; i < n; ++i)
@@ -332,8 +334,13 @@ static XRAPI_ATTR XrResult XRAPI_CALL hook_xrCreateAction(XrActionSet set, const
        XrAction *action) {
    PFN_xrCreateAction fn = (PFN_xrCreateAction)lookup(active_instance, "xrCreateAction");
    if (!fn) return XR_ERROR_FUNCTION_UNSUPPORTED;
-    XrResult r = fn(set, info, action);
-    if (XR_SUCCEEDED(r) && info && action) {  // OVRPlugin's action names
+    XrActionCreateInfo copy;
+    XrPath *kept = info && info->countSubactionPaths ? calloc(info->countSubactionPaths, sizeof(*kept)) : NULL;
+    XrResult r = fn(set, detached_strip_action(info, &copy, kept), action);
+    free(kept);
+    if (XR_FAILED(r) && input_diag)  // this hook replaces input_diag's wrapper of xrCreateAction
+        diag_call_failed("xrCreateAction", r, diag_name_detail(info ? info->actionName : NULL));
+    if (proximity_emul && XR_SUCCEEDED(r) && info && action) {  // OVRPlugin's action names
        if (!strcmp(info->actionName, "hand_thumb_proximity")) thumb_proximity_action = *action;
        else if (!strcmp(info->actionName, "hand_trigger_proximity")) trigger_proximity_action = *action;
        else return r;
@@ -429,11 +436,26 @@ static XrResult remap_to_touch(XrInstance instance, PFN_xrSuggestInteractionProf
    return r;
 }

+static XrResult suggest_bindings(XrInstance instance, PFN_xrSuggestInteractionProfileBindings fn,
+                                 const XrInteractionProfileSuggestedBinding *suggested);
+
 static XRAPI_ATTR XrResult XRAPI_CALL hook_xrSuggestInteractionProfileBindings(XrInstance instance,
        const XrInteractionProfileSuggestedBinding *suggested) {
    PFN_xrSuggestInteractionProfileBindings fn =
        (PFN_xrSuggestInteractionProfileBindings)lookup(instance, "xrSuggestInteractionProfileBindings");
    if (!fn) return XR_ERROR_FUNCTION_UNSUPPORTED;
+    XrInteractionProfileSuggestedBinding copy;
+    XrActionSuggestedBinding *kept = suggested && suggested->countSuggestedBindings
+        ? calloc(suggested->countSuggestedBindings, sizeof(*kept)) : NULL;
+    const XrInteractionProfileSuggestedBinding *use = detached_strip_bindings(suggested, &copy, kept);
+    // a profile with only detached-controller bindings: nothing the runtime could bind
+    XrResult r = use != suggested && !use->countSuggestedBindings ? XR_SUCCESS : suggest_bindings(instance, fn, use);
+    free(kept);
+    return r;
+}
+
+static XrResult suggest_bindings(XrInstance instance, PFN_xrSuggestInteractionProfileBindings fn,
+                                 const XrInteractionProfileSuggestedBinding *suggested) {
    PFN_xrPathToString to_string = (PFN_xrPathToString)lookup(instance, "xrPathToString");
    if (suggested && to_string && (layer_debug || aim_correction_on()))
        for (uint32_t i = 0; i < suggested->countSuggestedBindings; ++i) {
@@ -456,6 +478,7 @@ static XRAPI_ATTR XrResult XRAPI_CALL hook_xrSuggestInteractionProfileBindings(X
    }
    if (r != XR_ERROR_PATH_UNSUPPORTED || app_suggested_touch || !IN(profile, NEWER_TOUCH)) return r;
    XrResult remapped = remap_to_touch(instance, fn, to_string, suggested, profile);
+    if (XR_SUCCEEDED(remapped)) snprintf(remapped_profile, sizeof(remapped_profile), "%s", profile);
    return XR_SUCCEEDED(remapped) ? XR_SUCCESS : r;
 }

@@ -101,8 +101,6 @@ def main() -> int:
    ap.add_argument("--viewport", default="1280x820", help="browser size, e.g. 2560x1440")
    ap.add_argument("--update", action="store_true", help="pretend a new FramePort release exists (update UI: "
                    "changelog dialog, what's new bar + dialog, Settings changelog)")
-    ap.add_argument("--announcement", action="store_true", help="show the announcement pop-up (with a picture, "
-                    "then text only); nothing is fetched")
    ap.add_argument("--fake-frame", action="store_true", help="pretend a Steam Frame is connected (no device needed)")
    ap.add_argument("--hover", default=None, help="x,y: move the mouse there before the Library screenshot")
    ap.add_argument("--install-questions", nargs="+", metavar="PKG", default=None,
@@ -139,8 +137,7 @@ def main() -> int:
             ("monitor", lambda a: a.go("monitor")), ("monitor-details", open_monitor_details),
             ("tools", lambda a: a.go("settings")),
             # the index on the left: "This PC" scrolls the page there
-             ("settings-index", lambda a: a.page.run_task(a.settings_view.show_section, "pc")),
-             ("settings-installing", lambda a: a.page.run_task(a.settings_view.show_section, "installing"))]
+             ("settings-index", lambda a: a.page.run_task(a.settings_view.show_section, "pc"))]
    if game:
        steps.insert(1, ("game", lambda a: a.open_game(game)))
        steps.insert(2, ("game-customize", lambda a: a.open_game(game, advanced=True)))
@@ -153,8 +150,7 @@ def main() -> int:
        if args.fake_frame:  # GitHub #90: the Move to… dialog (drives load in the background)
            steps.append(("move-dialog", lambda a: (a.page.pop_dialog(), a.move_game(game))))
            steps.append(("uninstall-dialog", lambda a: (a.page.pop_dialog(), a.uninstall(game))))
-        # last: the menus stay open over whatever comes next (the page's "…" menu, then the right-click menu)
-        steps.append(("game-menu", lambda a: (a.show_activity(False), a.open_game_menu(game))))
+        # last: the right-click menu stays open over whatever comes next
        steps.append(("library-menu", lambda a: (a.show_activity(False), a.navigate(0), time.sleep(3),
                                                 a.library_view.open_menu(game))))
    if args.docs:
@@ -282,7 +278,6 @@ def main() -> int:
                 ("linux-change-program", lambda a: a.choose_exe(LINUX_FOLDER)),
                 ("frame", lambda a: (a.page.pop_dialog(), a.navigate(1))),
                 ("linux-move", lambda a: a.move_game(LINUX_APPIMAGE) if args.fake_frame else None),
-                 ("linux-game-menu", lambda a: (a.page.pop_dialog(), a.open_game_menu(LINUX_FOLDER))),
                 ("linux-menu", lambda a: (a.page.pop_dialog(), a.navigate(0), time.sleep(3),
                                           a.library_view.open_menu(LINUX_APPIMAGE)))]
    if args.links:
@@ -423,26 +418,6 @@ def main() -> int:
            print(f"open dialogs: {len([d for d in a.page._dialogs.controls if d.open])}, queued: {queued}", flush=True)
        steps = [("library", lambda a: a.navigate(0)), ("questions", open_questions),
                 ("after-1st-double", double_click), ("after-2nd-double", double_click), ("end", report)]
-    if args.announcement:
-        import shutil
-
-        from frameport import announcements
-        from frameport.core.paths import user_data_dir
-
-        text = ("---\nid: smoke\ntitle: FramePort 1.3 brings the Monitor to every Frame\ndate: 2026-10-14T12:00:00Z\n"
-                "---\n"
-                "The **Monitor** tab now shows fps, battery and temperatures for any game the Frame runs, including "
-                "Steam's own. Open it from the sidebar's Frame card.\n\n"
-                "- Install links from FrameDrop buttons open in FramePort\n"
-                "- Uploads over the USB cable are about **3× faster**\n\n"
-                "Questions? Ask in [Discussions](https://example.invalid).")
-        news = announcements.parse(text)
-        pic = user_data_dir() / "announcements" / "smoke.png"
-        pic.parent.mkdir(parents=True, exist_ok=True)
-        shutil.copy(Path(__file__).resolve().parents[1] / "docs" / "images" / "library.png", pic)
-        steps = [("announcement-image", lambda a: (a.navigate(0), a.announcer.show(news, pic))),
-                 ("announcement-text", lambda a: (a.page.pop_dialog(), time.sleep(1.5), a.announcer.show(
-                     announcements.parse(text.replace("id: smoke", "id: smoke2")))))]
    if args.update:
        from frameport import __version__, updates

@@ -43,10 +43,7 @@ IL2CPP_METADATA = "assets/bin/Data/Managed/Metadata/global-metadata.dat"
 # 17: headset (the Meta headset a VR app was made for: Gear VR / Go games run through frame.a32_bridge) (2026-10)
 # 18: headset "quest" also for 32-bit apps that require 6DoF head tracking (Santa Cruz builds, e.g. Sports
 #     Scramble: Touch controllers on the a32 bridge) (2026-10)
-# 19: unreal_obb_delivery also for obfuscated DownloaderActivity predicates (GitHub #159) (2026-10)
-# 20: google_vr (Google Daydream / Cardboard builds: GVR or Cardboard SDK, no path to the Frame's headset,
-#     GitHub #335) (2026-10)
-ANALYSIS_VERSION = 20
+ANALYSIS_VERSION = 19


 # Android versions by API level (for messages); the Frame's Lepton container runs Android 11 (API 30)
@@ -200,32 +197,6 @@ def vr_kind(libs: set[str], manifest_strings: list[str]) -> str:
    return "none"


-# Google VR (Daydream / Cardboard): the manifest categories of a Daydream / Cardboard app, Daydream's VR service
-# (android:enableVrMode="com.google.vr.vrcore/..."), the GVR SDK's library and the Cardboard SDK's
-# (github.com/googlevr/cardboard), and the GVR SDK's Java classes. Not libgvraudio.so / Unity's
-# libaudioplugingvrunity.so: Google's spatial audio, which Quest games ship too (e.g. Shadow Point).
-DAYDREAM_CATEGORY = "com.google.intent.category.DAYDREAM"
-CARDBOARD_CATEGORY = "com.google.intent.category.CARDBOARD"
-GOOGLE_VR_LIBS = {"libgvr.so", "libcardboard_api.so", "libGfxPluginCardboard.so"}
-GVR_DEX_MARKERS = (b"Lcom/google/vr/ndk/base/GvrLayout;", b"Lcom/google/vr/sdk/base/GvrView;",
-                   b"Lcom/google/vr/sdk/base/GvrActivity;", b"Lcom/google/cardboard/sdk/")
-
-
-def google_vr(libs: set[str], cats: set[str], manifest_strings: list[str], gvr_java: bool = False,
-              boot: str = "") -> str:
-    """A Google VR app: "daydream" (Daydream: needs Google's VR services, VrCore), "cardboard" (Cardboard: draws
-    both eyes side by side with lens distortion onto a phone screen) or "" (neither). Neither has a path to the
-    Frame's headset: a Lepton app only reaches it through OpenXR (VrApi / OVRPlugin games are translated to it).
-    `boot` = Unity's boot.config (vr-device-list=, where Unity builds list their VR devices)."""
-    devices = next((ln.split("=", 1)[1].lower() for ln in boot.splitlines() if ln.startswith("vr-device-list=")), "")
-    if (DAYDREAM_CATEGORY in cats or any(s.startswith("com.google.vr.vrcore") for s in manifest_strings)
-            or "daydream" in devices):
-        return "daydream"
-    if CARDBOARD_CATEGORY in cats or "cardboard" in devices or libs & GOOGLE_VR_LIBS or gvr_java:
-        return "cardboard"
-    return ""
-
-
 # Kotlin's message for a failed non-null cast to ClipboardManager (Godot 4.2-4.4; 4.1 is Java, 4.5+ uses `as?`)
 GODOT_CLIPBOARD_CAST = b"null cannot be cast to non-null type android.content.ClipboardManager"

@@ -278,8 +249,6 @@ def analyze(path: Path, deep: bool = True, data_bytes: int | None = None) -> Ana
                                  for d in dexes)
        # video through Android's decoders (frame.hw_video_decode): Java MediaCodec, ExoPlayer/Media3, or libVLC
        media_codec = any(m in d for d in dexes for m in MEDIA_CODEC_MARKERS) or "libvlc.so" in libs
-        # Google VR's Java side (GvrLayout / GvrView, the Cardboard SDK): a Daydream / Cardboard app (google_vr)
-        gvr_java = any(m in d for d in dexes for m in GVR_DEX_MARKERS)
        from ..patches.frame.unreal_obb_check import has_delivery_check

        # Includes obfuscated DownloaderActivity predicates; CRC verification is a separate manifest switch.
@@ -403,8 +372,6 @@ def analyze(path: Path, deep: bool = True, data_bytes: int | None = None) -> Ana
            "xr_layer_exts": sorted(layer_exts),  # composition-layer extensions the game's own libraries request
            "vr_kind": vr_kind(libset, manifest_strings),
            "headset": headset(meta, abis, vr_kind(libset, manifest_strings), requires_6dof(manifest)),
-            # a Google Daydream / Cardboard build (GVR / Cardboard SDK): no path to the Frame's headset (GitHub #335)
-            "google_vr": google_vr(libset, cats, manifest_strings, gvr_java, boot),
            # the base of a split APK set (Play "app bundle" installs): the code/libraries live in split APKs
            "split_apk": bool({"isSplitRequired", "requiredSplitTypes"} & set(manifest_strings)),
            # Unity (IL2CPP) text fields: they close at once on the Frame (frame.unity_text_input)
@@ -1,218 +0,0 @@
-"""Announcements: one short message from the maintainer, shown once as a pop-up in the app.
-
-Source of truth: `announcements/current.md` on GitHub `main` (front matter + Markdown, announcements/README.md), read
-through raw.githubusercontent like the catalog (cached, every 6 h), so a push reaches users without a release.
-
-Who sees it: only people who were already using FramePort before the announcement's `date` (a first start never
-shows one, and nor does one published before FramePort was installed). Closing it in any way (the X, a click outside,
-Escape, its button) dismisses that `id` for good; a new announcement = a new id. No Flet here.
-"""
-from __future__ import annotations
-
-import datetime as dt
-import hashlib
-import logging
-import os
-import re
-import time
-from dataclasses import dataclass
-from pathlib import Path
-
-import yaml
-
-from . import REPO_URL
-from .core import cache, library
-from .core.paths import user_data_dir
-
-_log = logging.getLogger("frameport.announcements")
-
-REPO = REPO_URL.removeprefix("https://github.com/").strip("/")
-PATH = "announcements/current.md"
-RAW = f"https://raw.githubusercontent.com/{REPO}/main/"
-URL = RAW + PATH
-CHECK_EVERY = 6 * 3600
-KEEP_DISMISSED = 50          # ids remembered (oldest dropped)
-IMAGE_MAX = 5 * 2**20
-ID_RE = re.compile(r"^[A-Za-z0-9][A-Za-z0-9._-]{0,79}$")
-# settings only an earlier GUI run writes: one of them when announcements first run = an existing user (not
-# recipes.app_version: library.load() writes that on the very first load)
-USED_BEFORE = ("update.last_seen_version", "update.last_check", "ui.welcome_done", "ui.window")
-
-
-@dataclass(frozen=True)
-class Announcement:
-    id: str
-    title: str
-    body: str                  # Markdown
-    date: float                # unix time it was published
-    image: str | None = None   # https URL (repo paths are resolved to raw GitHub)
-    image_alt: str = ""
-    button: str | None = None  # optional action: label + url
-    url: str | None = None
-    expires: float | None = None
-
-
-class AnnouncementError(ValueError):
-    pass
-
-
-def _when(value, end_of_day: bool = False) -> float:
-    """A front-matter date (YAML date/datetime or ISO text) as unix time; a bare date is UTC midnight (or the end of
-    that day for `expires`). Naive times are UTC."""
-    if isinstance(value, str):
-        text = value.strip().replace("Z", "+00:00")
-        try:
-            value = dt.datetime.fromisoformat(text) if "T" in text or " " in text else dt.date.fromisoformat(text)
-        except ValueError as exc:
-            raise AnnouncementError(f"not a date: {value!r}") from exc
-    if isinstance(value, dt.datetime):
-        return (value if value.tzinfo else value.replace(tzinfo=dt.timezone.utc)).timestamp()
-    if isinstance(value, dt.date):
-        day = dt.datetime(value.year, value.month, value.day, tzinfo=dt.timezone.utc)
-        return (day + dt.timedelta(days=1 if end_of_day else 0)).timestamp()
-    raise AnnouncementError(f"not a date: {value!r}")
-
-
-def _link(value) -> str | None:
-    """An image/button target: https URLs as they are, a repo path (announcements/x.png) → its raw GitHub URL."""
-    if value in (None, ""):
-        return None
-    text = str(value).strip()
-    if text.startswith("https://"):
-        return text
-    if "://" in text or text.startswith(("/", "..")) or ".." in text.split("/"):
-        raise AnnouncementError(f"use an https URL or a path in the repo: {text!r}")
-    return RAW + text
-
-
-def parse(text: str | None) -> Announcement | None:
-    """The file's announcement; None when there is none (empty file, `active: false`). Raises AnnouncementError for a
-    malformed one (the app then shows nothing; tests/test_announcements.py checks the committed file)."""
-    if not text or not text.strip():
-        return None
-    m = re.match(r"\A?---\s*\n(.*?)\n---\s*(?:\n|\Z)(.*)\Z", text, re.S)
-    if not m:
-        raise AnnouncementError("missing the --- front matter")
-    try:
-        meta = yaml.safe_load(m.group(1)) or {}
-    except yaml.YAMLError as exc:
-        raise AnnouncementError(f"front matter: {exc}") from exc
-    if not isinstance(meta, dict):
-        raise AnnouncementError("front matter must be key: value lines")
-    active = meta.get("active", True)
-    if active is False and not meta.get("id"):
-        return None
-    if not isinstance(active, bool):
-        raise AnnouncementError("active: true or false")
-    unknown = set(meta) - {"id", "title", "date", "image", "image_alt", "button", "url", "expires", "active"}
-    if unknown:
-        raise AnnouncementError(f"unknown fields: {', '.join(sorted(unknown))}")
-    ident, title = str(meta.get("id") or "").strip(), str(meta.get("title") or "").strip()
-    if not ID_RE.match(ident):
-        raise AnnouncementError("id: letters, digits, '.', '_' or '-' (change it to show a new announcement)")
-    if not title:
-        raise AnnouncementError("title is required")
-    if "date" not in meta:
-        raise AnnouncementError("date is required (only people using FramePort before it see the announcement)")
-    button, url = meta.get("button"), meta.get("url")
-    if bool(button) != bool(url):
-        raise AnnouncementError("button and url go together")
-    if not active:  # switched off, but still checked (tests catch mistakes before it's switched on)
-        _check_dates(meta)
-        return None
-    return Announcement(id=ident, title=title, body=m.group(2).strip(), date=_when(meta["date"]),
-                        image=_link(meta.get("image")), image_alt=str(meta.get("image_alt") or ""),
-                        button=str(button).strip() if button else None, url=_link(url),
-                        expires=_when(meta["expires"], end_of_day=True) if meta.get("expires") else None)
-
-
-def _check_dates(meta: dict) -> None:
-    _when(meta["date"])
-    if meta.get("expires"):
-        _when(meta["expires"], end_of_day=True)
-    _link(meta.get("image"))
-    _link(meta.get("url"))
-
-
-def disabled() -> bool:
-    return bool(os.environ.get("FRAMEPORT_NO_ANNOUNCEMENTS"))
-
-
-def fetch(force: bool = False) -> Announcement | None:
-    """The current announcement (cached 6 h; offline → the last copy; never raises)."""
-    try:
-        return parse(cache.cached_text("announcement.md", URL, max_age=0 if force else CHECK_EVERY, fallback=""))
-    except Exception as exc:  # noqa: BLE001
-        _log.warning("announcement skipped: %s", exc)
-        return None
-
-
-# ------------------------------------------------------------------------------------------ who sees it
-def since() -> float:
-    """When this user started using FramePort, as far as announcements are concerned (setting announce.since). Set
-    once, the first time it's asked: 0 for someone who used FramePort before announcements existed, else now (a first
-    start). Call it early at start, before anything records this start in the settings."""
-    value = library.setting("announce.since")
-    if isinstance(value, (int, float)):
-        return float(value)
-    value = 0.0 if any(library.setting(k) is not None for k in USED_BEFORE) or library.games() else time.time()
-    library.set_setting("announce.since", value)
-    return value
-
-
-def dismissed() -> list[str]:
-    value = library.setting("announce.dismissed")
-    return [v for v in value if isinstance(v, str)] if isinstance(value, list) else []
-
-
-def dismiss(ident: str) -> None:
-    """Never show this announcement again (any way of closing it)."""
-    library.update_setting("announce.dismissed",
-                           lambda cur: ([v for v in (cur or []) if v != ident] + [ident])[-KEEP_DISMISSED:], [])
-
-
-def due(a: Announcement | None, now: float | None = None, user_since: float | None = None) -> bool:
-    """Whether to show `a` now: published, not expired, not dismissed, and published after this
-    user started using FramePort."""
-    if a is None:
-        return False
-    now = time.time() if now is None else now
-    if a.expires is not None and now >= a.expires:
-        return False
-    if a.date > now:  # scheduled for later
-        return False
-    if a.id in dismissed():
-        return False
-    return a.date > (since() if user_since is None else user_since)
-
-
-def image_file(a: Announcement) -> Path | None:
-    """The announcement's image, downloaded once into <data>/announcements/ and checked (Pillow); None without one or
-    when it can't be loaded (the pop-up then shows no image). Shown by asset URL like artwork, never as bytes."""
-    if not a.image:
-        return None
-    folder = user_data_dir() / "announcements"
-    stem = hashlib.sha256(a.image.encode()).hexdigest()[:16]
-    for done in folder.glob(f"{stem}.*"):
-        if done.suffix != ".part":
-            return done
-    try:
-        from PIL import Image
-
-        tmp = folder / f"{stem}.part"
-        cache.download(a.image, tmp)
-        if tmp.stat().st_size > IMAGE_MAX:
-            raise AnnouncementError("image larger than 5 MiB")
-        with Image.open(tmp) as im:
-            im.verify()
-            fmt = (im.format or "").lower()
-        ext = {"jpeg": ".jpg", "png": ".png", "webp": ".webp", "gif": ".gif"}.get(fmt)
-        if not ext:
-            raise AnnouncementError(f"image format {fmt or '?'} (use PNG, JPEG, WebP or GIF)")
-        out = folder / f"{stem}{ext}"
-        tmp.replace(out)
-        return out
-    except Exception as exc:  # noqa: BLE001
-        _log.warning("announcement image skipped: %s", exc)
-        (folder / f"{stem}.part").unlink(missing_ok=True)
-        return None
@@ -398,30 +398,6 @@ def rename(package: str = typer.Argument(..., help="the game (package or part of
            pipeline.sync_title(pkg, _target(None, to="pc"), rep)


-@app.command("new-version")
-def new_version(package: str = typer.Argument(..., help="the game (package or part of its title)"),
-                path: Path = typer.Argument(..., exists=True, help="the newer version: an APK (Quest/Android games), "
-                                            "an AppImage/archive/folder (Linux apps) or the game folder (PC VR)")):
-    """Point a game at a newer version of it (GitHub #161). Its name, artwork, tags and your own recipe stay; install
-    it again (frameport install) to update it on the Frame."""
-    [pkg] = _pkgs(package, False)
-    try:
-        res = pipeline.replace_source(pkg, path, printing_reporter(verbose=False))
-    except pipeline.WrongPackage as exc:
-        raise typer.BadParameter(f"that APK is a different app: {exc}") from None
-    except ValueError as exc:
-        raise typer.BadParameter(str(exc)) from None
-    g = res["entry"]
-    typer.echo(f"{pkg}: now {path}" + (f" (program {g.get('exe')})" if g.get("kind") in ("rift", "linux") else ""))
-    if res.get("older"):
-        typer.echo("Heads-up: that APK is an older version than the one before.", err=True)
-    if res.get("different"):
-        typer.echo(f"Heads-up: {res.get('name')} looks like a different app than {g.get('title')}.", err=True)
-    if g.get("kind") == "rift" and g.get("exe_confirmed") is False:
-        typer.echo(f"More than one program could start it; FramePort picked {g.get('exe')}. Another one: "
-                   f"frameport recipe {pkg} --exe <program>", err=True)
-
-
@app.command()
 def patches():
    """List every available patch."""
@@ -730,31 +706,6 @@ def frame_trust_key(frame: Optional[str] = typer.Option(None, help=FRAME_HELP)):
    typer.echo(f"connected: {info.get('hostname') or t.host} (new key saved)")


-@frame_app.command("ssh-keys")
-def frame_ssh_keys(add: list[str] = typer.Option([], "--add", help="a private key file to log in with too"),
-                   remove: list[str] = typer.Option([], "--remove", help="stop using this key file (it stays)")):
-    """Private SSH key files FramePort logs in with besides its own key (Settings → Installing → SSH keys): for a
-    Frame that accepts only your own key. The Frame connection and OpenSSH uploads both use them. Lists them."""
-    from .frame.connection import KeyFileError, add_extra_key, extra_key_status, remove_extra_key
-
-    failed = False
-    for path in remove:
-        typer.echo(f"removed {path}" if remove_extra_key(path) else f"not in the list: {path}")
-    for path in add:
-        try:
-            typer.echo(f"added {add_extra_key(path)}")
-        except KeyFileError as exc:
-            typer.echo(f"can't use {path}: {exc}", err=True)
-            failed = True
-    status = extra_key_status()
-    for path, problem in status:
-        typer.echo(f"{path}" + (f"  (not usable: {problem})" if problem else ""))
-    if not status:
-        typer.echo("no extra keys: FramePort's own key and your SSH agent's keys only")
-    if failed:
-        raise typer.Exit(1)
-
-
@frame_app.command("usb-check")
 def frame_usb_check(frame: Optional[str] = typer.Option(None, help=FRAME_HELP),
                    no_speed: bool = typer.Option(False, help="skip the upload speed test (2 × 128 MB)")):
@@ -1,8 +1,8 @@
 """SSH connection to a Steam Frame and the remote agent protocol.

 Authentication: FramePort's own keys first (<user data>/ssh/id_ed25519, installed by the bootstrap script, and
-id_rsa, registered through Valve's devkit pairing, which only takes RSA keys), then key files the user added in
-Settings (EXTRA_KEYS_SETTING), then the user's SSH agent/keys, then a password if given.
+id_rsa, registered through Valve's devkit pairing, which only takes RSA keys), then the user's SSH agent/keys, then a
+password if given.
 """
 from __future__ import annotations

@@ -163,96 +163,6 @@ def app_keys() -> list[paramiko.PKey]:
    return keys


-EXTRA_KEYS_SETTING = "ssh.extra_keys"  # library setting: private key files the user added (Settings → Installing)
-
-
-class KeyFileError(ValueError):
-    """A key file the user named can't be used (missing, not a private key, protected with a passphrase)."""
-
-
-def load_key_file(path) -> paramiko.PKey:
-    """A private key FramePort can log in with, or KeyFileError with a sentence saying why not."""
-    p = Path(path).expanduser()
-    if not p.is_file():
-        raise KeyFileError(f"{p}: file not found")
-    try:
-        return paramiko.PKey.from_path(p)
-    except (paramiko.SSHException, ValueError, OSError, UnicodeDecodeError, TypeError) as exc:
-        # paramiko says so with PasswordRequiredException (PEM) or a plain SSHException (OpenSSH format)
-        if isinstance(exc, paramiko.PasswordRequiredException) or "password" in str(exc).lower():
-            raise KeyFileError(f"{p.name} is protected with a passphrase, which FramePort can't ask for: add the "
-                               "key to your SSH agent instead (FramePort also logs in with the agent's keys)") from None
-        raise KeyFileError(f"{p.name} isn't a private SSH key FramePort can read "
-                           f"(OpenSSH or PEM format; a .pub file is the public half): {exc}") from None
-
-
-def extra_key_paths() -> list[Path]:
-    """The key files from Settings, as stored (each may be missing or unreadable by now: see extra_keys)."""
-    try:
-        from ..core import library
-
-        stored = library.peek_setting(EXTRA_KEYS_SETTING, [])
-    except Exception:  # noqa: BLE001 - no library yet
-        return []
-    if isinstance(stored, str):
-        stored = [stored]
-    paths: list[Path] = []
-    for value in stored if isinstance(stored, list) else []:
-        if isinstance(value, str) and value.strip():
-            p = Path(value.strip()).expanduser()
-            if p not in paths:
-                paths.append(p)
-    return paths
-
-
-def add_extra_key(path) -> Path:
-    """Check a key file (KeyFileError if FramePort can't use it) and add it to Settings. Returns the stored path."""
-    p = Path(path).expanduser()
-    if p.name.endswith(".pub") and p.with_name(p.name[:-4]).is_file():
-        raise KeyFileError(f"{p.name} is the public half: pick {p.name[:-4]} (the file without .pub) instead")
-    load_key_file(p)
-    p = p.resolve()
-    from ..core import library
-
-    library.update_setting(EXTRA_KEYS_SETTING, lambda old: [v for v in (old if isinstance(old, list) else [])
-                                                              if Path(v).expanduser() != p] + [str(p)], [])
-    return p
-
-
-def remove_extra_key(path) -> bool:
-    """Take a key file out of Settings (the file itself stays). False if it wasn't there."""
-    from ..core import library
-
-    p = Path(path).expanduser()
-    before = extra_key_paths()
-    library.update_setting(EXTRA_KEYS_SETTING, lambda old: [v for v in (old if isinstance(old, list) else [])
-                                                              if Path(v).expanduser() != p], [])
-    return p in before
-
-
-def extra_key_status() -> list[tuple[Path, str]]:
-    """Each key file from Settings with "" when usable, else why not (for Settings and the CLI)."""
-    status = []
-    for path in extra_key_paths():
-        try:
-            load_key_file(path)
-            status.append((path, ""))
-        except KeyFileError as exc:
-            status.append((path, str(exc)))
-    return status
-
-
-def extra_keys() -> list[tuple[Path, paramiko.PKey]]:
-    """The usable keys from Settings; unusable ones are logged and skipped (a login still tries the others)."""
-    keys = []
-    for path in extra_key_paths():
-        try:
-            keys.append((path, load_key_file(path)))
-        except KeyFileError as exc:
-            log.warning("SSH key from Settings skipped: %s", exc)
-    return keys
-
-
@dataclass
 class FrameTarget:
    host: str
@@ -499,10 +409,6 @@ class Frame:
    _video_codec_digest: str = ""  # "<manifest digest>:<on|off>" handled on this connection (incl. a failed install)
    _video_codec_lock: threading.Lock = field(default_factory=threading.Lock)
    home: str = ""
-    # how the last login worked: "app_key" (FramePort's own key), "user_key" (a key file from Settings),
-    # "agent" (this PC's SSH agent / ~/.ssh keys) or "password"; OpenSSH uploads follow it (native_upload)
-    auth: str = ""
-    openssh_relaxed: bool | None = None  # native_upload: True once OpenSSH needed this PC's own keys/agent

    # ------------------------------------------------------------------ connect
    def connect(self, timeout: float = 10) -> Frame:
@@ -553,8 +459,7 @@ class Frame:
        kwargs = dict(hostname=self.target.host, port=self.target.port, username=self.target.user, timeout=timeout,
                      banner_timeout=timeout, auth_timeout=timeout)
        errors = []
-        attempts = ([("app_key", k) for k in app_keys()] + [("user_key", k) for _, k in extra_keys()]
-                    + [("agent", None), ("password", None)])
+        attempts = [("app_key", k) for k in app_keys()] + [("agent", None), ("password", None)]
        for attempt, pkey in attempts:
            if attempt == "password" and not self.password:
                continue
@@ -562,7 +467,7 @@ class Frame:
            client.load_host_keys(str(known))
            client.set_missing_host_key_policy(paramiko.AutoAddPolicy())  # trust on first use (pairing)
            try:
-                if attempt in ("app_key", "user_key"):
+                if attempt == "app_key":
                    client.connect(pkey=pkey, allow_agent=False, look_for_keys=False, **kwargs)
                elif attempt == "agent":
                    client.connect(allow_agent=True, look_for_keys=True, **kwargs)
@@ -587,7 +492,6 @@ class Frame:
                raise
        else:
            raise FrameNotPaired(bool(self.password), errors)
-        self.auth = attempt
        client.save_host_keys(str(known))
        transport = client.get_transport()
        transport.set_keepalive(15)
@@ -2,9 +2,10 @@
 from __future__ import annotations

 import contextlib
+import csv
+import io
 import os
 import posixpath
-import re
 import shutil
 import signal
 import subprocess
@@ -12,30 +13,19 @@ import tarfile
 import tempfile
 import threading
 import time
-from pathlib import Path, PureWindowsPath
+from pathlib import Path

-from .connection import extra_keys, sh_quote, ssh_dir
+from .connection import sh_quote, ssh_dir


-def quote(value, windows=False) -> str:
-    """One sftp batch argument, taken literally.
-
-    Inside double quotes sftp escapes glob characters (* ? [) itself and undoes that for put's destination, so
-    they must NOT be escaped again: an extra backslash became part of the name (GitHub #324: "[ENG]" in a folder
-    name made every OpenSSH upload fail, on Linux too). Only backslash and the quote are escaped. ``windows``: a
-    local Windows path goes with forward slashes; Win32-OpenSSH's sftp turns every backslash of a local path into
-    '/', escapes included ("C:\\\\Users" → "C://Users").
-    """
+def quote(value) -> str:
    value = str(value)
    if any(c in value for c in "\r\n\x00"):
        raise ValueError("SFTP paths cannot contain newlines or NUL")
-    if windows:
-        value = PureWindowsPath(value).as_posix()
-    return '"' + value.replace("\\", "\\\\").replace('"', '\\"') + '"'
-
-
-def quote_local(path) -> str:
-    return quote(path, windows=os.name == "nt")
+    escaped = value.replace("\\", "\\\\").replace('"', '\\"')
+    for char in "*?[":
+        escaped = escaped.replace(char, "\\" + char)
+    return '"' + escaped + '"'


 def size_of(sftp, path):
@@ -45,74 +35,27 @@ def size_of(sftp, path):
        return 0


-def key_files(relaxed=False) -> list[Path]:
-    """The private keys OpenSSH offers: FramePort's own (<data>/ssh) and the usable key files from Settings;
-    ``relaxed`` also this PC's default keys (default_key_files)."""
-    keys = [ssh_dir() / name for name in ("id_ed25519", "id_rsa") if (ssh_dir() / name).exists()]
-    for path in [path for path, _ in extra_keys()] + (default_key_files() if relaxed else []):
-        if path not in keys:
-            keys.append(path)
-    return keys
-
-
-def default_key_files() -> list[Path]:
-    """This PC's own keys that Paramiko's "agent" login tries (look_for_keys: ~/.ssh/id_rsa, id_dsa, id_ecdsa,
-    id_ed25519; on Windows ~/ssh too), usable without a passphrase. OpenSSH needs them named: it skips its default
-    keys as soon as one -i is given, and Windows OpenSSH refuses a key file others can read (a private copy can't
-    be refused)."""
-    from .connection import KeyFileError, load_key_file
-
-    folders = [Path.home() / ".ssh"] + ([Path.home() / "ssh"] if os.name == "nt" else [])
-    found = []
-    for folder in folders:
-        for name in ("id_rsa", "id_dsa", "id_ecdsa", "id_ed25519"):
-            path = folder / name
-            if not path.is_file():
-                continue
-            try:
-                load_key_file(path)
-            except KeyFileError:
-                continue  # passphrase-protected or not a key: only the agent can use it
-            found.append(path)
-    return found
-
-
-def current_sid() -> str:
-    """This Windows account's SID. whoami prints in the console code page: read bytes, so a user name with
-    accents can't break decoding (only the ASCII SID is used)."""
-    out = subprocess.check_output(["whoami", "/user", "/fo", "csv", "/nh"], **hidden())
-    match = re.search(rb"S-1-[0-9]+(?:-[0-9]+)+", out)
-    if not match:
-        raise OSError("cannot find this Windows account's SID for the key copies' permissions")
-    return match.group().decode()
-
-
@contextlib.contextmanager
-def credentials(frame, port_flag="-P", relaxed=False):
-    """OpenSSH arguments that log in like the Frame connection and trust only the host key it pinned.
-
-    Keys are offered as private temporary copies (that avoids modifying pairing keys, including their Windows
-    ACLs; Windows OpenSSH refuses key files others can read). Strict (default): FramePort's keys and the key
-    files from Settings only (IdentitiesOnly). ``relaxed``: also this PC's default ~/.ssh keys and SSH agent, the
-    way Paramiko's "agent" login does (GitHub #242: a Frame that only authorizes the user's own key). Verbose
-    (-v), so a refused login can say which keys were offered (failure()).
-    """
-    key_paths = key_files(relaxed)
-    if not key_paths and not relaxed:
+def credentials(frame, port_flag="-P"):
+    """Private temporary copies avoid modifying pairing keys, including their Windows ACLs."""
+    key_paths = [ssh_dir() / name for name in ("id_ed25519", "id_rsa") if (ssh_dir() / name).exists()]
+    if not key_paths:
        raise OSError("no FramePort key available for OpenSSH")
    key = frame.client.get_transport().get_remote_server_key()
    with tempfile.TemporaryDirectory(prefix="frameport-upload-") as directory:
        directory = Path(directory)
        sid = None
        if os.name == "nt":
-            sid = current_sid()
+            row = next(csv.reader(io.StringIO(subprocess.check_output(
+                ["whoami", "/user", "/fo", "csv", "/nh"], text=True, **hidden()))))
+            sid = row[-1]
            subprocess.run(["icacls", str(directory), "/inheritance:r", "/grant:r", f"*{sid}:(OI)(CI)F"],
                           check=True, stdout=subprocess.DEVNULL, **hidden())
        else:
            directory.chmod(0o700)
        copies = []
-        for n, path in enumerate(key_paths):
-            copy = directory / f"key{n}"  # own names: a key from Settings may be called id_ed25519 too
+        for path in key_paths:
+            copy = directory / path.name
            shutil.copyfile(path, copy)
            if sid:
                subprocess.run(["icacls", str(copy), "/inheritance:r", "/remove:g", "*S-1-3-4",
@@ -123,72 +66,13 @@ def credentials(frame, port_flag="-P", relaxed=False):
        known = directory / "known_hosts"
        host = frame.target.host if frame.target.port == 22 else f"[{frame.target.host}]:{frame.target.port}"
        known.write_text(f"{host} {key.get_name()} {key.get_base64()}\n")
-        yield ["-F", os.devnull, "-v", *copies, "-o", "BatchMode=yes",
-               *([] if relaxed else ["-o", "IdentitiesOnly=yes"]),
+        yield ["-F", os.devnull, *copies, "-o", "BatchMode=yes", "-o", "IdentitiesOnly=yes",
               "-o", "StrictHostKeyChecking=yes", "-o", f'UserKnownHostsFile="{known.as_posix()}"',
               "-o", f"GlobalKnownHostsFile={os.devnull}", "-o", "ConnectTimeout=10",
               "-o", "ServerAliveInterval=10", "-o", "ServerAliveCountMax=3",
               port_flag, str(frame.target.port)]


-class OpenSSHAuthFailed(OSError):
-    """OpenSSH reached the Frame but the login was refused (the keys it offered aren't authorized there)."""
-
-
-AUTH_REFUSED = ("Permission denied (", "Too many authentication failures", "No more authentication methods")
-# debug lines (-v) worth keeping: which keys were found, offered, refused or unreadable
-AUTH_DEBUG = ("identity file", "Offering public key", "Server accepts key", "Will attempt key",
-              "Authentications that can continue", "Authenticated to", "Load key", "no such identity",
-              "Skipping", "agent", "Next authentication method")
-
-
-def failure(what: str, code, stderr: bytes) -> OSError:
-    """The error for a failed OpenSSH run: OpenSSH's own messages (all non-debug lines: warnings such as
-    "UNPROTECTED PRIVATE KEY FILE" included) plus the -v lines about keys; OpenSSHAuthFailed for a refused login."""
-    text = stderr.decode(errors="replace").replace("\r\n", "\n")
-    lines = [line for line in text.splitlines() if line.strip() and (
-        not line.startswith("debug") or any(k in line for k in AUTH_DEBUG))]
-    detail = "\n".join(lines)
-    if len(detail) > 4000:
-        detail = "…" + detail[-4000:]
-    refused = code == 255 and any(marker in text for marker in AUTH_REFUSED)
-    return (OpenSSHAuthFailed if refused else OSError)(f"{what} failed ({code}): {detail}")
-
-
-def login_modes(frame) -> list[bool]:
-    """How OpenSSH logs in, in order (False = FramePort's keys only, True = also this PC's keys and agent).
-
-    A Frame connection that logged in with this PC's own keys/agent (Paramiko's "agent" attempt) goes straight to
-    relaxed: FramePort's key isn't authorized there. Else strict first, relaxed once more after a refused login.
-    A mode that worked is kept for the rest of the connection. FramePort doesn't add its key to the Frame for
-    this: it only does that after a password login, where the user typed the Frame's password for it."""
-    known = getattr(frame, "openssh_relaxed", None)
-    if known is not None:
-        return [bool(known)]
-    if getattr(frame, "auth", "") == "agent":
-        return [True]
-    return [False, True]
-
-
-def with_login_modes(frame, reporter, run):
-    """run(relaxed) in each login mode until one isn't refused (see login_modes)."""
-    modes = login_modes(frame)
-    if modes == [True] and getattr(frame, "openssh_relaxed", None) is None:
-        reporter.log("the Frame connection logged in with this PC's own SSH keys or agent: OpenSSH uses them too")
-    for n, relaxed in enumerate(modes):
-        try:
-            result = run(relaxed)
-        except OpenSSHAuthFailed as exc:
-            if n == len(modes) - 1:
-                raise
-            reporter.log(f"OpenSSH login with FramePort's SSH keys was refused; trying this PC's own SSH keys and "
-                         f"agent too. {exc}")
-            continue
-        with contextlib.suppress(AttributeError):
-            frame.openssh_relaxed = relaxed
-        return result
-
-
 def hidden():
    return {"creationflags": subprocess.CREATE_NO_WINDOW} if os.name == "nt" else {}

@@ -215,11 +99,6 @@ def upload(frame, items, remote_root, reporter, total, sent, workers):
    Only successful batches are promoted, after every process has exited successfully. All control operations
    happen in the supervising thread, so Paramiko's SFTP client is never shared across threads.
    """
-    return with_login_modes(frame, reporter, lambda relaxed: _upload(
-        frame, items, remote_root, reporter, total, sent, workers, relaxed))
-
-
-def _upload(frame, items, remote_root, reporter, total, sent, workers, relaxed):
    executable = shutil.which("sftp")
    if not executable:
        raise OSError("system OpenSSH SFTP is unavailable")
@@ -232,7 +111,7 @@ def _upload(frame, items, remote_root, reporter, total, sent, workers, relaxed):
    sizes, offsets, progress = {}, {}, {}
    for path, rel, size in sorted(items, key=lambda item: item[2], reverse=True):
        remote = posixpath.join(remote_root, rel)
-        quote_local(path)
+        quote(path)
        quote(remote)
        offset = size_of(frame.sftp, remote + ".part")
        if offset > size:
@@ -248,7 +127,7 @@ def _upload(frame, items, remote_root, reporter, total, sent, workers, relaxed):
    speed = Speed(total - sent - sum(offsets.values()))
    reporter.log(f"uploading large files with OpenSSH SFTP ({len(groups)} workers)")
    setup_started = time.monotonic()
-    with credentials(frame, relaxed=relaxed) as args, contextlib.ExitStack() as stack:
+    with credentials(frame) as args, contextlib.ExitStack() as stack:
        monitor = stack.enter_context(frame.client.open_sftp())
        monitor.get_channel().settimeout(2)
        reporter.log(f"OpenSSH credentials and progress connection ready in {time.monotonic() - setup_started:.2f}s")
@@ -260,7 +139,7 @@ def _upload(frame, items, remote_root, reporter, total, sent, workers, relaxed):
                for path, rel, _ in group:
                    remote = posixpath.join(remote_root, rel) + ".part"
                    command = "reput" if offsets[rel] else "put"
-                    batch.write(f"{command} {quote_local(path)} {quote(remote)}\n".encode())
+                    batch.write(f"{command} {quote(path)} {quote(remote)}\n".encode())
                batch.seek(0)
                errors = stack.enter_context(tempfile.TemporaryFile())
                process = subprocess.Popen([executable, *args, "-b", "-",
@@ -273,7 +152,8 @@ def _upload(frame, items, remote_root, reporter, total, sent, workers, relaxed):
                for process, errors in processes:
                    if process.poll() not in (None, 0):
                        errors.seek(0)
-                        raise failure("OpenSSH SFTP", process.returncode, errors.read())
+                        detail = errors.read().decode(errors="replace")[-1500:]
+                        raise OSError(f"OpenSSH SFTP failed ({process.returncode}): {detail}")
                for rel, size in sizes.items():
                    reporter.check_cancel()
                    progress[rel] = max(progress[rel], min(size, size_of(
@@ -307,16 +187,11 @@ def _upload(frame, items, remote_root, reporter, total, sent, workers, relaxed):

 def put_tar(frame, files, remote_root, reporter, progress):
    """Stream a tar batch over paired OpenSSH; supervise writes so Cancel also stops a blocked pipe."""
-    return with_login_modes(frame, reporter,
-                            lambda relaxed: _put_tar(frame, files, remote_root, reporter, progress, relaxed))
-
-
-def _put_tar(frame, files, remote_root, reporter, progress, relaxed):
    executable = shutil.which("ssh")
    if not executable:
        raise OSError("system OpenSSH SSH is unavailable")
    reporter.check_cancel()
-    with credentials(frame, port_flag="-p", relaxed=relaxed) as args, tempfile.TemporaryFile() as errors:
+    with credentials(frame, port_flag="-p") as args, tempfile.TemporaryFile() as errors:
        command = f"mkdir -p {sh_quote(remote_root)} && tar -xf - -C {sh_quote(remote_root)}"
        process = subprocess.Popen([executable, *args, f"{frame.target.user}@{frame.target.host}", command],
                                   stdin=subprocess.PIPE, stdout=subprocess.DEVNULL, stderr=errors,
@@ -347,14 +222,12 @@ def _put_tar(frame, files, remote_root, reporter, progress, relaxed):
                if not writer.is_alive() and process.poll() is None:
                    time.sleep(0.1)
            reporter.check_cancel()
-            if failures and process.poll() is None:  # a refused login shows as a broken pipe first
-                with contextlib.suppress(subprocess.TimeoutExpired):
-                    process.wait(timeout=2)
-            if process.poll() not in (None, 0):
-                errors.seek(0)
-                raise failure("OpenSSH tar", process.returncode, errors.read())
            if failures:
                raise failures[0]
+            if process.poll() != 0:
+                errors.seek(0)
+                raise OSError(f"OpenSSH tar failed ({process.returncode}): "
+                              + errors.read().decode(errors="replace")[-1500:])
        finally:
            stop_process(process)
            writer.join()
@@ -220,28 +220,6 @@ class PcvrPlan:
    art_lookup: str | None = None  # package whose store art to use
    dest: str | None = None
    overlay: dict | None = None  # a SteamVR overlay app: the agent's overlay argument (analysis/vroverlay.py)
-    source_id: str | None = None  # which version of the game folder (GitHub #161: a newer one was added)
-    changed_since: float | None = None  # a newer version: game files changed after this are sent again (see below)
-
-
-def changed_since(path: Path, since: float | None) -> bool:
-    """A newer version of a Linux app / PC VR game (GitHub #161): uploads skip files the Frame has with the same
-    size, so a changed file of the same size would stay old. Files written (or unpacked: ctime) after the last
-    install are sent again; since=None (no newer version) never, 0 (last install unknown) always."""
-    if since is None:
-        return False
-    try:
-        st = path.stat()
-    except OSError:
-        return True
-    return max(st.st_mtime, st.st_ctime) > since
-
-
-def _recipe_record(recipe: dict | None, source_id: str | None) -> dict | None:
-    """The deployment's recipe record, with the source version it was installed from (ui.components.source_replaced)."""
-    if not source_id:
-        return recipe
-    return {**(recipe or {}), "source_id": source_id}


 def install_pcvr(frame: Frame, plan: PcvrPlan, reporter: Reporter) -> dict:
@@ -281,8 +259,7 @@ def install_pcvr(frame: Frame, plan: PcvrPlan, reporter: Reporter) -> dict:
        manifests["helpers"] = {p.name: p.stat().st_size for p in sorted(helpers.iterdir()) if p.is_file()}
        sources["helpers"] = helpers
    to_send = [(t, rel) for t, m in manifests.items() for rel, size in m.items()
-               if prep["existing"].get(t, {}).get(rel) != size
-               or t == "game" and changed_since(plan.game_dir / rel, plan.changed_since)]
+               if prep["existing"].get(t, {}).get(rel) != size]
    need = sum(manifests[t][rel] for t, rel in to_send)
    if need > prep["free_bytes"] - (1 << 30):
        raise RuntimeError(f"not enough space on the Frame: need {need / 2**30:.1f} GiB + 1 GiB headroom, "
@@ -313,8 +290,7 @@ def install_pcvr(frame: Frame, plan: PcvrPlan, reporter: Reporter) -> dict:
        game_args=game_args(plan.recipe), no_crash_reporter="pcvr.no_crash_reporter" in plan.recipe.patches,
        libovr_redirect="pcvr.libovr_redirect" in plan.recipe.patches,
        exe_sha256=plan.exe_sha256, revive_version=plan.revive_version, vr=not is_flat_windows(plan.package),
-        recipe=_recipe_record({"patches": sorted(plan.recipe.patches), "source": plan.recipe.source}, plan.source_id),
-        overlay=plan.overlay,
+        recipe={"patches": sorted(plan.recipe.patches), "source": plan.recipe.source}, overlay=plan.overlay,
    )
    reporter.log(f"installed at {result['base']} (Proton {result['proton']}, Steam shortcut id {result['appid']})")
    log_overlay(result.get("overlay"), reporter)
@@ -349,8 +325,6 @@ class LinuxPlan:
    desktop_entry: bool = True  # an entry in Desktop Mode's menu and on its desktop (GitHub #84)
    desktop_icon: bool = True  # with it, a copy on Desktop Mode's desktop (GitHub #212)
    overlay: dict | None = None  # a SteamVR overlay app: the agent's overlay argument (analysis/vroverlay.py)
-    source_id: str | None = None  # which version of the app (GitHub #161: a newer one was added)
-    changed_since: float | None = None  # a newer version: files changed after this are sent again


 def install_linux(frame: Frame, plan: LinuxPlan, reporter: Reporter) -> dict:
@@ -365,8 +339,7 @@ def install_linux(frame: Frame, plan: LinuxPlan, reporter: Reporter) -> dict:
    else:
        manifest = local_data_manifest(plan.root)
        manifest = {k: v for k, v in manifest.items() if not k.startswith(".unpacked")}
-    to_send = [rel for rel, size in manifest.items() if prep["existing"].get("app", {}).get(rel) != size
-               or changed_since(plan.root / rel, plan.changed_since)]
+    to_send = [rel for rel, size in manifest.items() if prep["existing"].get("app", {}).get(rel) != size]
    need = sum(manifest[rel] for rel in to_send)
    if need > prep["free_bytes"] - (1 << 30):
        raise RuntimeError(f"not enough space on the Frame: need {need / 2**30:.1f} GiB + 1 GiB headroom, "
@@ -385,7 +358,7 @@ def install_linux(frame: Frame, plan: LinuxPlan, reporter: Reporter) -> dict:
                         appimage=plan.appimage, openxr=plan.openxr, x86_64=plan.x86_64, manifests={"app": manifest},
                         executables=executables, tags=_tags(plan.package), dest=plan.dest,
                         desktop_entry=plan.desktop_entry, desktop_icon=plan.desktop_icon, overlay=plan.overlay,
-                         recipe=_recipe_record(None, plan.source_id), timeout=900)
+                         timeout=900)
    reporter.log(f"installed at {result['base']} (Steam shortcut id {result['appid']})")
    log_overlay(result.get("overlay"), reporter)
    apply_app_icon(frame, plan.package, prep.get("anchor"), result, reporter)
@@ -94,7 +94,6 @@
 "AC Nexus: no AppSW at 72 Hz": "",
 "AC Nexus: no AppSW at 90 Hz": "",
 "Activity": "",
- "Add a key file…": "",
 "Add a Linux app folder…": "",
 "Add a Linux app…": "",
 "Add a PC game folder…": "",
@@ -174,7 +173,7 @@
 "Appearance": "",
 "AppImage": "",
 "Apply with Update on Frame.": "",
- "Apps that suggest controller bindings only for Meta's newer profiles (Touch Plus, Touch Pro), which the Frame's runtime rejects (XR_ERROR_PATH_UNSUPPORTED), get the same bindings as oculus/touch_controller instead (components Touch lacks are dropped). Without it such apps get no controller input.": "",
+ "Apps that suggest controller bindings only for Meta's newer profiles (Touch Plus, Touch Pro), which the Frame's runtime rejects (XR_ERROR_PATH_UNSUPPORTED), get the same bindings as oculus/touch_controller instead (components Touch lacks are dropped), and the runtime's answer for each hand is reported to them as their own profile (Unity's OpenXR input only connects controllers of a profile it knows). Meta's detached-controller paths (XR_META_detached_controllers, which the Frame lacks) are left out of the app's actions and bindings: one such path made Unity attach no controller input at all. Without it such apps get no controller input.": "",
 "Artwork for {get}": "",
 "Artwork updated ({src}). The Frame's Steam library still shows the old art.": "",
 "Artwork updated for {get}": "",
@@ -558,7 +557,6 @@
 "Frame OpenXR compatibility layer": "",
 "FrameBridge OpenXR adapter": "",
 "FramePort": "",
- "FramePort also logs in with {name} from the next connection.": "",
 "FramePort can't update itself in {value} (no permission) — opening the release page to download it": "",
 "FramePort changelog": "",
 "FramePort checks GitHub for a new version every few hours. Update now downloads and checks it, then restarts FramePort; your games and settings stay.": "",
@@ -570,7 +568,6 @@
 "FramePort isn't sure which program starts this game. Open the game and use … → Change program… to pick it.": "",
 "FramePort keeps its own copies; nothing is installed system-wide": "",
 "FramePort live view": "",
- "FramePort logs in to the Frame with its own key. If your Frame accepts only one of your own keys, add that private key file here; fast uploads use it too. A key with a passphrase: add it to your SSH agent instead.": "",
 "FramePort looked at your last session of {n} game and has something to try.": [
  "",
  ""
@@ -667,7 +664,6 @@
 "Hardware video decoding (H.264, HEVC, VP9)": "",
 "Hardware video decoding on the Frame": "",
 "Heads-up: that APK is an older version than the one before.": "",
- "Heads-up: {name} looks like a different app than {title}.": "",
 "headset found": "",
 "Hi there!": "",
 "Hide Android's navigation bar": "",
@@ -945,8 +941,6 @@
 "New recipe applied. Click Update on Frame to install it.": "",
 "Newer APK for {title}": "",
 "Newer APK of {title}": "",
- "Newer version for {title}": "",
- "Newer version of {title}": "",
 "Next": "",
 "Nice, it works! FramePort receives install links. (Demo: nothing was installed.)": "",
 "No": "",
@@ -1032,7 +1026,6 @@
 "On your Frame": "",
 "on: {names}": "",
 "One PC game folder": "",
- "Only FramePort's own key, and your SSH agent's keys.": "",
 "Only if 360° pictures show wrongly.": "",
 "Only if 360° pictures show wrongly: 1 = upside down, 2 = mirrored, 4 = turned around (add values to combine).": "",
 "Only install software from sites you trust. FramePort downloads it from {host} and installs it on your Frame.": "",
@@ -1145,7 +1138,6 @@
 "Pretty smooth": "",
 "Prevents a start-up crash in some Unreal games.": "",
 "Previous": "",
- "Private SSH key file (not the .pub file)": "",
 "Problems and feedback": "",
 "Processes": "",
 "Processor": "",
@@ -1181,7 +1173,6 @@
 "Reading the file list from the Frame…": "",
 "Reading the install link": "",
 "Reading the new APK": "",
- "Reading the new version": "",
 "ready": "",
 "Ready": "",
 "Ready to play": "",
@@ -1421,7 +1412,6 @@
 "Sound on": "",
 "Source": "",
 "square, 256 × 256": "",
- "SSH keys": "",
 "Stable (default)": "",
 "Stand in for cube layers": "",
 "Standard for every game": "",
@@ -1472,7 +1462,6 @@
 "Stereo (3D) 360° layers: 0 = as the game sends them, 2 = flat (the left image to both eyes).": "",
 "Stop": "",
 "Stop objects popping in and out": "",
- "Stop using this key (the file stays)": "",
 "Stopped: {why}": "",
 "Stops a black picture in Minecraft launchers (for example QuestCraft).": "",
 "Stops a crash a few seconds after start in some Unreal games with anti-aliasing (for example Star Wars Pinball VR).": "",
@@ -1524,7 +1513,6 @@
 "Test Proton on the Frame": "",
 "Text and layout size": "",
 "That APK is a different app, not {title}.": "",
- "That key can't be used: {error}": "",
 "That theme file can't be used: {error}": "",
 "That's me!": "",
 "The APK file is damaged or incomplete. Get the game again and rescan the folder.": "",
@@ -1609,7 +1597,6 @@
 "This Frame's SSH key changed since FramePort last connected (SteamOS was reset, or another device now has its address). If it's your Frame, choose Trust the new key on the Steam Frame page.": "",
 "This game can't run on the Steam Frame.": "",
 "This game is marked \"Can't run\" on the Steam Frame:": "",
- "This is a Google {platform} VR build. Its VR can't reach the Frame's headset, so it runs as a flat window at best, usually without working controls. An Oculus build of the game (Meta Quest, Oculus Go or Gear VR) works the normal way.": "",
 "This is a website in an app: it opens in Meta's browser, which the Frame doesn't have. If nothing opens, visit the website in a browser.": "",
 "This is the example button from frameport.app. Real buttons install real games.": "",
 "this PC": "",
@@ -1724,7 +1711,6 @@
 "Update the app only?": "",
 "Update tools": "",
 "Update with a newer APK…": "",
- "Update with a newer version…": "",
 "Updates": "",
 "Updates every game marked \"Update ready\", one after another.": "",
 "Updates the game, frame rate and battery every 5 seconds. Turn off to save the Frame's power.": "",
@@ -1985,8 +1971,6 @@
 "{title}: name updated in Steam": "",
 "{title}: newer APK added": "",
 "{title}: newer APK added. Press Update on Frame to install it.": "",
- "{title}: newer version added": "",
- "{title}: newer version added. Press Update to install it.": "",
 "{title}: ready": "",
 "{title}: Steam artwork updated on the Frame": "",
 "{title}: {line}": "",
@@ -106,7 +106,10 @@ SETTINGS = [
    ("profile_remap", "int", 1, "Newer Touch profiles as Touch",
     "Apps that suggest controller bindings only for Meta's newer profiles (Touch Plus, Touch Pro), which the Frame's "
     "runtime rejects (XR_ERROR_PATH_UNSUPPORTED), get the same bindings as oculus/touch_controller instead "
-     "(components Touch lacks are dropped). Without it such apps get no controller input."),
+     "(components Touch lacks are dropped), and the runtime's answer for each hand is reported to them as their own "
+     "profile (Unity's OpenXR input only connects controllers of a profile it knows). Meta's detached-controller paths "
+     "(XR_META_detached_controllers, which the Frame lacks) are left out of the app's actions and bindings: one such "
+     "path made Unity attach no controller input at all. Without it such apps get no controller input."),
    ("haptic_scale", "float", 1.0, "Vibration strength",
     "Scales every controller vibration the game asks for (0-1): plain vibrations, Meta's amplitude envelopes and "
     "PCM buffers. For games whose vibrations feel much stronger than on a Quest."),
@@ -137,25 +137,18 @@ def _existing_rift(folder: Path) -> dict | None:


 def add_rift_game(folder: Path, reporter: Reporter | None = None, tree=None, exe: str | None = None,
-                  force: bool = False, art: bool = False, replace: dict | None = None) -> dict | None:
+                  force: bool = False, art: bool = False) -> dict | None:
    """Analyze one Rift game folder and store it. Unchanged folders (same program, size, date) are not analyzed again;
    the user's exe choice, recipe and tags survive rescans. Returns None for folders without a VR runtime (unless
-    force). replace: the library entry this folder is a newer version of (replace_rift_game): it keeps its package and
-    name."""
+    force)."""
    from .analysis import rift
    from .recommend import catalog

    folder = Path(folder)
-    if replace is None and not force and any(str(folder) in (g.get("replaced_dirs") or []) for g in library.games()
-                                             if g.get("kind") == "rift"):
-        if reporter:  # the older copy of a game updated from another folder: a rescan must not bring it back
-            reporter.log(f"skipped {folder.name}: an older version of a game that was updated from another folder")
-        return None
-    old = replace or _existing_rift(folder)
+    old = _existing_rift(folder)
    old_extra = ((old or {}).get("analysis") or {}).get("extra") or {}
-    forced = exe is not None or replace is not None  # set_exe / a newer version: always analyze
-    if replace is None:
-        exe = exe or (old.get("exe") if old and old.get("exe_confirmed") else None)
+    forced = exe is not None  # set_exe: always analyze with the user's choice
+    exe = exe or (old.get("exe") if old and old.get("exe_confirmed") else None)
    if old and not forced and old_extra.get("fingerprint") and \
            old_extra["fingerprint"] == rift.fingerprint(folder, old.get("exe") or ""):
        if reporter:
@@ -184,9 +177,7 @@ def add_rift_game(folder: Path, reporter: Reporter | None = None, tree=None, exe
                  suggested=library.recipe_to_dict(recipe))
    if not old or (old.get("recipe") or {}).get("source") != "user":
        fields.update(recipe=library.recipe_to_dict(recipe), status=recipe.status)
-    if replace is not None:
-        pass  # a newer version of the game: its name stays
-    elif not old or not (old.get("title_locked") or old.get("art_source") in ("oculusdb", "meta", "steam")):
+    if not old or not (old.get("title_locked") or old.get("art_source") in ("oculusdb", "meta", "steam")):
        fields["title"] = recipe.title or a.label  # (store-matched titles are kept)
    elif old.get("title_locked") and old.get("art_source") not in ("oculusdb", "meta", "steam"):
        fields["auto_title"] = recipe.title or a.label  # the user's name stays; a reset brings this one
@@ -409,20 +400,14 @@ def missing_obb(entry: dict) -> bool:
    return bool(extra.get("expects_obb")) and not (entry.get("data_dir") and entry.get("data_bytes") != 0)


-def add_linux_app(path: Path | str, reporter: Reporter | None = None, exe: str | None = None,
-                  replace: str | None = None) -> dict:
+def add_linux_app(path: Path | str, reporter: Reporter | None = None, exe: str | None = None) -> dict:
    """Add a Linux app to the library (no conversion: it's installed as it is): arm64, or x86_64 (run through FEX on
-    the Frame). `exe` overrides the program FramePort picked (relative to the app's folder). replace: the package of
-    the library entry this is a newer version of (replace_linux_app): it keeps that package, its name and its art."""
+    the Frame). `exe` overrides the program FramePort picked (relative to the app's folder)."""
    from .analysis import linux
    from .core.models import Recipe

    path = Path(path)
    info = linux.inspect(path)
-    if replace and not exe and not info["files"]:  # a folder: the program the app started before, if it's still there
-        before = (library.game(replace) or {}).get("exe")
-        if before and before != info["exe"] and (Path(info["root"]) / before).is_file():
-            exe = before
    if exe:
        info["exe"] = exe
    x86 = info["machine"] == linux.EM_X86_64
@@ -432,7 +417,7 @@ def add_linux_app(path: Path | str, reporter: Reporter | None = None, exe: str |
    if x86 and reporter:
        reporter.log(f"{path.name} is an x86_64 build: the Frame runs it through FEX (x86 translation; an arm64 "
                     "build runs faster if there is one)")
-    package = replace or f"linux.{linux.slug(info['title'])}"
+    package = f"linux.{linux.slug(info['title'])}"
    if reporter:
        reporter.log(f"{info['title']}: program {info['exe']}{' (AppImage)' if info['appimage'] else ''}"
                     f"{', OpenXR (VR)' if info['openxr'] else ''}")
@@ -454,8 +439,6 @@ def add_linux_app(path: Path | str, reporter: Reporter | None = None, exe: str |
    if not old:
        fields.update(title=info["title"], recipe=library.recipe_to_dict(recipe), status="unknown")
    library.upsert_game(package, **fields)
-    if replace:  # a newer version: the artwork stays as it is
-        return library.game(package)
    try:
        from .artwork import fetch

@@ -597,7 +580,7 @@ def install_linux(package: str, target: Target, reporter: Reporter, add_to_libra
                                  reporter, x86_64=bool(extra.get("x86_64")),
                                  desktop_entry=entry.get("desktop_entry", True) is not False,
                                  desktop_icon=entry.get("desktop_icon", True) is not False,
-                                  overlay=linux_overlay(entry), **_source_args(entry, target.label))
+                                  overlay=linux_overlay(entry))
    if extra.get("x86_64"):
        reporter.check("x86 translation", True, "runs through FEX on SteamOS's x86 system (its libraries come from "
                                                 "there; not checked ahead)")
@@ -608,23 +591,10 @@ def install_linux(package: str, target: Target, reporter: Reporter, add_to_libra
        reporter.check("Libraries on the Frame", True, "everything the app needs is there")
    if add_to_library:
        target.add_to_library([package], reporter)
-    _record_install(package, target.label, {"exe": entry["exe"], "result": result, "time": time.time(),
-                                            "source_id": entry.get("source_id")})
+    _record_install(package, target.label, {"exe": entry["exe"], "result": result, "time": time.time()})
    return result


-def _source_args(entry: dict, label: str) -> dict:
-    """source_id (recorded with the install) and changed_since for a Linux app / PC VR game install: after a newer
-    version was added (replace_linux_app/replace_rift_game), files changed since the last install there are sent
-    again even when the Frame has a file of the same size (0 = the last install is unknown: every file)."""
-    sid = entry.get("source_id")
-    if not sid:
-        return {}
-    rec = (entry.get("installs") or {}).get(label) or {}
-    return {"source_id": sid,
-            "changed_since": None if rec.get("source_id") == sid else float(rec.get("time") or 0)}
-
-
 def add_game(src: SourceGame, reporter: Reporter | None = None) -> dict:
    if reporter:
        reporter.log(f"analyzing {src.apk.name}")
@@ -692,85 +662,6 @@ def replace_apk(package: str, apk: Path, reporter: Reporter | None = None) -> di
            "new_version": new_vc}


-def _looks_different(before: str | None, now: str | None) -> bool:
-    """A newer version whose name has little in common with the old one's (maybe another app): the caller warns."""
-    import difflib
-
-    a, b = _norm_title(before or ""), _norm_title(now or "")
-    if not a or not b or a in b or b in a:
-        return False
-    return difflib.SequenceMatcher(None, a, b).ratio() < 0.5
-
-
-def _mark_source_replaced(package: str, **fields) -> dict:
-    """A Linux app or PC VR game got a newer version: a new source id, which installs record (in the deployment's
-    recipe); an install without it shows the game as outdated (ui.components.source_replaced)."""
-    import uuid
-
-    return library.upsert_game(package, source_id=uuid.uuid4().hex[:12], source_updated=time.time(), **fields)
-
-
-def replace_linux_app(package: str, path: Path | str, reporter: Reporter | None = None) -> dict:
-    """A newer version of a Linux app already in the library (GitHub #161): an AppImage/archive or a folder, analysed
-    like "Add a Linux app…" (program, arm64/x86_64, AppImage, OpenXR). The app keeps its package (so its Steam
-    shortcut on the Frame), name, artwork, tags and switches (Desktop Mode entry, overlay app); a folder keeps the
-    program chosen before if it's still there. Returns {"entry", "different": its name looks like another app's,
-    "name": the new version's own name}."""
-    entry = library.game(package)
-    if entry is None or not is_linux(entry):
-        raise ValueError("only Linux apps can get a newer version this way")
-    before = ((entry.get("analysis") or {}).get("label")) or entry.get("title")
-    old_source = ((entry.get("analysis") or {}).get("extra") or {}).get("source")
-    if reporter:
-        reporter.log(f"reading {Path(path).name}")
-    stored = add_linux_app(path, reporter, replace=package)
-    name = (stored.get("analysis") or {}).get("label")
-    stored = _mark_source_replaced(package, replaced_source=old_source)
-    return {"entry": stored, "different": _looks_different(before, name), "name": name}
-
-
-def replace_rift_game(package: str, folder: Path | str, reporter: Reporter | None = None) -> dict:
-    """A newer version of a PC VR (Rift) game already in the library (GitHub #161): its new game folder, analysed like
-    a scanned one (programs, VR runtimes, fingerprint). The game keeps its package, name, artwork, tags and the user's
-    own recipe; a program the user confirmed stays if the new folder has it at the same place, else FramePort picks
-    one again (exe_confirmed False when that's unclear: the caller asks). The old folder is left out of later scans.
-    Returns {"entry", "different", "name", "exe_changed"}."""
-    entry = library.game(package)
-    if entry is None or not is_rift(entry):
-        raise ValueError("only PC VR games can get a newer version folder")
-    folder = Path(folder)
-    if not folder.is_dir():
-        raise ValueError(f"{folder} isn't a folder")
-    other = _existing_rift(folder)
-    if other and other["package"] != package:
-        raise ValueError(f"{folder.name} is already in the library as {other.get('title') or other['package']}")
-    before = (entry.get("analysis") or {}).get("label") or entry.get("title")
-    old_dir, old_exe = entry.get("game_dir"), entry.get("exe")
-    keep = old_exe if entry.get("exe_confirmed") and old_exe and (folder / old_exe).is_file() else None
-    stored = add_rift_game(folder, reporter, exe=keep, force=True, replace=entry)
-    if stored is None:
-        raise ValueError(f"no game program found in {folder.name}")
-    replaced = [d for d in (entry.get("replaced_dirs") or []) + [old_dir] if d and d != str(folder)]
-    # build=None: the next install checks the new folder first (prepare_rift); the exe's checksum comes from there
-    stored = _mark_source_replaced(package, build=None, replaced_dirs=list(dict.fromkeys(replaced)))
-    name = (stored.get("analysis") or {}).get("label")
-    return {"entry": stored, "different": _looks_different(before, name), "name": name,
-            "exe_changed": stored.get("exe") != old_exe}
-
-
-def replace_source(package: str, path: Path | str, reporter: Reporter | None = None) -> dict:
-    """A newer version of any game in the library: an APK (Quest/Android), an app file or folder (Linux) or a game
-    folder (PC VR). See replace_apk, replace_linux_app, replace_rift_game."""
-    entry = library.game(package)
-    if entry is None:
-        raise ValueError(f"{package} isn't in the library")
-    if is_linux(entry):
-        return replace_linux_app(package, path, reporter)
-    if is_rift(entry):
-        return replace_rift_game(package, path, reporter)
-    return replace_apk(package, Path(path), reporter)
-
-
 def _analyze_entry(entry: dict, reporter: Reporter | None = None):
    src = source_of(entry)
    if reporter:
@@ -1384,11 +1275,10 @@ def install_rift(package: str, target: Target, reporter: Reporter, add_to_librar
    result = target.install_pcvr(package, title, Path(entry["game_dir"]), entry["exe"], recipe, reporter,
                                 revive_dir=rdir, revive_version=revive.installed_version() if rdir else None,
                                 exe_sha256=entry["build"].get("sha256"), art_lookup=entry.get("quest_package"),
-                                 overlay=rift_overlay(entry, recipe), **_source_args(entry, target.label))
+                                 overlay=rift_overlay(entry, recipe))
    if add_to_library:
        target.add_to_library([package], reporter)
-    _record_install(package, target.label, {"exe": entry["exe"], "result": result, "time": time.time(),
-                                            "source_id": entry.get("source_id")})
+    _record_install(package, target.label, {"exe": entry["exe"], "result": result, "time": time.time()})
    return result


@@ -246,23 +246,10 @@ def web_wrapper_note(analysis: Analysis) -> str | None:
            f"Meta's browser, which the Frame doesn't have. If nothing opens, {where}.")


-def google_vr_note(analysis: Analysis) -> str | None:
-    """A Google Daydream / Cardboard build (analysis.detect.google_vr) that isn't also a Meta build: its VR can't
-    reach the Frame's headset (GitHub #335)."""
-    kind = (analysis.extra or {}).get("google_vr")
-    if not kind or analysis.vr_kind == "quest":  # a build with Oculus support too goes the normal way
-        return None
-    name = "Google Daydream" if kind == "daydream" else "Google Cardboard"
-    return (f"This is a {name} VR build (Google VR SDK). Its VR can't reach the Steam Frame's headset: Daydream "
-            "needs Google's VR services and Cardboard draws for a phone in a viewer, and FramePort has no "
-            "translation for either, so it runs as a flat window at best, usually without working controls. An "
-            "Oculus build of the same game (Meta Quest, Oculus Go or Gear VR) goes through FramePort's normal path.")
-
-
 def blocker_notes(analysis: Analysis) -> list[str]:
    """Warnings read from the APK's manifest that it may not run on the Frame (whatever the recipe says). Only
    warnings: the manifest alone never marks a game unsupported (owner's rule); a launch test's triage decides."""
-    return [n for n in (android_version_note(analysis), web_wrapper_note(analysis), google_vr_note(analysis)) if n]
+    return [n for n in (android_version_note(analysis), web_wrapper_note(analysis)) if n]


 def _static_blockers(analysis: Analysis, recipe: Recipe) -> None:
@@ -287,8 +274,7 @@ def _non_quest(analysis: Analysis, recipe: Recipe) -> None:
        recipe.reasons = {pid: v for pid, v in recipe.reasons.items() if pid in recipe.patches}
        recipe.alt_patches = []
        recipe.as_is = not any(base.get(pid).stage == "apk" for pid in recipe.patches)  # the APK stays unchanged
-        if not (analysis.extra or {}).get("google_vr"):  # a Google VR build says so in its own note (blocker_notes)
-            recipe.notes = _add(recipe.notes, "Android app without VR: installed without FramePort's VR translation.")
+        recipe.notes = _add(recipe.notes, "Android app without VR: installed without FramePort's VR translation.")
    elif kind in ("pico_sdk", "wave"):
        recipe.status = "unsupported"
        recipe.notes = _add(recipe.notes, f"Uses {'Pico' if kind == 'pico_sdk' else 'HTC Vive Wave'}'s own VR SDK "
@@ -36,8 +36,7 @@ class Target(ABC):
        raise NotImplementedError(f"{self.label} can't launch games")

    def install_linux(self, package, title, root, exe, files, appimage, openxr, reporter, x86_64=False,
-                      desktop_entry=True, overlay=None, desktop_icon=True, source_id=None,
-                      changed_since=None) -> dict:
+                      desktop_entry=True, overlay=None, desktop_icon=True) -> dict:
        """Install a Linux app (only the Frame runs them; x86_64 ones through FEX)."""
        raise NotImplementedError(f"{self.label} can't install Linux apps")

@@ -86,15 +86,14 @@ class FrameLeptonTarget(Target):
    def install_pcvr(self, package, title, game_dir, exe, recipe, reporter, **extra):
        plan = installer.PcvrPlan(package, title, Path(game_dir), exe, recipe, extra.get("revive_dir"),
                                  extra.get("exe_sha256"), extra.get("revive_version"), extra.get("art_lookup"),
-                                  dest=self.install_dest(), overlay=extra.get("overlay"),
-                                  source_id=extra.get("source_id"), changed_since=extra.get("changed_since"))
+                                  dest=self.install_dest(), overlay=extra.get("overlay"))
        return installer.install_pcvr(self.connect().frame, plan, reporter)

    def install_linux(self, package, title, root, exe, files, appimage, openxr, reporter, x86_64=False,
-                      desktop_entry=True, overlay=None, desktop_icon=True, source_id=None, changed_since=None):
+                      desktop_entry=True, overlay=None, desktop_icon=True):
        plan = installer.LinuxPlan(package, title, Path(root), exe, files, appimage, openxr, x86_64,
                                   dest=self.install_dest(), desktop_entry=desktop_entry, overlay=overlay,
-                                   desktop_icon=desktop_icon, source_id=source_id, changed_since=changed_since)
+                                   desktop_icon=desktop_icon)
        return installer.install_linux(self.connect().frame, plan, reporter)

    def drives(self) -> list[dict]:
@@ -191,9 +191,7 @@ class PcReviveTarget(Target):
               "tuning": dict(recipe.params("pcvr.steamvr_tuning"), enabled=True)
               if "pcvr.steamvr_tuning" in recipe.patches else None,
               "sha256": extra.get("exe_sha256"), "art_lookup": extra.get("art_lookup"),
-               "recipe": {"patches": sorted(recipe.patches), "source": recipe.source,
-                          **({"source_id": extra["source_id"]} if extra.get("source_id") else {})},
-               "time": time.time()}
+               "recipe": {"patches": sorted(recipe.patches), "source": recipe.source}, "time": time.time()}
        exe_field, _, _ = shortcut_fields(dep)
        d = pc_dir() / package
        try:  # a reinstall keeps the shortcut's appid: Steam's entry is matched by its Exe, whatever its name now
@@ -1,160 +0,0 @@
-"""The announcement pop-up (frameport.announcements does the fetching and the who-sees-it rules): checked in the
-background a little after start and every 6 h, shown once when no other dialog is open and the welcome screen is done.
-Any way of closing it (the X, a click outside, Escape, its button) dismisses that announcement for good."""
-from __future__ import annotations
-
-import threading
-import time
-from typing import TYPE_CHECKING
-
-import flet as ft
-
-from .. import announcements
-from ..core import applog
-from ..i18n import tr
-from . import components as C
-from . import theme as T
-
-if TYPE_CHECKING:
-    from ..announcements import Announcement
-    from .app import FramePortApp
-
-FIRST_DELAY = 20   # seconds after start: after the start-up work and the update check
-BUSY_RETRY = 15    # another dialog is open / the welcome screen is shown: look again
-LONG_BODY = 900    # characters: longer bodies scroll inside the pop-up
-
-
-class Announcer:
-    def __init__(self, app: FramePortApp):
-        self.app = app
-        self.shown: str | None = None  # id on screen (a check while it's open doesn't show it twice)
-        try:
-            announcements.since()  # first start → only announcements published after it (before anything is saved)
-        except Exception:  # noqa: BLE001
-            applog.log.exception("announcements: recording the first start failed")
-
-    def start(self) -> None:
-        if not announcements.disabled():
-            threading.Thread(target=self._loop, daemon=True).start()
-
-    def _loop(self) -> None:
-        time.sleep(FIRST_DELAY)
-        while True:
-            try:
-                a = announcements.fetch()
-                if announcements.due(a):
-                    self._offer(a)
-            except Exception:  # noqa: BLE001
-                applog.log.exception("announcement check failed")
-            time.sleep(announcements.CHECK_EVERY)
-
-    def _offer(self, a: Announcement) -> None:
-        """Wait for a quiet moment (no dialog, not the welcome screen), then show it (background thread)."""
-        image = announcements.image_file(a)
-        while self.app.route[0] == "welcome" or C.dialog_open(self.app.page):
-            time.sleep(BUSY_RETRY)
-        if announcements.due(a) and self.shown != a.id:
-            self.show(a, image)
-
-    # ---------------------------------------------------------------- the pop-up
-    def show(self, a: Announcement, image=None) -> None:
-        page = self.app.page
-        closed = []
-
-        def dismiss(e=None) -> None:
-            if closed:
-                return
-            closed.append(True)
-            self.shown = None
-            try:
-                announcements.dismiss(a.id)
-            except Exception:  # noqa: BLE001
-                applog.log.exception("announcement: saving the dismissal failed")
-
-        def close(e=None) -> None:
-            dismiss()
-            page.pop_dialog()
-
-        def act(e=None) -> None:
-            close()
-            self.app.open_url(a.url)
-
-        self.shown = a.id
-        page.show_dialog(C.dialog(None, announcement_card(page, a, image, close, act if a.button else None),
-                                  content_padding=0, actions_padding=0, inset_padding=self._insets(),
-                                  clip_behavior=ft.ClipBehavior.ANTI_ALIAS,
-                                  on_dismiss=dismiss, width=T.DIALOG_M))
-
-
-    def _insets(self) -> ft.Padding:
-        """Centred over the content area (right of the sidebar, left of an open activity panel), not the whole
-        window; where that area is narrower than the pop-up, the panel and then the sidebar are left out."""
-        gap = T.S5
-        try:
-            left, right = self.app.content_insets()
-            width = float(self.app.page.width or 0)
-        except Exception:  # noqa: BLE001
-            return ft.Padding.all(gap)
-        need = T.DIALOG_M + 2 * gap
-        if width and width - left - right < need:
-            right = 0
-        if width and width - left - right < need:
-            left = 0
-        return ft.Padding(left + gap, gap, right + gap, gap)
-
-
-def announcement_card(page: ft.Page, a: Announcement, image, on_close, on_action=None) -> ft.Control:
-    """The pop-up's content: the portal edge, the picture (if any) with the close button over it, title, date, the
-    Markdown body and the optional action."""
-    from ..artwork.thumbs import asset_url
-    from .updater import _notes_style, _open_url
-
-    width = T.DIALOG_M
-    close_tip = tr("Dismiss")
-    title = ft.Text(a.title, size=T.px(20), weight=ft.FontWeight.W_700, color=T.TEXT, selectable=True)
-    date = C.meta(time.strftime("%Y-%m-%d", time.localtime(a.date)))
-    body = ft.Markdown(a.body, selectable=True, extension_set=ft.MarkdownExtensionSet.GITHUB_WEB,
-                       md_style_sheet=_notes_style(),
-                       on_tap_link=lambda e: _open_url(page, e.data))
-    if len(a.body) > LONG_BODY:
-        body = ft.Column([body], scroll=ft.ScrollMode.AUTO, height=T.px(320))
-
-    head: list[ft.Control] = [ft.Container(height=T.px(3), gradient=C.portal_gradient())]
-    if image is not None:
-        head.append(ft.Stack([
-            ft.Image(src=asset_url(image), width=width, height=_image_height(image, width), fit=ft.BoxFit.COVER,
-                     semantics_label=a.image_alt or None),
-            ft.Container(
-                ft.Icon(ft.Icons.CLOSE_ROUNDED, size=T.px(18), color=T.TEXT),
-                width=T.px(34), height=T.px(34), border_radius=T.px(17), alignment=ft.Alignment.CENTER,
-                bgcolor=ft.Colors.with_opacity(0.62, T.BG), border=ft.Border.all(1, T.soft(T.TEXT, 0.18)),
-                tooltip=close_tip, ink=True, on_click=on_close, right=T.S3, top=T.S3),
-        ], width=width))
-        title_row: ft.Control = title
-    else:
-        title_row = ft.Row([ft.Container(title, expand=True, padding=ft.Padding(0, T.px(6), 0, 0)),
-                            C.icon_btn(ft.Icons.CLOSE_ROUNDED, close_tip, on_click=on_close)],
-                           vertical_alignment=ft.CrossAxisAlignment.START, spacing=T.S2)
-
-    text = [ft.Column([title_row, date], spacing=T.px(2), tight=True)]
-    if a.body:
-        text.append(body)
-    if on_action is not None:
-        text.append(ft.Row([C.primary(a.button, icon=ft.Icons.OPEN_IN_NEW_ROUNDED, on_click=on_action)],
-                           alignment=ft.MainAxisAlignment.END))
-    pad = ft.Padding(T.S5, T.S4 if image is None else T.S5, T.S4 if image is None else T.S5, T.S5)
-    return ft.Container(
-        ft.Column([*head, ft.Container(ft.Column(text, spacing=T.S4, tight=True), padding=pad)], spacing=0, tight=True),
-        width=width)
-
-
-def _image_height(path, width: float) -> float:
-    """The picture's height at the pop-up's width, kept between a banner and a third of a 16:9 screen."""
-    try:
-        from PIL import Image
-
-        with Image.open(path) as im:
-            ratio = im.height / im.width
-    except Exception:  # noqa: BLE001
-        ratio = 9 / 21
-    return max(T.px(140), min(width * ratio, T.px(320)))
@@ -96,9 +96,6 @@ def reduce_motion_setting() -> bool:
    return bool(library.setting(REDUCE_MOTION, False))


-SIDEBAR_WIDTH = 236  # logical px before the UI scale (content_insets)
-
-
 class FramePortApp:
    def __init__(self, page: ft.Page):
        from .views.library import load_filters
@@ -148,12 +145,9 @@ class FramePortApp:
                                   self.stop_live(),  # and stop a live view (it would keep the Frame encoding)
                                   self.stop_keyboard(), self.stop_monitor(), self.monitor_hub.close(),
                                   _link_state.update(owner=None) if _link_state["owner"] is self else None)
-        from .announcer import Announcer
        from .updater import Updater

        self.updater = Updater(self)  # new FramePort releases (sidebar card, Library bar, one-click update)
-        # maintainer announcements (pop-up once, not on a first start); before updater.start() saves this start
-        self.announcer = Announcer(self)

        page.title = tr("FramePort")
        for problem in T.load_user_themes(themes_dir()):  # installed theme files (Settings → Appearance)
@@ -188,7 +182,6 @@ class FramePortApp:
        self._start_auto_pair()
        threading.Thread(target=self._backfill_covers, daemon=True).start()
        self.updater.start()
-        self.announcer.start()
        self.run_bg(self._refresh_catalog)  # confirmed game configs from GitHub main (no release needed)
        _link_state["owner"] = self
        if _link_state["thread"] is None:
@@ -243,18 +236,13 @@ class FramePortApp:
            self.activity_card,
            self.conn_card,
            self.power_row,  # under the Frame card (owner's choice)
-        ], spacing=T.S2), width=T.px(SIDEBAR_WIDTH), bgcolor=T.SIDEBAR, padding=T.S4,
+        ], spacing=T.S2), width=T.px(236), bgcolor=T.SIDEBAR, padding=T.S4,
            border=None if T.DUAL else ft.Border(right=ft.BorderSide(1, T.BORDER)))
        # dual themes: the sidebar's edge is the portal, blue at the top into orange at the bottom
        edge = [ft.Container(width=2, gradient=C.portal_gradient(vertical=True, opacity=0.7))] if T.DUAL else []
        self.page.controls = [ft.Row([sidebar, *edge, self.body, self.activity.root], expand=True, spacing=0,
                                     vertical_alignment=ft.CrossAxisAlignment.STRETCH)]

-    def content_insets(self) -> tuple[float, float]:
-        """How much of the window's left (the sidebar + its edge) and right (the activity panel, when open) isn't the
-        content area: pop-ups about the content (announcements) centre over what's between."""
-        return T.px(SIDEBAR_WIDTH) + (2 if T.DUAL else 0), float(self.activity.root.width or 0)
-
    def restyle(self, theme: str) -> None:
        """Switch the colour theme while running (Settings → Appearance): new tokens, the window rebuilt, the views
        FramePort keeps between visits recreated (the files/screenshots views start at their first location again;
@@ -892,7 +880,7 @@ class FramePortApp:
                    self.toast(msg, error=True, action=tr("Details"),
                               on_action=lambda e: self.show_activity(True))
            self.refresh_view()
-            if job.kind in ("scan", "task") and self.exe_queue:  # (a task: a newer PC VR game version)
+            if job.kind == "scan" and self.exe_queue:
                self.page.run_thread(self.next_exe_choice)
        elif job and job.active and job.package and self.route[:2] == ("game", job.package):
            pkg, transit = self.hero_transit or (None, None)
@@ -1164,7 +1152,6 @@ class FramePortApp:
            "move": lambda e: self.move_game(pkg),
            "update_app": lambda e: self.update_app_only(pkg),
            "new_apk": lambda e: self.page.run_task(self.update_with_apk, pkg),
-            "new_version": lambda e: self.page.run_task(self.update_with_version, pkg),
            "uninstall_frame": lambda e: self.uninstall(pkg, "frame"),
            "uninstall_pc": lambda e: self.uninstall(pkg, "pc"),
            "remove": lambda e: self.remove_from_library(pkg),
@@ -1181,8 +1168,7 @@ class FramePortApp:
            settings=self.has_game_settings(g), programs=rift or (linux and bool(self.linux_programs(g))),
            selectable=lv is not None,
            media_button=C.is_media_player(g) and not rift,
-            movable=connected and C.frame_drive(g, self.frame_info) is not None, android=not rift and not linux,
-            new_version=rift or linux)
+            movable=connected and C.frame_drive(g, self.frame_info) is not None, android=not rift and not linux)
        return menu_sections(g, st, handlers.__getitem__)

    def open_game_menu(self, pkg: str) -> None:
@@ -1635,60 +1621,6 @@ class FramePortApp:
            return tr("{title}: newer APK added").format(title=self._title(pkg))
        self.submit(tr("Newer APK for {title}").format(title=self._title(pkg)), run, pkg, "task")

-    async def update_with_version(self, pkg: str) -> None:
-        """Game menu "Update with a newer version…" for Linux apps and PC VR games (GitHub #161): pick the new app
-        file or folder (how the app was added) / the new game folder; the game keeps its name, art, tags and switches,
-        and its page then offers Update on Frame (or on this PC)."""
-        from ..analysis import linux as linux_analysis
-
-        if self.jobs.busy_with(pkg):
-            return
-        g = library.game(pkg) or {}
-        rift = g.get("kind") == "rift"
-        title = tr("Newer version of {title}").format(title=self._title(pkg))
-        if rift or self._linux_folder_app(g):
-            path = await C.pick_dir(self.page, dialog_title=title)
-            if not path:
-                return
-        else:
-            paths = await C.pick_files(self.page, dialog_title=title)
-            if not paths:
-                return
-            path = paths[0]
-            if not linux_analysis.looks_like_linux_app(Path(path)):
-                self.toast(tr("{name} isn't a Linux app (AppImage, Linux program or .zip/.tar archive)")
-                           .format(name=Path(path).name), error=True)
-                return
-        on_frame = self.frame_state == "connected" and \
-            C.install_state(g, self.frame_info) in ("installed", "outdated")
-        on_pc = rift and pkg in self.pc_installs()
-
-        def run(job: Job):
-            job.reporter.stage(tr("Reading the new version"))
-            res = pipeline.replace_source(pkg, Path(path), job.reporter)
-            if res.get("different"):
-                self.toast(tr("Heads-up: {name} looks like a different app than {title}.").format(
-                    name=res.get("name") or Path(path).name, title=self._title(pkg)))
-            if rift and res["entry"].get("exe_confirmed") is False:  # which program starts it? (asked after the job)
-                self.exe_queue.append(pkg)
-            self.open_game(pkg)
-            if on_frame or on_pc:
-                return tr("{title}: newer version added. Press Update to install it.").format(
-                    title=self._title(pkg))
-            return tr("{title}: newer version added").format(title=self._title(pkg))
-        self.submit(tr("Newer version for {title}").format(title=self._title(pkg)), run, pkg, "task")
-
-    @staticmethod
-    def _linux_folder_app(g: dict) -> bool:
-        """A Linux app added from a folder (its newer version is a folder too), not from an AppImage/archive."""
-        from ..analysis import linux as linux_analysis
-
-        extra = (g.get("analysis") or {}).get("extra") or {}
-        source = Path(extra.get("source") or g.get("game_dir") or "")
-        if source.exists():
-            return source.is_dir()
-        return not extra.get("files") and not source.name.lower().endswith(linux_analysis.ARCHIVES)
-
    def updatable(self) -> list[tuple[str, str]]:
        """[(package, "frame" | "pc")] installs with an update ready (a newer build or changed patch settings)."""
        out = []
@@ -178,8 +178,6 @@ def install_state(game: dict, frame_info: dict | None) -> str | None:
    # still installed (GitHub #90)
    if not dep or (dep.get("apk_present") is False and not dep.get("drive_missing")):
        return "missing"
-    if source_replaced(game, dep):
-        return "outdated"  # a newer version of the Linux app / PC VR game was added since this install (GitHub #161)
    b = game.get("build") or {}
    if game.get("kind") not in ("linux", "rift") and b.get("apk_recipe_fp") and dep.get("configuration_fp"):
        from ..game_update import plan_update
@@ -196,16 +194,6 @@ def install_state(game: dict, frame_info: dict | None) -> str | None:
    return "outdated" if settings_diff(game, frame_info) else "installed"


-def source_replaced(game: dict, dep: dict | None) -> bool:
-    """A Linux app or PC VR game got a newer version ("Update with a newer version…", GitHub #161) that this install
-    (the Frame's or the PC's deployment record) doesn't have yet."""
-    sid = game.get("source_id")
-    if not sid or game.get("kind") not in ("linux", "rift"):
-        return False
-    rec = (dep or {}).get("recipe")
-    return (rec.get("source_id") if isinstance(rec, dict) else None) != sid
-
-
 def recipe_changed(game: dict) -> bool:
    from ..patches.base import recipe_fingerprint, revised_since_unrecorded

@@ -228,7 +216,7 @@ def pc_outdated(g: dict, dep: dict) -> bool:
        args = game_args(recipe_from_dict(g["recipe"]))
    except Exception:  # noqa: BLE001
        args = dep.get("game_args") or []
-    return installed != want or list(dep.get("game_args") or []) != args or source_replaced(g, dep)
+    return installed != want or list(dep.get("game_args") or []) != args


 def one_choice():
@@ -62,9 +62,6 @@ HELP: dict[str, str] = _Translated({
    "hw_video_decode": "Games with the Hardware video decoding patch play their videos on the Frame's video hardware. "
                       "Turn it off if videos misbehave; games pick it up at their next start. For one game only, put "
                       "FRAMEPORT_NO_HW_VIDEO=1 before %command% in its Steam launch options.",
-    "ssh_keys": "FramePort logs in to the Frame with its own key. If your Frame accepts only one of your own keys, "
-                "add that private key file here; fast uploads use it too. A key with a passphrase: add it to your SSH "
-                "agent instead.",
    "launch_test": "Starts the game on the Frame while nobody wears the headset and reads the log: did it start and "
                   "draw frames. It can't check the picture.",
    "last_session": "After you play a game on the Frame, FramePort reads that session's log: crashes, frame rate and "
@@ -35,7 +35,6 @@ class MenuState:
    media_button: bool = False     # the game page shows "Add videos" already
    movable: bool = False          # the Frame knows which drive it's on (agent v63+, microSD): Move to…
    android: bool = False          # a Quest/Android game (not PC VR, not a Linux app): it can get a newer APK
-    new_version: bool = False      # a Linux app or PC VR game: it can get a newer version (file or folder)


 def menu_sections(g: dict, st: MenuState, act: Callable[[str], Callable]) -> list:
@@ -56,8 +55,6 @@ def menu_sections(g: dict, st: MenuState, act: Callable[[str], Callable]) -> lis
        top.append((tr("Move to…"), ft.Icons.DRIVE_FILE_MOVE_ROUNDED, act("move")))
    if st.android and not job:  # GitHub #161: the game keeps its name, art and recipe
        top.append((tr("Update with a newer APK…"), ft.Icons.UPGRADE_ROUNDED, act("new_apk")))
-    if st.new_version and not job:  # the same for Linux apps and PC VR games
-        top.append((tr("Update with a newer version…"), ft.Icons.UPGRADE_ROUNDED, act("new_version")))
    if st.on_frame and not rift and not linux and not job:
        # the new build only; the Frame's game data stays (e.g. changed OBBs a normal update would replace)
        top.append((tr("Update app only…"), ft.Icons.SYSTEM_UPDATE_ALT_ROUNDED, act("update_app")))
@@ -106,8 +103,6 @@ def quick_menu(st: MenuState, act: Callable[[str], Callable]) -> list:
    out += st.installs[:1]
    if st.android:
        out.append((tr("Update with a newer APK…"), ft.Icons.UPGRADE_ROUNDED, act("new_apk")))
-    if st.new_version:
-        out.append((tr("Update with a newer version…"), ft.Icons.UPGRADE_ROUNDED, act("new_version")))
    if st.settings:
        out.append((tr("Game settings…"), ft.Icons.TUNE_ROUNDED, act("settings")))
    out.append((tr("Rename…"), ft.Icons.DRIVE_FILE_RENAME_OUTLINE_OUTLINED, act("rename")))
@@ -412,17 +412,8 @@ class GameView:
                          "have. If nothing opens, visit the website in a browser."), T.TEXT)]
                + ([C.meta(web["url"], T.TEXT_2, selectable=True)] if web.get("url") else []), spacing=T.px(4)),
                "warn", ft.Icons.LANGUAGE_ROUNDED))
-        # a Google Daydream / Cardboard build (no Oculus support in it): its VR has no way to the headset (#335)
-        gvr = (extra.get("google_vr") if not self.rift and not self.linux and extra.get("vr_kind") != "quest"
-               else "")
-        if gvr:
-            out.append(C.callout(tr("This is a Google {platform} VR build. Its VR can't reach the Frame's headset, so "
-                                    "it runs as a flat window at best, usually without working controls. An Oculus "
-                                    "build of the game (Meta Quest, Oculus Go or Gear VR) works the normal way.")
-                                 .format(platform="Daydream" if gvr == "daydream" else "Cardboard"),
-                                 "warn", ft.Icons.VIEW_IN_AR_ROUNDED))
        static = " ".join(engine.blocker_notes(library.analysis_from_dict(g["analysis"]))) \
-            if (too_new or web or gvr) else ""
+            if (too_new or web) else ""
        if static and recipe.notes.strip() == static:
            pass  # the recipe's note says the same (shown above)
        elif recipe.status == "unsupported":
@@ -131,55 +131,9 @@ class SettingsView:
                          C.meta(tr("Large files upload together using OpenSSH when available. "
                                    "Default: 3. Lower this on a busy network.")),
                          C.ghost(tr("Remove converted copies now"), ft.Icons.CLEANING_SERVICES_OUTLINED, clean,
-                                  tooltip=tr("Your own game files aren't touched.")),
-                          ft.Container(height=T.S2), self.ssh_keys()],
+                                  tooltip=tr("Your own game files aren't touched."))],
                         spacing=T.S2, horizontal_alignment=ft.CrossAxisAlignment.START)

-    def ssh_keys(self) -> ft.Control:
-        """Settings → Installing: private key files FramePort logs in with besides its own (frame.connection
-        EXTRA_KEYS_SETTING; the Frame connection and OpenSSH uploads both use them, GitHub #242)."""
-        from ...frame import connection
-
-        app = self.app
-        rows = ft.Column(spacing=T.S1)
-
-        def fill():
-            items = []
-            for path, problem in connection.extra_key_status():
-                items.append(ft.Row([
-                    C.as_icon(ft.Icons.KEY_ROUNDED if not problem else ft.Icons.WARNING_AMBER_ROUNDED, T.px(18),
-                              T.TEXT_2 if not problem else T.WARN),
-                    ft.Column([C.body(path.name, T.TEXT), C.meta(problem or str(path), selectable=True)],
-                              spacing=0, expand=True),
-                    C.icon_btn(ft.Icons.DELETE_OUTLINE_ROUNDED, tr("Stop using this key (the file stays)"),
-                               on_click=lambda e, p=path: remove(p)),
-                ], spacing=T.S2, vertical_alignment=ft.CrossAxisAlignment.CENTER))
-            rows.controls = items or [C.meta(tr("Only FramePort's own key, and your SSH agent's keys."))]
-            C.update(rows)
-
-        def remove(path):
-            connection.remove_extra_key(path)
-            fill()
-
-        async def add(e):
-            for path in await C.pick_files(app.page, dialog_title=tr("Private SSH key file (not the .pub file)"),
-                                           multiple=True):
-                try:
-                    stored = connection.add_extra_key(path)
-                except connection.KeyFileError as exc:
-                    app.toast(tr("That key can't be used: {error}").format(error=exc), error=True)
-                    continue
-                app.toast(tr("FramePort also logs in with {name} from the next connection.").format(name=stored.name))
-            fill()
-
-        fill()
-        return ft.Column([
-            ft.Row([C.body(tr("SSH keys"), T.TEXT, weight=ft.FontWeight.W_500), C.help_icon("ssh_keys")],
-                   spacing=T.px(4), vertical_alignment=ft.CrossAxisAlignment.CENTER),
-            rows,
-            C.secondary(tr("Add a key file…"), ft.Icons.VPN_KEY_ROUNDED, add),
-        ], spacing=T.S2, horizontal_alignment=ft.CrossAxisAlignment.START)
-
    def updates_card(self) -> ft.Control:
        """Settings → Updates: FramePort's own updates (ui/updater.py, frameport/updates.py)."""
        import time
@@ -1,140 +0,0 @@
-"""Announcements: the committed file parses, who sees one (never on a first start), and dismissing is for good."""
-from pathlib import Path
-
-import pytest
-
-from frameport import announcements as A
-from frameport.core import library
-
-ROOT = Path(__file__).resolve().parents[1]
-
-DOC = """---
-id: one
-title: Hello
-date: 2026-10-10T12:00:00Z
---
-Some **news**.
-"""
-
-
-def ann(text=DOC):
-    a = A.parse(text)
-    assert a is not None
-    return a
-
-
-def test_committed_announcement_is_valid():
-    """announcements/current.md must parse (an inactive one is checked too): a typo fails here, not on users."""
-    A.parse((ROOT / A.PATH).read_text(encoding="utf-8"))
-
-
-def test_parse_fields():
-    a = A.parse("""---
-id: frameport-1.3
-title: "FramePort 1.3: the Monitor"
-date: 2026-11-02
-image: announcements/x.png
-image_alt: A picture
-button: Read more
-url: https://frameport.app/changelog/
-expires: 2026-11-30
---
-Body *here*.""")
-    assert a.id == "frameport-1.3" and a.title == "FramePort 1.3: the Monitor" and a.body == "Body *here*."
-    assert a.image == A.RAW + "announcements/x.png" and a.image_alt == "A picture"
-    assert a.button == "Read more" and a.url == "https://frameport.app/changelog/"
-    assert a.date == 1793577600.0  # 2026-11-02 00:00 UTC
-    assert a.expires == 1795996800.0 + 86400  # end of 2026-11-30 (inclusive)
-
-
-@pytest.mark.parametrize("text", ["", "   \n", "---\nactive: false\n---\n"])
-def test_nothing_to_show(text):
-    assert A.parse(text) is None
-
-
-@pytest.mark.parametrize("front, error", [
-    ("title: x\ndate: 2026-10-10", "id"),
-    ("id: bad id\ntitle: x\ndate: 2026-10-10", "id"),
-    ("id: a\ndate: 2026-10-10", "title"),
-    ("id: a\ntitle: x", "date"),
-    ("id: a\ntitle: x\ndate: soon", "date"),
-    ("id: a\ntitle: x\ndate: 2026-10-10\nbutton: Go", "button and url"),
-    ("id: a\ntitle: x\ndate: 2026-10-10\nimage: http://example.com/x.png", "https"),
-    ("id: a\ntitle: x\ndate: 2026-10-10\nimage: ../secret.png", "https"),
-    ("id: a\ntitle: x\ndate: 2026-10-10\nwhere: app", "unknown"),  # the site pop-up was dropped
-    ("id: a\ntitle: x\ndate: 2026-10-10\ncolour: red", "unknown"),
-    ("active: false\nid: a\ntitle: x\ndate: tomorrow", "date"),  # switched off, still checked
-])
-def test_parse_errors(front, error):
-    with pytest.raises(A.AnnouncementError, match=error):
-        A.parse(f"---\n{front}\n---\nbody")
-
-
-def test_fetch_never_raises_on_a_broken_file(monkeypatch):
-    monkeypatch.setattr(A.cache, "cached_text", lambda *a, **k: "no front matter")
-    assert A.fetch() is None
-
-
-def test_first_start_sees_no_older_announcement():
-    """A new install: `since` = now, so an announcement published before it never shows."""
-    assert A.since() > 1.9e9 - 2e8  # roughly now
-    assert not A.due(ann())
-
-
-def test_existing_user_sees_it_once():
-    library.set_setting("update.last_seen_version", "1.2.0")  # FramePort ran before announcements existed
-    assert A.since() == 0
-    a = ann()
-    assert A.due(a)
-    A.dismiss(a.id)
-    assert not A.due(a)
-    assert not A.due(a)  # for good, also at the next check
-    # a typo fixed under the same id stays dismissed; a new id shows again
-    assert not A.due(ann(DOC.replace("Hello", "Hallo")))
-    assert A.due(ann(DOC.replace("id: one", "id: two")))
-
-
-def test_since_is_recorded_once():
-    first = A.since()
-    library.set_setting("update.last_seen_version", "1.2.0")  # written later by this same start
-    assert A.since() == first
-
-
-def test_new_user_sees_later_announcements():
-    start = 1_800_000_000.0
-    later = ann(DOC.replace("2026-10-10T12:00:00Z", "2027-01-20T00:00:00Z"))  # after `start`
-    assert A.due(later, now=later.date + 60, user_since=start)
-    assert not A.due(ann(), now=later.date + 60, user_since=start)  # published before the install
-
-
-def test_schedule_and_expiry():
-    a = ann(DOC.replace("---\nSome", "expires: 2026-10-12\n---\nSome"))
-    assert not A.due(a, now=a.date - 60, user_since=0)        # not published yet
-    assert A.due(a, now=a.date + 60, user_since=0)
-    assert not A.due(a, now=a.expires + 1, user_since=0)      # expired
-
-
-def test_dismissed_list_is_bounded():
-    for i in range(A.KEEP_DISMISSED + 5):
-        A.dismiss(f"id{i}")
-    kept = A.dismissed()
-    assert len(kept) == A.KEEP_DISMISSED and kept[-1] == f"id{A.KEEP_DISMISSED + 4}"
-    A.dismiss("id10")  # again: moves to the end, no duplicate
-    assert A.dismissed().count("id10") == 1 and A.dismissed()[-1] == "id10"
-
-
-def test_image_file_checks_the_picture(monkeypatch, tmp_path):
-    from PIL import Image
-
-    src = tmp_path / "pic.png"
-    Image.new("RGB", (40, 20), "orange").save(src)
-
-    def fake_download(url, dest, **kw):
-        dest.parent.mkdir(parents=True, exist_ok=True)
-        dest.write_bytes(src.read_bytes() if url.endswith(".png") else b"not an image")
-        return dest
-    monkeypatch.setattr(A.cache, "download", fake_download)
-    good = A.image_file(ann(DOC.replace("---\nSome", "image: announcements/a.png\n---\nSome")))
-    assert good is not None and good.suffix == ".png" and good.exists()
-    assert A.image_file(ann(DOC.replace("---\nSome", "image: https://example.com/a.jpg\n---\nSome"))) is None
-    assert not list(good.parent.glob("*.part"))
@@ -1,115 +0,0 @@
-"""Google Daydream / Cardboard (GVR SDK) apps: detected, warned about, never marked unsupported (GitHub #335)."""
-import zipfile
-
-from conftest import build_axml
-
-from frameport.analysis import detect
-from frameport.recommend import engine
-from frameport.validate.triage import triage
-
-DAYDREAM_VR_MODE = "com.google.vr.vrcore/com.google.vr.vrcore.common.VrCoreListenerService"
-
-
-def _manifest(package="com.example.daydream", categories=(), enable_vr_mode=None):
-    activity = [("name", "str", "com.unity3d.player.UnityPlayerActivity")]
-    if enable_vr_mode:
-        activity.append(("enableVrMode", "str", enable_vr_mode))
-    cats = []
-    for c in ("android.intent.category.LAUNCHER", *categories):
-        cats += [("start", "category", [("name", "str", c)]), ("end", "category")]
-    return build_axml([
-        ("start", "manifest", [("package", "str", package)]),
-        ("start", "uses-sdk", [("minSdkVersion", "int", 24), ("targetSdkVersion", "int", 26)]),
-        ("end", "uses-sdk"),
-        ("start", "application", []),
-        ("start", "activity", activity),
-        ("start", "intent-filter", []),
-        ("start", "action", [("name", "str", "android.intent.action.MAIN")]),
-        ("end", "action"),
-        *cats,
-        ("end", "intent-filter"),
-        ("end", "activity"),
-        ("end", "application"),
-        ("end", "manifest"),
-    ])
-
-
-def _apk(tmp_path, manifest, libs=("libmain.so", "libunity.so"), abi="armeabi-v7a", dex=b"dex\n035\0"):
-    p = tmp_path / "game.apk"
-    with zipfile.ZipFile(p, "w") as z:
-        z.writestr("AndroidManifest.xml", manifest)
-        z.writestr("classes.dex", dex)
-        for lib in libs:
-            z.writestr(f"lib/{abi}/{lib}", b"\x7fELF-" + lib.encode())
-    return p
-
-
-def test_google_vr_signals():
-    assert detect.google_vr(set(), {detect.DAYDREAM_CATEGORY}, []) == "daydream"
-    assert detect.google_vr(set(), set(), [DAYDREAM_VR_MODE]) == "daydream"
-    assert detect.google_vr(set(), {detect.CARDBOARD_CATEGORY}, []) == "cardboard"
-    assert detect.google_vr({"libgvr.so"}, set(), []) == "cardboard"
-    assert detect.google_vr({"libGfxPluginCardboard.so"}, set(), []) == "cardboard"
-    assert detect.google_vr(set(), set(), [], gvr_java=True) == "cardboard"
-    assert detect.google_vr(set(), set(), [], boot="vr-enabled=1\nvr-device-list=Daydream,Cardboard\n") == "daydream"
-    # both: Daydream is the more specific
-    assert detect.google_vr({"libgvr.so"}, {detect.CARDBOARD_CATEGORY, detect.DAYDREAM_CATEGORY}, []) == "daydream"
-    # Google's spatial audio alone isn't Google VR (Quest games ship it, e.g. Shadow Point)
-    assert detect.google_vr({"libgvraudio.so", "libaudioplugingvrunity.so"}, set(), []) == ""
-    assert detect.google_vr(set(), set(), [], boot="vr-enabled=1\nvr-device-list=Oculus\n") == ""
-
-
-def test_daydream_apk_is_detected(tmp_path):
-    """Blade Runner: Revelations' shape: Unity 2017, 32-bit, Daydream category + VrCore's VR mode, libgvr.so."""
-    m = _manifest(categories=[detect.DAYDREAM_CATEGORY], enable_vr_mode=DAYDREAM_VR_MODE)
-    a = detect.analyze(_apk(tmp_path, m, ("libmain.so", "libunity.so", "libgvr.so", "libaudioplugingvrunity.so")))
-    assert a.extra["google_vr"] == "daydream"
-    assert a.vr_kind == "none" and a.extra["analysis_version"] == detect.ANALYSIS_VERSION
-
-
-def test_cardboard_from_java_classes(tmp_path):
-    dex = b"dex\n035\0...Lcom/google/vr/sdk/base/GvrView;..."
-    a = detect.analyze(_apk(tmp_path, _manifest(), dex=dex))
-    assert a.extra["google_vr"] == "cardboard"
-
-
-def test_quest_game_with_google_audio_is_not_google_vr(tmp_path):
-    a = detect.analyze(_apk(tmp_path, _manifest(), ("libmain.so", "libunity.so", "libvrapi.so", "libgvraudio.so")))
-    assert a.extra["google_vr"] == "" and engine.google_vr_note(a) is None
-
-
-def test_warning_but_never_unsupported(tmp_path):
-    m = _manifest(categories=[detect.DAYDREAM_CATEGORY], enable_vr_mode=DAYDREAM_VR_MODE)
-    a = detect.analyze(_apk(tmp_path, m, ("libmain.so", "libunity.so", "libgvr.so")))
-    note = engine.google_vr_note(a)
-    assert note and "Daydream" in note and "Oculus build" in note
-    assert note in engine.blocker_notes(a)
-    r = engine.suggest(a, use_catalog=False)
-    assert r.status != "unsupported"  # the manifest alone never decides; the launch test's triage does
-    assert note in r.notes and "Android app without VR" not in r.notes
-
-
-def test_daydream_and_oculus_build_goes_the_normal_way(tmp_path):
-    """A Unity build with both Daydream and Oculus support: the Oculus path works, so no warning."""
-    m = _manifest(categories=[detect.DAYDREAM_CATEGORY], enable_vr_mode=DAYDREAM_VR_MODE)
-    a = detect.analyze(_apk(tmp_path, m, ("libmain.so", "libunity.so", "libgvr.so", "libvrapi.so")))
-    assert a.extra["google_vr"] == "daydream" and a.vr_kind == "quest"
-    assert engine.google_vr_note(a) is None
-
-
-def test_triage_gvr_not_supported():
-    """Lines from #335's launch log (Blade Runner: Revelations on the 32-bit bridge)."""
-    lines = [
-        "10-16 05:27:34.526  1355  1384 W a32bridge: libgvr.so: Java_com_google_vr_sdk_base_CardboardViewNativeImpl_"
-        "nativeDestroy: class com/google/vr/sdk/base/CardboardViewNativeImpl not found",
-        "10-16 05:27:34.560  1355  1384 E Unity   : Google VR Error [Daydream]: Google VR had a fatal issue while "
-        "loading. VR will not be available.",
-        "10-16 05:27:43.854   225  1097 W ActivityManager: Unable to start service Intent { "
-        "act=com.google.vr.vrcore.controller.BIND pkg=com.google.vr.vrcore } U=0: not found",
-    ]
-    for line in lines:
-        r = triage(line + "\n", "RUNNING")
-        assert [f.id for f in r.findings] == ["gvr-not-supported"] and r.verdict == "fail", line
-    # GVR's own start-up line alone isn't a failure (a Daydream build with Oculus support logs it too)
-    assert not triage("10-16 05:27:34.555  1355  1355 I GVR     : [vr/gvr/capi/src/gvr.cc:103] Initialized GVR "
-                      "version 1.101.0\n", "RUNNING").findings
@@ -31,11 +31,9 @@ def _states():
        ("quest not installed", QUEST, MenuState(connected=True, installs=[_install("Install on Frame")],
                                                 settings=True, selectable=True, android=True)),
        ("rift on PC", RIFT, MenuState(on_pc=True, plays=[_play("this PC")], programs=True, selectable=True,
-                                       installs=[_install("Reinstall on this PC")], new_version=True)),
+                                       installs=[_install("Reinstall on this PC")])),
        ("linux on Frame", LINUX, MenuState(connected=True, on_frame=True, plays=[_play()], installs=[_install()],
-                                            selectable=True, new_version=True)),
-        ("linux job running", LINUX, MenuState(connected=True, on_frame=True, job=True, selectable=True,
-                                               new_version=True)),
+                                            selectable=True)),
        ("job running", QUEST, MenuState(connected=True, on_frame=True, job=True, settings=True, selectable=True,
                                         android=True)),
    ]
@@ -174,17 +172,3 @@ def test_newer_apk_for_quest_games_in_both_menus():
        want = g is QUEST and not st.job
        assert ("Update with a newer APK…" in quick) == want, name
        assert ("Update with a newer APK…" in full) == want, name
-
-
-def test_newer_version_for_linux_apps_and_pc_vr_games():
-    """GitHub #161: Linux apps and PC VR games get "Update with a newer version…" (a file or folder), not the APK
-    entry, in both menus; never while a job runs."""
-    for name, g, st in _states():
-        quick = [e[0] for e in _items(menu_sections(g, st, _key))]
-        st.quick = False
-        full = [e[0] for e in _items(menu_sections(g, st, _key))]
-        want = g is not QUEST and not st.job
-        assert ("Update with a newer version…" in quick) == want, name
-        assert ("Update with a newer version…" in full) == want, name
-        if g is not QUEST:
-            assert "Update with a newer APK…" not in quick + full, name
@@ -38,36 +38,8 @@ def test_quote_refuses_batch_injection(value):
        native.quote(value)


-def test_quote_leaves_globs_to_sftp():
-    """Inside double quotes sftp escapes * ? [ itself: an extra backslash became part of the name (GitHub #324)."""
-    assert native.quote('a *?["b') == '"a *?[\\"b"'
-    assert native.quote("/x/te*s?t [ENG] \\b+(1).apk") == '"/x/te*s?t [ENG] \\\\b+(1).apk"'
-
-
-def test_quote_windows_local_path_uses_forward_slashes():
-    """Win32-OpenSSH turns a local path's backslashes into '/', escapes included ("C://Users", "/[ENG]")."""
-    path = r"C:\Users\user_name\AppData\Local\FramePort\output\All-In-One - Sports VR [ENG] v100+1.9.0 (x)\a.apk"
-    assert native.quote(path, windows=True) == (
-        '"C:/Users/user_name/AppData/Local/FramePort/output/All-In-One - Sports VR [ENG] v100+1.9.0 (x)/a.apk"')
-    assert native.quote(r"\\server\share\*?[a].apk", windows=True) == '"//server/share/*?[a].apk"'
-    assert native.quote('C:\\odd "name"\\a.apk', windows=True) == '"C:/odd \\"name\\"/a.apk"'
-
-
-@pytest.mark.parametrize("os_name,expected", [("nt", '"C:/games/[ENG] a/x.apk"'),
-                                              ("posix", '"C:\\\\games\\\\[ENG] a\\\\x.apk"')])
-def test_quote_local_follows_the_platform(monkeypatch, os_name, expected):
-    monkeypatch.setattr(native.os, "name", os_name)
-    assert native.quote_local(r"C:\games\[ENG] a\x.apk") == expected
-
-
-def test_batch_line_for_bracketed_folder(tmp_path, monkeypatch):
-    folder = tmp_path / "All-In-One - Sports VR [ENG] v100+1.9.0"
-    folder.mkdir()
-    frame, items, files, commands, processes = setup_batch(folder, monkeypatch)
-    monkeypatch.setattr(native.os, "name", "posix")
-    native.upload(frame, items, "/incoming", Reporter(), 20, 0, 1)
-    assert sorted(commands[0].splitlines()) == [f'put "{folder}/patch.obb" "/incoming/patch.obb.part"',
-                                                f'reput "{folder}/main.obb" "/incoming/main.obb.part"']
+def test_quote_protects_spaces_quotes_globs():
+    assert native.quote('a *?["b') == '"a \\*\\?\\[\\"b"'


 def test_size_lookup_does_not_hide_connection_errors():
@@ -93,11 +65,10 @@ def setup_batch(tmp_path, monkeypatch, code=0):
    monitor.stat.side_effect = stat
    monitor.remove.side_effect = lambda path: files.pop(path)
    frame = SimpleNamespace(sftp=monitor, client=SimpleNamespace(open_sftp=lambda: monitor),
-                            target=FrameTarget("paired"), run=Mock(return_value=(0, "", "")), modes_seen=[])
+                            target=FrameTarget("paired"), run=Mock(return_value=(0, "", "")))
    monkeypatch.setattr(native.shutil, "which", lambda _: "sftp")
    @contextlib.contextmanager
-    def creds(frame, relaxed=False):
-        frame.modes_seen.append(relaxed)
+    def creds(frame):
        yield ["-o", "StrictHostKeyChecking=yes"]
    monkeypatch.setattr(native, "credentials", creds)
    commands, processes = [], []
@@ -239,7 +210,7 @@ def setup_tar(tmp_path, monkeypatch, code=0):

    path = tmp_path / "small.bin"
    path.write_bytes(b"payload")
-    frame = SimpleNamespace(target=FrameTarget("paired.example", port=2222), modes_seen=[])
+    frame = SimpleNamespace(target=FrameTarget("paired.example", port=2222))
    pipe = io.BytesIO()
    pipe.close = lambda: None
    process = Mock(stdin=pipe, returncode=code)
@@ -248,9 +219,8 @@ def setup_tar(tmp_path, monkeypatch, code=0):
    monkeypatch.setattr(native.subprocess, "Popen", popen)
    monkeypatch.setattr(native.shutil, "which", lambda _: "ssh")
    @contextlib.contextmanager
-    def creds(frame, port_flag, relaxed=False):
+    def creds(frame, port_flag):
        assert port_flag == "-p"
-        frame.modes_seen.append(relaxed)
        yield ["-o", "StrictHostKeyChecking=yes", port_flag, "2222"]
    monkeypatch.setattr(native, "credentials", creds)
    return frame, [(path, "nested/small.bin")], process, popen, pipe
@@ -1,230 +0,0 @@
-"""GitHub #161: a newer version of a Linux app or a PC VR game already in the library (game menu "Update with a newer
-version…", CLI `frameport new-version`)."""
-import os
-import time
-
-import pytest
-from test_install_drives import FakeFrame
-from test_linux_apps import elf
-from test_rift import unity_game
-
-from frameport import pipeline
-from frameport.analysis import linux
-from frameport.core import library
-from frameport.core.events import Reporter
-from frameport.install import installer
-from frameport.ui import components as C
-
-
-def _appimage(path, extra=b""):
-    path.parent.mkdir(parents=True, exist_ok=True)
-    path.write_bytes(elf(linux.EM_AARCH64, appimage=True, extra=extra))
-    return path
-
-
-def _frame(package, recipe=None):
-    return {"installed": [{"package": package, "sha256": None, "recipe": recipe}]}
-
-
-# ------------------------------------------------------------------------------------------ Linux apps
-def test_newer_appimage_keeps_name_art_and_switches(tmp_path):
-    old = _appimage(tmp_path / "v1" / "Venera-Prime-2.4.2-aarch64.AppImage")
-    pkg = pipeline.add_linux_app(old)["package"]
-    library.upsert_game(pkg, title="My Venera", title_locked=True, tags=["mine"], desktop_entry=False,
-                        desktop_icon=False, vr_overlay=True)
-    assert C.install_state(library.game(pkg), _frame(pkg)) == "installed"  # never updated: no source id needed
-    new = _appimage(tmp_path / "v2" / "Venera-Prime-2.5.0-aarch64.AppImage", extra=b"newer")
-    res = pipeline.replace_linux_app(pkg, new)
-    g = library.game(pkg)
-    assert g["package"] == pkg and g["exe"] == new.name and g["game_dir"] == str(new.parent)
-    assert g["analysis"]["extra"]["source"] == str(new) and g["analysis"]["extra"]["files"] == [new.name]
-    assert g["data_bytes"] == new.stat().st_size
-    assert (g["title"], g["title_locked"], g["tags"]) == ("My Venera", True, ["mine"])
-    assert (g["desktop_entry"], g["desktop_icon"], g["vr_overlay"]) == (False, False, True)
-    assert g["replaced_source"] == str(old) and g["source_id"] and res["different"] is False
-    # the Frame's copy (installed before) is outdated until an install records this version
-    assert C.install_state(g, _frame(pkg)) == "outdated"
-    assert C.install_state(g, _frame(pkg, {"source_id": "older"})) == "outdated"
-    assert C.install_state(g, _frame(pkg, {"source_id": g["source_id"]})) == "installed"
-
-
-def test_newer_linux_folder_keeps_the_chosen_program(tmp_path):
-    def app(root, size):
-        (root / "bin").mkdir(parents=True)
-        (root / "Tool").write_bytes(elf(linux.EM_AARCH64, extra=b"\0" * size))  # bigger: FramePort's pick
-        (root / "bin" / "tool-vr").write_bytes(elf(linux.EM_AARCH64))
-        return root
-    pkg = pipeline.add_linux_app(app(tmp_path / "v1" / "Tool", 4096), exe="bin/tool-vr")["package"]
-    assert library.game(pkg)["exe"] == "bin/tool-vr"
-    pipeline.replace_linux_app(pkg, app(tmp_path / "v2" / "Tool", 8192))
-    g = library.game(pkg)
-    assert g["exe"] == "bin/tool-vr" and g["game_dir"] == str(tmp_path / "v2" / "Tool")
-    # the program isn't there any more: FramePort's pick
-    (tmp_path / "v3" / "Tool").mkdir(parents=True)
-    (tmp_path / "v3" / "Tool" / "Tool").write_bytes(elf(linux.EM_AARCH64))
-    pipeline.replace_linux_app(pkg, tmp_path / "v3" / "Tool")
-    assert library.game(pkg)["exe"] == "Tool"
-
-
-def test_another_linux_app_is_added_with_a_warning(tmp_path):
-    pkg = pipeline.add_linux_app(_appimage(tmp_path / "Venera-Prime-1.0-aarch64.AppImage"))["package"]
-    res = pipeline.replace_linux_app(pkg, _appimage(tmp_path / "Blender-4.2-aarch64.AppImage"))
-    assert res["different"] and res["name"] == "Blender" and library.game(pkg)["exe"].startswith("Blender")
-    assert not library.game("linux.blender")  # no second entry: the user's pick is the newer version
-    with pytest.raises(ValueError):
-        pipeline.replace_linux_app(pkg, tmp_path / "missing.AppImage")
-
-
-def test_only_the_right_kind(tmp_path):
-    pkg = pipeline.add_linux_app(_appimage(tmp_path / "Tool-aarch64.AppImage"))["package"]
-    with pytest.raises(ValueError):
-        pipeline.replace_rift_game(pkg, tmp_path)
-    library.upsert_game("com.x.quest", title="Quest", apk="/x.apk")
-    with pytest.raises(ValueError):
-        pipeline.replace_linux_app("com.x.quest", tmp_path / "Tool-aarch64.AppImage")
-
-
-def test_linux_update_sends_changed_files_of_the_same_size(tmp_path, monkeypatch):
-    (tmp_path / "app").mkdir()
-    for name in ("tool", "data.txt"):
-        (tmp_path / "app" / name).write_bytes(b"x" * 10)
-    old = time.time() - 3600
-    os.utime(tmp_path / "app" / "data.txt", (old, old))
-    monkeypatch.setattr(installer, "upload_steam_art", lambda *a, **k: None)
-    monkeypatch.setattr(installer, "apply_app_icon", lambda *a, **k: None)
-    monkeypatch.setattr(installer, "_tags", lambda pkg: [])
-    sent = []
-    monkeypatch.setattr(installer, "upload_files", lambda xfer, files, *a: sent.extend(f[1] for f in files))
-    monkeypatch.setattr(installer, "transfer_link", lambda *a: _Null())
-    frame = FakeFrame({"prepare_linux": {"existing": {"app": {"tool": 10, "data.txt": 10}}, "free_bytes": 1 << 40,
-                                         "incoming": "/x/incoming", "base": "/b"},
-                       "finalize_linux": {"base": "/b", "appid": 1}})
-    plan = installer.LinuxPlan("linux.tool", "Tool", tmp_path / "app", "tool")
-    installer.install_linux(frame, plan, Reporter())
-    assert sent == [] and dict(frame.calls)["finalize_linux"]["recipe"] is None  # same sizes: nothing sent
-    # (st_ctime can't be set: the file's own ctime is now) a newer version: files changed since the last install
-    plan = installer.LinuxPlan("linux.tool", "Tool", tmp_path / "app", "tool", source_id="v2",
-                               changed_since=time.time() + 60)
-    installer.install_linux(frame, plan, Reporter())
-    assert sent == []
-    plan.changed_since = time.time() - 60
-    installer.install_linux(frame, plan, Reporter())
-    assert sorted(sent) == ["app/data.txt", "app/tool"]
-    assert frame.calls[-1][1]["recipe"] == {"source_id": "v2"}
-
-
-class _Null:
-    def __enter__(self):
-        return None
-
-    def __exit__(self, *a):
-        return False
-
-
-def test_install_records_the_version(tmp_path, monkeypatch):
-    pkg = pipeline.add_linux_app(_appimage(tmp_path / "v1" / "Tool-aarch64.AppImage"))["package"]
-    got = {}
-
-    class T:
-        label = "Frame"
-
-        def install_linux(self, *a, **k):
-            got.clear()
-            got.update(k)
-            return {}
-    monkeypatch.setattr(pipeline, "steam_title", lambda e: "Tool")
-    pipeline.install_linux(pkg, T(), Reporter(), add_to_library=False)
-    assert "source_id" not in got  # never updated: installs as before
-    pipeline.replace_linux_app(pkg, _appimage(tmp_path / "v2" / "Tool-aarch64.AppImage"))
-    sid = library.game(pkg)["source_id"]
-    pipeline.install_linux(pkg, T(), Reporter(), add_to_library=False)
-    assert got["source_id"] == sid and 0 < got["changed_since"] <= time.time()  # since the last install there
-    assert library.game(pkg)["installs"]["Frame"]["source_id"] == sid
-    pipeline.install_linux(pkg, T(), Reporter(), add_to_library=False)
-    assert got["changed_since"] is None  # this version is there already: resumes as usual
-
-
-# ------------------------------------------------------------------------------------------ PC VR (Rift) games
-def _rift(tmp_path):
-    first = unity_game(tmp_path / "v1")
-    [g] = pipeline.add_path(tmp_path / "v1")
-    pkg = g["package"]
-    r = library.recipe_from_dict(g["recipe"])
-    r.source = "user"
-    r.patches["pcvr.no_crash_reporter"] = {}
-    pipeline.set_recipe(pkg, r)
-    library.upsert_game(pkg, title="My Space", tags=["mine"], exe_confirmed=True,
-                        build={"ok": True, "sha256": "old", "kind": "rift"})
-    return pkg, first
-
-
-def test_newer_rift_folder_keeps_name_recipe_and_program(tmp_path):
-    pkg, first = _rift(tmp_path)
-    new = unity_game(tmp_path / "v2")
-    res = pipeline.replace_rift_game(pkg, new)
-    g = library.game(pkg)
-    assert g["game_dir"] == str(new) and g["exe"] == "Space Game.exe" and g["exe_confirmed"] is True
-    assert (g["title"], g["tags"]) == ("My Space", ["mine"])
-    assert "pcvr.no_crash_reporter" in g["recipe"]["patches"] and g["recipe"]["source"] == "user"
-    assert g["build"] is None and g["replaced_dirs"] == [str(first)] and not res["different"]
-    from frameport.patches.pcvr import game_args
-
-    dep = {"package": pkg, "sha256": "old", "recipe": {"patches": sorted(g["recipe"]["patches"])},
-           "game_args": game_args(library.recipe_from_dict(g["recipe"]))}
-    assert C.install_state(g, {"installed": [dep]}) == "outdated"
-    assert C.pc_outdated(g, dep)
-    dep["recipe"]["source_id"] = g["source_id"]
-    assert C.install_state(g, {"installed": [dep]}) == "installed" and not C.pc_outdated(g, dep)
-    # a rescan of the folders doesn't bring the old copy back
-    assert pipeline.add_path(tmp_path / "v1") == [] and library.game(pkg)["game_dir"] == str(new)
-
-
-def test_newer_rift_folder_without_the_program_picks_again(tmp_path):
-    pkg, _ = _rift(tmp_path)
-    new = unity_game(tmp_path / "v2", name="Space Game VR")
-    res = pipeline.replace_rift_game(pkg, new)
-    assert res["exe_changed"] and library.game(pkg)["exe"] == "Space Game VR.exe"
-    with pytest.raises(ValueError):
-        pipeline.replace_rift_game(pkg, tmp_path / "nothing")
-    other = unity_game(tmp_path / "other", name="Moon Game")
-    pipeline.add_path(tmp_path / "other")
-    with pytest.raises(ValueError, match="already in the library"):
-        pipeline.replace_rift_game(pkg, other)
-
-
-def test_rift_update_resends_changed_game_files(tmp_path, monkeypatch):
-    game = unity_game(tmp_path)
-    monkeypatch.setattr(installer, "upload_steam_art", lambda *a, **k: None)
-    monkeypatch.setattr(installer, "_tags", lambda pkg: [])
-    monkeypatch.setattr(installer, "transfer_link", lambda *a: _Null())
-    sent = []
-    monkeypatch.setattr(installer, "upload_files", lambda xfer, files, *a: sent.extend(f[1] for f in files))
-    monkeypatch.setattr("frameport.artwork.sources.has_art", lambda pkg: True)
-    manifest = installer.local_data_manifest(game)
-    frame = FakeFrame({"prepare_pcvr": {"proton": {"display_name": "Proton"}, "openxr": None,
-                                        "existing": {"game": dict(manifest)}, "free_bytes": 1 << 40,
-                                        "incoming": "/i", "base": "/b"},
-                       "finalize_pcvr": {"base": "/b", "proton": "p", "appid": 1}})
-    from frameport.core.models import Recipe
-
-    plan = installer.PcvrPlan("rift.space_game", "Space", game, "Space Game.exe", Recipe(package="rift.space_game"),
-                              None, source_id="v2", changed_since=time.time() - 60)
-    installer.install_pcvr(frame, plan, Reporter())
-    assert sorted(sent) == sorted(f"game/{rel}" for rel in manifest)
-    assert frame.calls[-1][1]["recipe"]["source_id"] == "v2"
-
-
-# ------------------------------------------------------------------------------------------ CLI
-def test_cli_new_version(tmp_path):
-    from typer.testing import CliRunner
-
-    from frameport import cli
-
-    pkg = pipeline.add_linux_app(_appimage(tmp_path / "v1" / "Tool-1.0-aarch64.AppImage"))["package"]
-    new = _appimage(tmp_path / "v2" / "Tool-1.1-aarch64.AppImage")
-    out = CliRunner().invoke(cli.app, ["new-version", pkg, str(new)])
-    assert out.exit_code == 0, out.output
-    assert library.game(pkg)["exe"] == new.name and "program Tool-1.1-aarch64.AppImage" in out.output
-    (tmp_path / "empty").mkdir()
-    bad = CliRunner().invoke(cli.app, ["new-version", pkg, str(tmp_path / "empty")])  # no program in it
-    assert bad.exit_code == 2
@@ -0,0 +1,223 @@
+"""What FrameBridge's xrGetCurrentInteractionProfile reports (native/adapter/profile_report.c): SteamVR's profiles as
+Touch (controller_fix) and, after profile_remap moved a game's Touch Plus/Pro bindings to Touch, the game's own profile
+(GitHub #327: Unity's OpenXR input found no device for oculus/touch_controller, the hands lay on the floor). Compiled
+for this host with a small harness standing in for the adapter and the runtime.
+Opt-in (FRAMEPORT_NATIVE_TESTS=1, -m native): needs the OpenXR headers in native/.cache (from native/build.py)."""
+import os
+import shutil
+import subprocess
+from pathlib import Path
+
+import pytest
+
+ROOT = Path(__file__).resolve().parents[1]
+INC = next(iter((ROOT / "native/.cache").glob("openxr-*")), None)
+CC = shutil.which("cc") or shutil.which("clang")
+pytestmark = [pytest.mark.native, pytest.mark.skipif(
+    not os.environ.get("FRAMEPORT_NATIVE_TESTS") or not INC or not CC,
+    reason="set FRAMEPORT_NATIVE_TESTS=1 (needs the OpenXR headers from native/build.py and a host C compiler)")]
+
+HARNESS = r"""
+#include <openxr/openxr.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#define LOG(...) (fprintf(stderr, __VA_ARGS__), fputc('\n', stderr))
+static XrInstance active_instance = (XrInstance)(uintptr_t)1;
+static int controller_fix = 1, profile_remap = 1, app_suggested_touch;
+static const char *const TOUCH_PROFILE = "/interaction_profiles/oculus/touch_controller";
+static char paths[16][XR_MAX_PATH_LENGTH];
+static int path_count;
+static XRAPI_ATTR XrResult XRAPI_CALL fake_string_to_path(XrInstance i, const char *s, XrPath *out) {
+    (void)i;
+    for (int k = 0; k < path_count; ++k) if (!strcmp(paths[k], s)) { *out = (XrPath)(k + 1); return XR_SUCCESS; }
+    snprintf(paths[path_count], XR_MAX_PATH_LENGTH, "%s", s);
+    *out = (XrPath)++path_count;
+    return XR_SUCCESS;
+}
+static XRAPI_ATTR XrResult XRAPI_CALL fake_path_to_string(XrInstance i, XrPath p, uint32_t cap, uint32_t *n,
+                                                          char *out) {
+    (void)i;
+    if (!p || p > (XrPath)path_count) return XR_ERROR_PATH_INVALID;
+    *n = (uint32_t)snprintf(out, cap, "%s", paths[p - 1]) + 1;
+    return XR_SUCCESS;
+}
+static PFN_xrVoidFunction lookup(XrInstance i, const char *name) {
+    (void)i;
+    if (!strcmp(name, "xrPathToString")) return (PFN_xrVoidFunction)fake_path_to_string;
+    if (!strcmp(name, "xrStringToPath")) return (PFN_xrVoidFunction)fake_string_to_path;
+    return NULL;
+}
+#include "profile_report.c"
+static XrPath P(const char *s) { XrPath p; fake_string_to_path(0, s, &p); return p; }
+static const char *answer(const char *hand, const char *runtime) {
+    XrInteractionProfileState state = {XR_TYPE_INTERACTION_PROFILE_STATE, NULL, runtime ? P(runtime) : XR_NULL_PATH};
+    current_profile_fix(P(hand), &state);
+    return state.interactionProfile ? paths[state.interactionProfile - 1] : "(none)";
+}
+int main(void) {
+    const char *touch = "/interaction_profiles/oculus/touch_controller";
+    const char *frame = "/interaction_profiles/valve/frame_controller";
+    const char *plus = "/interaction_profiles/meta/touch_controller_plus";
+    // no remap: SteamVR's profile becomes Touch, Touch stays Touch, none stays none
+    printf("%s\n", answer("/user/hand/left", frame));
+    printf("%s\n", answer("/user/hand/left", touch));
+    printf("%s\n", answer("/user/hand/left", NULL));
+    // the game's Touch Plus bindings were moved to Touch: Touch (and SteamVR's profile) are reported as Touch Plus
+    snprintf(remapped_profile, sizeof(remapped_profile), "%s", plus);
+    printf("%s\n", answer("/user/hand/left", touch));
+    printf("%s\n", answer("/user/hand/right", frame));
+    printf("%s\n", answer("/user/hand/right", NULL));
+    printf("%s\n", answer("/user/hand/right", "/interaction_profiles/htc/vive_controller"));
+    // controller_fix off: SteamVR's own profile is passed on unchanged, Touch is still reported as the game's
+    controller_fix = 0;
+    printf("%s\n", answer("/user/hand/left", frame));
+    printf("%s\n", answer("/user/hand/left", touch));
+    // the game suggested Touch bindings itself: Touch is reported as Touch
+    controller_fix = 1;
+    app_suggested_touch = 1;
+    printf("%s\n", answer("/user/hand/left", touch));
+    // profile_remap off: Touch as Touch
+    app_suggested_touch = 0;
+    profile_remap = 0;
+    printf("%s\n", answer("/user/hand/left", touch));
+    return 0;
+}
+"""
+
+STDOUT = [
+    "/interaction_profiles/oculus/touch_controller",
+    "/interaction_profiles/oculus/touch_controller",
+    "(none)",
+    "/interaction_profiles/meta/touch_controller_plus",
+    "/interaction_profiles/meta/touch_controller_plus",
+    "(none)",
+    "/interaction_profiles/htc/vive_controller",
+    "/interaction_profiles/valve/frame_controller",
+    "/interaction_profiles/meta/touch_controller_plus",
+    "/interaction_profiles/oculus/touch_controller",
+    "/interaction_profiles/oculus/touch_controller",
+]
+
+
+@pytest.fixture(scope="module")
+def harness(tmp_path_factory):
+    d = tmp_path_factory.mktemp("profile_report")
+    (d / "harness.c").write_text(HARNESS)
+    subprocess.run([CC, "-std=c11", "-D_GNU_SOURCE", "-Wall", "-Wextra", "-Werror", "-Wno-unused-function",
+                    "-Wno-missing-field-initializers", "-I", str(INC), "-I", str(ROOT / "native/adapter"),
+                    str(d / "harness.c"), "-o", str(d / "harness")], check=True)
+    return d / "harness"
+
+
+def test_reports_the_games_profile_after_a_remap(harness):
+    p = subprocess.run([str(harness)], capture_output=True, text=True)
+    assert p.returncode == 0, p.stderr
+    assert p.stdout.splitlines() == STDOUT
+    logged = [line for line in p.stderr.splitlines() if line.startswith("profile_remap:")]
+    assert logged[:2] == [
+        "profile_remap: /user/hand/left reported as meta/touch_controller_plus (the app's profile) instead of "
+        "oculus/touch_controller",
+        "profile_remap: /user/hand/right reported as meta/touch_controller_plus (the app's profile) instead of "
+        "oculus/touch_controller",
+    ]
+    assert len(logged) == 3  # once per report (at most 4)
+
+
+DETACHED = r"""
+#include <openxr/openxr.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#define LOG(...) (fprintf(stderr, __VA_ARGS__), fputc('\n', stderr))
+static XrInstance active_instance = (XrInstance)(uintptr_t)1;
+static int profile_remap = 1, runtime_has_detached_controllers;
+static char paths[32][XR_MAX_PATH_LENGTH];
+static int path_count;
+static XRAPI_ATTR XrResult XRAPI_CALL fake_string_to_path(XrInstance i, const char *s, XrPath *out) {
+    (void)i;
+    for (int k = 0; k < path_count; ++k) if (!strcmp(paths[k], s)) { *out = (XrPath)(k + 1); return XR_SUCCESS; }
+    snprintf(paths[path_count], XR_MAX_PATH_LENGTH, "%s", s);
+    *out = (XrPath)++path_count;
+    return XR_SUCCESS;
+}
+static XRAPI_ATTR XrResult XRAPI_CALL fake_path_to_string(XrInstance i, XrPath p, uint32_t cap, uint32_t *n,
+                                                          char *out) {
+    (void)i;
+    if (!p || p > (XrPath)path_count) return XR_ERROR_PATH_INVALID;
+    *n = (uint32_t)snprintf(out, cap, "%s", paths[p - 1]) + 1;
+    return XR_SUCCESS;
+}
+static PFN_xrVoidFunction lookup(XrInstance i, const char *name) {
+    (void)i;
+    if (!strcmp(name, "xrPathToString")) return (PFN_xrVoidFunction)fake_path_to_string;
+    return NULL;
+}
+#include "detached_controllers.c"
+static XrPath P(const char *s) { XrPath p; fake_string_to_path(0, s, &p); return p; }
+static void show_action(const XrActionCreateInfo *info) {
+    printf("%s:", info->actionName);
+    for (uint32_t i = 0; i < info->countSubactionPaths; ++i) printf(" %s", paths[info->subactionPaths[i] - 1]);
+    printf("\n");
+}
+int main(void) {
+    XrPath sub[4] = {P("/user/hand/left"), P("/user/hand/right"), P("/user/detached_controller_meta/left"),
+                     P("/user/detached_controller_meta/right")}, kept[4];
+    XrActionCreateInfo info = {XR_TYPE_ACTION_CREATE_INFO, NULL, "thumbstick", XR_ACTION_TYPE_VECTOR2F_INPUT, 4, sub,
+                               "Thumbstick"}, copy;
+    show_action(detached_strip_action(&info, &copy, kept));
+    info.countSubactionPaths = 2;  // hands only: passed on as it is
+    printf("%d\n", detached_strip_action(&info, &copy, kept) == &info);
+
+    XrActionSuggestedBinding b[3] = {{(XrAction)(uintptr_t)7, P("/user/hand/left/input/thumbstick")},
+                                     {(XrAction)(uintptr_t)7, P("/user/detached_controller_meta/left/input/thumbstick")},
+                                     {(XrAction)(uintptr_t)8, P("/user/hand/right/input/a/click")}}, kb[3];
+    XrInteractionProfileSuggestedBinding s = {XR_TYPE_INTERACTION_PROFILE_SUGGESTED_BINDING, NULL,
+                                              P("/interaction_profiles/oculus/touch_controller"), 3, b}, scopy;
+    const XrInteractionProfileSuggestedBinding *u = detached_strip_bindings(&s, &scopy, kb);
+    for (uint32_t i = 0; i < u->countSuggestedBindings; ++i) printf("%s\n", paths[u->suggestedBindings[i].binding - 1]);
+
+    XrInteractionProfileState st = {XR_TYPE_INTERACTION_PROFILE_STATE, NULL, 5};
+    XrResult r = detached_current_profile(sub[2], &st, XR_ERROR_PATH_UNSUPPORTED);
+    printf("%d %llu\n", r, (unsigned long long)st.interactionProfile);
+    printf("%d\n", detached_current_profile(sub[0], &st, XR_ERROR_PATH_UNSUPPORTED));  // hands: unchanged
+    printf("%d\n", detached_current_profile(sub[2], &st, XR_ERROR_ACTIONSET_NOT_ATTACHED));  // other errors stay
+
+    runtime_has_detached_controllers = 1;  // the runtime knows them: nothing changes
+    info.countSubactionPaths = 4;
+    printf("%d %d %d\n", detached_strip_action(&info, &copy, kept) == &info,
+           detached_strip_bindings(&s, &scopy, kb) == &s,
+           detached_current_profile(sub[2], &st, XR_ERROR_PATH_UNSUPPORTED));
+    runtime_has_detached_controllers = 0;
+    profile_remap = 0;  // off: nothing changes
+    printf("%d %d\n", detached_strip_action(&info, &copy, kept) == &info, detached_strip_bindings(&s, &scopy, kb) == &s);
+    return 0;
+}
+"""
+
+
+def test_detached_controller_paths_left_out(tmp_path):
+    (tmp_path / "detached.c").write_text(DETACHED)
+    subprocess.run([CC, "-std=c11", "-D_GNU_SOURCE", "-Wall", "-Wextra", "-Werror", "-Wno-unused-function",
+                    "-Wno-missing-field-initializers", "-I", str(INC), "-I", str(ROOT / "native/adapter"),
+                    str(tmp_path / "detached.c"), "-o", str(tmp_path / "detached")], check=True)
+    p = subprocess.run([str(tmp_path / "detached")], capture_output=True, text=True)
+    assert p.returncode == 0, p.stderr
+    assert p.stdout.splitlines() == [
+        "thumbstick: /user/hand/left /user/hand/right",
+        "1",
+        "/user/hand/left/input/thumbstick",
+        "/user/hand/right/input/a/click",
+        "0 0",
+        str(-22),  # XR_ERROR_PATH_UNSUPPORTED
+        str(-46),  # XR_ERROR_ACTIONSET_NOT_ATTACHED
+        "1 1 -22",
+        "1 1",
+    ]
+    assert p.stderr.splitlines() == [
+        "profile_remap: action thumbstick without 2 detached-controller path(s) (the runtime has no "
+        "XR_META_detached_controllers)",
+        "profile_remap: /interaction_profiles/oculus/touch_controller bindings without 1 detached-controller path(s)",
+    ]
@@ -1,340 +0,0 @@
-"""SSH keys beyond FramePort's own (GitHub #242): key files from Settings, the login a connection used, and OpenSSH
-uploads that fall back to this PC's own keys/agent when the Frame refuses FramePort's key."""
-import contextlib
-from pathlib import Path
-from types import SimpleNamespace
-from unittest.mock import Mock
-
-import paramiko
-import pytest
-from cryptography.hazmat.primitives import serialization
-from cryptography.hazmat.primitives.asymmetric import ed25519
-
-from frameport.core import library
-from frameport.core.events import Reporter
-from frameport.frame import connection as C
-from frameport.frame import native_upload as native
-
-REFUSED = (b"debug1: Reading configuration data nul\r\n"
-           b"debug1: identity file C:/Temp/frameport-upload-x/key0 type 3\r\n"
-           b"debug1: Connecting to 10.0.0.2 [10.0.0.2] port 22.\r\n"
-           b"@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @\r\n"
-           b"debug1: Offering public key: C:/Temp/frameport-upload-x/key0 ED25519 SHA256:abc explicit\r\n"
-           b"debug1: Authentications that can continue: publickey,password\r\n"
-           b"debug1: kex: algorithm: curve25519-sha256\r\n"
-           b"steamos@10.0.0.2: Permission denied (publickey,password).\r\n")
-
-
-@pytest.fixture(autouse=True)
-def no_real_home_keys(tmp_path, monkeypatch):
-    """Never read the real ~/.ssh (relaxed mode looks there)."""
-    empty = tmp_path / "empty-home"
-    empty.mkdir()
-    monkeypatch.setattr(native.Path, "home", lambda: empty)
-
-
-def write_key(path: Path, password: bytes | None = None) -> Path:
-    enc = serialization.BestAvailableEncryption(password) if password else serialization.NoEncryption()
-    key = ed25519.Ed25519PrivateKey.generate()
-    path.write_bytes(key.private_bytes(serialization.Encoding.PEM, serialization.PrivateFormat.OpenSSH, enc))
-    path.with_name(path.name + ".pub").write_bytes(key.public_key().public_bytes(
-        serialization.Encoding.OpenSSH, serialization.PublicFormat.OpenSSH))
-    return path
-
-
-# ------------------------------------------------------------------------------------------- key files
-def test_key_file_validation(tmp_path):
-    good = write_key(tmp_path / "id_ed25519")
-    assert isinstance(C.load_key_file(good), paramiko.PKey)
-    with pytest.raises(C.KeyFileError, match="passphrase"):
-        C.load_key_file(write_key(tmp_path / "locked", b"secret"))
-    with pytest.raises(C.KeyFileError, match="public half"):
-        C.load_key_file(tmp_path / "id_ed25519.pub")
-    with pytest.raises(C.KeyFileError, match="not found"):
-        C.load_key_file(tmp_path / "missing")
-    (tmp_path / "notes.txt").write_text("hello")
-    with pytest.raises(C.KeyFileError, match="isn't a private SSH key"):
-        C.load_key_file(tmp_path / "notes.txt")
-
-
-def test_extra_keys_come_from_settings_and_skip_unusable_ones(tmp_path):
-    good = write_key(tmp_path / "mine")
-    locked = write_key(tmp_path / "locked", b"secret")
-    library.set_setting(C.EXTRA_KEYS_SETTING, [str(good), str(good), str(locked), str(tmp_path / "gone"), "", 3])
-    assert C.extra_key_paths() == [good, locked, tmp_path / "gone"]
-    assert [path for path, _ in C.extra_keys()] == [good]
-    library.set_setting(C.EXTRA_KEYS_SETTING, str(good))  # a single path, e.g. edited by hand
-    assert C.extra_key_paths() == [good]
-
-
-class _Client:
-    """paramiko.SSHClient stand-in: accepts the key `accepted` (or the agent when accepted == "agent")."""
-    accepted = None
-    tried: list = []
-
-    def load_host_keys(self, path):
-        pass
-
-    def set_missing_host_key_policy(self, policy):
-        pass
-
-    def close(self):
-        pass
-
-    def save_host_keys(self, path):
-        pass
-
-    def get_transport(self):
-        return Mock()
-
-    def connect(self, pkey=None, password=None, allow_agent=False, look_for_keys=False, **kw):
-        kind = "password" if password else "agent" if allow_agent else pkey
-        _Client.tried.append(kind)
-        if kind != _Client.accepted:
-            raise paramiko.AuthenticationException("Authentication failed.")
-
-
-@pytest.mark.parametrize("accepted,auth", [("app", "app_key"), ("user", "user_key"), ("agent", "agent")])
-def test_connection_records_the_login_that_worked(monkeypatch, accepted, auth):
-    monkeypatch.setattr(C.paramiko, "SSHClient", _Client)
-    monkeypatch.setattr(C, "app_keys", lambda: ["app"])
-    monkeypatch.setattr(C, "extra_keys", lambda: [(Path("/k"), "user")])
-    monkeypatch.setattr(C.Frame, "run", lambda self, cmd: (0, "/home/steamos", ""))
-    _Client.accepted, _Client.tried = accepted, []
-    frame = C.Frame(C.FrameTarget("10.0.0.2")).connect()
-    assert frame.auth == auth
-    assert _Client.tried == ["app", "user", "agent"][:["app", "user", "agent"].index(accepted) + 1]
-
-
-# ------------------------------------------------------------------------------------------- OpenSSH arguments
-def frame_with_key():
-    key = SimpleNamespace(get_name=lambda: "ssh-ed25519", get_base64=lambda: "PAIRED_KEY")
-    client = SimpleNamespace(get_transport=lambda: SimpleNamespace(get_remote_server_key=lambda: key))
-    return C.Frame(C.FrameTarget("paired.example"), client=client)
-
-
-def test_credentials_offer_own_and_settings_keys_strict_or_relaxed(tmp_path, monkeypatch):
-    own = tmp_path / "ssh"
-    own.mkdir()
-    write_key(own / "id_ed25519")
-    mine = write_key(tmp_path / "id_ed25519")  # same file name as FramePort's: copies get their own names
-    monkeypatch.setattr(native, "ssh_dir", lambda: own)
-    library.set_setting(C.EXTRA_KEYS_SETTING, [str(mine)])
-    with native.credentials(frame_with_key()) as args:
-        copies = [Path(args[i + 1]) for i, a in enumerate(args) if a == "-i"]
-        assert [c.read_bytes() for c in copies] == [(own / "id_ed25519").read_bytes(), mine.read_bytes()]
-        assert "IdentitiesOnly=yes" in args and "BatchMode=yes" in args and "-v" in args
-        assert all(oct(c.stat().st_mode & 0o777) == "0o600" for c in copies)
-    assert not any(c.exists() for c in copies)
-    with native.credentials(frame_with_key(), relaxed=True) as args:
-        assert "IdentitiesOnly=yes" not in args and args.count("-i") == 2
-        assert "StrictHostKeyChecking=yes" in args  # host key still pinned
-
-
-def test_relaxed_credentials_work_without_any_key_file(tmp_path, monkeypatch):
-    monkeypatch.setattr(native, "ssh_dir", lambda: tmp_path)
-    with pytest.raises(OSError, match="no FramePort key"):
-        with native.credentials(frame_with_key()):
-            pass
-    with native.credentials(frame_with_key(), relaxed=True) as args:
-        assert "-i" not in args
-
-
-def test_windows_sid_survives_a_non_ascii_user_name(monkeypatch):
-    out = '"desktop-1\\josé müller","S-1-5-21-1004336348-1177238915-682003330-1001"\r\n'.encode("cp850")
-    monkeypatch.setattr(native.subprocess, "check_output", lambda *a, **k: out)
-    assert native.current_sid() == "S-1-5-21-1004336348-1177238915-682003330-1001"
-    monkeypatch.setattr(native.subprocess, "check_output", lambda *a, **k: b"nothing")
-    with pytest.raises(OSError):
-        native.current_sid()
-
-
-# ------------------------------------------------------------------------------------------- failures and modes
-def test_failure_keeps_openssh_messages_and_key_lines():
-    exc = native.failure("OpenSSH SFTP", 255, REFUSED)
-    assert isinstance(exc, native.OpenSSHAuthFailed)
-    text = str(exc)
-    assert "UNPROTECTED PRIVATE KEY FILE" in text and "Offering public key" in text
-    assert "identity file" in text and "Permission denied (publickey,password)" in text
-    assert "kex: algorithm" not in text and "Reading configuration" not in text
-    other = native.failure("OpenSSH SFTP", 1, b"stat x: No such file or directory\n")
-    assert type(other) is OSError and "No such file" in str(other)
-    assert type(native.failure("OpenSSH tar", 255, b"ssh: connect to host x port 22: Connection timed out")) is OSError
-
-
-@pytest.mark.parametrize("auth,known,modes", [("app_key", None, [False, True]), ("user_key", None, [False, True]),
-                                              ("password", None, [False, True]), ("agent", None, [True]),
-                                              ("app_key", True, [True]), ("agent", False, [False])])
-def test_login_modes(auth, known, modes):
-    assert native.login_modes(SimpleNamespace(auth=auth, openssh_relaxed=known)) == modes
-    assert native.login_modes(SimpleNamespace()) == [False, True]  # stand-ins without the fields
-
-
-def sftp_setup(tmp_path, monkeypatch, refuse_strict=True, refuse_relaxed=False, auth="app_key"):
-    """Two .part-less files; strict/relaxed logins refused as asked; returns the frame and the Popen calls."""
-    paths = [tmp_path / "main.obb", tmp_path / "patch.obb"]
-    for path in paths:
-        path.write_bytes(b"0123456789")
-    items = [(path, path.name, 10) for path in paths]
-    files = {}
-    monitor = Mock()
-    monitor.__enter__ = Mock(return_value=monitor)
-    monitor.__exit__ = Mock(return_value=False)
-
-    def stat(path):
-        if path not in files:
-            raise FileNotFoundError(path)
-        return SimpleNamespace(st_size=files[path])
-    monitor.stat.side_effect = stat
-    frame = SimpleNamespace(sftp=monitor, client=SimpleNamespace(open_sftp=lambda: monitor), auth=auth,
-                            openssh_relaxed=None, target=C.FrameTarget("paired"), run=Mock(return_value=(0, "", "")))
-    monkeypatch.setattr(native.shutil, "which", lambda _: "sftp")
-    mode = {}
-
-    @contextlib.contextmanager
-    def creds(frame, port_flag="-P", relaxed=False):
-        mode["relaxed"] = relaxed
-        yield ["relaxed" if relaxed else "strict"]
-    monkeypatch.setattr(native, "credentials", creds)
-    calls = []
-
-    def popen(args, **kwargs):
-        relaxed = mode["relaxed"]
-        calls.append(relaxed)
-        refused = refuse_relaxed if relaxed else refuse_strict
-        if refused:
-            kwargs["stderr"].write(REFUSED)
-            code = 255
-        else:
-            for _, rel, size in items:
-                files["/incoming/" + rel + ".part"] = size
-            code = 0
-        process = Mock(returncode=code)
-        process.poll.return_value = code
-        return process
-    monkeypatch.setattr(native.subprocess, "Popen", popen)
-    return frame, items, calls
-
-
-def test_refused_strict_login_retries_with_this_pcs_keys(tmp_path, monkeypatch):
-    frame, items, calls = sftp_setup(tmp_path, monkeypatch)
-    logs = []
-    reporter = Reporter()
-    reporter.log = lambda message, **k: logs.append(message)
-    assert native.upload(frame, items, "/incoming", reporter, 20, 0, 2) == 20
-    assert calls == [False, False, True, True]  # both strict workers are refused, then both run relaxed
-    assert frame.openssh_relaxed is True
-    assert any("trying this PC's own SSH keys" in m and "UNPROTECTED" in m for m in logs)
-    assert native.login_modes(frame) == [True]  # the next upload starts in the mode that worked
-
-
-def test_agent_login_goes_straight_to_relaxed(tmp_path, monkeypatch):
-    frame, items, calls = sftp_setup(tmp_path, monkeypatch, auth="agent")
-    assert native.upload(frame, items, "/incoming", Reporter(), 20, 0, 1) == 20
-    assert calls == [True]
-
-
-def test_refused_in_both_modes_raises_the_auth_failure(tmp_path, monkeypatch):
-    frame, items, calls = sftp_setup(tmp_path, monkeypatch, refuse_relaxed=True)
-    with pytest.raises(native.OpenSSHAuthFailed, match="Permission denied"):
-        native.upload(frame, items, "/incoming", Reporter(), 20, 0, 1)
-    assert calls == [False, True] and frame.openssh_relaxed is None
-    assert not frame.run.called  # nothing promoted
-
-
-def test_tar_retries_a_refused_login(tmp_path, monkeypatch):
-    path = tmp_path / "small.bin"
-    path.write_bytes(b"abc")
-    frame = SimpleNamespace(target=C.FrameTarget("paired"), auth="app_key", openssh_relaxed=None)
-    monkeypatch.setattr(native.shutil, "which", lambda _: "ssh")
-    mode = {}
-
-    @contextlib.contextmanager
-    def creds(frame, port_flag="-P", relaxed=False):
-        mode["relaxed"] = relaxed
-        yield []
-    monkeypatch.setattr(native, "credentials", creds)
-
-    class Pipe:
-        def write(self, data):
-            if not mode["relaxed"]:
-                raise BrokenPipeError(32, "Broken pipe")  # ssh already exited
-            return len(data)
-
-        def flush(self):
-            pass
-
-        def close(self):
-            pass
-    calls = []
-
-    def popen(args, **kwargs):
-        calls.append(mode["relaxed"])
-        code = 0 if mode["relaxed"] else 255
-        if code:
-            kwargs["stderr"].write(REFUSED)
-        process = Mock(stdin=Pipe(), returncode=code)
-        process.poll.return_value = code
-        return process
-    monkeypatch.setattr(native.subprocess, "Popen", popen)
-    native.put_tar(frame, [(path, "small.bin")], "/incoming", Reporter(), Mock())
-    assert calls == [False, True] and frame.openssh_relaxed is True
-
-
-def test_azure_ad_sid(monkeypatch):
-    out = b'"azuread\\jmueller","S-1-12-1-1234567890-1234567890-1234567890-1234567890"\r\n'
-    monkeypatch.setattr(native.subprocess, "check_output", lambda *a, **k: out)
-    assert native.current_sid() == "S-1-12-1-1234567890-1234567890-1234567890-1234567890"
-
-
-def test_relaxed_mode_names_this_pcs_default_keys(tmp_path, monkeypatch):
-    """OpenSSH skips its default keys once any -i is given, so relaxed mode names the ones Paramiko tries."""
-    home = tmp_path / "home"
-    (home / ".ssh").mkdir(parents=True)
-    rsa = home / ".ssh" / "id_rsa"
-    from cryptography.hazmat.primitives.asymmetric import rsa as rsa_keys
-
-    rsa.write_bytes(rsa_keys.generate_private_key(65537, 2048).private_bytes(
-        serialization.Encoding.PEM, serialization.PrivateFormat.OpenSSH, serialization.NoEncryption()))
-    write_key(home / ".ssh" / "id_ecdsa", b"secret")  # passphrase: only usable through the agent
-    (home / ".ssh" / "id_ed25519").write_text("garbage")
-    monkeypatch.setattr(native.Path, "home", lambda: home)
-    own = tmp_path / "own"
-    own.mkdir()
-    write_key(own / "id_ed25519")
-    monkeypatch.setattr(native, "ssh_dir", lambda: own)
-    assert native.default_key_files() == [rsa]
-    assert native.key_files() == [own / "id_ed25519"]
-    assert native.key_files(relaxed=True) == [own / "id_ed25519", rsa]
-    library.set_setting(C.EXTRA_KEYS_SETTING, [str(rsa)])  # a default key also named in Settings: offered once
-    assert native.key_files(relaxed=True) == [own / "id_ed25519", rsa]
-
-
-def test_add_remove_and_status_of_settings_keys(tmp_path):
-    good = write_key(tmp_path / "frame key")
-    with pytest.raises(C.KeyFileError, match="public half"):
-        C.add_extra_key(tmp_path / "frame key.pub")
-    with pytest.raises(C.KeyFileError, match="passphrase"):
-        C.add_extra_key(write_key(tmp_path / "locked", b"pw"))
-    assert C.add_extra_key(good) == good.resolve()
-    C.add_extra_key(good)  # once only
-    assert C.extra_key_paths() == [good.resolve()]
-    good.unlink()
-    [(path, problem)] = C.extra_key_status()
-    assert path == good.resolve() and "not found" in problem
-    assert C.remove_extra_key(good) is True and C.remove_extra_key(good) is False
-    assert C.extra_key_paths() == []
-
-
-def test_cli_ssh_keys(tmp_path):
-    from typer.testing import CliRunner
-
-    from frameport.cli import app
-
-    good = write_key(tmp_path / "mine")
-    run = CliRunner().invoke(app, ["frame", "ssh-keys", "--add", str(good)])
-    assert run.exit_code == 0 and f"added {good.resolve()}" in run.output
-    run = CliRunner().invoke(app, ["frame", "ssh-keys", "--add", str(tmp_path / "nope")])
-    assert run.exit_code == 1 and str(good.resolve()) in run.output
-    run = CliRunner().invoke(app, ["frame", "ssh-keys", "--remove", str(good.resolve())])
-    assert run.exit_code == 0 and "no extra keys" in run.output