Replaces the deploy.py approach (which sed-patched index.html inside the
container, and was therefore lost on every jellyfin/jellyfin upgrade) with a
proper plugin installable from a Jellyfin plugin repository.
The web bundle is unchanged: the same src/*.js -> dist/jfvr.js is now embedded
in Jellyfin.Plugin.JFVR.dll and served from /JFVR/jfvr.js with a content-hash
cache key. index.html is rewritten at request time by an IStartupFilter
middleware, so nothing on disk is touched.
Verified before this commit:
- dotnet build: 0 warnings, 0 errors (net10.0, Jellyfin.Controller 12.1.0)
- the DLL embeds dist/jfvr.js byte for byte
- 19/19 checks on the rewrite logic (injection, idempotency, legacy-tag
takeover, no </body> safety, other scripts preserved, URL override)
- manifest.json passes Jellyfin's PackageInfo/VersionInfo expectations
- the packaged zip's MD5 matches the checksum the manifest advertises
Details that were checked against the Jellyfin source rather than assumed:
- a catalog version survives when targetAbi <= serverVersion, so a single
targetAbi 12.0.0.0 package covers all of 12.x (server is 12.1.0)
- Jellyfin writes meta.json itself at install time, so the zip needs only
the DLL
- Jellyfin verifies the MD5 at install time
Also adds pack.py (build -> package -> manifest -> Gitea release) and documents
the plugin route in README/HANDOFF, keeping deploy.py as a fallback.
28 lines
1.2 KiB
YAML
28 lines
1.2 KiB
YAML
---
|
|
# Metadata for the Jellyfin plugin catalog entry. pack.py reads this file to
|
|
# build manifest.json, and passes `version` to dotnet as -p:Version.
|
|
#
|
|
# targetAbi is deliberately 12.0.0.0 rather than the exact server version:
|
|
# Jellyfin keeps a catalog version only when `targetAbi <= serverVersion`
|
|
# (InstallationManager.GetAvailablePackages), so one package covers all of 12.x.
|
|
name: "Jellyfin Web VR"
|
|
guid: "7d33ef59-f9b0-412b-93bd-5cd5353018de"
|
|
version: "0.1.0.0"
|
|
targetAbi: "12.0.0.0"
|
|
framework: "net10.0"
|
|
overview: "VR180/VR360 playback inside Jellyfin Web for Meta Quest 3."
|
|
description: >
|
|
Injects a "VR 播放" button into the Jellyfin Web video player page and drives
|
|
an immersive WebXR session on Meta Quest 3, preferring
|
|
XRMediaBinding.createEquirectLayer and falling back to XRWebGLBinding.
|
|
Ships equirectangular 180/360 plus SBS/OU layouts, in-headset subtitles,
|
|
a wrist controller, and hand tracking.
|
|
category: "General"
|
|
owner: "cat-shark"
|
|
artifacts:
|
|
- "Jellyfin.Plugin.JFVR.dll"
|
|
changelog: >
|
|
First plugin build. The web bundle is embedded in the DLL and served from
|
|
/JFVR/jfvr.js; index.html is rewritten at request time, so nothing is written
|
|
to the jellyfin-web folder on disk.
|