Files
jellytau/docs/traceability.md
T
dtourolle 13264e225b fix(player): never let the server burn a subtitle in, and never offer one we cannot draw
Reported as "subtitles are shown even when off", and no toggle in the app
cleared them — because they were not the app's subtitles at all. The server was
painting them into the video.

`PlaybackInfo` omitted `SubtitleStreamIndex`, which does not mean "none": the
server then honours the source's own default/forced flag. On the reported
episode that default is a PGS track — a bitmap, which cannot go out as a
sidecar — so the server fell back to `SubtitleMethod=Encode` and composited it
onto every frame. Confirmed against the live server, which answered the same
PlaybackInfo request two ways: with the index omitted it returned
`SubtitleStreamIndex=2` + `SubtitleMethod=Encode` and a
`SubtitleCodecNotSupported` transcode reason, and its ffmpeg command carried
`[0:2]…[sub];[main][sub]overlay_qsv=…`; with `-1` it selected no subtitle stream
at all. The cost landed on the video, not the subtitle: burn-in rules out
remuxing, so a stream that only needed its audio transcoded was re-encoded frame
by frame.

Three parts:

- The negotiation asks for `SubtitleStreamIndex=-1` and advertises every text
  format we can render (srt/subrip/ass/ssa/vtt) as `External`.
- The stream URL says the same thing, because the negotiation is not what opens
  most streams: a quality switch, a transcoded seek and an audio-track switch
  each rebuild the URL on their own, and an omitted index there lets the server
  pick the default track back up out of whatever session state it still holds.
- The picker offers only subtitles the app can actually draw. Each subtitle
  stream now crosses the boundary carrying `supports_external_delivery`, decided
  in Rust where the codec vocabulary belongs, and `None` for anything that is
  not a subtitle so a `false` cannot be misread as a verdict.
  `subtitleStreamsOf()` drops the rejected ones — and since that one function
  feeds the menu, the `<track>` children and the native play request alike, a
  bitmap track disappears from all three without its URL ever being fetched.
  Only an explicit "no" hides a track; a stream carrying no verdict behaves
  exactly as before.

Nothing is lost by refusing burn-in: the app already fetches the text tracks and
draws them itself (UR-020), so the server's composited copy was always
redundant. Image-based tracks are consequently not offered, which is honest
rather than a regression — the renderer cannot composite a bitmap, and the old
behaviour paid for them by making the whole stream unwatchable.

Tests were written first and observed failing: the Rust one would not compile
against a field that did not exist, and the frontend one resolved a URL for the
PGS track it was supposed to drop.

Carries with it the in-flight per-stream `PlaySessionId` work in online.rs,
whose hunks sit inside the same request builder and could not be separated from
these.

TRACES: UR-020, UR-004 | DR-176 | UT-168
2026-08-16 09:47:09 +02:00

359 KiB

Code Traceability Matrix

Generated: 8/16/2026, 9:42:42 AM

Summary

  • Total Files Scanned: 360
  • Total TRACES Found: 785
  • Requirements Covered:
    • User Requirements (UR): 71
    • Integration Requirements (IR): 19
    • Development Requirements (DR): 157
    • Jellyfin API Requirements (JA): 28

Requirements by Type

User Requirements (UR)

UR-002, UR-003, UR-004, UR-005, UR-007, UR-008, UR-009, UR-010, UR-011, UR-012, UR-013, UR-014, UR-015, UR-016, UR-017, UR-018, UR-019, UR-020, UR-021, UR-022, UR-023, UR-024, UR-025, UR-026, UR-027, UR-028, UR-029, UR-030, UR-031, UR-032, UR-033, UR-034, UR-035, UR-036, UR-038, UR-039, UR-040, UR-041, UR-042, UR-043, UR-044, UR-045, UR-046, UR-047, UR-048, UR-049, UR-050, UR-051, UR-052, UR-053, UR-054, UR-055, UR-056, UR-057, UR-058, UR-059, UR-060, UR-061, UR-062, UR-063, UR-064, UR-065, UR-066, UR-067, UR-068, UR-069, UR-071, UR-072, UR-073, UR-074, UR-075

Integration Requirements (IR)

IR-003, IR-004, IR-009, IR-010, IR-011, IR-012, IR-013, IR-014, IR-015, IR-016, IR-020, IR-021, IR-023, IR-025, IR-026, IR-027, IR-028, IR-030, IR-031

Development Requirements (DR)

DR-001, DR-002, DR-003, DR-004, DR-005, DR-006, DR-007, DR-009, DR-010, DR-011, DR-012, DR-013, DR-014, DR-015, DR-016, DR-017, DR-018, DR-020, DR-021, DR-022, DR-023, DR-024, DR-025, DR-026, DR-027, DR-028, DR-029, DR-030, DR-032, DR-033, DR-034, DR-035, DR-036, DR-037, DR-038, DR-039, DR-040, DR-041, DR-043, DR-044, DR-045, DR-047, DR-048, DR-049, DR-050, DR-051, DR-052, DR-053, DR-054, DR-055, DR-056, DR-057, DR-058, DR-059, DR-060, DR-061, DR-062, DR-063, DR-064, DR-065, DR-066, DR-067, DR-068, DR-069, DR-070, DR-074, DR-075, DR-076, DR-077, DR-078, DR-079, DR-080, DR-081, DR-082, DR-083, DR-084, DR-085, DR-086, DR-087, DR-088, DR-089, DR-090, DR-091, DR-092, DR-093, DR-095, DR-096, DR-097, DR-098, DR-099, DR-100, DR-101, DR-102, DR-103, DR-104, DR-105, DR-106, DR-107, DR-108, DR-109, DR-110, DR-111, DR-112, DR-113, DR-114, DR-115, DR-116, DR-117, DR-118, DR-119, DR-120, DR-123, DR-126, DR-127, DR-128, DR-129, DR-130, DR-131, DR-132, DR-133, DR-134, DR-135, DR-136, DR-137, DR-140, DR-141, DR-142, DR-143, DR-147, DR-148, DR-149, DR-150, DR-151, DR-152, DR-153, DR-154, DR-155, DR-156, DR-157, DR-158, DR-159, DR-160, DR-162, DR-167, DR-168, DR-169, DR-170, DR-171, DR-172, DR-173, DR-174, DR-175, DR-176, DR-177, DR-178, DR-179, DR-180

Jellyfin API Requirements (JA)

JA-001, JA-002, JA-003, JA-004, JA-005, JA-007, JA-008, JA-010, JA-011, JA-012, JA-016, JA-017, JA-019, JA-020, JA-021, JA-022, JA-023, JA-024, JA-025, JA-026, JA-028, JA-029, JA-030, JA-031, JA-032, JA-033, JA-034, JA-035

Detailed Mapping

IR-003

Locations: 2 file(s)

IR-004

Locations: 1 file(s)

IR-009

Locations: 6 file(s)

IR-010

Locations: 2 file(s)

IR-011

Locations: 1 file(s)

IR-012

Locations: 2 file(s)

IR-013

Locations: 3 file(s)

IR-014

Locations: 6 file(s)

IR-015

Locations: 1 file(s)

IR-016

Locations: 16 file(s)

IR-020

Locations: 8 file(s)

IR-021

Locations: 1 file(s)

IR-023

Locations: 1 file(s)

IR-025

Locations: 2 file(s)

IR-026

Locations: 1 file(s)

IR-027

Locations: 1 file(s)

IR-028

Locations: 1 file(s)

IR-030

Locations: 2 file(s)

IR-031

Locations: 2 file(s)

DR-001

Locations: 17 file(s)

DR-002

Locations: 2 file(s)

DR-003

Locations: 2 file(s)

DR-004

Locations: 16 file(s)

DR-005

Locations: 13 file(s)

DR-006

Locations: 2 file(s)

DR-007

Locations: 9 file(s)

DR-009

Locations: 12 file(s)

DR-010

Locations: 1 file(s)

DR-011

Locations: 9 file(s)

DR-012

Locations: 7 file(s)

DR-013

Locations: 5 file(s)

DR-014

Locations: 4 file(s)

DR-015

Locations: 6 file(s)

DR-016

Locations: 3 file(s)

DR-017

Locations: 3 file(s)

DR-018

Locations: 1 file(s)

DR-020

Locations: 8 file(s)

DR-021

Locations: 3 file(s)

DR-022

Locations: 1 file(s)

DR-023

Locations: 12 file(s)

DR-024

Locations: 8 file(s)

DR-025

Locations: 1 file(s)

DR-026

Locations: 2 file(s)

DR-027

Locations: 2 file(s)

DR-028

Locations: 20 file(s)

DR-029

Locations: 10 file(s)

DR-030

Locations: 18 file(s)

DR-032

Locations: 1 file(s)

DR-033

Locations: 2 file(s)

DR-034

Locations: 2 file(s)

DR-035

Locations: 7 file(s)

DR-036

Locations: 12 file(s)

DR-037

Locations: 12 file(s)

DR-038

Locations: 9 file(s)

DR-039

Locations: 8 file(s)

DR-040

Locations: 3 file(s)

DR-041

Locations: 2 file(s)

DR-043

Locations: 1 file(s)

DR-044

Locations: 1 file(s)

DR-045

Locations: 1 file(s)

DR-047

Locations: 15 file(s)

DR-048

Locations: 6 file(s)

DR-049

Locations: 1 file(s)

DR-050

Locations: 1 file(s)

DR-051

Locations: 3 file(s)

DR-052

Locations: 20 file(s)

DR-053

Locations: 1 file(s)

DR-054

Locations: 1 file(s)

DR-055

Locations: 2 file(s)

DR-056

Locations: 1 file(s)

DR-057

Locations: 1 file(s)

DR-058

Locations: 1 file(s)

DR-059

Locations: 2 file(s)

DR-060

Locations: 1 file(s)

DR-061

Locations: 2 file(s)

DR-062

Locations: 6 file(s)

DR-063

Locations: 17 file(s)

DR-064

Locations: 5 file(s)

DR-065

Locations: 2 file(s)

DR-066

Locations: 5 file(s)

DR-067

Locations: 3 file(s)

DR-068

Locations: 1 file(s)

DR-069

Locations: 1 file(s)

DR-070

Locations: 1 file(s)

DR-074

Locations: 17 file(s)

DR-075

Locations: 1 file(s)

DR-076

Locations: 2 file(s)

DR-077

Locations: 2 file(s)

DR-078

Locations: 7 file(s)

DR-079

Locations: 2 file(s)

DR-080

Locations: 2 file(s)

DR-081

Locations: 2 file(s)

DR-082

Locations: 21 file(s)

DR-083

Locations: 19 file(s)

DR-084

Locations: 2 file(s)

DR-085

Locations: 15 file(s)

DR-086

Locations: 1 file(s)

DR-087

Locations: 3 file(s)

DR-088

Locations: 2 file(s)

DR-089

Locations: 4 file(s)

DR-090

Locations: 1 file(s)

DR-091

Locations: 2 file(s)

DR-092

Locations: 2 file(s)

DR-093

Locations: 4 file(s)

DR-095

Locations: 1 file(s)

DR-096

Locations: 1 file(s)

DR-097

Locations: 9 file(s)

DR-098

Locations: 4 file(s)

DR-099

Locations: 2 file(s)

DR-100

Locations: 2 file(s)

DR-101

Locations: 8 file(s)

DR-102

Locations: 7 file(s)

DR-103

Locations: 6 file(s)

DR-104

Locations: 1 file(s)

DR-105

Locations: 10 file(s)

DR-106

Locations: 7 file(s)

DR-107

Locations: 2 file(s)

DR-108

Locations: 5 file(s)

DR-109

Locations: 6 file(s)

DR-110

Locations: 8 file(s)

DR-111

Locations: 5 file(s)

DR-112

Locations: 6 file(s)

DR-113

Locations: 4 file(s)

DR-114

Locations: 2 file(s)

DR-115

Locations: 16 file(s)

DR-116

Locations: 11 file(s)

DR-117

Locations: 8 file(s)

DR-118

Locations: 5 file(s)

DR-119

Locations: 15 file(s)

DR-120

Locations: 19 file(s)

DR-123

Locations: 8 file(s)

DR-126

Locations: 2 file(s)

DR-127

Locations: 6 file(s)

DR-128

Locations: 3 file(s)

DR-129

Locations: 8 file(s)

DR-130

Locations: 7 file(s)

DR-131

Locations: 16 file(s)

DR-132

Locations: 12 file(s)

DR-133

Locations: 2 file(s)

DR-134

Locations: 1 file(s)

DR-135

Locations: 5 file(s)

DR-136

Locations: 3 file(s)

DR-137

Locations: 17 file(s)

DR-140

Locations: 2 file(s)

DR-141

Locations: 2 file(s)

DR-142

Locations: 11 file(s)

DR-143

Locations: 11 file(s)

DR-147

Locations: 5 file(s)

DR-148

Locations: 1 file(s)

DR-149

Locations: 3 file(s)

DR-150

Locations: 4 file(s)

DR-151

Locations: 1 file(s)

DR-152

Locations: 2 file(s)

DR-153

Locations: 1 file(s)

DR-154

Locations: 7 file(s)

DR-155

Locations: 5 file(s)

DR-156

Locations: 2 file(s)

DR-157

Locations: 1 file(s)

DR-158

Locations: 6 file(s)

DR-159

Locations: 3 file(s)

DR-160

Locations: 1 file(s)

DR-162

Locations: 39 file(s)

DR-167

Locations: 2 file(s)

DR-168

Locations: 6 file(s)

DR-169

Locations: 2 file(s)

DR-170

Locations: 2 file(s)

DR-171

Locations: 9 file(s)

DR-172

Locations: 1 file(s)

DR-173

Locations: 17 file(s)

DR-174

Locations: 8 file(s)

DR-175

Locations: 9 file(s)

DR-176

Locations: 17 file(s)

DR-177

Locations: 9 file(s)

DR-178

Locations: 13 file(s)

DR-179

Locations: 15 file(s)

DR-180

Locations: 6 file(s)

JA-001

Locations: 1 file(s)

JA-002

Locations: 2 file(s)

JA-003

Locations: 1 file(s)

JA-004

Locations: 3 file(s)

JA-005

Locations: 1 file(s)

JA-007

Locations: 1 file(s)

JA-008

Locations: 8 file(s)

JA-010

Locations: 2 file(s)

JA-011

Locations: 2 file(s)

JA-012

Locations: 2 file(s)

JA-016

Locations: 1 file(s)

JA-017

Locations: 1 file(s)

JA-019

Locations: 1 file(s)

JA-020

Locations: 1 file(s)

JA-021

Locations: 6 file(s)

JA-022

Locations: 3 file(s)

JA-023

Locations: 3 file(s)

JA-024

Locations: 2 file(s)

JA-025

Locations: 4 file(s)

JA-026

Locations: 3 file(s)

JA-028

Locations: 1 file(s)

JA-029

Locations: 3 file(s)

JA-030

Locations: 2 file(s)

JA-031

Locations: 2 file(s)

JA-032

Locations: 10 file(s)

JA-033

Locations: 7 file(s)

JA-034

Locations: 3 file(s)

JA-035

Locations: 2 file(s)

UR-007

Locations: 16 file(s)

UR-013

Locations: 2 file(s)

UR-016

Locations: 2 file(s)

UR-023

Locations: 24 file(s)

UR-024

Locations: 2 file(s)

UR-025

Locations: 69 file(s)

UR-027

Locations: 23 file(s)

UR-029

Locations: 5 file(s)

UR-034

Locations: 10 file(s)

UR-035

Locations: 5 file(s)

UR-038

Locations: 1 file(s)

UR-040

Locations: 58 file(s)

UR-043

Locations: 2 file(s)

UR-048

Locations: 6 file(s)

UR-049

Locations: 22 file(s)

UR-052

Locations: 23 file(s)

UR-055

Locations: 54 file(s)

UR-056

Locations: 17 file(s)

UR-057

Locations: 1 file(s)

UR-058

Locations: 11 file(s)

UR-059

Locations: 6 file(s)

UR-062

Locations: 17 file(s)

UR-063

Locations: 10 file(s)

UR-066

Locations: 7 file(s)

UR-067

Locations: 41 file(s)

UR-068

Locations: 14 file(s)

IT-013

Locations: 4 file(s)

IT-016

Locations: 1 file(s)

IT-017

Locations: 1 file(s)

UT-010

Locations: 1 file(s)

UT-014

Locations: 2 file(s)

UT-015

Locations: 2 file(s)

UT-016

Locations: 2 file(s)

UT-017

Locations: 2 file(s)

UT-018

Locations: 2 file(s)

UT-019

Locations: 2 file(s)

UT-020

Locations: 2 file(s)

UT-021

Locations: 2 file(s)

UT-022

Locations: 2 file(s)

UT-023

Locations: 2 file(s)

UT-024

Locations: 1 file(s)

UT-025

Locations: 2 file(s)

UT-026

Locations: 2 file(s)

UT-027

Locations: 1 file(s)

UT-028

Locations: 1 file(s)

UT-029

Locations: 1 file(s)

UT-030

Locations: 1 file(s)

UT-031

Locations: 1 file(s)

UT-032

Locations: 1 file(s)

UT-033

Locations: 1 file(s)

UT-042

Locations: 1 file(s)

UT-043

Locations: 1 file(s)

UT-044

Locations: 1 file(s)

UT-051

Locations: 1 file(s)

UT-052

Locations: 1 file(s)

UT-059

Locations: 3 file(s)

UT-060

Locations: 3 file(s)

UT-062

Locations: 1 file(s)

UT-066

Locations: 1 file(s)

UT-067

Locations: 1 file(s)

UT-071

Locations: 1 file(s)

UT-072

Locations: 1 file(s)

UT-073

Locations: 1 file(s)

UT-074

Locations: 1 file(s)

UT-075

Locations: 1 file(s)

UT-076

Locations: 1 file(s)

UT-077

Locations: 1 file(s)

UT-078

Locations: 1 file(s)

UT-079

Locations: 1 file(s)

UT-080

Locations: 1 file(s)

UT-081

Locations: 1 file(s)

UT-082

Locations: 1 file(s)

UT-083

Locations: 1 file(s)

UT-084

Locations: 1 file(s)

UT-089

Locations: 1 file(s)

UT-090

Locations: 1 file(s)

UT-091

Locations: 2 file(s)

UT-094

Locations: 1 file(s)

UT-095

Locations: 1 file(s)

UT-096

Locations: 1 file(s)

UT-097

Locations: 1 file(s)

UT-099

Locations: 3 file(s)

UT-100

Locations: 6 file(s)

UT-101

Locations: 4 file(s)

UT-102

Locations: 2 file(s)

UT-103

Locations: 6 file(s)

UT-105

Locations: 3 file(s)

UT-106

Locations: 3 file(s)

UR-003

Locations: 29 file(s)

UR-004

Locations: 41 file(s)

UR-005

Locations: 96 file(s)

UR-018

Locations: 20 file(s)

UR-026

Locations: 19 file(s)

UR-033

Locations: 12 file(s)

UR-060

Locations: 7 file(s)

UR-069

Locations: 24 file(s)

UR-071

Locations: 63 file(s)

UR-074

Locations: 47 file(s)

UR-075

Locations: 12 file(s)

UT-061

Locations: 9 file(s)

UR-064

Locations: 7 file(s)

UT-098

Locations: 1 file(s)

UT-104

Locations: 7 file(s)

UT-107

Locations: 6 file(s)

UT-116

Locations: 4 file(s)

UT-117

Locations: 7 file(s)

UR-009

Locations: 15 file(s)

UR-011

Locations: 11 file(s)

UR-019

Locations: 12 file(s)

UR-020

Locations: 41 file(s)

UR-028

Locations: 2 file(s)

UR-041

Locations: 2 file(s)

UR-050

Locations: 9 file(s)

UR-072

Locations: 1 file(s)

UR-073

Locations: 6 file(s)

IT-003

Locations: 1 file(s)

IT-004

Locations: 1 file(s)

UT-012

Locations: 1 file(s)

UT-086

Locations: 2 file(s)

UT-087

Locations: 2 file(s)

UT-088

Locations: 1 file(s)

UT-108

Locations: 2 file(s)

UT-109

Locations: 1 file(s)

UT-110

Locations: 1 file(s)

UT-111

Locations: 3 file(s)

UT-112

Locations: 2 file(s)

UT-113

Locations: 2 file(s)

UT-114

Locations: 2 file(s)

UT-115

Locations: 2 file(s)

UT-118

Locations: 1 file(s)

UT-119

Locations: 2 file(s)

UT-120

Locations: 2 file(s)

UT-121

Locations: 2 file(s)

UT-122

Locations: 11 file(s)

UT-123

Locations: 2 file(s)

UT-124

Locations: 1 file(s)

UT-125

Locations: 3 file(s)

UT-126

Locations: 2 file(s)

UT-127

Locations: 11 file(s)

UT-130

Locations: 2 file(s)

UT-131

Locations: 1 file(s)

UT-132

Locations: 1 file(s)

UT-133

Locations: 1 file(s)

UT-134

Locations: 1 file(s)

UT-135

Locations: 1 file(s)

UT-136

Locations: 1 file(s)

UT-137

Locations: 1 file(s)

UT-138

Locations: 1 file(s)

UT-139

Locations: 1 file(s)

UT-140

Locations: 1 file(s)

UT-141

Locations: 2 file(s)

UT-142

Locations: 1 file(s)

UT-143

Locations: 3 file(s)

UT-144

Locations: 3 file(s)

UT-146

Locations: 3 file(s)

UT-148

Locations: 3 file(s)

UT-149

Locations: 2 file(s)

UT-150

Locations: 1 file(s)

UT-152

Locations: 4 file(s)

UT-154

Locations: 2 file(s)

UT-155

Locations: 3 file(s)

UT-156

Locations: 4 file(s)

UT-157

Locations: 3 file(s)

UT-160

Locations: 1 file(s)

UT-161

Locations: 4 file(s)

UT-162

Locations: 1 file(s)

UT-163

Locations: 1 file(s)

UT-164

Locations: 1 file(s)

UT-166

Locations: 7 file(s)

UT-170

Locations: 8 file(s)

UR-053

Locations: 17 file(s)

UT-145

Locations: 5 file(s)

UT-151

Locations: 7 file(s)

UT-168

Locations: 17 file(s)

UR-002

Locations: 21 file(s)

UR-017

Locations: 10 file(s)

UR-061

Locations: 4 file(s)

UT-085

Locations: 2 file(s)

UT-092

Locations: 3 file(s)

UT-093

Locations: 2 file(s)

UT-171

Locations: 2 file(s)

UT-172

Locations: 3 file(s)

UT-173

Locations: 5 file(s)

UT-174

Locations: 2 file(s)

UR-008

Locations: 2 file(s)

UR-021

Locations: 5 file(s)

UT-147

Locations: 8 file(s)

UR-010

Locations: 16 file(s)

UR-012

Locations: 9 file(s)

UR-015

Locations: 13 file(s)

UR-030

Locations: 2 file(s)

UR-036

Locations: 3 file(s)

UR-051

Locations: 2 file(s)

UT-158

Locations: 1 file(s)

UT-159

Locations: 1 file(s)

UT-167

Locations: 1 file(s)

UR-039

Locations: 1 file(s)

UR-054

Locations: 7 file(s)

UT-175

Locations: 1 file(s)

UR-032

Locations: 7 file(s)

UT-003

Locations: 1 file(s)

UT-004

Locations: 1 file(s)

UT-005

Locations: 1 file(s)

UT-176

Locations: 3 file(s)

UT-177

Locations: 6 file(s)

UT-178

Locations: 3 file(s)

UT-179

Locations: 4 file(s)

UT-180

Locations: 3 file(s)

UT-181

Locations: 6 file(s)

UR-014

Locations: 1 file(s)

UR-022

Locations: 1 file(s)

UR-031

Locations: 2 file(s)

UR-042

Locations: 1 file(s)

UR-044

Locations: 1 file(s)

UR-045

Locations: 1 file(s)

UR-046

Locations: 1 file(s)

UR-047

Locations: 1 file(s)

UR-065

Locations: 22 file(s)