Open a fresh browser, capture one /videoplayback POST, close. Used by the legacy one-shot path. The daemon path uses `_capture_on_page` direc

Auto-seek past any sponsor segment the playhead landed in. Called on every POS event. We use the same `_handle_seek_req` machinery as

11-char URL-safe random nonce, same alphabet Cobalt uses.

Long-running visible Camoufox + Unix-socket request handler. Headless Camoufox on this host can't reach the proxy (Firefox-specific NS_ERROR_

Fetch the JPEG. If `url` not given, derive from video_id (mqdefault).

Length of StreamerContext.poToken (field 19 → 2) in a SABR POST. Used to distinguish the cold-start placeholder (~10B) the browser sends in i

POST /youtubei/v1/player with a non-WEB client context. Returns the response JSON as a string (serialised back from dict) so the caller treat

Return PR JSON blob if streamingData present, else None.

Current signatureTimestamp from YouTube's player JS, cached 12h. TVHTML5 /player answers UNPLAYABLE "The page needs to be reloaded" when the

Triggered by LOAD_MORE_RECS from ffplay-yt when the user scrolls near the end of the list. Spawns recs_pipeline with the saved continu

Rewrite the bootstrap body's player-context fields with our HD hints.

Shared worker body: spawn recs_pipeline.py with `args`, pipe each stdout line into ffplay-yt's IPC, intercept CONTINUATION lines for t

Pick a videoId to expand from — bias toward recently-added so results stay related to whatever we're showing the user now.

Pull the seed videoId out of a /next response so we can tell if the cache was for the same seed video.

First batch — runs in a daemon thread so the controller loop isn't blocked while recommendations are fetched.

GET / to get a fresh VISITOR_INFO1_LIVE under the strategy's fingerprint. Returns True if HTTP 200, False otherwise (we still try /watch even

Try to find ffplay window by title and by WM_CLASS=ffplay.

Return (x, y, w, h) of the active X11 window (the terminal), captured right before we launch ffplay so we know where to drop its window. None

* Decode one audio frame and return its uncompressed size. * * The processed audio frame is decoded, converted if required, and * stored in is->aud

Return Bootstrap for the given YouTube URL. `engine`: "chromium" (fast, may hit bot wall) or "camoufox" (slower but reliable; default). On fa

ffplay-yt: build an `atempo=…[,atempo=…],asetpts=…` chain for a given * playback speed. libavfilter's atempo accepts 0.5–2.0 per filter — for * 3x a

Take the bootstrap-captured template and overwrite the per-step state. Currently overwrites: - top-level field 2 (repeated, selected format

Run SABR client, write video.fmp4 + audio.fmp4. Returns their paths.

Heavy yellow rectangle around the focused tile (thumb + 2 text rows).

Render recommendation tiles into the left sidebar. Called from * video_display after the video has been drawn (so we paint on top). * * `x_offset`

The centered overlay: rounded-ish dark plate with 3 chevrons (lit * up to `speed_anim_value`) and the speed in a small caption. Pops * in with overs

handle an event sent by the GUI */

Try authenticated TVHTML5 InnerTube .next() — gives personalized recs. Returns (items, next_continuation_token) or None if auth not available.

Plain WEB-client unauth /next call. Public key is well-known.

16-char client playback nonce — same alphabet YT web JS uses.

Return the strategy to try right now. If the persisted current is somehow dead (e.g. another invocation just killed it), advance.

Return PNG bytes ready to feed kitty. Cached in memory by (id, size).

Return list of (start_sec, end_sec, category) tuples, sorted by start.

Return valid tokens; auto-refresh or trigger pairing as needed.