@torrent-tv/proxy 2.95.0 → 2.95.2

package/assets/calibration/NOTICE.md

@@ -42,6 +42,21 @@ The MPEG-4 Part 2 set is decoded by the same decoder (`mpeg4`) as an XviD or
 DivX 4+ release. VC-1 has no set because ffmpeg has no VC-1 encoder, and
 10-bit AV1 has none yet; both are priced as H.264, and the startup log says so.
 
+## The encode reference clip
+
+`cal-encode-reference.mp4` is 3 s of **"Chimera"**, also Netflix Open Content
+under CC BY 4.0, from `AV1/Chimera/Old/Chimera-AV1-8bit-1920x1080-6736kbps.mp4`
+at 250 s, re-encoded with `libx264 -preset slow -crf 21 -profile:v high -g 72`,
+1920×1080, 24 fps, no audio. Every startup encode reading is taken on it.
+
+It is the middle of that film by how hard it is to encode, and that film was
+the hardest of four measured on the addon host on 2026-10-07 (Meridian, Chimera,
+Sparks, Cosmos Laundromat): its typical stretch cost 1.30x the processor time per
+second of video of the Meridian clip used before at `ultrafast` and 2.2x at
+`fast`. Encoded at `-crf 12` instead, the same stretch cost the same within 2 %.
+(torrent-tv/meta#3, `research/startup-calibration-spread-2026-10-07.md` in
+`torrent-tv/meta`.)
+
 ## Why six, and why this grid
 
 `services/encode/hwaccel.js` decodes them at startup and fits the host's decode cost,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@torrent-tv/proxy",
-  "version": "2.95.0",
+  "version": "2.95.2",
   "description": "Torrent proxy client that exposes webseed-like HTTP stream endpoint.",
   "license": "GPL-3.0-or-later",
   "repository": {

package/services/encode/hwaccel.js

@@ -506,7 +506,22 @@ const CALIBRATION_SETS = {
     "cal-av1-480-lo.mp4"
   ]
 };
-export const CALIBRATION_REFERENCE_CLIP = "cal-h264-1080-hi.mp4";
+/**
+ * The footage every encode reading is taken on: 3 s of Netflix Open Content
+ * "Chimera" (CC BY 4.0), from the middle of that film by how hard it is to
+ * encode (torrent-tv/meta#3).
+ *
+ * It used to be the first decode clip, 2 s of "Meridian". Measured on the addon
+ * host on 2026-10-07, against the hardest and the middle stretches of four films,
+ * that clip was the cheapest of them all to encode: a typical stretch of Chimera
+ * took 1.32x its processor time per second of video at `ultrafast` and 2.42x at
+ * `fast`, so every startup figure read a machine faster than it is on an
+ * ordinary film. The hardest film's typical stretch is the baseline, not its
+ * hardest five seconds: the offer is about the speed a machine holds for a whole
+ * film, and a short hard stretch is what the viewer's cushion is for
+ * (`research/startup-calibration-spread-2026-10-07.md`).
+ */
+export const CALIBRATION_REFERENCE_CLIP = "cal-encode-reference.mp4";
 export const CALIBRATION_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "assets", "calibration");
 // How wide the measured window must be before the slope is trusted, and how
 // long to wait for it at most.

package/services/media/playback-declarations.js

@@ -1,4 +1,5 @@
 import { AudioTrack } from "./tracks/AudioTrack.js";
+import { TextSubtitleTrack } from "./tracks/TextSubtitleTrack.js";
 
 const VIDEO_CODECS = new Map([
   ["V_MPEG4/ISO/AVC", "h264"], ["avc1", "h264"], ["avc3", "h264"],
@@ -37,7 +38,11 @@ export function playbackDeclarations({ tracks, media, fileBytes = null }) {
     ...track, index, streamIndex: track.declaredIndex,
     codec: type === "audio" ? AudioTrack.codecNameOf(track)
       : SUBTITLE_CODECS.get(track.codecId) ?? track.codecId.toLowerCase(),
-    title: track.name ?? ""
+    title: track.name ?? "",
+    // The browser offers only tracks marked text-based: a picture subtitle
+    // cannot become WebVTT. Dropped when the plan moved to these declarations
+    // (torrent-tv/meta#95), which emptied every subtitle menu (#8).
+    ...(type === "subtitle" ? { textBased: TextSubtitleTrack.isTextCodec(track.codecId) } : {})
   }));
   const audioTracks = inventory("audio"), subtitleTracks = inventory("subtitle");
   return { tracks, video, audioTracks, subtitleTracks,