commit 838675baa67381b5c48a042ac9a9574847e8a6b0 Author: catShark <1716967236@qq.com> Date: Sun Oct 11 19:19:06 2026 +0800 Jellyfin Web VR plugin for Quest 3 (VR180 stereo playback) Injects a 「VR 播放」 button into Jellyfin Web's video player page and plays VR180 / VR360 stereo content on Meta Quest 3 directly in the browser, with DirectPlay 8K HEVC, in-VR subtitles and an in-VR control panel. Modules (src/, concatenated in filename order into dist/jfvr.js): 00-core.js namespace, shared state, GL helpers, layer/frame-hook registry 10-subtitles.js libass canvas -> head-locked quad layer, auto-cropped to ink, with depth/size decoupling (angular-size lock) 20-controls.js in-VR control panel: progress/seek, transport, subtitle rows, aiming beam, padlock, pure 2D canvas -> XR quad layer 30-hands.js system hand model (Three.js + generic-hand GLB) via a manually driven projection layer 90-main.js boot, XR session lifecycle, rAF broker (rAF stops during XR), input dispatch, settings panel, localStorage persistence Key on-device findings are documented in HANDOFF.md §6 and README.md addenda: requestAnimationFrame stops during an XR session, 3:2 pulldown at 90 Hz needs updateTargetFrameRate(120), libass must be resized before entering VR, a quad's local -Z is its plane normal, and hand aiming must use the gaze ray because the emulated targetRaySpace points sideways. Quest does not expose eye tracking. Docs: INTERFACES.md (module contract + addenda), README.md (measurements), HANDOFF.md (handover notes). Credentials are NOT in the repo: deploy.py reads the SSH password from the JF_PW environment variable. diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..0c1f491 --- /dev/null +++ b/.gitignore @@ -0,0 +1,20 @@ +# --- secrets (never commit) ------------------------------------------- +# Local copy of the NAS / Jellyfin credentials. The repo only carries +# placeholders; see HANDOFF.md §2.1.1. +secrets.local.md +secrets*.md + +# --- duplicate / scratch ---------------------------------------------- +# Root copy is byte-identical to legacy/jfvr-mvp-v6-working.js (which +# deploy.py --legacy actually uses), so only the legacy one is tracked. +/jfvr-mvp.js +# Temporary offline test page (fake