docs: publish site from 5fede123

2026-08-22 10:28:21 +00:00
commit 94f99c4f8d
1514 changed files with 155632 additions and 0 deletions
@@ -0,0 +1,5 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Consecutive resume attempts allowed at the same position before giving up."><title>MAX_STALLED_RESUME_ATTEMPTS in jellytau_lib::player::stream_end - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc constant"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">MAX_STALLED_RESUME_ATTEMPTS</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.10.1</span></h2></div><div class="sidebar-elems"><div id="rustdoc-modnav"><h2><a href="index.html">In jellytau_<wbr>lib::<wbr>player::<wbr>stream_<wbr>end</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a>::<wbr><a href="index.html">stream_end</a></div><h1>Constant <span class="constant">MAX_<wbr>STALLED_<wbr>RESUME_<wbr>ATTEMPTS</span>&nbsp;<button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/stream_end.rs.html#44">Source</a> </span></div><pre class="rust item-decl"><code>pub const MAX_STALLED_RESUME_ATTEMPTS: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.u32.html">u32</a> = 3;</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Consecutive resume attempts allowed at the same position before giving up.</p>
+<p>A resume re-opens the same URL, so a server that is genuinely gone would
+otherwise end → resume → end forever. Progress past the last attempt resets
+the budget (see <a href="struct.ResumeTracker.html" title="struct jellytau_lib::player::stream_end::ResumeTracker"><code>ResumeTracker</code></a>), so this only bounds <em>stuck</em> retries.</p>
+</div></details></section></div></main></body></html>
@@ -0,0 +1,3 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Position change that counts as “this is a different playback context” — either the resume made progress, or a different item is loaded."><title>RESUME_PROGRESS_EPSILON_SECS in jellytau_lib::player::stream_end - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc constant"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">RESUME_PROGRESS_EPSILON_SECS</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.10.1</span></h2></div><div class="sidebar-elems"><div id="rustdoc-modnav"><h2><a href="index.html">In jellytau_<wbr>lib::<wbr>player::<wbr>stream_<wbr>end</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a>::<wbr><a href="index.html">stream_end</a></div><h1>Constant <span class="constant">RESUME_<wbr>PROGRESS_<wbr>EPSILON_<wbr>SECS</span>&nbsp;<button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/stream_end.rs.html#48">Source</a> </span></div><pre class="rust item-decl"><code>const RESUME_PROGRESS_EPSILON_SECS: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f64.html">f64</a> = 1.0;</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Position change that counts as “this is a different playback context” —
+either the resume made progress, or a different item is loaded.</p>
+</div></details></section></div></main></body></html>
@@ -0,0 +1,10 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="How far short of the item’s runtime a stream may end and still count as a natural finish."><title>TRUNCATED_STREAM_TOLERANCE_SECS in jellytau_lib::player::stream_end - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc constant"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">TRUNCATED_STREAM_TOLERANCE_SECS</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.10.1</span></h2></div><div class="sidebar-elems"><div id="rustdoc-modnav"><h2><a href="index.html">In jellytau_<wbr>lib::<wbr>player::<wbr>stream_<wbr>end</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a>::<wbr><a href="index.html">stream_end</a></div><h1>Constant <span class="constant">TRUNCATED_<wbr>STREAM_<wbr>TOLERANCE_<wbr>SECS</span>&nbsp;<button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/stream_end.rs.html#37">Source</a> </span></div><pre class="rust item-decl"><code>pub const TRUNCATED_STREAM_TOLERANCE_SECS: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f64.html">f64</a> = 10.0;</code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>How far short of the item’s runtime a stream may end and still count as a
+natural finish.</p>
+<p>Sized to swallow the two sources of slack in the comparison — the position
+poll is up to 250 ms stale, and Jellyfin’s reported runtime can disagree with
+the transcoded output by a second or two — while staying far below the
+minutes-long gap a dropped connection leaves. Erring long is the safe
+direction: a false “finished” is the bug we are fixing, whereas a false
+“truncated” only re-opens the stream for its last few seconds and then ends
+again normally.</p>
+</div></details></section></div></main></body></html>
@@ -0,0 +1,5 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="A video item played through the native audio path — i.e. the background audio-only handoff, the only place a length-less progressive transcode is used. Jellyfin’s item-type taxonomy stays in Rust (CLAUDE.md)."><title>is_audio_only_video in jellytau_lib::player::stream_end - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc fn"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">is_audio_only_video</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.10.1</span></h2></div><div class="sidebar-elems"><div id="rustdoc-modnav"><h2><a href="index.html">In jellytau_<wbr>lib::<wbr>player::<wbr>stream_<wbr>end</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a>::<wbr><a href="index.html">stream_end</a></div><h1>Function <span class="fn">is_<wbr>audio_<wbr>only_<wbr>video</span>&nbsp;<button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/stream_end.rs.html#55-58">Source</a> </span></div><pre class="rust item-decl"><code>pub fn is_audio_only_video(item: &amp;<a class="struct" href="../media/struct.MediaItem.html" title="struct jellytau_lib::player::media::MediaItem">MediaItem</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.bool.html">bool</a></code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>A video item played through the native <em>audio</em> path — i.e. the background
+audio-only handoff, the only place a length-less progressive transcode is
+used. Jellyfin’s item-type taxonomy stays in Rust (CLAUDE.md).</p>
+<p>TRACES: UR-040 | DR-129, DR-203 | UT-117, UT-200</p>
+</div></details></section></div></main></body></html>
@@ -0,0 +1,14 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Did this end-of-stream happen far enough short of the item’s runtime to be a truncation rather than a finish?"><title>is_truncated_end in jellytau_lib::player::stream_end - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc fn"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">is_truncated_end</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.10.1</span></h2></div><div class="sidebar-elems"><div id="rustdoc-modnav"><h2><a href="index.html">In jellytau_<wbr>lib::<wbr>player::<wbr>stream_<wbr>end</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a>::<wbr><a href="index.html">stream_end</a></div><h1>Function <span class="fn">is_<wbr>truncated_<wbr>end</span>&nbsp;<button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/stream_end.rs.html#106-114">Source</a> </span></div><pre class="rust item-decl"><code>pub fn is_truncated_end(
+    position: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f64.html">f64</a>,
+    duration: <a class="enum" href="https://doc.rust-lang.org/1.97.1/core/option/enum.Option.html" title="enum core::option::Option">Option</a>&lt;<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f64.html">f64</a>&gt;,
+    tolerance: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f64.html">f64</a>,
+) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.bool.html">bool</a></code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Did this end-of-stream happen far enough short of the item’s runtime to be a
+truncation rather than a finish?</p>
+<p><code>position</code> and <code>duration</code> must be on the same timeline — for a handoff stream
+built with <code>StartTimeTicks</code>, that means the <em>absolute</em> position (handoff base</p>
+<ul>
+<li>the player’s relative position) against the item’s full runtime.</li>
+</ul>
+<p>An unknown or non-positive <code>duration</code> answers <code>false</code>: with nothing to
+compare against, the reported end is taken at face value (previous behaviour).</p>
+</div></details></section></div></main></body></html>
@@ -0,0 +1,29 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Would the player’s own load-error retry restart this stream from its beginning? If so the retry must be switched off and recovery left to `crate::player::PlayerController::recoverable_error_resume`."><title>player_retry_restarts_stream in jellytau_lib::player::stream_end - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc fn"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">player_retry_restarts_stream</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.10.1</span></h2></div><div class="sidebar-elems"><div id="rustdoc-modnav"><h2><a href="index.html">In jellytau_<wbr>lib::<wbr>player::<wbr>stream_<wbr>end</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a>::<wbr><a href="index.html">stream_end</a></div><h1>Function <span class="fn">player_<wbr>retry_<wbr>restarts_<wbr>stream</span>&nbsp;<button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/stream_end.rs.html#93-95">Source</a> </span></div><pre class="rust item-decl"><code>pub fn player_retry_restarts_stream(item: &amp;<a class="struct" href="../media/struct.MediaItem.html" title="struct jellytau_lib::player::media::MediaItem">MediaItem</a>) -&gt; <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.bool.html">bool</a></code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Would the <em>player’s own</em> load-error retry restart this stream from its
+beginning? If so the retry must be switched off and recovery left to
+<a href="../struct.PlayerController.html#method.recoverable_error_resume" title="method jellytau_lib::player::PlayerController::recoverable_error_resume"><code>crate::player::PlayerController::recoverable_error_resume</code></a>.</p>
+<p>ExoPlayer resumes a failed load in place only when it knows where “in place”
+is: <code>ProgressiveMediaPeriod.configureRetry</code> keeps the load position when the
+content length is known <em>or</em> the extractor produced a seek map with a
+duration, and otherwise treats the source as live — the data at the URL is
+assumed to have changed, so it resets every sample queue and re-requests the
+URL from offset 0.</p>
+<p>The handoff transcode satisfies neither condition: it is chunked (no
+<code>Content-Length</code>) and a live mp3 encode carries no <code>Xing</code> header, so the
+player reports its duration as unset — visible in logcat as every position
+tick reading <code>&lt;position&gt; / 0.0</code>. Its URL carries <code>StartTimeTicks</code> = the
+handoff point, so restarting it from offset 0 restarts the <em>episode</em> at the
+handoff point, and playback then runs on from there. Nothing surfaces: no
+error, no <code>STATE_ENDED</code>, so neither the truncation path nor the error path of
+DR-129 is consulted, and the app’s only sign of it is a position that jumps
+backwards. That is the “it randomly jumps back to where audio-only started”
+the user sees, and how random it is depends on whether a network blip happens
+to land while a load is in flight rather than while the ~50s buffer covers it.</p>
+<p>A retry that can only restart the stream is worth less than no retry at all:
+declining it turns the silent rewind into a recoverable error, which
+<code>recoverable_error_resume</code> answers by re-opening the stream at the position
+playback actually reached (<code>StartTimeTicks</code> rewritten, backoff and attempt
+budget included). Every other source keeps the player’s retry: a static file
+and an HLS playlist both declare their timeline, so ExoPlayer resumes them
+exactly where the load failed.</p>
+<p>TRACES: UR-040, UR-004 | DR-203 | UT-200</p>
+</div></details></section></div></main></body></html>
@@ -0,0 +1,7 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Rewrite an audio-only stream URL to start at `position_seconds`."><title>with_start_time in jellytau_lib::player::stream_end - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc fn"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">with_start_time</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.10.1</span></h2></div><div class="sidebar-elems"><div id="rustdoc-modnav"><h2><a href="index.html">In jellytau_<wbr>lib::<wbr>player::<wbr>stream_<wbr>end</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a>::<wbr><a href="index.html">stream_end</a></div><h1>Function <span class="fn">with_<wbr>start_<wbr>time</span>&nbsp;<button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/stream_end.rs.html#123-152">Source</a> </span></div><pre class="rust item-decl"><code>pub fn with_start_time(url: &amp;<a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.str.html">str</a>, position_seconds: <a class="primitive" href="https://doc.rust-lang.org/1.97.1/std/primitive.f64.html">f64</a>) -&gt; <a class="struct" href="https://doc.rust-lang.org/1.97.1/alloc/string/struct.String.html" title="struct alloc::string::String">String</a></code></pre><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Rewrite an audio-only stream URL to start at <code>position_seconds</code>.</p>
+<p>Resuming re-opens <em>the stream we were already playing</em>, so the URL is edited
+in place rather than rebuilt from the repository: every other parameter —
+<code>AudioStreamIndex</code> (the track the user picked in the video player),
+<code>MediaSourceId</code>, <code>api_key</code> — is carried over untouched, and no network call
+is needed to recover from a network failure.</p>
+</div></details></section></div></main></body></html>
@@ -0,0 +1,27 @@
+<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta name="generator" content="rustdoc"><meta name="description" content="Telling a finished stream apart from a truncated one."><title>jellytau_lib::player::stream_end - Rust</title><script>if(window.location.protocol!=="file:")document.head.insertAdjacentHTML("beforeend","SourceSerif4-Regular-6b053e98.ttf.woff2,FiraSans-Italic-81dc35de.woff2,FiraSans-Regular-0fe48ade.woff2,FiraSans-MediumItalic-ccf7e434.woff2,FiraSans-Medium-e1aa3f0a.woff2,SourceCodePro-Regular-8badfe75.ttf.woff2,SourceCodePro-Semibold-aa29a496.ttf.woff2".split(",").map(f=>`<link rel="preload" as="font" type="font/woff2"href="../../../static.files/${f}">`).join(""))</script><link rel="stylesheet" href="../../../static.files/normalize-9960930a.css"><link rel="stylesheet" href="../../../static.files/rustdoc-17e0aaed.css"><meta name="rustdoc-vars" data-root-path="../../../" data-static-root-path="../../../static.files/" data-current-crate="jellytau_lib" data-themes="" data-resource-suffix="" data-rustdoc-version="1.97.1 (8bab26f4f 2026-07-14)" data-channel="1.97.1" data-search-js="search-fd9372ac.js" data-stringdex-js="stringdex-2da4960a.js" data-settings-js="settings-170eb4bf.js" ><script src="../../../static.files/storage-41dd4d93.js"></script><script defer src="../sidebar-items.js"></script><script defer src="../../../static.files/main-fcd733ba.js"></script><noscript><link rel="stylesheet" href="../../../static.files/noscript-f7c3ffd8.css"></noscript><link rel="alternate icon" type="image/png" href="../../../static.files/favicon-32x32-eab170b8.png"><link rel="icon" type="image/svg+xml" href="../../../static.files/favicon-044be391.svg"></head><body class="rustdoc mod"><a class="skip-main-content" href="#main-content">Skip to main content</a><!--[if lte IE 11]><div class="warning">This old browser is unsupported and will most likely display funky things.</div><![endif]--><rustdoc-topbar><h2><a href="#">Module stream_end</a></h2></rustdoc-topbar><nav class="sidebar"><div class="sidebar-crate"><h2><a href="../../../jellytau_lib/index.html">jellytau_<wbr>lib</a><span class="version">0.10.1</span></h2></div><div class="sidebar-elems"><section id="rustdoc-toc"><h2 class="location"><a href="#">Module stream_<wbr>end</a></h2><h3><a href="#structs">Module Items</a></h3><ul class="block"><li><a href="#structs" title="Structs">Structs</a></li><li><a href="#constants" title="Constants">Constants</a></li><li><a href="#functions" title="Functions">Functions</a></li></ul></section><div id="rustdoc-modnav"><h2><a href="../index.html">In jellytau_<wbr>lib::<wbr>player</a></h2></div></div></nav><div class="sidebar-resizer" title="Drag to resize sidebar"></div><main><div class="width-limiter"><section id="main-content" class="content" tabindex="-1"><div class="main-heading"><div class="rustdoc-breadcrumbs"><a href="../../index.html">jellytau_lib</a>::<wbr><a href="../index.html">player</a></div><h1>Module <span>stream_<wbr>end</span>&nbsp;<button id="copy-path" title="Copy item path to clipboard">Copy item path</button></h1><rustdoc-toolbar></rustdoc-toolbar><span class="sub-heading"><a class="src" href="../../../src/jellytau_lib/player/stream_end.rs.html#1-516">Source</a> </span></div><details class="toggle top-doc" open><summary class="hideme"><span>Expand description</span></summary><div class="docblock"><p>Telling a <em>finished</em> stream apart from a <em>truncated</em> one.</p>
+<p>TRACES: UR-040 | DR-129 | UT-117</p>
+<p>Background audio-only playback of a video item streams a <strong>progressive mp3
+transcode over plain HTTP</strong> (see
+<code>OnlineRepository::build_audio_only_stream_url_for_video</code>). That response has
+no reliable length — a live transcode is chunked — so when the connection
+drops mid-episode the data source simply sees end-of-input. ExoPlayer cannot
+distinguish that from the real end of the media and reports
+<code>Player.STATE_ENDED</code>, which the app then treats as “the episode finished”.</p>
+<p>The user-visible damage is not the missed advance itself. Playback parks in
+ExoPlayer’s <code>STATE_ENDED</code>, and the next play intent from the lockscreen,
+notification or a Bluetooth reconnect goes through media3’s
+<code>Util.handlePlayButtonAction</code>, which seeks an ENDED player to its default
+position before playing — so <strong>the episode starts over from 0:00</strong>. On a
+flaky connection that reads as “it randomly restarts the episode”.</p>
+<p>The player itself has no way to know; the <em>duration</em> does. Jellyfin gives us
+the item’s real runtime, so an end reported well short of it is a truncation,
+not a finish — and the right response is to re-open the stream where it died,
+which is the “buffer and resume” the user expects.</p>
+</div></details><h2 id="structs" class="section-header">Structs<a href="#structs" class="anchor">§</a></h2><dl class="item-table"><dt><a class="struct" href="struct.ObservedTime.html" title="struct jellytau_lib::player::stream_end::ObservedTime">Observed<wbr>Time</a></dt><dd>The last playback time actually observed while media was loaded.</dd><dt><a class="struct" href="struct.ResumeTracker.html" title="struct jellytau_lib::player::stream_end::ResumeTracker">Resume<wbr>Tracker</a></dt><dd>Budget for consecutive resume attempts that make no progress.</dd></dl><h2 id="constants" class="section-header">Constants<a href="#constants" class="anchor">§</a></h2><dl class="item-table"><dt><a class="constant" href="constant.MAX_STALLED_RESUME_ATTEMPTS.html" title="constant jellytau_lib::player::stream_end::MAX_STALLED_RESUME_ATTEMPTS">MAX_<wbr>STALLED_<wbr>RESUME_<wbr>ATTEMPTS</a></dt><dd>Consecutive resume attempts allowed at the same position before giving up.</dd><dt><a class="constant" href="constant.RESUME_PROGRESS_EPSILON_SECS.html" title="constant jellytau_lib::player::stream_end::RESUME_PROGRESS_EPSILON_SECS">RESUME_<wbr>PROGRESS_<wbr>EPSILON_<wbr>SECS</a><span title="Restricted Visibility">&nbsp;🔒</span> </dt><dd>Position change that counts as “this is a different playback context” —
+either the resume made progress, or a different item is loaded.</dd><dt><a class="constant" href="constant.TRUNCATED_STREAM_TOLERANCE_SECS.html" title="constant jellytau_lib::player::stream_end::TRUNCATED_STREAM_TOLERANCE_SECS">TRUNCATED_<wbr>STREAM_<wbr>TOLERANCE_<wbr>SECS</a></dt><dd>How far short of the item’s runtime a stream may end and still count as a
+natural finish.</dd></dl><h2 id="functions" class="section-header">Functions<a href="#functions" class="anchor">§</a></h2><dl class="item-table"><dt><a class="fn" href="fn.is_audio_only_video.html" title="fn jellytau_lib::player::stream_end::is_audio_only_video">is_<wbr>audio_<wbr>only_<wbr>video</a></dt><dd>A video item played through the native <em>audio</em> path — i.e. the background
+audio-only handoff, the only place a length-less progressive transcode is
+used. Jellyfin’s item-type taxonomy stays in Rust (CLAUDE.md).</dd><dt><a class="fn" href="fn.is_truncated_end.html" title="fn jellytau_lib::player::stream_end::is_truncated_end">is_<wbr>truncated_<wbr>end</a></dt><dd>Did this end-of-stream happen far enough short of the item’s runtime to be a
+truncation rather than a finish?</dd><dt><a class="fn" href="fn.player_retry_restarts_stream.html" title="fn jellytau_lib::player::stream_end::player_retry_restarts_stream">player_<wbr>retry_<wbr>restarts_<wbr>stream</a></dt><dd>Would the <em>player’s own</em> load-error retry restart this stream from its
+beginning? If so the retry must be switched off and recovery left to
+<a href="../struct.PlayerController.html#method.recoverable_error_resume" title="method jellytau_lib::player::PlayerController::recoverable_error_resume"><code>crate::player::PlayerController::recoverable_error_resume</code></a>.</dd><dt><a class="fn" href="fn.with_start_time.html" title="fn jellytau_lib::player::stream_end::with_start_time">with_<wbr>start_<wbr>time</a></dt><dd>Rewrite an audio-only stream URL to start at <code>position_seconds</code>.</dd></dl></section></div></main></body></html>
@@ -0,0 +1 @@
+window.SIDEBAR_ITEMS = {"constant":["MAX_STALLED_RESUME_ATTEMPTS","RESUME_PROGRESS_EPSILON_SECS","TRUNCATED_STREAM_TOLERANCE_SECS"],"fn":["is_audio_only_video","is_truncated_end","player_retry_restarts_stream","with_start_time"],"struct":["ObservedTime","ResumeTracker"]};
				`@@ -0,0 +1 @@`
				`window.SIDEBAR_ITEMS = {"constant":["MAX_STALLED_RESUME_ATTEMPTS","RESUME_PROGRESS_EPSILON_SECS","TRUNCATED_STREAM_TOLERANCE_SECS"],"fn":["is_audio_only_video","is_truncated_end","player_retry_restarts_stream","with_start_time"],"struct":["ObservedTime","ResumeTracker"]};`