@torrent-tv/proxy 2.43.0 → 2.43.1

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.43.1
+
+- **New**: A subtitle request can say where the browser's copy ends (`?after=<seconds>`) and gets back only the cues past it. A track read out of downloaded clusters grows as the film does, and the browser was being sent all of it every few seconds — 76 KB a time on the field file — for the few lines at its end. The language is still detected from every cue held rather than from the handful being sent, because three lines say much less about a language than a whole track does.
+
 ## 2.43.0
 
 - **New**: An MP4's text subtitles are read the same way, and more cheaply than Matroska's. Where a Matroska cue costs whatever cluster holds it — the picture around it included — an MP4 states every sample's own byte range in its sample table (ISO/IEC 14496-12 §8.6.1.2, §8.7.3-8.7.5), so a cue costs its own few dozen bytes and nothing else. The tables are read out of the `moov` the keyframe reader already fetches: `stts` for when each cue starts and how long it lasts, `stsz` for its length, `stsc` with `stco`/`co64` for where its bytes are. `tx3g` (3GPP timed text) and `wvtt` (WebVTT in MP4) are decoded; `stpp` (TTML) is XML and is deliberately left out rather than half-shown. An empty sample is the format's way of saying nothing is on screen and is not turned into a blank cue. Same rule as before: only samples whose bytes are already downloaded are read, so a cue never costs a request.

package/package.json

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

package/routes/api/subtitles/get.js

@@ -100,7 +100,19 @@ export async function handleApiSubtitlesGet(req, reply, { sourceRegistry, torren
   // read that way. Costs no network at all and answers with the part of the
   // film they are watching; the rest arrives as they watch it. Only when the
   // container cannot be read this way does the old extraction run.
-  const held = await cuesFromDownloadedClusters(torrentPool, torrent, fileIndex, trackIndex);
+  // Where the browser's copy of this track ends. It already holds every cue
+  // before this second, so sending them again is bytes for nothing: measured
+  // 2026-08-19, one track is 76 KB and the browser asked for it every few
+  // seconds while the film downloaded. Absent or unparsable means "send
+  // everything", which is what a browser asking for the first time wants.
+  const after = Number.parseFloat(String(req.query?.after ?? ""));
+  const held = await cuesFromDownloadedClusters(
+    torrentPool,
+    torrent,
+    fileIndex,
+    trackIndex,
+    Number.isFinite(after) ? after : null
+  );
   if (held !== null) {
     setLanguageHeaders(reply, held.language);
     reply.header("content-type", "text/vtt; charset=utf-8");
@@ -252,7 +264,7 @@ function readFileFully(file, maxBytes) {
  * @returns {Promise<{ vtt: string, language: object | null, coveredClusters: number, indexedClusters: number } | null>}
  *   Null when this file cannot be read this way, and then the caller falls back.
  */
-async function cuesFromDownloadedClusters(torrentPool, torrent, fileIndex, trackIndex) {
+async function cuesFromDownloadedClusters(torrentPool, torrent, fileIndex, trackIndex, after = null) {
   if (typeof torrentPool?.getSubtitleTracks !== "function") {
     return null;
   }
@@ -275,7 +287,13 @@ async function cuesFromDownloadedClusters(torrentPool, torrent, fileIndex, track
   if (!held || !Array.isArray(held.cues)) {
     return null;
   }
-  const vtt = cuesToVtt(held.cues, held.codecId);
+  // Only what the browser does not have. The language is still detected from
+  // EVERYTHING held, because three new lines say much less about a language
+  // than the whole track does.
+  const fresh = Number.isFinite(after)
+    ? held.cues.filter((cue) => cue.startSeconds > after)
+    : held.cues;
+  const vtt = cuesToVtt(fresh, held.codecId);
   const language = held.cues.length > 0
     ? detectLanguage(held.cues.map((cue) => cue.text).join("\n"))
     : null;