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.
21 lines
654 B
Plaintext
21 lines
654 B
Plaintext
# --- 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 <video> + libass canvas + XR stubs).
|
|
_harness.html
|
|
|
|
# --- build / tooling noise --------------------------------------------
|
|
__pycache__/
|
|
*.py[cod]
|
|
.DS_Store
|
|
Thumbs.db
|
|
*.swp
|
|
*~
|