Files
jellytau/docs/traceability.md
T
dtourolle 95129d04a3 fix(player): make Android native video actually visible, and usable
DR-172 reverted native video to opt-in after it shipped as audio with no
picture, naming the compositing as the suspect. The compositing was fine. Five
separate defects sat between ExoPlayer and the screen, each able to produce that
exact symptom on its own, and each invisible to the others.

DR-185 — the app shell painted over the surface. app.css clears the page's
opaque layers through three selectors, one of which targets `[data-app-shell]`,
an attribute NO component has ever set, in any commit. The shell paints
--color-background across the whole viewport and VideoPlayer stacks above it, so
the WebView composited opaque no matter what else was cleared. Invisible three
ways over: the CSS is valid, the selector is plausible, and a rule matching
nothing looks exactly like a rule matching something already transparent.

DR-182 — nothing could lift the poster card. Every markMediaReady() call site is
an HTML5 <video> event, and the native branch renders no element, so the black
title card covered the surface for the entire session. The first fix hooked
`player://position-update` / `player://state-changed`; those channels are never
emitted by the backend, so it passed a test that fired them by hand and did
nothing on a device. Driven from the player store now, as the seek bar already
was.

DR-183 — the JS bridges raced the page load. Installed 500ms after onCreate by
walking the view tree, while WebView binds injected objects at page-load time,
and the identity guard then declined to re-inject forever. setTransparent(true)
could never arrive. Installed from WryActivity.onWebViewCreate instead, which
wry calls immediately before the first loadUrl.

DR-184 — the SurfaceView was never detached. detachVideoSurface had no callers
anywhere, mirroring the DR-151 defect: every native video left its surface
parented to the content view and the next one stacked another beneath it.

DR-191 — the overlay stopped repainting. Incremental damage (the clock's text,
the control bar's opacity) never reached the screen while structural changes did,
so the progress bar froze, the controls would not fade, and the play overlay
appeared to work because it is added and removed from the DOM. Driven from the
Activity via postInvalidateOnAnimation while compositing is on.

Two UI defects only this path could reveal came with them: isPlaying froze at
its initial value, leaving the play overlay dimming and covering the video
(DR-186), and the control bar's auto-hide was armed solely by mousemove, which a
touchscreen never fires (DR-189). Immersive mode now applies on entering the
player rather than only via the fullscreen button (DR-187).

Verified on a device (Honor ROD2-W09, Android 16): logcat carries
`WebView transparent = true` and `Marking media ready` with video on screen —
the pair DR-172 went looking for and could not find — and skip, seek, rotation
and subtitle rendering were exercised by hand.

The default stays OFF (DR-188). Turning it on surfaced a further unverified
sub-path: returning from background audio is HTML5-only, so playback stays dead
(DR-190, proposed). Shipping it would have repeated DR-161 exactly — a verified
sub-path made default over an unverified one.
2026-08-16 15:28:10 +02:00

371 KiB

Code Traceability Matrix

Generated: 8/16/2026, 3:10:50 PM

Summary

  • Total Files Scanned: 366
  • Total TRACES Found: 805
  • Requirements Covered:
    • User Requirements (UR): 71
    • Integration Requirements (IR): 19
    • Development Requirements (DR): 163
    • 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-173, DR-174, DR-175, DR-176, DR-177, DR-178, DR-179, DR-180, DR-181, DR-182, DR-183, DR-185, DR-186, DR-188, DR-189

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: 3 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-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)

DR-181

Locations: 11 file(s)

DR-182

Locations: 4 file(s)

DR-183

Locations: 1 file(s)

DR-185

Locations: 1 file(s)

DR-186

Locations: 1 file(s)

DR-188

Locations: 1 file(s)

DR-189

Locations: 4 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-004

Locations: 56 file(s)

UR-009

Locations: 15 file(s)

UR-023

Locations: 24 file(s)

UR-026

Locations: 19 file(s)

UR-027

Locations: 23 file(s)

UR-028

Locations: 2 file(s)

UR-036

Locations: 3 file(s)

UR-040

Locations: 59 file(s)

IT-003

Locations: 1 file(s)

IT-004

Locations: 1 file(s)

IT-013

Locations: 4 file(s)

IT-016

Locations: 1 file(s)

UT-003

Locations: 1 file(s)

UT-004

Locations: 1 file(s)

UT-005

Locations: 1 file(s)

UT-010

Locations: 1 file(s)

UT-012

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-051

Locations: 1 file(s)

UT-052

Locations: 1 file(s)

UT-059

Locations: 3 file(s)

UT-060

Locations: 3 file(s)

UT-061

Locations: 9 file(s)

UR-003

Locations: 39 file(s)

UR-005

Locations: 100 file(s)

UR-018

Locations: 20 file(s)

UR-020

Locations: 41 file(s)

UR-025

Locations: 69 file(s)

UR-049

Locations: 22 file(s)

UR-050

Locations: 9 file(s)

UR-053

Locations: 17 file(s)

UR-055

Locations: 54 file(s)

UR-056

Locations: 17 file(s)

UR-062

Locations: 17 file(s)

UR-064

Locations: 7 file(s)

UR-067

Locations: 41 file(s)

UR-071

Locations: 63 file(s)

UR-073

Locations: 6 file(s)

UR-074

Locations: 48 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-085

Locations: 2 file(s)

UT-086

Locations: 2 file(s)

UT-087

Locations: 2 file(s)

UT-088

Locations: 1 file(s)

UT-089

Locations: 1 file(s)

UT-090

Locations: 1 file(s)

UT-092

Locations: 3 file(s)

UT-093

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-098

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-104

Locations: 7 file(s)

UT-105

Locations: 3 file(s)

UT-106

Locations: 3 file(s)

UT-107

Locations: 6 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-116

Locations: 4 file(s)

UT-117

Locations: 7 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-127

Locations: 11 file(s)

UT-130

Locations: 3 file(s)

UT-133

Locations: 1 file(s)

UT-134

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-143

Locations: 3 file(s)

UT-144

Locations: 3 file(s)

UT-145

Locations: 5 file(s)

UT-147

Locations: 8 file(s)

UT-149

Locations: 2 file(s)

UT-151

Locations: 7 file(s)

UT-158

Locations: 1 file(s)

UT-159

Locations: 1 file(s)

UT-160

Locations: 1 file(s)

UT-167

Locations: 1 file(s)

UT-168

Locations: 17 file(s)

UT-170

Locations: 8 file(s)

UT-182

Locations: 5 file(s)

UR-002

Locations: 21 file(s)

UR-007

Locations: 16 file(s)

UR-008

Locations: 2 file(s)

UR-011

Locations: 11 file(s)

UR-012

Locations: 9 file(s)

UR-013

Locations: 2 file(s)

UR-015

Locations: 13 file(s)

UR-017

Locations: 10 file(s)

UR-019

Locations: 13 file(s)

UR-021

Locations: 6 file(s)

UR-024

Locations: 2 file(s)

UR-042

Locations: 1 file(s)

UR-043

Locations: 2 file(s)

UR-057

Locations: 1 file(s)

UR-059

Locations: 6 file(s)

UR-060

Locations: 7 file(s)

UR-061

Locations: 4 file(s)

UR-065

Locations: 22 file(s)

UR-069

Locations: 24 file(s)

UR-072

Locations: 1 file(s)

UR-075

Locations: 12 file(s)

IT-017

Locations: 1 file(s)

UT-042

Locations: 1 file(s)

UT-043

Locations: 1 file(s)

UT-044

Locations: 1 file(s)

UT-103

Locations: 6 file(s)

UT-115

Locations: 2 file(s)

UT-119

Locations: 2 file(s)

UT-125

Locations: 3 file(s)

UT-126

Locations: 2 file(s)

UT-146

Locations: 3 file(s)

UR-029

Locations: 5 file(s)

UR-030

Locations: 2 file(s)

UR-034

Locations: 10 file(s)

UR-035

Locations: 5 file(s)

UR-039

Locations: 1 file(s)

UR-048

Locations: 6 file(s)

UR-051

Locations: 2 file(s)

UR-052

Locations: 23 file(s)

UR-054

Locations: 7 file(s)

UR-058

Locations: 11 file(s)

UR-066

Locations: 11 file(s)

UR-068

Locations: 14 file(s)

UT-131

Locations: 1 file(s)

UT-132

Locations: 1 file(s)

UT-135

Locations: 1 file(s)

UR-063

Locations: 10 file(s)

UT-150

Locations: 1 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-161

Locations: 4 file(s)

UT-162

Locations: 1 file(s)

UT-163

Locations: 1 file(s)

UT-164

Locations: 1 file(s)

UT-171

Locations: 2 file(s)

UT-172

Locations: 3 file(s)

UT-174

Locations: 2 file(s)

UT-175

Locations: 1 file(s)

UT-183

Locations: 2 file(s)

UT-184

Locations: 2 file(s)

UT-185

Locations: 2 file(s)

UT-186

Locations: 1 file(s)

UT-187

Locations: 1 file(s)

UT-188

Locations: 4 file(s)

UR-010

Locations: 16 file(s)

UR-014

Locations: 1 file(s)

UR-016

Locations: 2 file(s)

UR-032

Locations: 7 file(s)

UR-033

Locations: 12 file(s)

UR-038

Locations: 1 file(s)

UR-041

Locations: 3 file(s)

UT-091

Locations: 2 file(s)

UT-118

Locations: 1 file(s)

UR-044

Locations: 1 file(s)

UR-045

Locations: 1 file(s)

UT-141

Locations: 2 file(s)

UT-142

Locations: 1 file(s)

UT-148

Locations: 3 file(s)

UT-152

Locations: 4 file(s)

UT-166

Locations: 7 file(s)

UT-173

Locations: 5 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-022

Locations: 1 file(s)

UR-031

Locations: 2 file(s)

UR-046

Locations: 1 file(s)

UR-047

Locations: 1 file(s)