From 8a21fbe07fa5a8bdfd00e7eeb434af0e33922d85 Mon Sep 17 00:00:00 2001
From: KoalaDev <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 09:43:11 +0200
Subject: [PATCH 01/22] Fix Netflix seek handling

---
 extension/background.js | 86 +++++++++++++++++++++++++++++++++++++----
 extension/content.js    | 28 ++++++++++----
 extension/popup.js      | 17 ++++----
 3 files changed, 106 insertions(+), 25 deletions(-)

diff --git a/extension/background.js b/extension/background.js
index 2b5f601..dac9678 100644
--- a/extension/background.js
+++ b/extension/background.js
@@ -1592,6 +1592,68 @@ async function routeToContent(action, payload) {
     _routeToContentInternal(tabId, action, payload, actionTimestamp, commandSenderId, 0);
 }
 
+function isNetflixUrl(url) {
+    try {
+        const host = new URL(url).hostname.toLowerCase();
+        return host === 'netflix.com' || host.endsWith('.netflix.com');
+    } catch (_e) {
+        return false;
+    }
+}
+
+function installNetflixSeekBridge() {
+    if (window.__koalaNetflixSeekBridgeInstalled) return;
+    window.__koalaNetflixSeekBridgeInstalled = true;
+
+    function getNetflixPlayer() {
+        try {
+            const videoPlayer = window.netflix?.appContext?.state?.playerApp?.getAPI?.().videoPlayer;
+            const sessionId = videoPlayer?.getAllPlayerSessionIds?.()[0];
+            return sessionId ? videoPlayer.getVideoPlayerBySessionId(sessionId) : null;
+        } catch (_e) {
+            return null;
+        }
+    }
+
+    window.addEventListener('message', (event) => {
+        if (event.source !== window) return;
+        const data = event.data;
+        if (!data || data.__koalaNetflixSeek !== 1 || data.kind !== 'seek' || typeof data.time !== 'number') return;
+        try {
+            getNetflixPlayer()?.seek(Math.round(data.time * 1000));
+        } catch (_e) {
+            // Netflix player not ready or private API changed; the next sync tick can retry.
+        }
+    });
+}
+
+async function injectContentScript(tabId) {
+    let isNetflix = false;
+    try {
+        const tab = await chrome.tabs.get(tabId);
+        isNetflix = isNetflixUrl(tab?.url || '');
+    } catch (_e) {
+        // Fall through to the generic content script injection.
+    }
+
+    if (isNetflix) {
+        try {
+            await chrome.scripting.executeScript({
+                target: { tabId },
+                world: 'MAIN',
+                func: installNetflixSeekBridge
+            });
+        } catch (err) {
+            addLog(`Netflix seek bridge injection failed: ${err.message}`, 'warn');
+        }
+    }
+
+    return chrome.scripting.executeScript({
+        target: { tabId },
+        files: ['content.js']
+    });
+}
+
 function _routeToContentInternal(tabId, action, payload, actionTimestamp, commandSenderId, retries) {
     chrome.tabs.sendMessage(tabId, { 
         type: 'SERVER_COMMAND',
@@ -1606,10 +1668,7 @@ function _routeToContentInternal(tabId, action, payload, actionTimestamp, comman
             return;
         }
         if (err.message.includes('Receiving end does not exist') || err.message.includes('Extension context invalidated')) {
-            chrome.scripting.executeScript({
-                target: { tabId },
-                files: ['content.js']
-            }).then(() => {
+            injectContentScript(tabId).then(() => {
                 setTimeout(() => _routeToContentInternal(tabId, action, payload, actionTimestamp, commandSenderId, retries + 1), 500);
             }).catch(_err => {
                 addLog(`Auto-reinject failed for tab ${tabId}`, 'warn');
@@ -2196,6 +2255,20 @@ async function handleAsyncMessage(message, sender, sendResponse) {
             addLog('Heartbeat settings error: ' + err.message, 'error');
             sendResponse({ status: 'ok' });
         });
+    } else if (message.type === 'INJECT_CONTENT_SCRIPT') {
+        const tabId = Number(message.tabId);
+        if (!Number.isInteger(tabId)) {
+            sendResponse({ status: 'invalid_tab' });
+            return true;
+        }
+
+        injectContentScript(tabId).then(() => {
+            sendResponse({ status: 'ok' });
+        }).catch(err => {
+            addLog(`Failed to inject into tab: ${err.message}`, 'warn');
+            sendResponse({ status: 'error', message: err.message });
+        });
+        return true;
     } else if (message.type === 'SET_TARGET_TAB') {
         const previousTabId = currentTabId;
         currentTabId = message.tabId;
@@ -2213,10 +2286,7 @@ async function handleAsyncMessage(message, sender, sendResponse) {
         
         if (currentTabId) {
             const selectedTabId = currentTabId;
-            chrome.scripting.executeScript({
-                target: { tabId: selectedTabId },
-                files: ['content.js']
-            })
+            injectContentScript(selectedTabId)
                 .then(() => applyAudioSettingsToTab(selectedTabId))
                 .catch(err => {
                     addLog(`Failed to inject into tab: ${err.message}`, 'warn');
diff --git a/extension/content.js b/extension/content.js
index a7ade14..01a491e 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -57,6 +57,22 @@
     let seekDebounceTimer = null;     // debounce timer for rapid seek events
     let expectedSeekTime = null;      // strictly track programmatic seeks
 
+    const NETFLIX_SEEK_BRIDGE = 1;
+
+    function isNetflixHost() {
+        const host = window.location.hostname.toLowerCase();
+        return host === 'netflix.com' || host.endsWith('.netflix.com');
+    }
+
+    function seekVideo(video, targetTime) {
+        expectedSeekTime = targetTime;
+        if (isNetflixHost()) {
+            window.postMessage({ __koalaNetflixSeek: NETFLIX_SEEK_BRIDGE, kind: 'seek', time: targetTime }, '*');
+            return;
+        }
+        video.currentTime = targetTime;
+    }
+
     // --- Play/Pause Coalescing (leading + trailing) ---
     // Media players (HLS/DASH, ad insertion, ABR/quality switches, source swaps,
     // page teardown) fire bursts of native play/pause events within a few hundred
@@ -748,8 +764,7 @@
                         ytButton.click();
                     }
                     if (action === EVENTS.SEEK) {
-                        expectedSeekTime = data.targetTime;
-                        video.currentTime = data.targetTime;
+                        seekVideo(video, data.targetTime);
                     }
                     return;
                 }
@@ -764,8 +779,7 @@
                         twitchButton.click();
                     }
                     if (action === EVENTS.SEEK) {
-                        expectedSeekTime = data.targetTime;
-                        video.currentTime = data.targetTime;
+                        seekVideo(video, data.targetTime);
                     }
                     return;
                 }
@@ -782,8 +796,7 @@
                 _setSuppress('paused');
                 video.pause();
             } else if (action === EVENTS.SEEK) {
-                expectedSeekTime = data.targetTime;
-                video.currentTime = data.targetTime;
+                seekVideo(video, data.targetTime);
             }
     } catch (e) {
             reportLog(`Media Action Error: ${e.message}`, 'error');
@@ -931,10 +944,9 @@
                         return;
                     }
                     _setSuppress('paused');
-                    expectedSeekTime = payload.targetTime;
                     video.pause();
                     try {
-                        video.currentTime = payload.targetTime;
+                        seekVideo(video, payload.targetTime);
                     } catch (e) {
                         reportLog(`Force Sync Seek Error: ${e.message}`, 'error');
                     }
diff --git a/extension/popup.js b/extension/popup.js
index a9e2952..7ecead6 100644
--- a/extension/popup.js
+++ b/extension/popup.js
@@ -1609,10 +1609,14 @@ elements.forceSyncBtn.addEventListener('click', async () => {
     if (mode === 'jump-to-me') {
         chrome.tabs.sendMessage(tabId, { action: 'get_current_time' }, (response) => {
             if (chrome.runtime.lastError || !response || response.currentTime === undefined) {
-                chrome.scripting.executeScript({
-                    target: { tabId },
-                    files: ['content.js']
-                }).then(() => {
+                chrome.runtime.sendMessage({ type: 'INJECT_CONTENT_SCRIPT', tabId }, (injectResponse) => {
+                    if (chrome.runtime.lastError || !injectResponse || injectResponse.status !== 'ok') {
+                        showError(getMessage('ERR_NO_VIDEO_TAB'));
+                        forceSyncDone = true;
+                        elements.forceSyncBtn.disabled = false;
+                        elements.forceSyncBtn.textContent = originalText;
+                        return;
+                    }
                     setTimeout(() => {
                         chrome.tabs.sendMessage(tabId, { action: 'get_current_time' }, (retryResponse) => {
                             if (chrome.runtime.lastError) return;
@@ -1621,11 +1625,6 @@ elements.forceSyncBtn.addEventListener('click', async () => {
                             }
                         });
                     }, 500);
-                }).catch(() => {
-                    showError(getMessage('ERR_NO_VIDEO_TAB'));
-                    forceSyncDone = true;
-                    elements.forceSyncBtn.disabled = false;
-                    elements.forceSyncBtn.textContent = originalText;
                 });
                 return;
             }

From 57cd071d58cce500daaae15eb738a3684b0fb50b Mon Sep 17 00:00:00 2001
From: KoalaDev <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 09:50:39 +0200
Subject: [PATCH 02/22] Add hidden remote seek test controls

---
 extension/background.js | 66 +++++++++++++++++++++++++++++++++++++++++
 extension/popup.html    |  9 ++++++
 extension/popup.js      | 43 +++++++++++++++++++++++++--
 3 files changed, 115 insertions(+), 3 deletions(-)

diff --git a/extension/background.js b/extension/background.js
index dac9678..d46b479 100644
--- a/extension/background.js
+++ b/extension/background.js
@@ -1592,6 +1592,62 @@ async function routeToContent(action, payload) {
     _routeToContentInternal(tabId, action, payload, actionTimestamp, commandSenderId, 0);
 }
 
+function getTabVideoState(tabId) {
+    return new Promise((resolve) => {
+        chrome.tabs.sendMessage(tabId, { type: 'GET_VIDEO_STATE' }, (res) => {
+            if (chrome.runtime.lastError) {
+                resolve({ error: chrome.runtime.lastError.message });
+                return;
+            }
+            resolve(res);
+        });
+    });
+}
+
+async function getReadyTabVideoState(tabId) {
+    let state = await getTabVideoState(tabId);
+    if (!state || state.error) {
+        await injectContentScript(tabId);
+        await new Promise(resolve => setTimeout(resolve, 250));
+        state = await getTabVideoState(tabId);
+    }
+    return state;
+}
+
+async function simulateRemoteSeek(delta) {
+    if (!currentTabId) return { status: 'no_tab' };
+    const tabId = parseInt(currentTabId);
+    if (isNaN(tabId)) return { status: 'no_tab' };
+
+    const state = await getReadyTabVideoState(tabId);
+    if (!state || state.error) return { status: 'error', message: state?.error || 'No video state' };
+    if (!state.found || !Number.isFinite(state.currentTime)) return { status: 'no_video' };
+
+    let targetTime = Math.max(0, state.currentTime + delta);
+    if (Number.isFinite(state.duration) && state.duration > 0) {
+        targetTime = Math.min(targetTime, Math.max(0, state.duration - 0.1));
+    }
+
+    const senderId = 'KoalaDev';
+    const timestamp = Date.now();
+    const payload = {
+        senderId,
+        actionTimestamp: timestamp,
+        currentTime: targetTime,
+        targetTime
+    };
+
+    addToHistory(EVENTS.SEEK, senderId);
+    showNotification(senderId, EVENTS.SEEK);
+    updateLastAction(EVENTS.SEEK, senderId, timestamp);
+    lastActionState.targetTime = targetTime;
+    if (storageInitialized) chrome.storage.session.set({ lastActionState });
+    updateLocalPeerState(senderId, { currentTime: targetTime });
+    routeToContent(EVENTS.SEEK, payload);
+
+    return { status: 'ok', targetTime };
+}
+
 function isNetflixUrl(url) {
     try {
         const host = new URL(url).hostname.toLowerCase();
@@ -2056,6 +2112,16 @@ async function handleAsyncMessage(message, sender, sendResponse) {
                 sendResponse(res);
             }
         });
+    } else if (message.type === 'DEV_SIMULATE_REMOTE_SEEK') {
+        const delta = Number(message.delta);
+        if (!Number.isFinite(delta)) {
+            sendResponse({ status: 'invalid_delta' });
+            return;
+        }
+        simulateRemoteSeek(delta).then(sendResponse).catch(err => {
+            addLog(`Remote seek simulation failed: ${err.message}`, 'warn');
+            sendResponse({ status: 'error', message: err.message });
+        });
     } else if (message.type === 'CONTENT_EVENT') {
         const processEvent = async () => {
             // Host Control Mode (sender-side): a non-controller in host-only mode must
diff --git a/extension/popup.html b/extension/popup.html
index 23a2080..5df9ef9 100644
--- a/extension/popup.html
+++ b/extension/popup.html
@@ -391,6 +391,7 @@
         <button class="tab-btn" data-tab="tab-sync" data-i18n="TAB_SYNC" data-i18n-title="TAB_SYNC_TOOLTIP" title="Video sync controls and remote actions">Sync</button>
         <button class="tab-btn" data-tab="tab-settings" data-i18n="TAB_SETTINGS" data-i18n-title="TAB_SETTINGS_TOOLTIP" title="Extension preferences">Settings</button>
         <button class="tab-btn" data-tab="tab-dev" data-i18n="TAB_STATUS" data-i18n-title="TAB_STATUS_TOOLTIP" title="Advanced Diagnostics & Logs">Status</button>
+        <button id="devToolsTabBtn" class="tab-btn" data-tab="tab-devtools" style="display:none;">Dev</button>
     </div>
 
     <!-- Room Tab -->
@@ -692,6 +693,14 @@
         </div>
     </div>
 
+    <div id="tab-devtools" class="tab-content">
+        <label>Remote Seek</label>
+        <div class="info-card" style="display:flex; gap:8px; margin-bottom:15px;">
+            <button id="remoteSeekBack" class="secondary" style="flex:1; font-size:12px;">-30s</button>
+            <button id="remoteSeekForward" class="secondary" style="flex:1; font-size:12px;">+30s</button>
+        </div>
+    </div>
+
     <script src="popup.js" type="module"></script>
 
     <!-- Onboarding Overlay -->
diff --git a/extension/popup.js b/extension/popup.js
index 7ecead6..7ea0322 100644
--- a/extension/popup.js
+++ b/extension/popup.js
@@ -71,7 +71,10 @@ const elements = {
     settingsVersion: document.getElementById('settingsVersion'),
     devSupportLink: document.getElementById('devSupportLink'),
     devReviewLink: document.getElementById('devReviewLink'),
-    syncTabCopyInvite: document.getElementById('syncTabCopyInvite')
+    syncTabCopyInvite: document.getElementById('syncTabCopyInvite'),
+    devToolsTabBtn: document.getElementById('devToolsTabBtn'),
+    remoteSeekBack: document.getElementById('remoteSeekBack'),
+    remoteSeekForward: document.getElementById('remoteSeekForward')
 };
 
 let localPeerId = null;
@@ -88,6 +91,19 @@ let errorToken = 0;
 let forceSyncDone = false;
 let connectionErrorTimer = null;
 let pendingConnectionErrorMsg = null;
+
+function devToolsEnabled() {
+    return elements.username && elements.username.value.trim() === 'KoalaDev';
+}
+
+function syncDevToolsVisibility() {
+    if (!elements.devToolsTabBtn) return;
+    const enabled = devToolsEnabled();
+    elements.devToolsTabBtn.style.display = enabled ? '' : 'none';
+    if (!enabled && document.getElementById('tab-devtools')?.classList.contains('active')) {
+        document.querySelector('.tab-btn[data-tab="tab-settings"]')?.click();
+    }
+}
 let roomListRefreshTimer = null;
 let roomListRefreshInterval = null;
 const ROOM_LIST_REFRESH_COOLDOWN_MS = 11000;
@@ -210,6 +226,7 @@ async function init() {
     elements.roomId.value = localData.roomId || '';
     elements.password.value = localData.password || '';
     elements.username.value = username;
+    syncDevToolsVisibility();
     if (elements.filterNoise) elements.filterNoise.checked = localData.filterNoise !== false;
     if (elements.autoSyncNextEpisode) elements.autoSyncNextEpisode.checked = localData.autoSyncNextEpisode !== false;
     const legacyTitlePrivacyMode = Object.values(TITLE_PRIVACY_MODES).includes(localData.titlePrivacyMode) ? localData.titlePrivacyMode : TITLE_PRIVACY_MODES.FULL;
@@ -277,13 +294,13 @@ async function init() {
                 const syncTabBtn = document.querySelector('.tab-btn[data-tab="tab-sync"]');
                 if (syncTabBtn) syncTabBtn.click();
                 showSelectVideoHint();
-            } else if (localData.activeTab) {
+            } else if (localData.activeTab && (localData.activeTab !== 'tab-devtools' || devToolsEnabled())) {
                 const btn = document.querySelector(`.tab-btn[data-tab="${localData.activeTab}"]`);
                 if (btn) btn.click();
             }
         } else {
             await populateTabs();
-            if (localData.activeTab) {
+            if (localData.activeTab && (localData.activeTab !== 'tab-devtools' || devToolsEnabled())) {
                 const btn = document.querySelector(`.tab-btn[data-tab="${localData.activeTab}"]`);
                 if (btn) btn.click();
             }
@@ -1275,8 +1292,10 @@ elements.serverUrl.addEventListener('input', () => {
     chrome.storage.local.set({ serverUrl: elements.serverUrl.value });
 });
 
+elements.username.addEventListener('input', syncDevToolsVisibility);
 elements.username.addEventListener('change', () => {
     chrome.storage.local.set({ username: elements.username.value });
+    syncDevToolsVisibility();
 });
 
 if (elements.langSelector) {
@@ -1689,6 +1708,24 @@ elements.pauseBtn.addEventListener('click', () => {
     }, 2500);
 });
 
+function simulateRemoteSeek(delta) {
+    chrome.runtime.sendMessage({ type: 'DEV_SIMULATE_REMOTE_SEEK', delta }, (res) => {
+        if (chrome.runtime.lastError || !res || res.status !== 'ok') {
+            showToast(res?.message || 'Remote seek failed', 'error');
+            return;
+        }
+        showToast(`Remote seek -> ${formatTime(res.targetTime)}`, 'success', 1200);
+        refreshDebugInfo();
+    });
+}
+
+if (elements.remoteSeekBack) {
+    elements.remoteSeekBack.addEventListener('click', () => simulateRemoteSeek(-30));
+}
+if (elements.remoteSeekForward) {
+    elements.remoteSeekForward.addEventListener('click', () => simulateRemoteSeek(30));
+}
+
 elements.clearLogs.addEventListener('click', () => {
     chrome.runtime.sendMessage({ type: 'CLEAR_LOGS' }, () => {
         elements.logList.innerHTML = '';

From 52265e84eb9d1f55513f6d64d57ba6c67ff902f7 Mon Sep 17 00:00:00 2001
From: KoalaDev <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 09:57:57 +0200
Subject: [PATCH 03/22] Generalize page API seek overrides

---
 extension/background.js              | 82 +++++++++++++++++++---------
 extension/content.js                 | 13 +++--
 extension/page-api-seek-overrides.js | 23 ++++++++
 3 files changed, 86 insertions(+), 32 deletions(-)
 create mode 100644 extension/page-api-seek-overrides.js

diff --git a/extension/background.js b/extension/background.js
index d46b479..b346e71 100644
--- a/extension/background.js
+++ b/extension/background.js
@@ -4,6 +4,7 @@ import { loadLocale, getMessage, getSystemLanguage } from './i18n.js';
 import { sameEpisode } from './episode-utils.js';
 import { applyTitlePrivacyToPayload, sanitizeSharedTitle, sanitizeTabTitle, normalizeSendTabTitle, normalizeTitlePrivacyMode } from './title-privacy.js';
 import { initTabManager } from './modules/tab-manager.js';
+import './page-api-seek-overrides.js';
 
 // --- Uninstall URL Initialization ---
 let uninstallURLInitPromise = null;
@@ -1648,62 +1649,87 @@ async function simulateRemoteSeek(delta) {
     return { status: 'ok', targetTime };
 }
 
-function isNetflixUrl(url) {
-    try {
-        const host = new URL(url).hostname.toLowerCase();
-        return host === 'netflix.com' || host.endsWith('.netflix.com');
-    } catch (_e) {
-        return false;
-    }
+async function devRemoteToolsAllowed() {
+    const data = await chrome.storage.local.get(['username']);
+    return data.username === 'KoalaDev';
 }
 
-function installNetflixSeekBridge() {
-    if (window.__koalaNetflixSeekBridgeInstalled) return;
-    window.__koalaNetflixSeekBridgeInstalled = true;
+function shouldUsePageApiSeek(url) {
+    return typeof globalThis.koalaFindPageApiSeekProvider === 'function' &&
+        !!globalThis.koalaFindPageApiSeekProvider(url);
+}
+
+function installPageApiSeekBridge() {
+    if (window.__koalaPageApiSeekBridgeInstalled) return;
+    window.__koalaPageApiSeekBridgeInstalled = true;
+
+    function seekWithPageApi(time) {
+        const match = typeof window.koalaFindPageApiSeekProvider === 'function'
+            ? window.koalaFindPageApiSeekProvider(window.location.hostname)
+            : null;
+        if (!match) return;
 
-    function getNetflixPlayer() {
         try {
-            const videoPlayer = window.netflix?.appContext?.state?.playerApp?.getAPI?.().videoPlayer;
-            const sessionId = videoPlayer?.getAllPlayerSessionIds?.()[0];
-            return sessionId ? videoPlayer.getVideoPlayerBySessionId(sessionId) : null;
+            if (match.provider === 'netflix') {
+                const videoPlayer = window.netflix?.appContext?.state?.playerApp?.getAPI?.().videoPlayer;
+                const sessionId = videoPlayer?.getAllPlayerSessionIds?.()[0];
+                const player = sessionId ? videoPlayer.getVideoPlayerBySessionId(sessionId) : null;
+                player?.seek(Math.round(time * 1000));
+            }
         } catch (_e) {
-            return null;
+            // Player not ready or private API changed; the next sync tick can retry.
         }
     }
 
     window.addEventListener('message', (event) => {
         if (event.source !== window) return;
         const data = event.data;
-        if (!data || data.__koalaNetflixSeek !== 1 || data.kind !== 'seek' || typeof data.time !== 'number') return;
-        try {
-            getNetflixPlayer()?.seek(Math.round(data.time * 1000));
-        } catch (_e) {
-            // Netflix player not ready or private API changed; the next sync tick can retry.
-        }
+        if (!data || data.__koalaPageApiSeek !== 1 || data.kind !== 'seek' || typeof data.time !== 'number') return;
+        seekWithPageApi(data.time);
     });
 }
 
+function setPageApiSeekEnabled(enabled) {
+    window.KOALA_PAGE_API_SEEK_ENABLED = enabled === true;
+}
+
 async function injectContentScript(tabId) {
-    let isNetflix = false;
+    let needsPageApiSeek = false;
+    let pageApiSeekReady = false;
     try {
         const tab = await chrome.tabs.get(tabId);
-        isNetflix = isNetflixUrl(tab?.url || '');
+        needsPageApiSeek = shouldUsePageApiSeek(tab?.url || '');
     } catch (_e) {
         // Fall through to the generic content script injection.
     }
 
-    if (isNetflix) {
+    if (needsPageApiSeek) {
         try {
             await chrome.scripting.executeScript({
                 target: { tabId },
                 world: 'MAIN',
-                func: installNetflixSeekBridge
+                files: ['page-api-seek-overrides.js']
             });
+            await chrome.scripting.executeScript({
+                target: { tabId },
+                world: 'MAIN',
+                func: installPageApiSeekBridge
+            });
+            pageApiSeekReady = true;
         } catch (err) {
-            addLog(`Netflix seek bridge injection failed: ${err.message}`, 'warn');
+            addLog(`Page API seek bridge injection failed: ${err.message}`, 'warn');
         }
     }
 
+    await chrome.scripting.executeScript({
+        target: { tabId },
+        files: ['page-api-seek-overrides.js']
+    });
+    await chrome.scripting.executeScript({
+        target: { tabId },
+        func: setPageApiSeekEnabled,
+        args: [pageApiSeekReady]
+    });
     return chrome.scripting.executeScript({
         target: { tabId },
         files: ['content.js']
@@ -2113,6 +2139,10 @@ async function handleAsyncMessage(message, sender, sendResponse) {
             }
         });
     } else if (message.type === 'DEV_SIMULATE_REMOTE_SEEK') {
+        if (!(await devRemoteToolsAllowed())) {
+            sendResponse({ status: 'forbidden' });
+            return;
+        }
         const delta = Number(message.delta);
         if (!Number.isFinite(delta)) {
             sendResponse({ status: 'invalid_delta' });
diff --git a/extension/content.js b/extension/content.js
index 01a491e..ef59983 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -57,17 +57,18 @@
     let seekDebounceTimer = null;     // debounce timer for rapid seek events
     let expectedSeekTime = null;      // strictly track programmatic seeks
 
-    const NETFLIX_SEEK_BRIDGE = 1;
+    const PAGE_API_SEEK_BRIDGE = 1;
 
-    function isNetflixHost() {
-        const host = window.location.hostname.toLowerCase();
-        return host === 'netflix.com' || host.endsWith('.netflix.com');
+    function shouldUsePageApiSeek() {
+        return window.KOALA_PAGE_API_SEEK_ENABLED === true &&
+            typeof window.koalaFindPageApiSeekProvider === 'function' &&
+            !!window.koalaFindPageApiSeekProvider(window.location.hostname);
     }
 
     function seekVideo(video, targetTime) {
         expectedSeekTime = targetTime;
-        if (isNetflixHost()) {
-            window.postMessage({ __koalaNetflixSeek: NETFLIX_SEEK_BRIDGE, kind: 'seek', time: targetTime }, '*');
+        if (shouldUsePageApiSeek()) {
+            window.postMessage({ __koalaPageApiSeek: PAGE_API_SEEK_BRIDGE, kind: 'seek', time: targetTime }, '*');
             return;
         }
         video.currentTime = targetTime;
diff --git a/extension/page-api-seek-overrides.js b/extension/page-api-seek-overrides.js
new file mode 100644
index 0000000..58532ed
--- /dev/null
+++ b/extension/page-api-seek-overrides.js
@@ -0,0 +1,23 @@
+(function(root) {
+    const PAGE_API_SEEK_PROVIDERS = [
+        { domain: 'netflix.com', provider: 'netflix' } // Avoids M7375 when seeking via video.currentTime.
+    ];
+
+    function normalizeHost(input) {
+        try {
+            return new URL(input).hostname.toLowerCase();
+        } catch (_e) {
+            return String(input || '').toLowerCase();
+        }
+    }
+
+    function matchesDomain(host, domain) {
+        return host === domain || host.endsWith(`.${domain}`);
+    }
+
+    root.KOALA_PAGE_API_SEEK_PROVIDERS = PAGE_API_SEEK_PROVIDERS;
+    root.koalaFindPageApiSeekProvider = (input) => {
+        const host = normalizeHost(input);
+        return PAGE_API_SEEK_PROVIDERS.find(entry => matchesDomain(host, entry.domain)) || null;
+    };
+})(globalThis);

From 0af22998c8890e6d36028255d752f6a14e108d27 Mon Sep 17 00:00:00 2001
From: KoalaDev <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 10:02:31 +0200
Subject: [PATCH 04/22] Handle target tab navigation reinjection

---
 extension/background.js          | 1 +
 extension/modules/tab-manager.js | 6 ++----
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/extension/background.js b/extension/background.js
index b346e71..0c22ffa 100644
--- a/extension/background.js
+++ b/extension/background.js
@@ -2565,6 +2565,7 @@ initTabManager({
     getSettings,
     emit,
     applyAudioSettingsToTab,
+    injectContentScript,
     ensureState,
     EVENTS
 });
diff --git a/extension/modules/tab-manager.js b/extension/modules/tab-manager.js
index 063a7be..8fcbc22 100644
--- a/extension/modules/tab-manager.js
+++ b/extension/modules/tab-manager.js
@@ -12,6 +12,7 @@ export function initTabManager({
     getSettings,
     emit,
     applyAudioSettingsToTab,
+    injectContentScript,
     ensureState,
     EVENTS
 }) {
@@ -83,10 +84,7 @@ export function initTabManager({
         await ensureState();
         const curTabId = getCurrentTabId();
         if (curTabId && tabId === parseInt(curTabId) && changeInfo.status === 'complete') {
-            chrome.scripting.executeScript({
-                target: { tabId },
-                files: ['content.js']
-            })
+            injectContentScript(tabId)
                 .then(() => applyAudioSettingsToTab(tabId))
                 .catch(() => {});
         }

From 01762b0c2fff1f2702930cc548871751417cdfc8 Mon Sep 17 00:00:00 2001
From: KoalaDev <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 10:20:25 +0200
Subject: [PATCH 05/22] Normalize shared tab titles

---
 docs/ROADMAP.md                | 17 ++++++++++++++++-
 extension/popup.js             |  4 ++--
 extension/title-privacy.js     |  8 +++++++-
 scripts/test-title-privacy.mjs |  6 ++++++
 4 files changed, 31 insertions(+), 4 deletions(-)

diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md
index d667bcf..d55cba6 100644
--- a/docs/ROADMAP.md
+++ b/docs/ROADMAP.md
@@ -60,6 +60,22 @@
   - **Legal/moderation:** Unclear what moderation requirements would apply if users can exchange chat messages. Could be relevant depending on jurisdiction.
 - **Status:** Under evaluation, may come later.
 
+### Cross-frame video detection and control
+
+- **Priority:** P3
+- **Category:** Compatibility / Embedded Players
+- **Background:** KoalaSync currently injects on demand into the selected tab's top frame. This works for normal top-frame players, including current Emby/Jellyfin usage, but does not cover cases where the real `<video>` lives inside a cross-origin iframe or an `about:blank`/`srcdoc` player frame.
+- **Possible approach:** Add an opt-in frame bridge where child frames announce detected videos to the top frame, and the top frame routes remote play/pause/seek commands to the active child video.
+- **Status:** Future compatibility work, not needed for current Emby behavior.
+
+### Local extension E2E smoke tests
+
+- **Priority:** P2
+- **Category:** Testing / Release Confidence
+- **Background:** The release verification covers unit tests, server integration, syntax, lint, audits, and builds, but it does not currently run a real browser extension flow. A small local E2E smoke suite would catch regressions in content-script injection, tab navigation reinjection, remote seek handling, and iframe player support.
+- **Possible approach:** Add a separate local-only Playwright smoke command that loads the unpacked extension, opens two controlled video pages, and verifies play/pause/seek through the actual extension path. Keep it outside `npm run verify` until it is stable enough for CI.
+- **Status:** Backlog, recommended before larger content-script or frame-bridge changes.
+
 ---
 
 ## ❌ Rejected
@@ -70,4 +86,3 @@
 |---|---|
 | *(none yet)* | |
 
-
diff --git a/extension/popup.js b/extension/popup.js
index 7ea0322..294dcb6 100644
--- a/extension/popup.js
+++ b/extension/popup.js
@@ -2,7 +2,7 @@ import { EVENTS, OFFICIAL_LANDING_PAGE_URL, SUPPORT_URL, getReviewUrl } from './
 import { BLACKLIST_DOMAINS } from './shared/blacklist.js';
 import { getAvatarForName, generateUsername, USERNAME_ADJECTIVES, USERNAME_NOUNS } from './shared/names.js';
 import { loadLocale, translateDOM, getMessage, getSystemLanguage } from './i18n.js';
-import { TITLE_PRIVACY_MODES, normalizeSendTabTitle } from './title-privacy.js';
+import { TITLE_PRIVACY_MODES, normalizeSendTabTitle, normalizeTabTitle } from './title-privacy.js';
 
 
 const elements = {
@@ -920,7 +920,7 @@ async function populateTabs(providedPeers = null, providedTargetTabId = null) {
     // Smart Matching Logic — exclude own tabTitle to prevent self-match (computed once)
     const cleanTitle = (rawTitle) => {
         if (!rawTitle) return '';
-        return rawTitle
+        return (normalizeTabTitle(rawTitle) || '')
             .replace(/(?:\s*[-\|•]\s*(?:YouTube|Twitch|Jellyfin|Emby|Netflix|Vimeo|Dailymotion).*)$/i, '')
             .replace(/^(?:Netflix|Twitch|YouTube|Emby|Jellyfin)\s*[-\|•]\s*/i, '')
             .trim();
diff --git a/extension/title-privacy.js b/extension/title-privacy.js
index 54a4f99..8528524 100644
--- a/extension/title-privacy.js
+++ b/extension/title-privacy.js
@@ -17,9 +17,15 @@ export function normalizeSendTabTitle(sendTabTitle, legacyMode = TITLE_PRIVACY_M
     return normalizeTitlePrivacyMode(legacyMode) === TITLE_PRIVACY_MODES.FULL;
 }
 
+export function normalizeTabTitle(title) {
+    if (typeof title !== 'string') return null;
+    const normalized = title.replace(/^\s*(?:\(\d{1,2}\)|\[\d{1,2}\])\s+/, '').trim();
+    return normalized.length > 0 ? normalized : null;
+}
+
 export function sanitizeTabTitle(title, sendTabTitle) {
     if (!sendTabTitle) return null;
-    return typeof title === 'string' && title.length > 0 ? title : null;
+    return normalizeTabTitle(title);
 }
 
 export function sanitizeSharedTitle(title, mode) {
diff --git a/scripts/test-title-privacy.mjs b/scripts/test-title-privacy.mjs
index 77565bd..cba3f66 100644
--- a/scripts/test-title-privacy.mjs
+++ b/scripts/test-title-privacy.mjs
@@ -3,6 +3,7 @@ import {
     TITLE_PRIVACY_MODES,
     applyTitlePrivacyToPayload,
     normalizeSendTabTitle,
+    normalizeTabTitle,
     normalizeTitlePrivacyMode,
     sanitizeSharedTitle,
     sanitizeTabTitle
@@ -15,8 +16,13 @@ assert.equal(normalizeSendTabTitle(undefined, TITLE_PRIVACY_MODES.FULL), true);
 assert.equal(normalizeSendTabTitle(undefined, TITLE_PRIVACY_MODES.EPISODE), false);
 assert.equal(normalizeSendTabTitle(true, TITLE_PRIVACY_MODES.HIDDEN), true);
 assert.equal(normalizeSendTabTitle(false, TITLE_PRIVACY_MODES.FULL), false);
+assert.equal(normalizeTabTitle('(12) Testvideo - YouTube'), 'Testvideo - YouTube');
+assert.equal(normalizeTabTitle('[7] Testvideo - YouTube'), 'Testvideo - YouTube');
+assert.equal(normalizeTabTitle('(500) Days of Summer'), '(500) Days of Summer');
+assert.equal(normalizeTabTitle('   '), null);
 
 assert.equal(sanitizeTabTitle('Private Tab', true), 'Private Tab');
+assert.equal(sanitizeTabTitle('(12) Private Tab', true), 'Private Tab');
 assert.equal(sanitizeTabTitle('Private Tab', false), null);
 assert.equal(sanitizeTabTitle('', true), null);
 

From beda924b65377f29d2cea6a63c07695896644c7f Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 12:57:58 +0200
Subject: [PATCH 06/22] Fix DEV_SIMULATE_REMOTE_SEEK targetTime routing in
 background.js and add build identifier

---
 extension/background.js     | 14 ++++++++------
 extension/popup.html        |  4 ++++
 scripts/build-extension.cjs |  6 ++++++
 3 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/extension/background.js b/extension/background.js
index 0c22ffa..5f95b5d 100644
--- a/extension/background.js
+++ b/extension/background.js
@@ -1615,7 +1615,7 @@ async function getReadyTabVideoState(tabId) {
     return state;
 }
 
-async function simulateRemoteSeek(delta) {
+async function simulateRemoteSeek(delta, explicitTargetTime = null) {
     if (!currentTabId) return { status: 'no_tab' };
     const tabId = parseInt(currentTabId);
     if (isNaN(tabId)) return { status: 'no_tab' };
@@ -1624,7 +1624,7 @@ async function simulateRemoteSeek(delta) {
     if (!state || state.error) return { status: 'error', message: state?.error || 'No video state' };
     if (!state.found || !Number.isFinite(state.currentTime)) return { status: 'no_video' };
 
-    let targetTime = Math.max(0, state.currentTime + delta);
+    let targetTime = explicitTargetTime !== null ? explicitTargetTime : Math.max(0, state.currentTime + (delta || 0));
     if (Number.isFinite(state.duration) && state.duration > 0) {
         targetTime = Math.min(targetTime, Math.max(0, state.duration - 0.1));
     }
@@ -2143,12 +2143,14 @@ async function handleAsyncMessage(message, sender, sendResponse) {
             sendResponse({ status: 'forbidden' });
             return;
         }
-        const delta = Number(message.delta);
-        if (!Number.isFinite(delta)) {
-            sendResponse({ status: 'invalid_delta' });
+        const delta = message.delta !== null && message.delta !== undefined ? Number(message.delta) : null;
+        const targetTime = message.targetTime !== null && message.targetTime !== undefined ? Number(message.targetTime) : null;
+
+        if (delta === null && targetTime === null) {
+            sendResponse({ status: 'invalid_params' });
             return;
         }
-        simulateRemoteSeek(delta).then(sendResponse).catch(err => {
+        simulateRemoteSeek(delta, targetTime).then(sendResponse).catch(err => {
             addLog(`Remote seek simulation failed: ${err.message}`, 'warn');
             sendResponse({ status: 'error', message: err.message });
         });
diff --git a/extension/popup.html b/extension/popup.html
index 5df9ef9..df2188c 100644
--- a/extension/popup.html
+++ b/extension/popup.html
@@ -699,6 +699,10 @@
             <button id="remoteSeekBack" class="secondary" style="flex:1; font-size:12px;">-30s</button>
             <button id="remoteSeekForward" class="secondary" style="flex:1; font-size:12px;">+30s</button>
         </div>
+        <button id="remoteSeekFiveMin" class="secondary" style="width:100%; font-size:12px; margin-bottom:15px;">Seek 5:00</button>
+        <div style="font-size:10px; color:var(--text-muted); text-align:center; margin-top:10px; opacity:0.7;">
+            Build: <span id="buildIdentifier">__BUILD_TIMESTAMP__</span>
+        </div>
     </div>
 
     <script src="popup.js" type="module"></script>
diff --git a/scripts/build-extension.cjs b/scripts/build-extension.cjs
index d7b8c2c..ec3568d 100644
--- a/scripts/build-extension.cjs
+++ b/scripts/build-extension.cjs
@@ -140,6 +140,12 @@ function copyExtensionFiles(targetDir, browserName) {
 
         fs.writeFileSync(destPath, content);
         console.log(`✓ Injected uninstall URL constants for ${browserName} into background.js`);
+      } else if (item === 'popup.html') {
+        let content = fs.readFileSync(srcPath, 'utf8');
+        const timestamp = new Date().toISOString().replace('T', ' ').substring(0, 19) + ' UTC';
+        content = content.replace(/__BUILD_TIMESTAMP__/g, timestamp);
+        fs.writeFileSync(destPath, content);
+        console.log(`✓ Injected build timestamp into popup.html: ${timestamp}`);
       } else {
         fs.copyFileSync(srcPath, destPath);
       }

From 9cbeb661d6f53092d6c343b1fb9f0dbd893abbf2 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:00:41 +0200
Subject: [PATCH 07/22] Save baseline state with Disney+ seek adjustments and
 build identifier

---
 extension/content.js                  | 3351 +++++++++++++------------
 extension/page-api-seek-overrides.js  |   18 +-
 extension/popup.js                    |   46 +-
 scripts/test-content-video-finder.cjs |  108 +-
 website/assets/NewLogoIcon_64.webp    |  Bin 1282 -> 1282 bytes
 5 files changed, 1974 insertions(+), 1549 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index ef59983..70d7315 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -1,1538 +1,1813 @@
-/**
- * KoalaSync Content Script
- * Injected into video tabs to control playback and detect events.
- */
-
-(function() {
-    // Injection Guard: Check if already injected AND context is valid
-    try {
-        if (window.koalaSyncInjected && chrome.runtime.id) {
-            return;
-        }
-    } catch (_e) {
-        // Context invalidated, proceed with re-injection
-    }
-    window.koalaSyncInjected = true;
-
-    // --- SHARED_EVENTS_INJECT_START ---
-    // This block is automatically updated by /scripts/build-extension.js
-    const EVENTS = {
-        PLAY: "play",
-        PAUSE: "pause",
-        SEEK: "seek",
-        FORCE_SYNC_PREPARE: "force_sync_prepare",
-        FORCE_SYNC_ACK: "force_sync_ack",
-        FORCE_SYNC_EXECUTE: "force_sync_execute",
-        PEER_STATUS: "peer_status",
-        EPISODE_LOBBY: "episode_lobby",
-        EPISODE_READY: "episode_ready"
-    };
-    // --- SHARED_EVENTS_INJECT_END ---
-
-    // Suppresses native event reporting after a programmatic action.
-    // Each entry is a per-type timer (key = 'playing'|'paused'|'seek').
-    // While a timer exists, matching native events are consumed and not relayed.
-    // Timers self-clean after 300ms if the native event never fires.
-    let _suppressTimers = {};
-
-    function _setSuppress(state) {
-        if (_suppressTimers[state]) clearTimeout(_suppressTimers[state]);
-        _suppressTimers[state] = setTimeout(() => {
-            delete _suppressTimers[state];
-        }, 300);
-    }
-
-    function _clearSuppress(state) {
-        if (_suppressTimers[state]) {
-            clearTimeout(_suppressTimers[state]);
-            delete _suppressTimers[state];
-        }
-    }
-
-    // --- Seek Relay Filtering ---
-    // Minimum seek delta (seconds) to report. Prevents HLS/DASH buffering micro-seeks
-    // from being relayed to peers as user-initiated seeks.
-    const MIN_SEEK_DELTA = 2.0;
-    let lastReportedSeekTime = null;  // last currentTime we relayed as a SEEK
-    let seekDebounceTimer = null;     // debounce timer for rapid seek events
-    let expectedSeekTime = null;      // strictly track programmatic seeks
-
-    const PAGE_API_SEEK_BRIDGE = 1;
-
-    function shouldUsePageApiSeek() {
-        return window.KOALA_PAGE_API_SEEK_ENABLED === true &&
-            typeof window.koalaFindPageApiSeekProvider === 'function' &&
-            !!window.koalaFindPageApiSeekProvider(window.location.hostname);
-    }
-
-    function seekVideo(video, targetTime) {
-        expectedSeekTime = targetTime;
-        if (shouldUsePageApiSeek()) {
-            window.postMessage({ __koalaPageApiSeek: PAGE_API_SEEK_BRIDGE, kind: 'seek', time: targetTime }, '*');
-            return;
-        }
-        video.currentTime = targetTime;
-    }
-
-    // --- Play/Pause Coalescing (leading + trailing) ---
-    // Media players (HLS/DASH, ad insertion, ABR/quality switches, source swaps,
-    // page teardown) fire bursts of native play/pause events within a few hundred
-    // ms. Relaying each as a distinct command spams peers and the relay.
-    //
-    // Strategy: emit the FIRST event immediately (leading edge → a deliberate
-    // single play/pause has zero added latency), then hold a short window. If
-    // more play/pause events arrive during the window it's a burst — we suppress
-    // the intermediate churn and, once it settles, emit the FINAL state on the
-    // trailing edge.
-    //
-    // We deliberately do NOT dedup the trailing send against the leading one. A
-    // remote play/pause may be applied mid-window (e.g. I pause, peer plays, I
-    // pause again within 150ms): the settled state then equals my last *sent*
-    // state yet is a genuine change versus the now-shared state — suppressing it
-    // would desync. Re-sending an unchanged state is a harmless no-op on peers,
-    // so re-sending is always the safe choice. Echo-suppression and seek-flush
-    // still run synchronously on event arrival (see reportEvent) — only the
-    // network emit is governed here.
-    const PLAY_PAUSE_COALESCE_MS = 150;
-    let playPauseCoalesceTimer = null;  // non-null = a coalescing window is open
-    let pendingPlayPauseAction = null;  // last play/pause seen during the window, awaiting trailing flush
-
-    // --- Episode Auto-Sync State ---
-    let lastKnownMediaTitle = null;
-    let episodeTransitionDebounce = null;
-    let _pendingLobbyTitle = null; // Title we're waiting to match (from remote lobby)
-    let lobbyPollTimer = null;
-    let _autoSyncEnabled = true; // Cached setting, updated via storage.onChanged
-    let _audioSettings = null;
-    let _audioProcessingAllowed = true;
-
-    // Cache the autoSyncNextEpisode setting (local-only; never read from sync)
-    chrome.storage.local.get(['autoSyncNextEpisode', 'audioSettings'], (data) => {
-        _autoSyncEnabled = data.autoSyncNextEpisode !== false;
-        _audioSettings = mergeAudioSettings(data.audioSettings);
-        const video = findVideo();
-        if (video && _audioProcessingAllowed) applyAudioSettings(video, _audioSettings);
-    });
-    chrome.storage.onChanged.addListener((changes, area) => {
-        if (area === 'local' && changes.autoSyncNextEpisode) {
-            _autoSyncEnabled = changes.autoSyncNextEpisode.newValue !== false;
-        }
-    });
-
-    // --- Host Control Mode (guest-side) ---
-    // When a room is in 'host-only' mode and we're a guest, a deliberate local
-    // pause/seek must not drive the room (background/server already drop it). Here
-    // we handle the *local* UX: snap back to the host's position, or — if the user
-    // really wants to — let them go solo (desync) with a resync escape hatch.
-    let hcmControlMode = 'everyone';   // mirror of room control mode
-    let hcmAmController = false;        // are we allowed to drive (owner or co-host)?
-    let hcmHostPeerId = null;          // last known host peerId (room/host identity)
-    let hcmDesynced = false;           // user chose to go solo
-    let hcmSnapBackCooldownUntil = 0;  // suppress re-trigger right after a snap-back
-    let hcmDeferredSnapPending = false; // a buffer-aware snap-back is waiting for readiness
-    let hcmLastUserGestureAt = 0;      // for deliberate-vs-involuntary classification
-    let hcmBufferingUntil = 0;         // set on 'waiting' — buffering grace window
-    let hcmDialogTimer = null;         // 8s auto-stay timer — cleared on dialog replace (H-4)
-    // Localized strings for the in-page dialog/badge (content has no i18n loader;
-    // background resolves them via GET_HCM_STRINGS on init). English fallbacks here.
-    const hcmStrings = {
-        title:  'KoalaSync · Host controls this room',
-        body:   'Only the host can control playback in this room. Keep watching together, or watch on your own?',
-        stay:   'Stay in sync',
-        solo:   'Watch on my own',
-        badge:  'Watching on your own',
-        resync: 'Resync'
-    };
-    const HCM_USER_GESTURE_MS = 1000;
-    const HCM_BUFFERING_GRACE_MS = 1500;
-    const HCM_SNAP_BACK_COOLDOWN_MS = 1000;
-    const HCM_BUFFER_WAIT_MS = 8000;   // cap on waiting for a buffering player before snapping anyway
-
-    // Track genuine user input so we can tell a deliberate pause/seek from a
-    // player-/browser-initiated one. Capturing + passive so we never interfere.
-    const _hcmGesture = () => { hcmLastUserGestureAt = Date.now(); };
-    document.addEventListener('keydown', _hcmGesture, { capture: true, passive: true });
-    document.addEventListener('pointerdown', _hcmGesture, { capture: true, passive: true });
-
-    function hcmIsGuestGated() {
-        return hcmControlMode === 'host-only' && !hcmAmController;
-    }
-
-    // EC-9 intent classifier: only a *clearly deliberate* guest action triggers the
-    // dialog/snap-back. Anything that smells involuntary (buffering, seeking, tab
-    // refocus, no recent gesture) is treated as involuntary. Bias intentional —
-    // in host-only the guest never broadcasts anyway, so this only tunes UX.
-    function hcmClassifyIntent() {
-        const video = findVideo();
-        if (!video) return 'involuntary';
-        if (hcmIsLive(video)) return 'live';                   // EC-15: degrade, don't gate
-        if (video.readyState < 3) return 'involuntary';        // buffering / not enough data
-        if (video.seeking) return 'involuntary';
-        if (Date.now() < hcmBufferingUntil) return 'involuntary';
-        if (Date.now() < visibilityGraceUntil) return 'involuntary';
-        if (Date.now() - hcmLastUserGestureAt > HCM_USER_GESTURE_MS) return 'involuntary';
-        return 'deliberate';
-    }
-
-    // Live detection (EC-15 + DVR). Pure live reports duration Infinity/NaN. Live-DVR
-    // (Twitch/YouTube-live with rewind) reports a *finite, sliding* duration — its
-    // seekable window doesn't start at 0, which we use as the DVR signal.
-    function hcmIsLive(video) {
-        // Don't trust duration before metadata has loaded (readyState >= 1) —
-        // otherwise pre-loaded videos report NaN and get misclassified as live,
-        // which suppresses the desync dialog (L-2).
-        if (video.readyState < 1) return false;
-        if (!Number.isFinite(video.duration)) return true;
-        try {
-            const s = video.seekable;
-            if (s && s.length > 0 && s.start(0) > 1) return true; // sliding DVR window
-        } catch (_e) { /* seekable may throw if empty */ }
-        return false;
-    }
-
-    // Snap the local player back to the host's current position/state.
-    function hcmSnapBackToHost(target) {
-        if (hcmDesynced) return; // user opted out — never yank them back automatically
-        hcmSnapBackCooldownUntil = Date.now() + HCM_SNAP_BACK_COOLDOWN_MS;
-        const video = findVideo();
-        if (!video) return;
-        if (target && Number.isFinite(target.targetTime)) {
-            tryMediaAction(EVENTS.SEEK, { targetTime: target.targetTime });
-        }
-        // Adopt the host's play/pause state — but ONLY if we actually know it.
-        // Defaulting to PLAY when the state is unknown would auto-resume a paused
-        // video against the host's real state (H-1).
-        if (target && target.playbackState === 'paused') {
-            tryMediaAction(EVENTS.PAUSE);
-        } else if (target && target.playbackState === 'playing') {
-            tryMediaAction(EVENTS.PLAY);
-        }
-        reportLog('Host-only: snapped back to host position', 'info');
-    }
-
-    // Resync to the host's current position, retrying briefly if the host's state
-    // isn't known yet (e.g. they just paused and no heartbeat has propagated) —
-    // otherwise the request is a silent no-op and the user thinks they're synced
-    // when they aren't. Shared by the dialog's "Stay in sync" and the Resync badge.
-    function hcmRequestHostSyncWithRetry() {
-        let attempts = 0;
-        const tryOnce = () => {
-            chrome.runtime.sendMessage({ type: 'REQUEST_HOST_SYNC' }, (res) => {
-                if (chrome.runtime.lastError || !res || !res.target) {
-                    if (++attempts < 5) setTimeout(tryOnce, 250);
-                    else reportLog('Host-only: resync requested but host state unavailable', 'warn');
-                    return;
-                }
-                hcmSnapBackToHost(res.target);
-            });
-        };
-        tryOnce();
-    }
-
-    // Buffer-aware snap-back (#3). An involuntary pause/seek often coincides with the
-    // player buffering — and a player can't actually play while it's stalled. Snapping
-    // immediately just fights the buffer (seek → re-buffer → another pause → …), which
-    // looks like stutter. Instead: if the player isn't ready, wait until it can play
-    // (readyState>=3, not seeking), then snap ONCE to the host's *current* position
-    // (re-queried, since the captured target may be stale by the time buffering ends).
-    // Player-agnostic on purpose — we can't enumerate every site, so this must be safe
-    // regardless of whether a given player fires 'pause' or only 'waiting'.
-    function hcmDeferredSnapBack() {
-        if (hcmDeferredSnapPending) return; // already waiting — don't stack polls
-        hcmDeferredSnapPending = true;
-        const deadline = Date.now() + HCM_BUFFER_WAIT_MS;
-        const poll = () => {
-            // Abort if the reason to snap is gone: user went solo, we're no longer a
-            // gated guest, or the video vanished.
-            if (hcmDesynced || !hcmIsGuestGated()) { hcmDeferredSnapPending = false; return; }
-            const video = findVideo();
-            const ready = video && video.readyState >= 3 && !video.seeking;
-            if (ready || Date.now() >= deadline) {
-                hcmDeferredSnapPending = false;
-                hcmRequestHostSyncWithRetry(); // fresh host position + snap once
-                return;
-            }
-            setTimeout(poll, 300);
-        };
-        poll();
-    }
-
-    // Entry point: background told us our local action was blocked in host-only.
-    function hcmHandleBlocked(action, target) {
-        // HOST_BLOCKED is only ever sent to a gated guest (background verifies
-        // host-only + !host before sending), so it's authoritative. Adopt the
-        // role/mode from it in case our CONTROL_MODE broadcast hasn't landed yet
-        // (join race, EC-5) — otherwise we'd miss the dialog/snap-back.
-        hcmControlMode = 'host-only';
-        hcmAmController = false;
-        if (hcmDesynced) return; // already solo, nothing to do
-
-        const intent = hcmClassifyIntent();
-        if (intent === 'live') return;          // EC-15: leave the guest alone on live
-        if (intent === 'involuntary') {
-            // EC-4 loop guard: only the silent auto snap-back is suppressed by the
-            // cooldown — the deliberate dialog path below must still go through,
-            // otherwise a second deliberate pause inside the cooldown window leaves
-            // the user stuck paused with no UI (M-3).
-            if (Date.now() < hcmSnapBackCooldownUntil || hcmDeferredSnapPending) return;
-            // Buffering/ads/throttle — silently re-sync, no dialog spam.
-            const video = findVideo();
-            if (video && video.readyState >= 3 && !video.seeking) {
-                // Ready now → snap immediately. Use the captured target if it's
-                // usable, otherwise re-query+retry (host state may not be known yet)
-                // so we never leave the guest silently stuck (consistent with the
-                // deferred and "Stay in sync" paths).
-                if (target && Number.isFinite(target.targetTime)) hcmSnapBackToHost(target);
-                else hcmRequestHostSyncWithRetry();
-            } else {
-                hcmDeferredSnapBack();             // buffering → wait for ready, then snap once (#3)
-            }
-            return;
-        }
-        // Deliberate: offer the choice (Teleparty-style), default = snap back.
-        hcmShowDesyncDialog(action, target);
-    }
-
-    // --- In-page UI (dialog + persistent desync badge) ---
-    // Built with the DOM API (CSSOM .style is CSP-safe; inline style="" in innerHTML
-    // is stripped by strict style-src on Netflix/YouTube/Disney+). Hosted in a
-    // Shadow DOM so the page's CSS can't restyle or hide our controls.
-    let hcmDialogHost = null;  // shadow host element for the dialog
-    let hcmBadgeHost = null;   // shadow host element for the persistent badge
-    let hcmBadgePending = false;  // retry flag for early-injection badge creation (L-4)
-
-    function hcmEl(tag, css, text) {
-        const el = document.createElement(tag);
-        if (css) el.style.cssText = css;        // CSSOM assignment — not gated by CSP
-        if (text != null) el.textContent = text;
-        return el;
-    }
-
-    function hcmRemoveDialog() {
-        // Cancel any pending auto-stay timer so a replaced dialog's stale closure
-        // can't later remove its successor / snap to an outdated target (H-4).
-        if (hcmDialogTimer) { clearTimeout(hcmDialogTimer); hcmDialogTimer = null; }
-        if (hcmDialogHost) { hcmDialogHost.remove(); hcmDialogHost = null; }
-    }
-
-    function hcmShowDesyncDialog(action, target) {
-        if (!document.body) { hcmSnapBackToHost(target); return; }
-        hcmRemoveDialog();
-        const host = hcmEl('div', 'all:initial');
-        const root = host.attachShadow({ mode: 'open' });
-
-        const wrap = hcmEl('div', 'position:fixed;z-index:2147483647;left:50%;bottom:32px;transform:translateX(-50%);background:#1f2937;color:#f9fafb;font:14px/1.4 system-ui,sans-serif;padding:16px 18px;border-radius:12px;box-shadow:0 8px 30px rgba(0,0,0,.45);max-width:360px;border:1px solid #374151');
-        wrap.setAttribute('role', 'dialog');
-        const title = hcmEl('div', 'font-weight:600;margin-bottom:6px', hcmStrings.title);
-        const body = hcmEl('div', 'margin-bottom:12px;color:#d1d5db', hcmStrings.body);
-        const btnRow = hcmEl('div', 'display:flex;gap:8px;justify-content:flex-end');
-        const soloBtn = hcmEl('button', 'background:#374151;color:#f9fafb;border:0;padding:8px 12px;border-radius:8px;cursor:pointer', hcmStrings.solo);
-        const stayBtn = hcmEl('button', 'background:#10b981;color:#062a20;border:0;padding:8px 12px;border-radius:8px;cursor:pointer;font-weight:600', hcmStrings.stay);
-        btnRow.append(soloBtn, stayBtn);
-        wrap.append(title, body, btnRow);
-        root.appendChild(wrap);
-        document.body.appendChild(host);
-        hcmDialogHost = host;
-
-        let settled = false;
-        // Re-query the host's current position on click instead of using the
-        // potentially stale target captured at HOST_BLOCKED time (M-1).
-        const stay = () => {
-            if (settled) return; settled = true; hcmRemoveDialog();
-            hcmRequestHostSyncWithRetry();
-        };
-        const solo = () => { if (settled) return; settled = true; hcmRemoveDialog(); hcmEnterDesync(); };
-        stayBtn.addEventListener('click', stay);
-        soloBtn.addEventListener('click', solo);
-        // EC-18: if the user ignores the prompt, default to staying in sync.
-        hcmDialogTimer = setTimeout(() => { if (!settled) stay(); }, 8000);
-    }
-
-    function hcmEnterDesync() {
-        hcmDesynced = true;
-        reportLog('Host-only: you chose to watch on your own (desynced)', 'warn');
-        // Notify background so it can relay our desynced state to the host via
-        // heartbeats — the host's UI then knows we're not following commands
-        // instead of appearing silently un-ACK'd.
-        chrome.runtime.sendMessage({ type: 'HCM_DESYNC_STATE', desynced: true }).catch(() => {});
-        hcmShowBadge();
-    }
-
-    function hcmExitDesync() {
-        const wasDesynced = hcmDesynced;
-        hcmDesynced = false;
-        hcmRemoveBadge();
-        if (wasDesynced) {
-            chrome.runtime.sendMessage({ type: 'HCM_DESYNC_STATE', desynced: false }).catch(() => {});
-        }
-        // Resync to the host's current position (retries if host state not yet known).
-        hcmRequestHostSyncWithRetry();
-        reportLog('Host-only: resynced with the host', 'info');
-    }
-
-    function hcmShowBadge() {
-        if (hcmBadgeHost) return;
-        if (!document.body) {
-            // Body not ready yet (very early injection). Defer until DOMReady,
-            // otherwise the desynced user silently never sees the badge (L-4).
-            if (!hcmBadgePending) {
-                hcmBadgePending = true;
-                const retry = () => {
-                    hcmBadgePending = false;
-                    if (hcmDesynced && !hcmBadgeHost) hcmShowBadge();
-                };
-                if (document.readyState === 'loading') {
-                    document.addEventListener('DOMContentLoaded', retry, { once: true });
-                } else {
-                    setTimeout(retry, 50);
-                }
-            }
-            return;
-        }
-        const host = hcmEl('div', 'all:initial');
-        const root = host.attachShadow({ mode: 'open' });
-        const b = hcmEl('div', 'position:fixed;z-index:2147483646;right:16px;bottom:16px;background:#b45309;color:#fff;font:13px/1.3 system-ui,sans-serif;padding:8px 12px;border-radius:10px;box-shadow:0 6px 20px rgba(0,0,0,.4);cursor:pointer;display:flex;align-items:center;gap:8px');
-        b.append(hcmEl('span', null, '● ' + hcmStrings.badge), hcmEl('span', 'text-decoration:underline', hcmStrings.resync));
-        b.addEventListener('click', hcmExitDesync);
-        root.appendChild(b);
-        document.body.appendChild(host);
-        hcmBadgeHost = host;
-    }
-
-    function hcmRemoveBadge() {
-        if (hcmBadgeHost) { hcmBadgeHost.remove(); hcmBadgeHost = null; }
-    }
-
-    function hcmReset() {
-        const wasDesynced = hcmDesynced;
-        hcmDesynced = false;
-        hcmDeferredSnapPending = false;
-        hcmSnapBackCooldownUntil = 0; // don't let a stale cooldown swallow the next snap-back
-        hcmBufferingUntil = 0;
-        hcmRemoveDialog();
-        hcmRemoveBadge();
-        // If we were desynced, notify background so it stops reporting us as
-        // desynced in heartbeats (otherwise the host's UI keeps showing the
-        // stale Solo badge until the next state change).
-        if (wasDesynced) {
-            chrome.runtime.sendMessage({ type: 'HCM_DESYNC_STATE', desynced: false }).catch(() => {});
-        }
-    }
-
-    function reportLog(message, level = 'info') {
-        chrome.runtime.sendMessage({ type: 'LOG', message, level }).catch(() => {});
-    }
-
-    // --- Helper: find the best video element on the page ---
-    // Prefers larger, visible videos over tiny preview/trailer elements.
-    function findVideo(root = document) {
-        const candidates = Array.from(root.querySelectorAll('video'));
-
-        // Scan likely media hosts even when light-DOM videos exist; many players
-        // expose a tiny preview/ad video outside Shadow DOM and the real player inside.
-        const potentialHosts = root.querySelectorAll('[id*="player" i], [class*="player" i], [id*="video" i], [class*="video" i], [id*="media" i], [class*="media" i], [id*="stream" i], [class*="stream" i], ytd-player, netflix-player, emby-player, jellyfin-player, video-player');
-        for (const el of potentialHosts) {
-            if (el.shadowRoot) {
-                const found = findVideo(el.shadowRoot);
-                if (found) candidates.push(found);
-            }
-        }
-
-        if (candidates.length === 0) return null;
-
-        // Multiple videos found → pick the best one
-        if (candidates.length === 1) return candidates[0];
-
-        let best = null;
-        let bestScore = -1;
-        for (const v of candidates) {
-            if (v.tagName !== 'VIDEO') continue;
-            // Score: visible area + bonus for unmuted + bonus for longer duration
-            const area = (v.videoWidth || v.offsetWidth || 0) * (v.videoHeight || v.offsetHeight || 0);
-            const unmutedBonus = v.muted ? 0 : 100000;
-            const durationBonus = (v.duration && isFinite(v.duration) ? v.duration : 0) * 100;
-            const score = area + unmutedBonus + durationBonus;
-            if (score > bestScore) {
-                bestScore = score;
-                best = v;
-            }
-        }
-        return best;
-    }
-
-    // --- Audio Processing Module ---
-    const AUDIO_PRESETS = {
-        recommended: { threshold: -24, ratio: 8, attack: 0.010, release: 0.300, knee: 15 },
-        dynamicRange: { threshold: -18, ratio: 4, attack: 0.020, release: 0.200, knee: 10 },
-        vocalEnhancement: { threshold: -12, ratio: 3, attack: 0.015, release: 0.150, knee: 5 },
-        smooth: { threshold: -30, ratio: 1.5, attack: 0.030, release: 0.250, knee: 20 },
-        custom: { threshold: -24, ratio: 12, attack: 0.003, release: 0.250, knee: 30 }
-    };
-    const DEFAULT_AUDIO_SETTINGS = {
-        enabled: false,
-        compressor: {
-            enabled: false,
-            preset: 'recommended',
-            customParams: { ...AUDIO_PRESETS.custom }
-        }
-    };
-    let audioCtx = null;
-    let audioChains = new WeakMap();
-    let currentAudioVideo = null;
-
-    function mergeAudioSettings(settings = {}) {
-        const safeSettings = settings && typeof settings === 'object' ? settings : {};
-        return {
-            ...DEFAULT_AUDIO_SETTINGS,
-            ...safeSettings,
-            compressor: {
-                ...DEFAULT_AUDIO_SETTINGS.compressor,
-                ...(safeSettings.compressor || {}),
-                customParams: {
-                    ...DEFAULT_AUDIO_SETTINGS.compressor.customParams,
-                    ...(safeSettings.compressor?.customParams || {})
-                }
-            }
-        };
-    }
-
-    function initAudioContext() {
-        if (!audioCtx) {
-            try {
-                const AudioContextClass = window.AudioContext || window.webkitAudioContext;
-                if (!AudioContextClass) return null;
-                audioCtx = new AudioContextClass({ latencyHint: 'interactive' });
-            } catch (e) {
-                reportLog(`Audio Processing unavailable: ${e.message}`, 'warn');
-                return null;
-            }
-        }
-        if (audioCtx.state === 'suspended') {
-            audioCtx.resume().catch(() => { reportLog('AudioContext resume failed - browser may need page interaction first', 'warn'); });
-        }
-        return audioCtx;
-    }
-
-    function closeAudioContext() {
-        if (audioCtx) {
-            audioCtx.close().catch(() => {});
-            audioCtx = null;
-        }
-        audioChains = new WeakMap();
-        currentAudioVideo = null;
-    }
-
-    function setupAudioChain(videoEl) {
-        if (audioChains.has(videoEl)) return audioChains.get(videoEl);
-        const ctx = initAudioContext();
-        if (!ctx) return null;
-
-        try {
-            const src = ctx.createMediaElementSource(videoEl);
-            const compressor = ctx.createDynamicsCompressor();
-            const dryGain = ctx.createGain();
-            const compGain = ctx.createGain();
-
-            src.connect(dryGain);
-            dryGain.connect(ctx.destination);
-            src.connect(compressor);
-            compressor.connect(compGain);
-            compGain.connect(ctx.destination);
-
-            dryGain.gain.value = 1;
-            compGain.gain.value = 0;
-
-            const chain = { compressor, dryGain, compGain, active: false };
-            audioChains.set(videoEl, chain);
-            currentAudioVideo = videoEl;
-            return chain;
-        } catch (e) {
-            reportLog(`Audio Processing setup failed: ${e.message}`, 'warn');
-            return null;
-        }
-    }
-
-    function rampGain(node, value, t) {
-        const current = node.gain.value;
-        node.gain.cancelScheduledValues(t);
-        node.gain.setValueAtTime(current, t);
-        node.gain.linearRampToValueAtTime(value, t + 0.04);
-    }
-
-    function applyAudioBypass(videoEl) {
-        const chain = audioChains.get(videoEl);
-        if (!chain || !chain.active) return;
-        const t = chain.dryGain.context.currentTime;
-        rampGain(chain.dryGain, 1, t);
-        rampGain(chain.compGain, 0, t);
-        chain.active = false;
-        reportLog('Audio compressor disabled', 'info');
-    }
-
-    function bypassCurrentAudioProcessing() {
-        if (currentAudioVideo) applyAudioBypass(currentAudioVideo);
-    }
-
-    function applyAudioSettings(videoEl, settings) {
-        const mergedSettings = mergeAudioSettings(settings);
-        if (!mergedSettings.enabled || !mergedSettings.compressor?.enabled) {
-            applyAudioBypass(videoEl);
-            return;
-        }
-
-        const chain = setupAudioChain(videoEl);
-        if (!chain) return;
-
-        const cSettings = mergedSettings.compressor;
-        const params = cSettings.preset === 'custom'
-            ? cSettings.customParams
-            : AUDIO_PRESETS[cSettings.preset] || AUDIO_PRESETS.recommended;
-
-        chain.compressor.threshold.value = params.threshold ?? -24;
-        chain.compressor.knee.value = params.knee ?? 15;
-        chain.compressor.ratio.value = params.ratio ?? 8;
-        chain.compressor.attack.value = params.attack ?? 0.010;
-        chain.compressor.release.value = params.release ?? 0.300;
-
-        if (!chain.active) {
-            const t = chain.dryGain.context.currentTime;
-            rampGain(chain.dryGain, 0, t);
-            rampGain(chain.compGain, 1, t);
-            chain.active = true;
-            reportLog('Audio compressor enabled', 'info');
-        }
-    }
-
-    // --- Episode Auto-Sync: Detection ---
-    function getMediaTitle() {
-        return (navigator.mediaSession && navigator.mediaSession.metadata)
-            ? navigator.mediaSession.metadata.title
-            : null;
-    }
-
-    // Extract a canonical episode identifier from a title string.
-    // Handles: S01E01, S1E1, S01 - E01, Season 1 Episode 1, "Folge 5", "Episode 5", "Ep. 5", "#5"
-    // Returns null if no episode pattern found.
-    // --- SHARED_EPISODE_UTILS_INJECT_START ---
-    // This block is automatically replaced by /scripts/build-extension.js
-    function extractEpisodeId(title) {
-        if (!title || typeof title !== 'string') return null;
-        const se = title.match(/S(?:eason\s*)?(\d+)[^a-zA-Z0-9]*E(?:pisode\s*)?(\d+)/i);
-        if (se) return `S${String(se[1]).padStart(2, '0')}E${String(se[2]).padStart(2, '0')}`;
-        const ep = title.match(/(?:Episode|Folge|Ep\.?|#)\s*(\d+)/i);
-        if (ep) return `EP${String(ep[1]).padStart(3, '0')}`;
-        return null;
-    }
-
-    function sameEpisode(titleA, titleB) {
-        if (!titleA && !titleB) return true;
-        if (!titleA || !titleB) return false;
-        const idA = extractEpisodeId(titleA);
-        const idB = extractEpisodeId(titleB);
-        if (idA && idB) return idA === idB;
-        if (idA || idB) return false;
-        return titleA === titleB;
-    }
-    // --- SHARED_EPISODE_UTILS_INJECT_END ---
-
-    // Returns true only when we are CERTAIN the episodes differ.
-    // Permissive: only blocks if BOTH titles have parseable IDs AND they differ.
-    // Films, music, unparseable titles always pass through.
-    function isDifferentEpisode(titleA, titleB) {
-        if (!titleA || !titleB) return false; // Unknown → allow
-        const idA = extractEpisodeId(titleA);
-        const idB = extractEpisodeId(titleB);
-        if (!idA || !idB) return false; // At least one unparseable → allow
-        return idA !== idB;             // Both parseable → only block if different
-    }
-
-    function checkEpisodeTransition() {
-        const currentTitle = getMediaTitle();
-        const video = findVideo();
-
-        // Only trigger if: we had a previous title, the title changed,
-        // a video exists, and we're near the start of new content.
-        if (lastKnownMediaTitle && currentTitle
-            && !sameEpisode(currentTitle, lastKnownMediaTitle)
-            && video
-            && video.currentTime < 5
-            && video.readyState >= 1) {
-            onEpisodeTransition(currentTitle);
-        }
-
-        // Always track the latest known title
-        if (currentTitle) lastKnownMediaTitle = currentTitle;
-    }
-
-    function onEpisodeTransition(newTitle) {
-        // Debounce: prevent duplicate fires from multiple signals
-        if (episodeTransitionDebounce) return;
-        episodeTransitionDebounce = setTimeout(() => {
-            episodeTransitionDebounce = null;
-        }, 2000);
-
-        reportLog(`Episode transition detected: "${newTitle}"`, 'info');
-
-        // EC-12: a new episode dissolves any solo/desync state — the guest rejoins
-        // the room for the fresh content rather than staying stuck on the old one.
-        if (hcmDesynced) hcmReset();
-
-        // Do NOT pause here. We notify background.js first.
-        // Background checks the setting; if enabled it creates a lobby
-        // and sends back PAUSE_FOR_LOBBY so we only freeze if the feature is on.
-        chrome.runtime.sendMessage({
-            type: 'EPISODE_CHANGED',
-            payload: { newTitle }
-        }).catch(() => {});
-    }
-
-    function checkAndReportLobbyReady(expectedTitle) {
-        const video = findVideo();
-        const currentTitle = getMediaTitle();
-
-        if (video && currentTitle && sameEpisode(currentTitle, expectedTitle)
-            && video.currentTime < 5 && video.readyState >= 1) {
-            // Match! Pause at start and report ready.
-            if (!video.paused) {
-                _setSuppress('paused');
-                video.pause();
-            }
-            stopLobbyPoll();
-            chrome.runtime.sendMessage({
-                type: 'EPISODE_READY_LOCAL',
-                payload: { title: currentTitle }
-            }).catch(() => {});
-            reportLog(`Episode lobby: Ready for "${currentTitle}"`, 'success');
-            return true;
-        }
-        return false;
-    }
-
-    function startLobbyPoll(expectedTitle) {
-        stopLobbyPoll();
-        _pendingLobbyTitle = expectedTitle;
-
-        // NOTE: Do NOT pause here. Three callers reach this function:
-        // 1. PAUSE_FOR_LOBBY (initiator): already paused by that handler before calling us.
-        // 2. EPISODE_LOBBY (non-initiator): peer may still be on the PREVIOUS episode — pausing
-        //    would freeze them mid-episode. The pause happens inside checkAndReportLobbyReady()
-        //    only once their title actually matches.
-        // 3. CONTENT_BOOT recovery: same reasoning as (2).
-
-        // Check immediately
-        if (checkAndReportLobbyReady(expectedTitle)) return;
-
-        // Poll every 2 seconds — no log spam, internal only
-        lobbyPollTimer = setInterval(() => {
-            checkAndReportLobbyReady(expectedTitle);
-        }, 2000);
-    }
-
-
-    function stopLobbyPoll() {
-        _pendingLobbyTitle = null;
-        if (lobbyPollTimer) {
-            clearInterval(lobbyPollTimer);
-            lobbyPollTimer = null;
-        }
-    }
-
-    // --- Helper: YouTube/Twitch specific actions ---
-    function tryMediaAction(action, data) {
-        const video = findVideo();
-        if (!video) return;
-
-        if (action === EVENTS.SEEK) {
-            const target = data ? (data.targetTime !== undefined ? data.targetTime : data.currentTime) : undefined;
-            if (!Number.isFinite(target)) {
-                reportLog(`Media Action Error: Invalid seek payload - ${JSON.stringify(data)}`, 'error');
-                return;
-            }
-            data = { ...data, targetTime: target };
-        }
-
-        try {
-            const host = window.location.hostname.toLowerCase();
-            const isYouTube = host === 'youtube.com' || host.endsWith('.youtube.com');
-            const isTwitch  = host === 'twitch.tv' || host.endsWith('.twitch.tv');
-
-            if (isYouTube) {
-                const ytButton = document.querySelector('.ytp-play-button');
-                if (ytButton) {
-                    const isCurrentlyPlaying = !video.paused;
-                    if ((action === EVENTS.PLAY && !isCurrentlyPlaying) || (action === EVENTS.PAUSE && isCurrentlyPlaying)) {
-                        _setSuppress(action === EVENTS.PLAY ? 'playing' : 'paused');
-                        ytButton.click();
-                    }
-                    if (action === EVENTS.SEEK) {
-                        seekVideo(video, data.targetTime);
-                    }
-                    return;
-                }
-            }
-
-            if (isTwitch) {
-                const twitchButton = document.querySelector('[data-a-target="player-play-pause-button"]');
-                if (twitchButton) {
-                    const isCurrentlyPlaying = !video.paused;
-                    if ((action === EVENTS.PLAY && !isCurrentlyPlaying) || (action === EVENTS.PAUSE && isCurrentlyPlaying)) {
-                        _setSuppress(action === EVENTS.PLAY ? 'playing' : 'paused');
-                        twitchButton.click();
-                    }
-                    if (action === EVENTS.SEEK) {
-                        seekVideo(video, data.targetTime);
-                    }
-                    return;
-                }
-            }
-
-            // Fallback for native HTML5
-            if (action === EVENTS.PLAY) {
-                _setSuppress('playing');
-                video.play().catch((e) => {
-                    reportLog(`Playback prevented: ${e.message}`, 'warn');
-                    _clearSuppress('playing');
-                });
-            } else if (action === EVENTS.PAUSE) {
-                _setSuppress('paused');
-                video.pause();
-            } else if (action === EVENTS.SEEK) {
-                seekVideo(video, data.targetTime);
-            }
-    } catch (e) {
-            reportLog(`Media Action Error: ${e.message}`, 'error');
-        }
-    }
-
-    // --- Helper: Wait until video is ready for playback (buffered & seeked) ---
-    function pollSeekReady(targetTime, timeoutMs = 8000) {
-        return new Promise((resolve) => {
-            const interval = 150;
-            let elapsed = 0;
-            const timer = setInterval(() => {
-                const video = findVideo(); // Re-query DOM on every iteration
-                if (!video) {
-                    clearInterval(timer);
-                    resolve(false);
-                    return;
-                }
-
-                elapsed += interval;
-                const timeDiff = Math.abs(video.currentTime - targetTime);
-                const ready = video.readyState >= 3 && timeDiff < 2.0;
-                if (ready) {
-                    clearInterval(timer);
-                    resolve(true);
-                } else if (elapsed >= timeoutMs) {
-                    clearInterval(timer);
-                    resolve(false);
-                }
-            }, interval);
-        });
-    }
-
-    // Listen for commands from background.js
-    chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
-        if (!message) return;
-        if (message.action === 'get_current_time') {
-            const video = findVideo();
-            sendResponse({ currentTime: video ? video.currentTime : null });
-            return true;
-        }
-
-        if (message.action === 'APPLY_AUDIO_SETTINGS') {
-            _audioProcessingAllowed = true;
-            _audioSettings = mergeAudioSettings(message.settings);
-            const video = findVideo();
-            if (video) applyAudioSettings(video, _audioSettings);
-            sendResponse({ ok: true });
-            return true;
-        }
-
-        if (message.action === 'RESET_AUDIO_PROCESSING') {
-            _audioProcessingAllowed = false;
-            bypassCurrentAudioProcessing();
-            sendResponse({ ok: true });
-            return true;
-        }
-
-        // Host Control Mode: room mode/role changed.
-        if (message.type === 'CONTROL_MODE') {
-            const wasGated = hcmIsGuestGated();
-            const prevHostPeerId = hcmHostPeerId;
-            hcmControlMode = message.controlMode || 'everyone';
-            hcmAmController = !!message.amController;
-            hcmHostPeerId = message.hostPeerId || null;
-            // Reset guest-side state when leaving the gated state, OR when the
-            // host identity changes (room switch, host-leave fallback, missed
-            // teardown broadcast) — clears stale desync so a rejoin starts clean (H-3).
-            const hostChanged = prevHostPeerId !== null && hcmHostPeerId !== prevHostPeerId;
-            if ((wasGated && !hcmIsGuestGated()) || hostChanged) hcmReset();
-            sendResponse({ ok: true });
-            return true;
-        }
-
-        // Host Control Mode: background blocked our local action — handle UX locally.
-        if (message.type === 'HOST_BLOCKED') {
-            hcmHandleBlocked(message.action, message.target || null);
-            sendResponse({ ok: true });
-            return true;
-        }
-
-        // Background asks for an immediate state push (e.g. the first peer just
-        // joined while we were solo) so the newcomer syncs without waiting.
-        if (message.type === 'REQUEST_HEARTBEAT') {
-            sendHeartbeat();
-            sendResponse({ ok: true });
-            return true;
-        }
-
-        if (message.type === 'SERVER_COMMAND') {
-            const { action, payload } = message;
-            let actionCompleted = false;
-
-            // Host Control Mode: while watching on our own (desynced), don't apply
-            // host commands. Only ACK FORCE_SYNC_PREPARE — that's the one the host's
-            // force-sync flow actually waits on. Skipping CMD_ACKs for PLAY/PAUSE/SEEK
-            // is intentional so the host's UI honestly reflects that we didn't apply
-            // the command (M-2); sending them would make the host think we're synced.
-            if (hcmDesynced) {
-                const soloIgnored = [EVENTS.PLAY, EVENTS.PAUSE, EVENTS.SEEK, EVENTS.FORCE_SYNC_PREPARE, EVENTS.FORCE_SYNC_EXECUTE];
-                if (soloIgnored.includes(action)) {
-                    if (action === EVENTS.FORCE_SYNC_PREPARE) {
-                        chrome.runtime.sendMessage({ type: 'FORCE_SYNC_ACK' }).catch(() => {});
-                    }
-                    return;
-                }
-            }
-
-            // Guard: Don't execute sync commands if peers are on different episodes.
-            // Only active when autoSyncNextEpisode setting is enabled (default: on).
-            // Only blocks when BOTH sides have parseable S01E01-style IDs that differ.
-            // Films and unparseable titles always pass through.
-            const syncActions = [EVENTS.PLAY, EVENTS.PAUSE, EVENTS.SEEK,
-                                 EVENTS.FORCE_SYNC_PREPARE, EVENTS.FORCE_SYNC_EXECUTE];
-            if (_autoSyncEnabled && syncActions.includes(action)) {
-                const senderTitle = payload?.mediaTitle;
-                const myTitle = getMediaTitle();
-                if (isDifferentEpisode(senderTitle, myTitle)) {
-                    reportLog(`Episode mismatch: sender="${senderTitle || '?'}" vs mine="${myTitle || '?'}" — skipping ${action}. Disable "Auto-Sync next Episode" in settings if this causes issues.`, 'warn');
-                    if (action !== EVENTS.FORCE_SYNC_PREPARE && action !== EVENTS.FORCE_SYNC_EXECUTE) {
-                        chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId }).catch(() => {});
-                    }
-                    return;
-                }
-            }
-            
-            if (action === EVENTS.PLAY) {
-                tryMediaAction(EVENTS.PLAY);
-                chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId });
-                actionCompleted = true;
-            } else if (action === EVENTS.PAUSE) {
-                tryMediaAction(EVENTS.PAUSE);
-                chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId });
-                actionCompleted = true;
-            } else if (action === EVENTS.SEEK) {
-                tryMediaAction(EVENTS.SEEK, payload);
-                chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId });
-                actionCompleted = true;
-            } else if (action === EVENTS.FORCE_SYNC_PREPARE) {
-                if (!payload || payload.targetTime === undefined) return;
-                const video = findVideo();
-                if (video) {
-                    if (!Number.isFinite(payload.targetTime)) {
-                        reportLog(`Media Action Error: Invalid force sync payload - ${JSON.stringify(payload)}`, 'error');
-                        return;
-                    }
-                    _setSuppress('paused');
-                    video.pause();
-                    try {
-                        seekVideo(video, payload.targetTime);
-                    } catch (e) {
-                        reportLog(`Force Sync Seek Error: ${e.message}`, 'error');
-                    }
-                    pollSeekReady(payload.targetTime).then((ready) => {
-                        chrome.runtime.sendMessage({ type: 'FORCE_SYNC_ACK' }).catch(() => {});
-                        if (ready) {
-                            scheduleProactiveHeartbeat();
-                        } else {
-                            reportLog('Force Sync: Seek ready timeout, proceeding anyway', 'warn');
-                        }
-                    }).catch(() => {});
-                }
-            } else if (action === EVENTS.FORCE_SYNC_EXECUTE) {
-                stopLobbyPoll();
-                tryMediaAction(EVENTS.PLAY);
-                chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId });
-                actionCompleted = true;
-            }
-
-            if (actionCompleted) {
-                scheduleProactiveHeartbeat();
-            }
-        }
-
-        // Episode Auto-Sync: Lobby notification from background
-        if (message.type === 'EPISODE_LOBBY') {
-            // Host Control Mode: a desynced guest is watching on their own and must
-            // not join the lobby flow. Otherwise they'd pause on title match, report
-            // ready, but then ignore the host's FORCE_SYNC_* (hcmDesynced skip in
-            // SERVER_COMMAND) and end up frozen in pause. They also can't be counted
-            // toward lobby completion (background filters them out).
-            if (hcmDesynced) {
-                sendResponse({ status: 'ignored_desynced' });
-                return true;
-            }
-            const expectedTitle = message.expectedTitle;
-            if (expectedTitle) {
-                reportLog(`Episode lobby received: waiting for "${expectedTitle}"`, 'info');
-                startLobbyPoll(expectedTitle);
-            }
-            sendResponse({ status: 'ok' });
-            return true;
-        }
-
-        // Episode Auto-Sync: Lobby cancelled by background
-        if (message.type === 'EPISODE_LOBBY_CANCEL') {
-            stopLobbyPoll();
-            sendResponse({ status: 'ok' });
-            return true;
-        }
-
-        // Episode Auto-Sync: Background confirmed lobby created, pause the video
-        if (message.type === 'PAUSE_FOR_LOBBY') {
-            const video = findVideo();
-            if (video && !video.paused) {
-                _setSuppress('paused');
-                video.pause();
-            }
-            // Start lobby poll now that we know the feature is enabled
-            if (message.expectedTitle) {
-                startLobbyPoll(message.expectedTitle);
-            }
-            sendResponse({ status: 'ok' });
-            return true;
-        }
-
-        if (message.type === 'GET_VIDEO_STATE') {
-            const video = findVideo();
-
-            const platform = (() => {
-                const h = window.location.hostname.toLowerCase();
-                if (h === 'youtube.com' || h.endsWith('.youtube.com')) return 'YouTube';
-                if (h === 'twitch.tv' || h.endsWith('.twitch.tv')) return 'Twitch';
-                if (h === 'netflix.com' || h.endsWith('.netflix.com')) return 'Netflix';
-                if (h === 'primevideo.com' || h.endsWith('.primevideo.com') || /(^|\.)amazon\.(com\.[a-z]{2}|co\.[a-z]{2}|[a-z]{2,})$/.test(h)) return 'Prime Video';
-                if (h === 'disneyplus.com' || h.endsWith('.disneyplus.com')) return 'Disney+';
-                if (h === 'hulu.com' || h.endsWith('.hulu.com')) return 'Hulu';
-                if (h === 'hbomax.com' || h.endsWith('.hbomax.com') || h === 'max.com' || h.endsWith('.max.com')) return 'Max/HBO';
-                if (h === 'vimeo.com' || h.endsWith('.vimeo.com')) return 'Vimeo';
-                if (h === 'dailymotion.com' || h.endsWith('.dailymotion.com')) return 'Dailymotion';
-                return 'Generic';
-            })();
-
-            const networkStates = ['NETWORK_EMPTY', 'NETWORK_IDLE', 'NETWORK_LOADING', 'NETWORK_NO_SOURCE'];
-            const readyStates = ['HAVE_NOTHING', 'HAVE_METADATA', 'HAVE_CURRENT_DATA', 'HAVE_FUTURE_DATA', 'HAVE_ENOUGH_DATA'];
-
-            const videoCount = document.querySelectorAll('video').length;
-            const inShadowDom = (() => {
-                let el = video;
-                while (el) {
-                    if (el.toString() === '[object ShadowRoot]') return true;
-                    el = el.parentNode;
-                }
-                // Also check if any potential host has shadow root (even if no video found)
-                if (!video) {
-                    const hosts = document.querySelectorAll('[id*="player" i], [class*="player" i], [id*="video" i], [class*="video" i]');
-                    for (const host of hosts) {
-                        if (host.shadowRoot) return true;
-                    }
-                }
-                return false;
-            })();
-
-            // Build multi-video summary for debug reports
-            const allVideos = [];
-            const allVideoEls = document.querySelectorAll('video');
-            for (let i = 0; i < allVideoEls.length; i++) {
-                const v = allVideoEls[i];
-                allVideos.push({
-                    index: i,
-                    width: v.videoWidth || v.offsetWidth || 0,
-                    height: v.videoHeight || v.offsetHeight || 0,
-                    muted: v.muted,
-                    paused: v.paused,
-                    duration: (v.duration && isFinite(v.duration)) ? Math.round(v.duration) : 0,
-                    readyState: v.readyState,
-                    src: (v.currentSrc || v.src || '').substring(0, 80),
-                    selected: v === video
-                });
-            }
-
-            if (video) {
-                const dataAttributes = {};
-                if (video.attributes) {
-                    for (const attr of video.attributes) {
-                        if (attr.name.startsWith('data-')) {
-                            dataAttributes[attr.name] = attr.value;
-                        }
-                    }
-                }
-
-                const metadata = (navigator.mediaSession && navigator.mediaSession.metadata) ? {
-                    title: navigator.mediaSession.metadata.title,
-                    artist: navigator.mediaSession.metadata.artist,
-                    album: navigator.mediaSession.metadata.album,
-                    artwork: Array.from(navigator.mediaSession.metadata.artwork || []).map(a => a.src)
-                } : null;
-
-                const errorInfo = video.error ? {
-                    code: video.error.code,
-                    message: video.error.message
-                } : null;
-
-                sendResponse({
-                    found: true,
-                    paused: video.paused,
-                    currentTime: video.currentTime,
-                    duration: video.duration || 0,
-                    readyState: video.readyState,
-                    readyStateLabel: readyStates[video.readyState] || 'UNKNOWN',
-                    networkState: video.networkState,
-                    networkStateLabel: networkStates[video.networkState] || 'UNKNOWN',
-                    muted: video.muted,
-                    volume: video.volume,
-                    playbackRate: video.playbackRate,
-                    videoWidth: video.videoWidth,
-                    videoHeight: video.videoHeight,
-                    seeking: video.seeking,
-                    ended: video.ended,
-                    error: errorInfo,
-                    buffered: video.buffered && video.buffered.length > 0
-                        ? Array.from({ length: video.buffered.length }, (_, i) =>
-                            `${video.buffered.start(i).toFixed(1)}-${video.buffered.end(i).toFixed(1)}s`).join(', ')
-                        : 'none',
-                    loop: video.loop,
-                    url: window.location.href,
-                    pageTitle: document.title,
-                    id: video.id || 'none',
-                    className: video.className || 'none',
-                    src: video.src || 'none',
-                    currentSrc: video.currentSrc || 'none',
-                    dataAttributes,
-                    metadata,
-                    videoCount,
-                    inShadowDom,
-                    platform,
-                    allVideos
-                });
-            } else {
-                sendResponse({
-                    found: false,
-                    videoCount,
-                    inShadowDom,
-                    platform,
-                    allVideos,
-                    url: window.location.href,
-                    pageTitle: document.title,
-                    metadata: (navigator.mediaSession && navigator.mediaSession.metadata) ? {
-                        title: navigator.mediaSession.metadata.title,
-                        artist: navigator.mediaSession.metadata.artist,
-                        album: navigator.mediaSession.metadata.album
-                    } : null
-                });
-            }
-        }
-    });
-
-    // Detect native events
-    // Build the relay payload from the *current* media state and send it to
-    // background.js. Re-reads the video each call so deferred (coalesced) emits
-    // carry an up-to-date position. Safe with no/invalid video — it no-ops.
-    function sendContentEvent(action) {
-        const video = findVideo();
-        if (!video) return;
-
-        const current = video.currentTime;
-        if (!Number.isFinite(current)) return;
-
-        const mediaTitle = (navigator.mediaSession && navigator.mediaSession.metadata) ? navigator.mediaSession.metadata.title : null;
-
-        chrome.runtime.sendMessage({
-            type: 'CONTENT_EVENT',
-            action,
-            payload: {
-                currentTime: current,
-                targetTime: current,
-                mediaTitle: mediaTitle,
-                timestamp: Date.now()
-            }
-        }).catch(() => {});
-
-        // Trigger proactive heartbeat to push stabilized state
-        scheduleProactiveHeartbeat();
-    }
-
-    // Trailing-edge flush of a coalesced play/pause burst: emit the final settled
-    // state. No-ops only when no burst followed the leading edge. We do NOT skip
-    // when the state matches the leading send — a remote command may have changed
-    // the shared state mid-window, so re-sending is the safe (idempotent) choice.
-    function flushPlayPause() {
-        playPauseCoalesceTimer = null;
-        const finalAction = pendingPlayPauseAction;
-        pendingPlayPauseAction = null;
-        // No burst follow-up (only the leading edge fired), or invalid state.
-        if (finalAction !== EVENTS.PLAY && finalAction !== EVENTS.PAUSE) return;
-        sendContentEvent(finalAction);
-    }
-
-    function reportEvent(action) {
-        if (seekDebounceTimer && (action === EVENTS.PLAY || action === EVENTS.PAUSE)) {
-            clearTimeout(seekDebounceTimer);
-            seekDebounceTimer = null;
-            const v = findVideo();
-            if (v && Number.isFinite(v.currentTime)) {
-                lastReportedSeekTime = v.currentTime;
-                reportLog(`[Seek] Debounce flushed immediately due to ${action.toUpperCase()}`, 'info');
-                reportEvent(EVENTS.SEEK);
-            }
-        }
-
-        const video = findVideo();
-        if (!video) return;
-
-        const current = video.currentTime;
-        if (!Number.isFinite(current)) return;
-
-        const eventState = action === EVENTS.PLAY ? 'playing' : (action === EVENTS.PAUSE ? 'paused' : (action === EVENTS.SEEK ? 'seek' : null));
-
-        // Echo-suppression for remotely-applied commands. MUST stay synchronous
-        // on event arrival: the suppress timer is short-lived (300ms) and would
-        // expire if deferred, leaking an echo back to peers.
-        if (_suppressTimers[eventState]) {
-            _clearSuppress(eventState);
-            return;
-        }
-
-        // Suppress only SEEK during visibility grace period (tab re-focus ghost jump).
-        // Play/Pause pass through — user may want to immediately pause after tabbing back.
-        if (Date.now() < visibilityGraceUntil && action === EVENTS.SEEK) return;
-
-        // Coalesce play/pause bursts (source swaps, ABR, ads, teardown). The
-        // synchronous gates above have already run; only the network emit is
-        // governed here. Leading edge sends the first event instantly; further
-        // events within the window are collapsed to the final state by the
-        // trailing flush. A pending burst is REPLACED, never dropped — the last
-        // event in the window always wins.
-        if (action === EVENTS.PLAY || action === EVENTS.PAUSE) {
-            if (playPauseCoalesceTimer === null) {
-                // Window closed → fresh action. Emit now (zero added latency).
-                sendContentEvent(action);
-                pendingPlayPauseAction = null;
-            } else {
-                // Window open → part of a burst. Defer to the trailing flush.
-                pendingPlayPauseAction = action;
-                clearTimeout(playPauseCoalesceTimer);
-            }
-            playPauseCoalesceTimer = setTimeout(flushPlayPause, PLAY_PAUSE_COALESCE_MS);
-            return;
-        }
-
-        // SEEK (and any non play/pause action): emit immediately.
-        sendContentEvent(action);
-    }
-
-    // --- Tab Visibility Handling ---
-    // Browsers (especially Firefox) aggressively throttle background tabs.
-    // When the user returns to a video tab, the video element may have lost
-    // time-sync and fires spurious seek events as it recovers (jumping back).
-    // We suppress only SEEK for a short grace period after tab re-focus.
-    // Play/Pause are NOT suppressed — the user may legitimately want to
-    // pause immediately after switching back.
-    let pageVisible = !document.hidden;
-    let visibilityGraceUntil = 0;
-    const VISIBILITY_GRACE_MS = 300;
-
-    document.addEventListener('visibilitychange', () => {
-        if (document.hidden) {
-            pageVisible = false;
-        } else if (!pageVisible) {
-            pageVisible = true;
-            visibilityGraceUntil = Date.now() + VISIBILITY_GRACE_MS;
-            reportLog(`Tab re-focused — suppressing seeks for ${VISIBILITY_GRACE_MS / 1000}s to prevent ghost relay`, 'warn');
-        }
-    });
-
-    // Reset on page hide/show (bfcache, tab discard)
-    window.addEventListener('pagehide', () => {
-        pageVisible = false;
-        closeAudioContext();
-        if (keepAlivePort) { try { keepAlivePort.disconnect(); } catch (_e) { /* ignore */ } keepAlivePort = null; }
-        if (lobbyPollTimer) { clearInterval(lobbyPollTimer); lobbyPollTimer = null; }
-        if (heartbeatTimeout) { clearTimeout(heartbeatTimeout); heartbeatTimeout = null; }
-        if (proactiveHeartbeatTimeout) { clearTimeout(proactiveHeartbeatTimeout); proactiveHeartbeatTimeout = null; }
-        // Drop any pending coalesced play/pause: we are tearing down and will
-        // disconnect — peers learn we are gone via PEER_STATUS 'left'. This also
-        // intentionally suppresses the teardown play/pause burst at the source.
-        if (playPauseCoalesceTimer) { clearTimeout(playPauseCoalesceTimer); playPauseCoalesceTimer = null; pendingPlayPauseAction = null; }
-        observer.disconnect();
-    });
-    window.addEventListener('pageshow', (event) => {
-        // event.persisted is true ONLY when restored from bfcache, not on initial load
-        if (event.persisted && !pageVisible) {
-            pageVisible = true;
-            visibilityGraceUntil = Date.now() + VISIBILITY_GRACE_MS;
-            reportLog(`Page restored from cache — suppressing seeks for ${VISIBILITY_GRACE_MS / 1000}s`, 'warn');
-        }
-    });
-
-    const handlePlay = () => reportEvent(EVENTS.PLAY);
-    const handlePause = () => reportEvent(EVENTS.PAUSE);
-    // Host Control Mode: a 'waiting' (buffering) event opens a grace window so the
-    // pause it may trigger isn't misread as a deliberate guest action (EC-1).
-    const handleWaiting = () => { hcmBufferingUntil = Date.now() + HCM_BUFFERING_GRACE_MS; };
-
-    // Seek filtering: ignore HLS/DASH buffering micro-seeks.
-    // Only relay if delta >= MIN_SEEK_DELTA AND not already debouncing.
-    const handleSeeked = () => {
-        const video = findVideo();
-        if (!video) return;
-        const current = video.currentTime;
-        if (!Number.isFinite(current)) return;
-
-        // Step 1: Check expectedSeekTime (programmatic seek from remote peer)
-        if (expectedSeekTime !== null) {
-            if (Math.abs(current - expectedSeekTime) < 1.0) {
-                // Video arrived at expected time. Safely clear and ignore.
-                expectedSeekTime = null;
-                lastReportedSeekTime = current;
-                return;
-            } else {
-                // User manually scrubbed to a DIFFERENT time while we were buffering
-                expectedSeekTime = null;
-            }
-        }
-
-        // Step 2: Suppress during visibility grace period (tab re-focus ghost events)
-        if (Date.now() < visibilityGraceUntil) return;
-
-        const delta = lastReportedSeekTime !== null ? Math.abs(current - lastReportedSeekTime) : null;
-        const deltaStr = delta !== null ? `Δ${delta.toFixed(2)}s` : 'Δ?';
-
-        // Step 3: Delta check — skip micro-seeks (buffering, chapter markers, etc.)
-        if (lastReportedSeekTime !== null && delta < MIN_SEEK_DELTA) {
-            reportLog(`[Seek] Filtered (${deltaStr} < ${MIN_SEEK_DELTA}s threshold) @ ${current.toFixed(2)}s — not relayed`, 'warn');
-            return;
-        }
-
-        // Step 4: Debounce rapid consecutive seeks (e.g. scrubbing)
-        // — wait 300ms for the user to settle before relaying
-        if (seekDebounceTimer) clearTimeout(seekDebounceTimer);
-        seekDebounceTimer = setTimeout(() => {
-            seekDebounceTimer = null;
-            const v = findVideo();
-            if (!v) return;
-            const settled = v.currentTime;
-            const finalDelta = lastReportedSeekTime !== null ? Math.abs(settled - lastReportedSeekTime) : null;
-            const finalDeltaStr = finalDelta !== null ? `Δ${finalDelta.toFixed(2)}s` : 'Δ?';
-            lastReportedSeekTime = settled;
-            reportLog(`[Seek] Relayed @ ${settled.toFixed(2)}s (${finalDeltaStr})`, 'info');
-            reportEvent(EVENTS.SEEK);
-        }, 300);
-    };
-
-
-    let lastVideoSrc = undefined;
-
-    // Episode detection handler for loadeddata event
-    const handleLoadedData = () => {
-        checkEpisodeTransition();
-    };
-
-    function setupListeners() {
-        const video = findVideo();
-        if (video) {
-            if (currentAudioVideo && currentAudioVideo !== video) {
-                bypassCurrentAudioProcessing();
-            }
-            const existing = video._koalaHandlers;
-            if (existing) {
-                video.removeEventListener('play', existing.play);
-                video.removeEventListener('pause', existing.pause);
-                video.removeEventListener('seeked', existing.seeked);
-                video.removeEventListener('loadeddata', existing.loadeddata);
-                if (existing.waiting) video.removeEventListener('waiting', existing.waiting);
-            }
-            video._koalaHandlers = { play: handlePlay, pause: handlePause, seeked: handleSeeked, loadeddata: handleLoadedData, waiting: handleWaiting };
-
-            video.addEventListener('play', handlePlay);
-            video.addEventListener('pause', handlePause);
-            video.addEventListener('seeked', handleSeeked);
-            video.addEventListener('loadeddata', handleLoadedData);
-            video.addEventListener('waiting', handleWaiting);
-            video.dataset.koalaAttached = 'true';
-            lastVideoSrc = video.currentSrc || video.src || null;
-
-            if (!lastKnownMediaTitle) {
-                lastKnownMediaTitle = getMediaTitle();
-            }
-
-            if (_audioSettings && _audioProcessingAllowed) applyAudioSettings(video, _audioSettings);
-        }
-    }
-
-    // SPA Navigation Handler (MutationObserver)
-    let lastMutate = 0;
-    let observerTimeout = null;
-
-    function checkVideo() {
-        lastMutate = Date.now();
-        const video = findVideo();
-
-        if (!video && lastVideoSrc !== undefined) {
-            reportLog('Video element removed from page', 'warn');
-            lastVideoSrc = undefined;
-            closeAudioContext();
-            return;
-        }
-
-        if (!video) return;
-
-        const currentSrc = video.currentSrc || video.src || null;
-
-        if (!video.dataset.koalaAttached || (lastVideoSrc !== undefined && currentSrc && lastVideoSrc !== currentSrc)) {
-            if (lastVideoSrc !== undefined && currentSrc && lastVideoSrc !== currentSrc) {
-                checkEpisodeTransition();
-            }
-            setupListeners();
-        }
-    }
-
-    const observer = new MutationObserver(() => {
-        const now = Date.now();
-        if (now - lastMutate >= 1000) {
-            checkVideo();
-        } else {
-            if (observerTimeout) clearTimeout(observerTimeout);
-            observerTimeout = setTimeout(checkVideo, 1000 - (now - lastMutate));
-        }
-    });
-    observer.observe(document.documentElement, { childList: true, subtree: true });
-
-    // --- SHARED_HEARTBEAT_INJECT_START ---
-    const HEARTBEAT_INTERVAL_VAL = 15000;
-    // --- SHARED_HEARTBEAT_INJECT_END ---
-
-    // Heartbeat Refactoring (Self-scheduling setTimeout with proactive heartbeat scheduling)
-    let heartbeatTimeout = null;
-    let proactiveHeartbeatTimeout = null;
-    let heartbeatErrorCount = 0;
-
-    function sendHeartbeat() {
-        const video = findVideo();
-        if (!video) return;
-
-        const mediaTitle = (navigator.mediaSession && navigator.mediaSession.metadata) ? navigator.mediaSession.metadata.title : null;
-        chrome.runtime.sendMessage({
-            type: 'HEARTBEAT',
-            payload: {
-                playbackState: video.paused ? 'paused' : 'playing',
-                currentTime: video.currentTime,
-                mediaTitle: mediaTitle,
-                volume: video.volume,
-                muted: video.muted
-            }
-        }).catch(err => {
-            if (err.message.includes('Extension context invalidated')) {
-                heartbeatErrorCount++;
-                if (heartbeatErrorCount === 1) {
-                    reportLog('Extension reloaded. Please refresh the page if sync stops working.', 'warn');
-                }
-                if (heartbeatTimeout) clearTimeout(heartbeatTimeout);
-                if (proactiveHeartbeatTimeout) clearTimeout(proactiveHeartbeatTimeout);
-                observer.disconnect();
-            }
-        });
-    }
-
-    function schedulePeriodicHeartbeat() {
-        if (heartbeatTimeout) clearTimeout(heartbeatTimeout);
-        heartbeatTimeout = setTimeout(() => {
-            sendHeartbeat();
-            schedulePeriodicHeartbeat();
-        }, HEARTBEAT_INTERVAL_VAL);
-    }
-
-    function scheduleProactiveHeartbeat() {
-        if (proactiveHeartbeatTimeout) clearTimeout(proactiveHeartbeatTimeout);
-        proactiveHeartbeatTimeout = setTimeout(() => {
-            sendHeartbeat();
-            schedulePeriodicHeartbeat(); // Reschedules the next periodic check to be exactly 15s from now
-        }, 500); // 500ms stabilization delay
-    }
-
-    // Initial Setup
-    setupListeners();
-
-    // Maintain a persistent keep-alive port connection to prevent background SW suspension
-    let keepAlivePort = null;
-    function connectKeepAlivePort() {
-        try {
-            if (chrome.runtime.id) {
-                keepAlivePort = chrome.runtime.connect({ name: 'keepAlive' });
-                keepAlivePort.onDisconnect.addListener(() => {
-                    keepAlivePort = null;
-                    setTimeout(connectKeepAlivePort, 1000);
-                });
-            }
-        } catch (_e) {
-            // Extension context invalidated or disabled
-        }
-    }
-    connectKeepAlivePort();
-
-    schedulePeriodicHeartbeat();
-
-    // Immediate heartbeat on injection — populate peer data without waiting 15s
-    setTimeout(() => sendHeartbeat(), 300);
-
-    // Episode Auto-Sync: Boot recovery — check if background has an active lobby
-    chrome.runtime.sendMessage({ type: 'CONTENT_BOOT' }, (res) => {
-        if (chrome.runtime.lastError) return;
-        if (res && res.lobbyActive && res.expectedTitle) {
-            reportLog(`Boot: Active lobby detected for "${res.expectedTitle}"`, 'info');
-            startLobbyPoll(res.expectedTitle);
-        }
-    });
-
-    // Host Control Mode: fetch current room mode/role on injection (we may have
-    // been injected after ROOM_DATA already arrived, missing the broadcast).
-    chrome.runtime.sendMessage({ type: 'GET_CONTROL_MODE' }, (res) => {
-        if (chrome.runtime.lastError || !res) return;
-        hcmControlMode = res.controlMode || 'everyone';
-        hcmAmController = !!res.amController;
-        hcmHostPeerId = res.hostPeerId || null;
-        // Re-adopt persisted desync after a page reload so we don't start synced
-        // while background still relays us as "Solo" to the host (split-brain).
-        // Only when we're actually a gated guest — never adopt a stale flag as a
-        // controller or in 'everyone' mode (would self-label "Solo" / ignore commands).
-        if (res.desynced && res.controlMode === 'host-only' && !res.amController && !hcmDesynced) {
-            hcmDesynced = true;
-            hcmShowBadge();
-        }
-    });
-
-    // Pull localized strings for the in-page dialog/badge (English fallback above).
-    chrome.runtime.sendMessage({ type: 'GET_HCM_STRINGS' }, (res) => {
-        if (chrome.runtime.lastError || !res) return;
-        Object.keys(hcmStrings).forEach(k => { if (res[k]) hcmStrings[k] = res[k]; });
-        // If the badge is already showing (early desync), refresh its text in place.
-        // Re-creating the host element nukes the click target mid-poll and can drop a
-        // click that landed between remove() and the re-create (L-4).
-        if (hcmBadgeHost) {
-            const span = hcmBadgeHost.shadowRoot && hcmBadgeHost.shadowRoot.querySelector('span');
-            if (span) span.textContent = '● ' + hcmStrings.badge;
-        }
-    });
-
-})();
+/**

+ * KoalaSync Content Script

+ * Injected into video tabs to control playback and detect events.

+ */

+

+(function() {

+    // Injection Guard: Check if already injected AND context is valid

+    try {

+        if (window.koalaSyncInjected && chrome.runtime.id) {

+            return;

+        }

+    } catch (_e) {

+        // Context invalidated, proceed with re-injection

+    }

+    window.koalaSyncInjected = true;

+

+    // --- SHARED_EVENTS_INJECT_START ---

+    // This block is automatically updated by /scripts/build-extension.js

+    const EVENTS = {

+        PLAY: "play",

+        PAUSE: "pause",

+        SEEK: "seek",

+        FORCE_SYNC_PREPARE: "force_sync_prepare",

+        FORCE_SYNC_ACK: "force_sync_ack",

+        FORCE_SYNC_EXECUTE: "force_sync_execute",

+        PEER_STATUS: "peer_status",

+        EPISODE_LOBBY: "episode_lobby",

+        EPISODE_READY: "episode_ready"

+    };

+    // --- SHARED_EVENTS_INJECT_END ---

+

+    // Suppresses native event reporting after a programmatic action.

+    // Each entry is a per-type timer (key = 'playing'|'paused'|'seek').

+    // While a timer exists, matching native events are consumed and not relayed.

+    // Timers self-clean after 300ms if the native event never fires.

+    let _suppressTimers = {};

+

+    function _setSuppress(state) {

+        if (_suppressTimers[state]) clearTimeout(_suppressTimers[state]);

+        _suppressTimers[state] = setTimeout(() => {

+            delete _suppressTimers[state];

+        }, 300);

+    }

+

+    function _clearSuppress(state) {

+        if (_suppressTimers[state]) {

+            clearTimeout(_suppressTimers[state]);

+            delete _suppressTimers[state];

+        }

+    }

+

+    // --- Seek Relay Filtering ---

+    // Minimum seek delta (seconds) to report. Prevents HLS/DASH buffering micro-seeks

+    // from being relayed to peers as user-initiated seeks.

+    const MIN_SEEK_DELTA = 2.0;

+    let lastReportedSeekTime = null;  // last currentTime we relayed as a SEEK

+    let seekDebounceTimer = null;     // debounce timer for rapid seek events

+    let expectedSeekTime = null;      // strictly track programmatic seeks

+

+    const PAGE_API_SEEK_BRIDGE = 1;
+    let lastDisneyPlusTimelineCandidates = [];
+
+    function hostMatchesUrl(host, url) {
+        const normalized = String(url || '')
+            .replace(/^https?:\/\//i, '')
+            .split('/')[0]
+            .toLowerCase();
+        return normalized && (host === normalized || host.endsWith(`.${normalized}`));
+    }
+
+    function matchesPlayerUrls(urls) {
+        const host = window.location.hostname.toLowerCase();
+        return Array.isArray(urls) && urls.some(url => hostMatchesUrl(host, url));
+    }
+
+    function isDisneyPlusHost() {
+        return matchesPlayerUrls(['disneyplus.com']);
+    }
+
+    function getSeekableRange(video) {
+        try {
+            const ranges = video.seekable;
+            if (!ranges || ranges.length === 0) return null;
+            const current = video.currentTime;
+            let index = ranges.length - 1;
+            if (Number.isFinite(current)) {
+                for (let i = 0; i < ranges.length; i++) {
+                    if (current >= ranges.start(i) && current <= ranges.end(i)) {
+                        index = i;
+                        break;
+                    }
+                }
+            }
+            const start = ranges.start(index);
+            const end = ranges.end(index);
+            if (!Number.isFinite(start) || !Number.isFinite(end) || end <= start) return null;
+            return { start, end, duration: end - start };
+        } catch (_e) {
+            return null;
+        }
+    }
+
+    function parseClockTime(value) {
+        const parts = String(value || '').trim().split(':').map(Number);
+        if (parts.length < 2 || parts.length > 3 || parts.some(n => !Number.isFinite(n))) return null;
+        return parts.length === 2
+            ? parts[0] * 60 + parts[1]
+            : parts[0] * 3600 + parts[1] * 60 + parts[2];
+    }
+
+    function parseTimelineText(text) {
+        const matches = String(text || '').match(/\b\d{1,3}:\d{2}(?::\d{2})?\b/g);
+        if (!matches || matches.length < 2) return null;
+        const current = parseClockTime(matches[0]);
+        const duration = parseClockTime(matches[matches.length - 1]);
+        if (!Number.isFinite(current) || !Number.isFinite(duration) || duration < 60 || current > duration + 5) return null;
+        return { current, duration };
+    }
+
+    function getDisneyPlusUiTimeline() {
+        if (typeof document === 'undefined') return null;
+        const selectors = [
+            '[role="slider"]',
+            '[role="progressbar"]',
+            '[aria-valuenow][aria-valuemax]',
+            '[aria-valuetext]',
+            '[aria-label]',
+            '[data-testid]',
+            '[data-test]',
+            '[class*="time" i]',
+            '[class*="progress" i]',
+            'time',
+            'output',
+            'button',
+            'span',
+            'p',
+            'div'
+        ].join(',');
+        const nodes = Array.from(document.querySelectorAll(selectors)).slice(0, 2000);
+        const textParts = [];
+        const candidates = [];
+        let best = null;
+        let bestScore = -1;
+
+        function considerTimeline(parsed, source, weight = 0) {
+            if (!parsed) return;
+            const score = weight +
+                (parsed.duration >= 20 * 60 ? 200 : 0) +
+                (parsed.current > 0 ? 50 : 0) -
+                Math.abs((parsed.duration / 2) - parsed.current) / 100;
+            candidates.push({ ...parsed, source, score: Math.round(score) });
+            if (score > bestScore) {
+                bestScore = score;
+                best = parsed;
+            }
+        }
+
+        for (const node of nodes) {
+            const now = Number(node.getAttribute?.('aria-valuenow') ?? node.value);
+            const max = Number(node.getAttribute?.('aria-valuemax') ?? node.max);
+            if (Number.isFinite(now) && Number.isFinite(max) && max >= 60 && now >= 0 && now <= max + 5) {
+                considerTimeline({ current: now, duration: max }, 'aria-value', 300);
+            }
+
+            for (const attr of ['aria-valuetext', 'aria-label', 'title', 'data-testid', 'data-test']) {
+                const parsed = parseTimelineText(node.getAttribute?.(attr));
+                considerTimeline(parsed, attr, 200);
+            }
+
+            const text = String(node.textContent || '').trim();
+            if (text && text.length < 200) {
+                const parsed = parseTimelineText(text);
+                considerTimeline(parsed, 'text', 100);
+                textParts.push(text);
+            }
+        }
+
+        considerTimeline(parseTimelineText(textParts.join(' ')), 'combined-text', 25);
+        lastDisneyPlusTimelineCandidates = candidates
+            .sort((a, b) => b.score - a.score)
+            .slice(0, 8)
+            .map(({ source, current, duration }) => ({ source, current, duration }));
+        return best;
+    }
+
+    function getElementLabel(el) {
+        return [
+            el.getAttribute?.('aria-label'),
+            el.getAttribute?.('title'),
+            el.getAttribute?.('data-testid'),
+            el.getAttribute?.('data-test'),
+            el.textContent
+        ].filter(Boolean).join(' ').replace(/\s+/g, ' ').trim();
+    }
+
+    function getDisneyPlusSeekButtonLabels() {
+        if (!isDisneyPlusHost() || typeof document === 'undefined') return [];
+        return Array.from(document.querySelectorAll('button,[role="button"]'))
+            .map(getElementLabel)
+            .filter(Boolean)
+            .slice(0, 20);
+    }
+
+    function clickDisneyPlusRelativeSeek(delta) {
+        if (!isDisneyPlusHost() || !Number.isFinite(delta) || Math.abs(delta) < 1 || typeof document === 'undefined') return false;
+        const backward = delta < 0;
+        const candidates = Array.from(document.querySelectorAll('button,[role="button"]'));
+        const backRe = /rewind|backward|back\b|zurück|zurueck|rück|rueck|retour|recul|retroced|atrás|voltar|indietro/i;
+        const forwardRe = /forward|ahead|skip|vorwärts|vorwaerts|vorsp|weiter|avancer|adelant|avançar|avancar|avanti/i;
+        const timeRe = /\b(5|10|15|30)\b|sec|sek|second/i;
+
+        const button = candidates.find(btn => {
+            const label = getElementLabel(btn);
+            const matchesDirection = backward ? backRe.test(label) : forwardRe.test(label);
+            return matchesDirection && timeRe.test(label);
+        }) || candidates.find(btn => {
+            const label = getElementLabel(btn);
+            return backward ? backRe.test(label) : forwardRe.test(label);
+        });
+
+        if (!button || typeof button.click !== 'function') return false;
+        const clicks = Math.max(1, Math.min(12, Math.round(Math.abs(delta) / 10)));
+        for (let i = 0; i < clicks; i++) {
+            setTimeout(() => button.click(), i * 60);
+        }
+        return true;
+    }
+
+    function getDisneyPlusTimeline(video) {
+        if (!isDisneyPlusHost()) return null;
+        const range = getSeekableRange(video);
+        const current = video.currentTime;
+        const ui = getDisneyPlusUiTimeline();
+
+        if (ui) {
+            let nativeScale = 1;
+            if (range && range.duration > ui.duration * 1.2) {
+                nativeScale = range.duration / ui.duration;
+            } else if (Number.isFinite(current) && ui.current > 1 && current > ui.current * 1.5) {
+                nativeScale = current / ui.current;
+            }
+            const nativeStart = Number.isFinite(current)
+                ? current - ui.current * nativeScale
+                : (range ? range.start : 0);
+            return {
+                ...(range || {}),
+                current: ui.current,
+                duration: ui.duration,
+                nativeScale,
+                nativeStart
+            };
+        }
+
+        if (!range || range.start < 1 || range.duration < 60) return null;
+        if (!Number.isFinite(current) || current < range.start - 1 || current > range.end + 1) return null;
+        return { ...range, current: Math.max(0, current - range.start), nativeScale: 1, nativeStart: range.start };
+    }
+
+    // Site-specific player exceptions live here. The default HTML5 path stays below.
+    function getSiteQuirkAdapters() {
+        return [{
+            name: 'disneyplus-timeline-and-buttons',
+            key: 'disneyPlus',
+            urls: ['disneyplus.com'],
+            matches() { return matchesPlayerUrls(this.urls); },
+            getTimeline: getDisneyPlusTimeline,
+            clickRelativeSeek: clickDisneyPlusRelativeSeek,
+            getDebug(video) {
+                return {
+                    name: this.name,
+                    key: 'disneyPlus',
+                    urls: this.urls,
+                    timeline: getDisneyPlusTimeline(video),
+                    timelineCandidates: lastDisneyPlusTimelineCandidates,
+                    seekButtons: getDisneyPlusSeekButtonLabels()
+                };
+            }
+        }];
+    }
+
+    function getActiveSiteQuirk() {
+        return getSiteQuirkAdapters().find(adapter => adapter.matches()) || null;
+    }
+
+    function getSiteQuirkTimeline(video) {
+        const adapter = getActiveSiteQuirk();
+        return adapter ? adapter.getTimeline(video) : null;
+    }
+
+    function getSiteQuirkDebug(video) {
+        const adapter = getActiveSiteQuirk();
+        return adapter ? adapter.getDebug(video) : null;
+    }
+
+    function getSyncCurrentTime(video) {
+        const current = video.currentTime;
+        if (!Number.isFinite(current)) return null;
+        const siteTimeline = getSiteQuirkTimeline(video);
+        return siteTimeline ? siteTimeline.current : current;
+    }
+
+    function getSyncDuration(video) {
+        const siteTimeline = getSiteQuirkTimeline(video);
+        if (siteTimeline) return siteTimeline.duration;
+        return Number.isFinite(video.duration) && video.duration > 0 ? video.duration : 0;
+    }
+
+    function toNativeSeekTime(video, targetTime) {
+        if (!Number.isFinite(targetTime)) return targetTime;
+        const siteTimeline = getSiteQuirkTimeline(video);
+        if (!siteTimeline) return targetTime;
+        const nativeTarget = siteTimeline.nativeStart + targetTime * siteTimeline.nativeScale;
+        const max = Number.isFinite(siteTimeline.end) ? siteTimeline.end : nativeTarget;
+        const min = Number.isFinite(siteTimeline.start) ? siteTimeline.start : 0;
+        return Math.max(min, Math.min(max, nativeTarget));
+    }
+
+    function shouldUsePageApiSeek() {
+        return window.KOALA_PAGE_API_SEEK_ENABLED === true &&
+            typeof window.koalaFindPageApiSeekProvider === 'function' &&
+            !!window.koalaFindPageApiSeekProvider(window.location.hostname);
+    }
+
+    function seekVideo(video, targetTime, relativeDelta = null) {
+        const siteQuirk = getActiveSiteQuirk();
+        if (siteQuirk && !siteQuirk.getTimeline(video) && siteQuirk.clickRelativeSeek(relativeDelta)) {
+            expectedSeekTime = null;
+            return;
+        }
+        const nativeTargetTime = toNativeSeekTime(video, targetTime);
+        expectedSeekTime = targetTime;
+        if (shouldUsePageApiSeek()) {
+            window.postMessage({ __koalaPageApiSeek: PAGE_API_SEEK_BRIDGE, kind: 'seek', time: targetTime }, '*');
+            return;
+        }
+        video.currentTime = nativeTargetTime;
+    }
+

+    // --- Play/Pause Coalescing (leading + trailing) ---

+    // Media players (HLS/DASH, ad insertion, ABR/quality switches, source swaps,

+    // page teardown) fire bursts of native play/pause events within a few hundred

+    // ms. Relaying each as a distinct command spams peers and the relay.

+    //

+    // Strategy: emit the FIRST event immediately (leading edge → a deliberate

+    // single play/pause has zero added latency), then hold a short window. If

+    // more play/pause events arrive during the window it's a burst — we suppress

+    // the intermediate churn and, once it settles, emit the FINAL state on the

+    // trailing edge.

+    //

+    // We deliberately do NOT dedup the trailing send against the leading one. A

+    // remote play/pause may be applied mid-window (e.g. I pause, peer plays, I

+    // pause again within 150ms): the settled state then equals my last *sent*

+    // state yet is a genuine change versus the now-shared state — suppressing it

+    // would desync. Re-sending an unchanged state is a harmless no-op on peers,

+    // so re-sending is always the safe choice. Echo-suppression and seek-flush

+    // still run synchronously on event arrival (see reportEvent) — only the

+    // network emit is governed here.

+    const PLAY_PAUSE_COALESCE_MS = 150;

+    let playPauseCoalesceTimer = null;  // non-null = a coalescing window is open

+    let pendingPlayPauseAction = null;  // last play/pause seen during the window, awaiting trailing flush

+

+    // --- Episode Auto-Sync State ---

+    let lastKnownMediaTitle = null;

+    let episodeTransitionDebounce = null;

+    let _pendingLobbyTitle = null; // Title we're waiting to match (from remote lobby)

+    let lobbyPollTimer = null;

+    let _autoSyncEnabled = true; // Cached setting, updated via storage.onChanged

+    let _audioSettings = null;

+    let _audioProcessingAllowed = true;

+

+    // Cache the autoSyncNextEpisode setting (local-only; never read from sync)

+    chrome.storage.local.get(['autoSyncNextEpisode', 'audioSettings'], (data) => {

+        _autoSyncEnabled = data.autoSyncNextEpisode !== false;

+        _audioSettings = mergeAudioSettings(data.audioSettings);

+        const video = findVideo();

+        if (video && _audioProcessingAllowed) applyAudioSettings(video, _audioSettings);

+    });

+    chrome.storage.onChanged.addListener((changes, area) => {

+        if (area === 'local' && changes.autoSyncNextEpisode) {

+            _autoSyncEnabled = changes.autoSyncNextEpisode.newValue !== false;

+        }

+    });

+

+    // --- Host Control Mode (guest-side) ---

+    // When a room is in 'host-only' mode and we're a guest, a deliberate local

+    // pause/seek must not drive the room (background/server already drop it). Here

+    // we handle the *local* UX: snap back to the host's position, or — if the user

+    // really wants to — let them go solo (desync) with a resync escape hatch.

+    let hcmControlMode = 'everyone';   // mirror of room control mode

+    let hcmAmController = false;        // are we allowed to drive (owner or co-host)?

+    let hcmHostPeerId = null;          // last known host peerId (room/host identity)

+    let hcmDesynced = false;           // user chose to go solo

+    let hcmSnapBackCooldownUntil = 0;  // suppress re-trigger right after a snap-back

+    let hcmDeferredSnapPending = false; // a buffer-aware snap-back is waiting for readiness

+    let hcmLastUserGestureAt = 0;      // for deliberate-vs-involuntary classification

+    let hcmBufferingUntil = 0;         // set on 'waiting' — buffering grace window

+    let hcmDialogTimer = null;         // 8s auto-stay timer — cleared on dialog replace (H-4)

+    // Localized strings for the in-page dialog/badge (content has no i18n loader;

+    // background resolves them via GET_HCM_STRINGS on init). English fallbacks here.

+    const hcmStrings = {

+        title:  'KoalaSync · Host controls this room',

+        body:   'Only the host can control playback in this room. Keep watching together, or watch on your own?',

+        stay:   'Stay in sync',

+        solo:   'Watch on my own',

+        badge:  'Watching on your own',

+        resync: 'Resync'

+    };

+    const HCM_USER_GESTURE_MS = 1000;

+    const HCM_BUFFERING_GRACE_MS = 1500;

+    const HCM_SNAP_BACK_COOLDOWN_MS = 1000;

+    const HCM_BUFFER_WAIT_MS = 8000;   // cap on waiting for a buffering player before snapping anyway

+

+    // Track genuine user input so we can tell a deliberate pause/seek from a

+    // player-/browser-initiated one. Capturing + passive so we never interfere.

+    const _hcmGesture = () => { hcmLastUserGestureAt = Date.now(); };

+    document.addEventListener('keydown', _hcmGesture, { capture: true, passive: true });

+    document.addEventListener('pointerdown', _hcmGesture, { capture: true, passive: true });

+

+    function hcmIsGuestGated() {

+        return hcmControlMode === 'host-only' && !hcmAmController;

+    }

+

+    // EC-9 intent classifier: only a *clearly deliberate* guest action triggers the

+    // dialog/snap-back. Anything that smells involuntary (buffering, seeking, tab

+    // refocus, no recent gesture) is treated as involuntary. Bias intentional —

+    // in host-only the guest never broadcasts anyway, so this only tunes UX.

+    function hcmClassifyIntent() {

+        const video = findVideo();

+        if (!video) return 'involuntary';

+        if (hcmIsLive(video)) return 'live';                   // EC-15: degrade, don't gate

+        if (video.readyState < 3) return 'involuntary';        // buffering / not enough data

+        if (video.seeking) return 'involuntary';

+        if (Date.now() < hcmBufferingUntil) return 'involuntary';

+        if (Date.now() < visibilityGraceUntil) return 'involuntary';

+        if (Date.now() - hcmLastUserGestureAt > HCM_USER_GESTURE_MS) return 'involuntary';

+        return 'deliberate';

+    }

+

+    // Live detection (EC-15 + DVR). Pure live reports duration Infinity/NaN. Live-DVR

+    // (Twitch/YouTube-live with rewind) reports a *finite, sliding* duration — its

+    // seekable window doesn't start at 0, which we use as the DVR signal.

+    function hcmIsLive(video) {

+        // Don't trust duration before metadata has loaded (readyState >= 1) —

+        // otherwise pre-loaded videos report NaN and get misclassified as live,

+        // which suppresses the desync dialog (L-2).

+        if (video.readyState < 1) return false;

+        if (!Number.isFinite(video.duration)) return true;

+        try {

+            const s = video.seekable;

+            if (s && s.length > 0 && s.start(0) > 1) return true; // sliding DVR window

+        } catch (_e) { /* seekable may throw if empty */ }

+        return false;

+    }

+

+    // Snap the local player back to the host's current position/state.

+    function hcmSnapBackToHost(target) {

+        if (hcmDesynced) return; // user opted out — never yank them back automatically

+        hcmSnapBackCooldownUntil = Date.now() + HCM_SNAP_BACK_COOLDOWN_MS;

+        const video = findVideo();

+        if (!video) return;

+        if (target && Number.isFinite(target.targetTime)) {

+            tryMediaAction(EVENTS.SEEK, { targetTime: target.targetTime });

+        }

+        // Adopt the host's play/pause state — but ONLY if we actually know it.

+        // Defaulting to PLAY when the state is unknown would auto-resume a paused

+        // video against the host's real state (H-1).

+        if (target && target.playbackState === 'paused') {

+            tryMediaAction(EVENTS.PAUSE);

+        } else if (target && target.playbackState === 'playing') {

+            tryMediaAction(EVENTS.PLAY);

+        }

+        reportLog('Host-only: snapped back to host position', 'info');

+    }

+

+    // Resync to the host's current position, retrying briefly if the host's state

+    // isn't known yet (e.g. they just paused and no heartbeat has propagated) —

+    // otherwise the request is a silent no-op and the user thinks they're synced

+    // when they aren't. Shared by the dialog's "Stay in sync" and the Resync badge.

+    function hcmRequestHostSyncWithRetry() {

+        let attempts = 0;

+        const tryOnce = () => {

+            chrome.runtime.sendMessage({ type: 'REQUEST_HOST_SYNC' }, (res) => {

+                if (chrome.runtime.lastError || !res || !res.target) {

+                    if (++attempts < 5) setTimeout(tryOnce, 250);

+                    else reportLog('Host-only: resync requested but host state unavailable', 'warn');

+                    return;

+                }

+                hcmSnapBackToHost(res.target);

+            });

+        };

+        tryOnce();

+    }

+

+    // Buffer-aware snap-back (#3). An involuntary pause/seek often coincides with the

+    // player buffering — and a player can't actually play while it's stalled. Snapping

+    // immediately just fights the buffer (seek → re-buffer → another pause → …), which

+    // looks like stutter. Instead: if the player isn't ready, wait until it can play

+    // (readyState>=3, not seeking), then snap ONCE to the host's *current* position

+    // (re-queried, since the captured target may be stale by the time buffering ends).

+    // Player-agnostic on purpose — we can't enumerate every site, so this must be safe

+    // regardless of whether a given player fires 'pause' or only 'waiting'.

+    function hcmDeferredSnapBack() {

+        if (hcmDeferredSnapPending) return; // already waiting — don't stack polls

+        hcmDeferredSnapPending = true;

+        const deadline = Date.now() + HCM_BUFFER_WAIT_MS;

+        const poll = () => {

+            // Abort if the reason to snap is gone: user went solo, we're no longer a

+            // gated guest, or the video vanished.

+            if (hcmDesynced || !hcmIsGuestGated()) { hcmDeferredSnapPending = false; return; }

+            const video = findVideo();

+            const ready = video && video.readyState >= 3 && !video.seeking;

+            if (ready || Date.now() >= deadline) {

+                hcmDeferredSnapPending = false;

+                hcmRequestHostSyncWithRetry(); // fresh host position + snap once

+                return;

+            }

+            setTimeout(poll, 300);

+        };

+        poll();

+    }

+

+    // Entry point: background told us our local action was blocked in host-only.

+    function hcmHandleBlocked(action, target) {

+        // HOST_BLOCKED is only ever sent to a gated guest (background verifies

+        // host-only + !host before sending), so it's authoritative. Adopt the

+        // role/mode from it in case our CONTROL_MODE broadcast hasn't landed yet

+        // (join race, EC-5) — otherwise we'd miss the dialog/snap-back.

+        hcmControlMode = 'host-only';

+        hcmAmController = false;

+        if (hcmDesynced) return; // already solo, nothing to do

+

+        const intent = hcmClassifyIntent();

+        if (intent === 'live') return;          // EC-15: leave the guest alone on live

+        if (intent === 'involuntary') {

+            // EC-4 loop guard: only the silent auto snap-back is suppressed by the

+            // cooldown — the deliberate dialog path below must still go through,

+            // otherwise a second deliberate pause inside the cooldown window leaves

+            // the user stuck paused with no UI (M-3).

+            if (Date.now() < hcmSnapBackCooldownUntil || hcmDeferredSnapPending) return;

+            // Buffering/ads/throttle — silently re-sync, no dialog spam.

+            const video = findVideo();

+            if (video && video.readyState >= 3 && !video.seeking) {

+                // Ready now → snap immediately. Use the captured target if it's

+                // usable, otherwise re-query+retry (host state may not be known yet)

+                // so we never leave the guest silently stuck (consistent with the

+                // deferred and "Stay in sync" paths).

+                if (target && Number.isFinite(target.targetTime)) hcmSnapBackToHost(target);

+                else hcmRequestHostSyncWithRetry();

+            } else {

+                hcmDeferredSnapBack();             // buffering → wait for ready, then snap once (#3)

+            }

+            return;

+        }

+        // Deliberate: offer the choice (Teleparty-style), default = snap back.

+        hcmShowDesyncDialog(action, target);

+    }

+

+    // --- In-page UI (dialog + persistent desync badge) ---

+    // Built with the DOM API (CSSOM .style is CSP-safe; inline style="" in innerHTML

+    // is stripped by strict style-src on Netflix/YouTube/Disney+). Hosted in a

+    // Shadow DOM so the page's CSS can't restyle or hide our controls.

+    let hcmDialogHost = null;  // shadow host element for the dialog

+    let hcmBadgeHost = null;   // shadow host element for the persistent badge

+    let hcmBadgePending = false;  // retry flag for early-injection badge creation (L-4)

+

+    function hcmEl(tag, css, text) {

+        const el = document.createElement(tag);

+        if (css) el.style.cssText = css;        // CSSOM assignment — not gated by CSP

+        if (text != null) el.textContent = text;

+        return el;

+    }

+

+    function hcmRemoveDialog() {

+        // Cancel any pending auto-stay timer so a replaced dialog's stale closure

+        // can't later remove its successor / snap to an outdated target (H-4).

+        if (hcmDialogTimer) { clearTimeout(hcmDialogTimer); hcmDialogTimer = null; }

+        if (hcmDialogHost) { hcmDialogHost.remove(); hcmDialogHost = null; }

+    }

+

+    function hcmShowDesyncDialog(action, target) {

+        if (!document.body) { hcmSnapBackToHost(target); return; }

+        hcmRemoveDialog();

+        const host = hcmEl('div', 'all:initial');

+        const root = host.attachShadow({ mode: 'open' });

+

+        const wrap = hcmEl('div', 'position:fixed;z-index:2147483647;left:50%;bottom:32px;transform:translateX(-50%);background:#1f2937;color:#f9fafb;font:14px/1.4 system-ui,sans-serif;padding:16px 18px;border-radius:12px;box-shadow:0 8px 30px rgba(0,0,0,.45);max-width:360px;border:1px solid #374151');

+        wrap.setAttribute('role', 'dialog');

+        const title = hcmEl('div', 'font-weight:600;margin-bottom:6px', hcmStrings.title);

+        const body = hcmEl('div', 'margin-bottom:12px;color:#d1d5db', hcmStrings.body);

+        const btnRow = hcmEl('div', 'display:flex;gap:8px;justify-content:flex-end');

+        const soloBtn = hcmEl('button', 'background:#374151;color:#f9fafb;border:0;padding:8px 12px;border-radius:8px;cursor:pointer', hcmStrings.solo);

+        const stayBtn = hcmEl('button', 'background:#10b981;color:#062a20;border:0;padding:8px 12px;border-radius:8px;cursor:pointer;font-weight:600', hcmStrings.stay);

+        btnRow.append(soloBtn, stayBtn);

+        wrap.append(title, body, btnRow);

+        root.appendChild(wrap);

+        document.body.appendChild(host);

+        hcmDialogHost = host;

+

+        let settled = false;

+        // Re-query the host's current position on click instead of using the

+        // potentially stale target captured at HOST_BLOCKED time (M-1).

+        const stay = () => {

+            if (settled) return; settled = true; hcmRemoveDialog();

+            hcmRequestHostSyncWithRetry();

+        };

+        const solo = () => { if (settled) return; settled = true; hcmRemoveDialog(); hcmEnterDesync(); };

+        stayBtn.addEventListener('click', stay);

+        soloBtn.addEventListener('click', solo);

+        // EC-18: if the user ignores the prompt, default to staying in sync.

+        hcmDialogTimer = setTimeout(() => { if (!settled) stay(); }, 8000);

+    }

+

+    function hcmEnterDesync() {

+        hcmDesynced = true;

+        reportLog('Host-only: you chose to watch on your own (desynced)', 'warn');

+        // Notify background so it can relay our desynced state to the host via

+        // heartbeats — the host's UI then knows we're not following commands

+        // instead of appearing silently un-ACK'd.

+        chrome.runtime.sendMessage({ type: 'HCM_DESYNC_STATE', desynced: true }).catch(() => {});

+        hcmShowBadge();

+    }

+

+    function hcmExitDesync() {

+        const wasDesynced = hcmDesynced;

+        hcmDesynced = false;

+        hcmRemoveBadge();

+        if (wasDesynced) {

+            chrome.runtime.sendMessage({ type: 'HCM_DESYNC_STATE', desynced: false }).catch(() => {});

+        }

+        // Resync to the host's current position (retries if host state not yet known).

+        hcmRequestHostSyncWithRetry();

+        reportLog('Host-only: resynced with the host', 'info');

+    }

+

+    function hcmShowBadge() {

+        if (hcmBadgeHost) return;

+        if (!document.body) {

+            // Body not ready yet (very early injection). Defer until DOMReady,

+            // otherwise the desynced user silently never sees the badge (L-4).

+            if (!hcmBadgePending) {

+                hcmBadgePending = true;

+                const retry = () => {

+                    hcmBadgePending = false;

+                    if (hcmDesynced && !hcmBadgeHost) hcmShowBadge();

+                };

+                if (document.readyState === 'loading') {

+                    document.addEventListener('DOMContentLoaded', retry, { once: true });

+                } else {

+                    setTimeout(retry, 50);

+                }

+            }

+            return;

+        }

+        const host = hcmEl('div', 'all:initial');

+        const root = host.attachShadow({ mode: 'open' });

+        const b = hcmEl('div', 'position:fixed;z-index:2147483646;right:16px;bottom:16px;background:#b45309;color:#fff;font:13px/1.3 system-ui,sans-serif;padding:8px 12px;border-radius:10px;box-shadow:0 6px 20px rgba(0,0,0,.4);cursor:pointer;display:flex;align-items:center;gap:8px');

+        b.append(hcmEl('span', null, '● ' + hcmStrings.badge), hcmEl('span', 'text-decoration:underline', hcmStrings.resync));

+        b.addEventListener('click', hcmExitDesync);

+        root.appendChild(b);

+        document.body.appendChild(host);

+        hcmBadgeHost = host;

+    }

+

+    function hcmRemoveBadge() {

+        if (hcmBadgeHost) { hcmBadgeHost.remove(); hcmBadgeHost = null; }

+    }

+

+    function hcmReset() {

+        const wasDesynced = hcmDesynced;

+        hcmDesynced = false;

+        hcmDeferredSnapPending = false;

+        hcmSnapBackCooldownUntil = 0; // don't let a stale cooldown swallow the next snap-back

+        hcmBufferingUntil = 0;

+        hcmRemoveDialog();

+        hcmRemoveBadge();

+        // If we were desynced, notify background so it stops reporting us as

+        // desynced in heartbeats (otherwise the host's UI keeps showing the

+        // stale Solo badge until the next state change).

+        if (wasDesynced) {

+            chrome.runtime.sendMessage({ type: 'HCM_DESYNC_STATE', desynced: false }).catch(() => {});

+        }

+    }

+

+    function reportLog(message, level = 'info') {

+        chrome.runtime.sendMessage({ type: 'LOG', message, level }).catch(() => {});

+    }

+

+    // --- Helper: find the best video element on the page ---

+    // Prefers larger, visible videos over tiny preview/trailer elements.

+    function findVideo(root = document) {

+        const candidates = Array.from(root.querySelectorAll('video'));

+

+        // Scan likely media hosts even when light-DOM videos exist; many players

+        // expose a tiny preview/ad video outside Shadow DOM and the real player inside.

+        const potentialHosts = root.querySelectorAll('[id*="player" i], [class*="player" i], [id*="video" i], [class*="video" i], [id*="media" i], [class*="media" i], [id*="stream" i], [class*="stream" i], ytd-player, netflix-player, emby-player, jellyfin-player, video-player');

+        for (const el of potentialHosts) {

+            if (el.shadowRoot) {

+                const found = findVideo(el.shadowRoot);

+                if (found) candidates.push(found);

+            }

+        }

+

+        if (candidates.length === 0) return null;

+

+        // Multiple videos found → pick the best one

+        if (candidates.length === 1) return candidates[0];

+

+        let best = null;

+        let bestScore = -1;

+        for (const v of candidates) {

+            if (v.tagName !== 'VIDEO') continue;

+            // Score: visible area + bonus for unmuted + bonus for longer duration

+            const area = (v.videoWidth || v.offsetWidth || 0) * (v.videoHeight || v.offsetHeight || 0);

+            const unmutedBonus = v.muted ? 0 : 100000;

+            const durationBonus = (v.duration && isFinite(v.duration) ? v.duration : 0) * 100;

+            const score = area + unmutedBonus + durationBonus;

+            if (score > bestScore) {

+                bestScore = score;

+                best = v;

+            }

+        }

+        return best;

+    }

+

+    // --- Audio Processing Module ---

+    const AUDIO_PRESETS = {

+        recommended: { threshold: -24, ratio: 8, attack: 0.010, release: 0.300, knee: 15 },

+        dynamicRange: { threshold: -18, ratio: 4, attack: 0.020, release: 0.200, knee: 10 },

+        vocalEnhancement: { threshold: -12, ratio: 3, attack: 0.015, release: 0.150, knee: 5 },

+        smooth: { threshold: -30, ratio: 1.5, attack: 0.030, release: 0.250, knee: 20 },

+        custom: { threshold: -24, ratio: 12, attack: 0.003, release: 0.250, knee: 30 }

+    };

+    const DEFAULT_AUDIO_SETTINGS = {

+        enabled: false,

+        compressor: {

+            enabled: false,

+            preset: 'recommended',

+            customParams: { ...AUDIO_PRESETS.custom }

+        }

+    };

+    let audioCtx = null;

+    let audioChains = new WeakMap();

+    let currentAudioVideo = null;

+

+    function mergeAudioSettings(settings = {}) {

+        const safeSettings = settings && typeof settings === 'object' ? settings : {};

+        return {

+            ...DEFAULT_AUDIO_SETTINGS,

+            ...safeSettings,

+            compressor: {

+                ...DEFAULT_AUDIO_SETTINGS.compressor,

+                ...(safeSettings.compressor || {}),

+                customParams: {

+                    ...DEFAULT_AUDIO_SETTINGS.compressor.customParams,

+                    ...(safeSettings.compressor?.customParams || {})

+                }

+            }

+        };

+    }

+

+    function initAudioContext() {

+        if (!audioCtx) {

+            try {

+                const AudioContextClass = window.AudioContext || window.webkitAudioContext;

+                if (!AudioContextClass) return null;

+                audioCtx = new AudioContextClass({ latencyHint: 'interactive' });

+            } catch (e) {

+                reportLog(`Audio Processing unavailable: ${e.message}`, 'warn');

+                return null;

+            }

+        }

+        if (audioCtx.state === 'suspended') {

+            audioCtx.resume().catch(() => { reportLog('AudioContext resume failed - browser may need page interaction first', 'warn'); });

+        }

+        return audioCtx;

+    }

+

+    function closeAudioContext() {

+        if (audioCtx) {

+            audioCtx.close().catch(() => {});

+            audioCtx = null;

+        }

+        audioChains = new WeakMap();

+        currentAudioVideo = null;

+    }

+

+    function setupAudioChain(videoEl) {

+        if (audioChains.has(videoEl)) return audioChains.get(videoEl);

+        const ctx = initAudioContext();

+        if (!ctx) return null;

+

+        try {

+            const src = ctx.createMediaElementSource(videoEl);

+            const compressor = ctx.createDynamicsCompressor();

+            const dryGain = ctx.createGain();

+            const compGain = ctx.createGain();

+

+            src.connect(dryGain);

+            dryGain.connect(ctx.destination);

+            src.connect(compressor);

+            compressor.connect(compGain);

+            compGain.connect(ctx.destination);

+

+            dryGain.gain.value = 1;

+            compGain.gain.value = 0;

+

+            const chain = { compressor, dryGain, compGain, active: false };

+            audioChains.set(videoEl, chain);

+            currentAudioVideo = videoEl;

+            return chain;

+        } catch (e) {

+            reportLog(`Audio Processing setup failed: ${e.message}`, 'warn');

+            return null;

+        }

+    }

+

+    function rampGain(node, value, t) {

+        const current = node.gain.value;

+        node.gain.cancelScheduledValues(t);

+        node.gain.setValueAtTime(current, t);

+        node.gain.linearRampToValueAtTime(value, t + 0.04);

+    }

+

+    function applyAudioBypass(videoEl) {

+        const chain = audioChains.get(videoEl);

+        if (!chain || !chain.active) return;

+        const t = chain.dryGain.context.currentTime;

+        rampGain(chain.dryGain, 1, t);

+        rampGain(chain.compGain, 0, t);

+        chain.active = false;

+        reportLog('Audio compressor disabled', 'info');

+    }

+

+    function bypassCurrentAudioProcessing() {

+        if (currentAudioVideo) applyAudioBypass(currentAudioVideo);

+    }

+

+    function applyAudioSettings(videoEl, settings) {

+        const mergedSettings = mergeAudioSettings(settings);

+        if (!mergedSettings.enabled || !mergedSettings.compressor?.enabled) {

+            applyAudioBypass(videoEl);

+            return;

+        }

+

+        const chain = setupAudioChain(videoEl);

+        if (!chain) return;

+

+        const cSettings = mergedSettings.compressor;

+        const params = cSettings.preset === 'custom'

+            ? cSettings.customParams

+            : AUDIO_PRESETS[cSettings.preset] || AUDIO_PRESETS.recommended;

+

+        chain.compressor.threshold.value = params.threshold ?? -24;

+        chain.compressor.knee.value = params.knee ?? 15;

+        chain.compressor.ratio.value = params.ratio ?? 8;

+        chain.compressor.attack.value = params.attack ?? 0.010;

+        chain.compressor.release.value = params.release ?? 0.300;

+

+        if (!chain.active) {

+            const t = chain.dryGain.context.currentTime;

+            rampGain(chain.dryGain, 0, t);

+            rampGain(chain.compGain, 1, t);

+            chain.active = true;

+            reportLog('Audio compressor enabled', 'info');

+        }

+    }

+

+    // --- Episode Auto-Sync: Detection ---

+    function getMediaTitle() {

+        return (navigator.mediaSession && navigator.mediaSession.metadata)

+            ? navigator.mediaSession.metadata.title

+            : null;

+    }

+

+    // Extract a canonical episode identifier from a title string.

+    // Handles: S01E01, S1E1, S01 - E01, Season 1 Episode 1, "Folge 5", "Episode 5", "Ep. 5", "#5"

+    // Returns null if no episode pattern found.

+    // --- SHARED_EPISODE_UTILS_INJECT_START ---

+    // This block is automatically replaced by /scripts/build-extension.js

+    function extractEpisodeId(title) {

+        if (!title || typeof title !== 'string') return null;

+        const se = title.match(/S(?:eason\s*)?(\d+)[^a-zA-Z0-9]*E(?:pisode\s*)?(\d+)/i);

+        if (se) return `S${String(se[1]).padStart(2, '0')}E${String(se[2]).padStart(2, '0')}`;

+        const ep = title.match(/(?:Episode|Folge|Ep\.?|#)\s*(\d+)/i);

+        if (ep) return `EP${String(ep[1]).padStart(3, '0')}`;

+        return null;

+    }

+

+    function sameEpisode(titleA, titleB) {

+        if (!titleA && !titleB) return true;

+        if (!titleA || !titleB) return false;

+        const idA = extractEpisodeId(titleA);

+        const idB = extractEpisodeId(titleB);

+        if (idA && idB) return idA === idB;

+        if (idA || idB) return false;

+        return titleA === titleB;

+    }

+    // --- SHARED_EPISODE_UTILS_INJECT_END ---

+

+    // Returns true only when we are CERTAIN the episodes differ.

+    // Permissive: only blocks if BOTH titles have parseable IDs AND they differ.

+    // Films, music, unparseable titles always pass through.

+    function isDifferentEpisode(titleA, titleB) {

+        if (!titleA || !titleB) return false; // Unknown → allow

+        const idA = extractEpisodeId(titleA);

+        const idB = extractEpisodeId(titleB);

+        if (!idA || !idB) return false; // At least one unparseable → allow

+        return idA !== idB;             // Both parseable → only block if different

+    }

+

+    function checkEpisodeTransition() {

+        const currentTitle = getMediaTitle();

+        const video = findVideo();

+

+        // Only trigger if: we had a previous title, the title changed,

+        // a video exists, and we're near the start of new content.

+        if (lastKnownMediaTitle && currentTitle

+            && !sameEpisode(currentTitle, lastKnownMediaTitle)

+            && video

+            && video.currentTime < 5

+            && video.readyState >= 1) {

+            onEpisodeTransition(currentTitle);

+        }

+

+        // Always track the latest known title

+        if (currentTitle) lastKnownMediaTitle = currentTitle;

+    }

+

+    function onEpisodeTransition(newTitle) {

+        // Debounce: prevent duplicate fires from multiple signals

+        if (episodeTransitionDebounce) return;

+        episodeTransitionDebounce = setTimeout(() => {

+            episodeTransitionDebounce = null;

+        }, 2000);

+

+        reportLog(`Episode transition detected: "${newTitle}"`, 'info');

+

+        // EC-12: a new episode dissolves any solo/desync state — the guest rejoins

+        // the room for the fresh content rather than staying stuck on the old one.

+        if (hcmDesynced) hcmReset();

+

+        // Do NOT pause here. We notify background.js first.

+        // Background checks the setting; if enabled it creates a lobby

+        // and sends back PAUSE_FOR_LOBBY so we only freeze if the feature is on.

+        chrome.runtime.sendMessage({

+            type: 'EPISODE_CHANGED',

+            payload: { newTitle }

+        }).catch(() => {});

+    }

+

+    function checkAndReportLobbyReady(expectedTitle) {

+        const video = findVideo();

+        const currentTitle = getMediaTitle();

+

+        if (video && currentTitle && sameEpisode(currentTitle, expectedTitle)

+            && video.currentTime < 5 && video.readyState >= 1) {

+            // Match! Pause at start and report ready.

+            if (!video.paused) {

+                _setSuppress('paused');

+                video.pause();

+            }

+            stopLobbyPoll();

+            chrome.runtime.sendMessage({

+                type: 'EPISODE_READY_LOCAL',

+                payload: { title: currentTitle }

+            }).catch(() => {});

+            reportLog(`Episode lobby: Ready for "${currentTitle}"`, 'success');

+            return true;

+        }

+        return false;

+    }

+

+    function startLobbyPoll(expectedTitle) {

+        stopLobbyPoll();

+        _pendingLobbyTitle = expectedTitle;

+

+        // NOTE: Do NOT pause here. Three callers reach this function:

+        // 1. PAUSE_FOR_LOBBY (initiator): already paused by that handler before calling us.

+        // 2. EPISODE_LOBBY (non-initiator): peer may still be on the PREVIOUS episode — pausing

+        //    would freeze them mid-episode. The pause happens inside checkAndReportLobbyReady()

+        //    only once their title actually matches.

+        // 3. CONTENT_BOOT recovery: same reasoning as (2).

+

+        // Check immediately

+        if (checkAndReportLobbyReady(expectedTitle)) return;

+

+        // Poll every 2 seconds — no log spam, internal only

+        lobbyPollTimer = setInterval(() => {

+            checkAndReportLobbyReady(expectedTitle);

+        }, 2000);

+    }

+

+

+    function stopLobbyPoll() {

+        _pendingLobbyTitle = null;

+        if (lobbyPollTimer) {

+            clearInterval(lobbyPollTimer);

+            lobbyPollTimer = null;

+        }

+    }

+

+    function getPlayerActionFixes() {
+        return [
+            {
+                name: 'youtube-player-buttons',
+                urls: ['youtube.com'],
+                playPauseButtonSelector: '.ytp-play-button'
+            },
+            {
+                name: 'twitch-player-buttons',
+                urls: ['twitch.tv'],
+                playPauseButtonSelector: '[data-a-target="player-play-pause-button"]'
+            }
+        ];
+    }
+
+    function getActivePlayerActionFix() {
+        return getPlayerActionFixes().find(fix => matchesPlayerUrls(fix.urls)) || null;
+    }
+
+    function tryPlayerActionFix(fix, action, video, data) {
+        if (!fix) return false;
+        const button = document.querySelector(fix.playPauseButtonSelector);
+        if (!button) return false;
+
+        const isCurrentlyPlaying = !video.paused;
+        if ((action === EVENTS.PLAY && !isCurrentlyPlaying) || (action === EVENTS.PAUSE && isCurrentlyPlaying)) {
+            _setSuppress(action === EVENTS.PLAY ? 'playing' : 'paused');
+            button.click();
+        }
+        if (action === EVENTS.SEEK) {
+            seekVideo(video, data.targetTime, data.delta);
+        }
+        return true;
+    }
+
+    // --- Helper: site-specific player actions, then native HTML5 fallback ---
+    function tryMediaAction(action, data) {
+        const video = findVideo();
+        if (!video) return;
+

+        if (action === EVENTS.SEEK) {

+            const target = data ? (data.targetTime !== undefined ? data.targetTime : data.currentTime) : undefined;

+            if (!Number.isFinite(target)) {

+                reportLog(`Media Action Error: Invalid seek payload - ${JSON.stringify(data)}`, 'error');

+                return;

+            }

+            data = { ...data, targetTime: target };

+        }

+
+        try {
+            const actionFix = getActivePlayerActionFix();
+            if (tryPlayerActionFix(actionFix, action, video, data)) {
+                return;
+            }
+
+            // Fallback for native HTML5
+            if (action === EVENTS.PLAY) {

+                _setSuppress('playing');

+                video.play().catch((e) => {

+                    reportLog(`Playback prevented: ${e.message}`, 'warn');

+                    _clearSuppress('playing');

+                });

+            } else if (action === EVENTS.PAUSE) {

+                _setSuppress('paused');

+                video.pause();

+            } else if (action === EVENTS.SEEK) {
+                seekVideo(video, data.targetTime, data.delta);
+            }

+    } catch (e) {

+            reportLog(`Media Action Error: ${e.message}`, 'error');

+        }

+    }

+

+    // --- Helper: Wait until video is ready for playback (buffered & seeked) ---

+    function pollSeekReady(targetTime, timeoutMs = 8000) {

+        return new Promise((resolve) => {

+            const interval = 150;

+            let elapsed = 0;

+            const timer = setInterval(() => {

+                const video = findVideo(); // Re-query DOM on every iteration

+                if (!video) {

+                    clearInterval(timer);

+                    resolve(false);

+                    return;

+                }

+

+                elapsed += interval;

+                const current = getSyncCurrentTime(video);
+                const timeDiff = current !== null ? Math.abs(current - targetTime) : Infinity;
+                const ready = video.readyState >= 3 && timeDiff < 2.0;
+                if (ready) {

+                    clearInterval(timer);

+                    resolve(true);

+                } else if (elapsed >= timeoutMs) {

+                    clearInterval(timer);

+                    resolve(false);

+                }

+            }, interval);

+        });

+    }

+

+    // Listen for commands from background.js

+    chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {

+        if (!message) return;

+        if (message.action === 'get_current_time') {

+            const video = findVideo();

+            sendResponse({ currentTime: video ? video.currentTime : null });

+            return true;

+        }

+

+        if (message.action === 'APPLY_AUDIO_SETTINGS') {

+            _audioProcessingAllowed = true;

+            _audioSettings = mergeAudioSettings(message.settings);

+            const video = findVideo();

+            if (video) applyAudioSettings(video, _audioSettings);

+            sendResponse({ ok: true });

+            return true;

+        }

+

+        if (message.action === 'RESET_AUDIO_PROCESSING') {

+            _audioProcessingAllowed = false;

+            bypassCurrentAudioProcessing();

+            sendResponse({ ok: true });

+            return true;

+        }

+

+        // Host Control Mode: room mode/role changed.

+        if (message.type === 'CONTROL_MODE') {

+            const wasGated = hcmIsGuestGated();

+            const prevHostPeerId = hcmHostPeerId;

+            hcmControlMode = message.controlMode || 'everyone';

+            hcmAmController = !!message.amController;

+            hcmHostPeerId = message.hostPeerId || null;

+            // Reset guest-side state when leaving the gated state, OR when the

+            // host identity changes (room switch, host-leave fallback, missed

+            // teardown broadcast) — clears stale desync so a rejoin starts clean (H-3).

+            const hostChanged = prevHostPeerId !== null && hcmHostPeerId !== prevHostPeerId;

+            if ((wasGated && !hcmIsGuestGated()) || hostChanged) hcmReset();

+            sendResponse({ ok: true });

+            return true;

+        }

+

+        // Host Control Mode: background blocked our local action — handle UX locally.

+        if (message.type === 'HOST_BLOCKED') {

+            hcmHandleBlocked(message.action, message.target || null);

+            sendResponse({ ok: true });

+            return true;

+        }

+

+        // Background asks for an immediate state push (e.g. the first peer just

+        // joined while we were solo) so the newcomer syncs without waiting.

+        if (message.type === 'REQUEST_HEARTBEAT') {

+            sendHeartbeat();

+            sendResponse({ ok: true });

+            return true;

+        }

+

+        if (message.type === 'SERVER_COMMAND') {

+            const { action, payload } = message;

+            let actionCompleted = false;

+

+            // Host Control Mode: while watching on our own (desynced), don't apply

+            // host commands. Only ACK FORCE_SYNC_PREPARE — that's the one the host's

+            // force-sync flow actually waits on. Skipping CMD_ACKs for PLAY/PAUSE/SEEK

+            // is intentional so the host's UI honestly reflects that we didn't apply

+            // the command (M-2); sending them would make the host think we're synced.

+            if (hcmDesynced) {

+                const soloIgnored = [EVENTS.PLAY, EVENTS.PAUSE, EVENTS.SEEK, EVENTS.FORCE_SYNC_PREPARE, EVENTS.FORCE_SYNC_EXECUTE];

+                if (soloIgnored.includes(action)) {

+                    if (action === EVENTS.FORCE_SYNC_PREPARE) {

+                        chrome.runtime.sendMessage({ type: 'FORCE_SYNC_ACK' }).catch(() => {});

+                    }

+                    return;

+                }

+            }

+

+            // Guard: Don't execute sync commands if peers are on different episodes.

+            // Only active when autoSyncNextEpisode setting is enabled (default: on).

+            // Only blocks when BOTH sides have parseable S01E01-style IDs that differ.

+            // Films and unparseable titles always pass through.

+            const syncActions = [EVENTS.PLAY, EVENTS.PAUSE, EVENTS.SEEK,

+                                 EVENTS.FORCE_SYNC_PREPARE, EVENTS.FORCE_SYNC_EXECUTE];

+            if (_autoSyncEnabled && syncActions.includes(action)) {

+                const senderTitle = payload?.mediaTitle;

+                const myTitle = getMediaTitle();

+                if (isDifferentEpisode(senderTitle, myTitle)) {

+                    reportLog(`Episode mismatch: sender="${senderTitle || '?'}" vs mine="${myTitle || '?'}" — skipping ${action}. Disable "Auto-Sync next Episode" in settings if this causes issues.`, 'warn');

+                    if (action !== EVENTS.FORCE_SYNC_PREPARE && action !== EVENTS.FORCE_SYNC_EXECUTE) {

+                        chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId }).catch(() => {});

+                    }

+                    return;

+                }

+            }

+            

+            if (action === EVENTS.PLAY) {

+                tryMediaAction(EVENTS.PLAY);

+                chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId });

+                actionCompleted = true;

+            } else if (action === EVENTS.PAUSE) {

+                tryMediaAction(EVENTS.PAUSE);

+                chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId });

+                actionCompleted = true;

+            } else if (action === EVENTS.SEEK) {

+                tryMediaAction(EVENTS.SEEK, payload);

+                chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId });

+                actionCompleted = true;

+            } else if (action === EVENTS.FORCE_SYNC_PREPARE) {

+                if (!payload || payload.targetTime === undefined) return;

+                const video = findVideo();

+                if (video) {

+                    if (!Number.isFinite(payload.targetTime)) {

+                        reportLog(`Media Action Error: Invalid force sync payload - ${JSON.stringify(payload)}`, 'error');

+                        return;

+                    }

+                    _setSuppress('paused');

+                    video.pause();

+                    try {

+                        seekVideo(video, payload.targetTime);

+                    } catch (e) {

+                        reportLog(`Force Sync Seek Error: ${e.message}`, 'error');

+                    }

+                    pollSeekReady(payload.targetTime).then((ready) => {

+                        chrome.runtime.sendMessage({ type: 'FORCE_SYNC_ACK' }).catch(() => {});

+                        if (ready) {

+                            scheduleProactiveHeartbeat();

+                        } else {

+                            reportLog('Force Sync: Seek ready timeout, proceeding anyway', 'warn');

+                        }

+                    }).catch(() => {});

+                }

+            } else if (action === EVENTS.FORCE_SYNC_EXECUTE) {

+                stopLobbyPoll();

+                tryMediaAction(EVENTS.PLAY);

+                chrome.runtime.sendMessage({ type: 'CMD_ACK', actionTimestamp: message.actionTimestamp, commandSenderId: message.commandSenderId });

+                actionCompleted = true;

+            }

+

+            if (actionCompleted) {

+                scheduleProactiveHeartbeat();

+            }

+        }

+

+        // Episode Auto-Sync: Lobby notification from background

+        if (message.type === 'EPISODE_LOBBY') {

+            // Host Control Mode: a desynced guest is watching on their own and must

+            // not join the lobby flow. Otherwise they'd pause on title match, report

+            // ready, but then ignore the host's FORCE_SYNC_* (hcmDesynced skip in

+            // SERVER_COMMAND) and end up frozen in pause. They also can't be counted

+            // toward lobby completion (background filters them out).

+            if (hcmDesynced) {

+                sendResponse({ status: 'ignored_desynced' });

+                return true;

+            }

+            const expectedTitle = message.expectedTitle;

+            if (expectedTitle) {

+                reportLog(`Episode lobby received: waiting for "${expectedTitle}"`, 'info');

+                startLobbyPoll(expectedTitle);

+            }

+            sendResponse({ status: 'ok' });

+            return true;

+        }

+

+        // Episode Auto-Sync: Lobby cancelled by background

+        if (message.type === 'EPISODE_LOBBY_CANCEL') {

+            stopLobbyPoll();

+            sendResponse({ status: 'ok' });

+            return true;

+        }

+

+        // Episode Auto-Sync: Background confirmed lobby created, pause the video

+        if (message.type === 'PAUSE_FOR_LOBBY') {

+            const video = findVideo();

+            if (video && !video.paused) {

+                _setSuppress('paused');

+                video.pause();

+            }

+            // Start lobby poll now that we know the feature is enabled

+            if (message.expectedTitle) {

+                startLobbyPoll(message.expectedTitle);

+            }

+            sendResponse({ status: 'ok' });

+            return true;

+        }

+

+        if (message.type === 'GET_VIDEO_STATE') {

+            const video = findVideo();

+

+            const platform = (() => {

+                const h = window.location.hostname.toLowerCase();

+                if (h === 'youtube.com' || h.endsWith('.youtube.com')) return 'YouTube';

+                if (h === 'twitch.tv' || h.endsWith('.twitch.tv')) return 'Twitch';

+                if (h === 'netflix.com' || h.endsWith('.netflix.com')) return 'Netflix';

+                if (h === 'primevideo.com' || h.endsWith('.primevideo.com') || /(^|\.)amazon\.(com\.[a-z]{2}|co\.[a-z]{2}|[a-z]{2,})$/.test(h)) return 'Prime Video';

+                if (h === 'disneyplus.com' || h.endsWith('.disneyplus.com')) return 'Disney+';

+                if (h === 'hulu.com' || h.endsWith('.hulu.com')) return 'Hulu';

+                if (h === 'hbomax.com' || h.endsWith('.hbomax.com') || h === 'max.com' || h.endsWith('.max.com')) return 'Max/HBO';

+                if (h === 'vimeo.com' || h.endsWith('.vimeo.com')) return 'Vimeo';

+                if (h === 'dailymotion.com' || h.endsWith('.dailymotion.com')) return 'Dailymotion';

+                return 'Generic';

+            })();

+

+            const networkStates = ['NETWORK_EMPTY', 'NETWORK_IDLE', 'NETWORK_LOADING', 'NETWORK_NO_SOURCE'];

+            const readyStates = ['HAVE_NOTHING', 'HAVE_METADATA', 'HAVE_CURRENT_DATA', 'HAVE_FUTURE_DATA', 'HAVE_ENOUGH_DATA'];

+

+            const videoCount = document.querySelectorAll('video').length;

+            const inShadowDom = (() => {

+                let el = video;

+                while (el) {

+                    if (el.toString() === '[object ShadowRoot]') return true;

+                    el = el.parentNode;

+                }

+                // Also check if any potential host has shadow root (even if no video found)

+                if (!video) {

+                    const hosts = document.querySelectorAll('[id*="player" i], [class*="player" i], [id*="video" i], [class*="video" i]');

+                    for (const host of hosts) {

+                        if (host.shadowRoot) return true;

+                    }

+                }

+                return false;

+            })();

+

+            // Build multi-video summary for debug reports

+            const allVideos = [];

+            const allVideoEls = document.querySelectorAll('video');

+            for (let i = 0; i < allVideoEls.length; i++) {

+                const v = allVideoEls[i];

+                allVideos.push({

+                    index: i,

+                    width: v.videoWidth || v.offsetWidth || 0,

+                    height: v.videoHeight || v.offsetHeight || 0,

+                    muted: v.muted,

+                    paused: v.paused,

+                    duration: (v.duration && isFinite(v.duration)) ? Math.round(v.duration) : 0,

+                    readyState: v.readyState,

+                    src: (v.currentSrc || v.src || '').substring(0, 80),

+                    selected: v === video

+                });

+            }

+

+            if (video) {

+                const dataAttributes = {};

+                if (video.attributes) {

+                    for (const attr of video.attributes) {

+                        if (attr.name.startsWith('data-')) {

+                            dataAttributes[attr.name] = attr.value;

+                        }

+                    }

+                }

+

+                const metadata = (navigator.mediaSession && navigator.mediaSession.metadata) ? {

+                    title: navigator.mediaSession.metadata.title,

+                    artist: navigator.mediaSession.metadata.artist,

+                    album: navigator.mediaSession.metadata.album,

+                    artwork: Array.from(navigator.mediaSession.metadata.artwork || []).map(a => a.src)

+                } : null;

+

+                const errorInfo = video.error ? {

+                    code: video.error.code,

+                    message: video.error.message

+                } : null;

+

+                sendResponse({

+                    found: true,

+                    paused: video.paused,

+                    currentTime: getSyncCurrentTime(video),
+                    duration: getSyncDuration(video),
+                    nativeCurrentTime: video.currentTime,
+                    nativeDuration: Number.isFinite(video.duration) ? video.duration : 0,
+                    readyState: video.readyState,

+                    readyStateLabel: readyStates[video.readyState] || 'UNKNOWN',

+                    networkState: video.networkState,

+                    networkStateLabel: networkStates[video.networkState] || 'UNKNOWN',

+                    muted: video.muted,

+                    volume: video.volume,

+                    playbackRate: video.playbackRate,

+                    videoWidth: video.videoWidth,

+                    videoHeight: video.videoHeight,

+                    seeking: video.seeking,

+                    ended: video.ended,

+                    error: errorInfo,

+                    buffered: video.buffered && video.buffered.length > 0

+                        ? Array.from({ length: video.buffered.length }, (_, i) =>

+                            `${video.buffered.start(i).toFixed(1)}-${video.buffered.end(i).toFixed(1)}s`).join(', ')

+                        : 'none',

+                    loop: video.loop,

+                    url: window.location.href,

+                    pageTitle: document.title,

+                    id: video.id || 'none',

+                    className: video.className || 'none',

+                    src: video.src || 'none',

+                    currentSrc: video.currentSrc || 'none',

+                    dataAttributes,

+                    metadata,

+                    videoCount,

+                    inShadowDom,

+                    platform,
+                    siteQuirk: getSiteQuirkDebug(video),
+                    allVideos
+                });
+            } else {

+                sendResponse({

+                    found: false,

+                    videoCount,

+                    inShadowDom,

+                    platform,

+                    allVideos,

+                    url: window.location.href,

+                    pageTitle: document.title,

+                    metadata: (navigator.mediaSession && navigator.mediaSession.metadata) ? {

+                        title: navigator.mediaSession.metadata.title,

+                        artist: navigator.mediaSession.metadata.artist,

+                        album: navigator.mediaSession.metadata.album

+                    } : null

+                });

+            }

+        }

+    });

+

+    // Detect native events

+    // Build the relay payload from the *current* media state and send it to

+    // background.js. Re-reads the video each call so deferred (coalesced) emits

+    // carry an up-to-date position. Safe with no/invalid video — it no-ops.

+    function sendContentEvent(action) {

+        const video = findVideo();

+        if (!video) return;

+

+        const current = getSyncCurrentTime(video);
+        if (current === null) return;
+

+        const mediaTitle = (navigator.mediaSession && navigator.mediaSession.metadata) ? navigator.mediaSession.metadata.title : null;

+

+        chrome.runtime.sendMessage({

+            type: 'CONTENT_EVENT',

+            action,

+            payload: {

+                currentTime: current,

+                targetTime: current,

+                mediaTitle: mediaTitle,

+                timestamp: Date.now()

+            }

+        }).catch(() => {});

+

+        // Trigger proactive heartbeat to push stabilized state

+        scheduleProactiveHeartbeat();

+    }

+

+    // Trailing-edge flush of a coalesced play/pause burst: emit the final settled

+    // state. No-ops only when no burst followed the leading edge. We do NOT skip

+    // when the state matches the leading send — a remote command may have changed

+    // the shared state mid-window, so re-sending is the safe (idempotent) choice.

+    function flushPlayPause() {

+        playPauseCoalesceTimer = null;

+        const finalAction = pendingPlayPauseAction;

+        pendingPlayPauseAction = null;

+        // No burst follow-up (only the leading edge fired), or invalid state.

+        if (finalAction !== EVENTS.PLAY && finalAction !== EVENTS.PAUSE) return;

+        sendContentEvent(finalAction);

+    }

+

+    function reportEvent(action) {

+        if (seekDebounceTimer && (action === EVENTS.PLAY || action === EVENTS.PAUSE)) {

+            clearTimeout(seekDebounceTimer);

+            seekDebounceTimer = null;

+            const v = findVideo();

+            if (v) {
+                const syncTime = getSyncCurrentTime(v);
+                if (syncTime === null) return;
+                lastReportedSeekTime = syncTime;
+                reportLog(`[Seek] Debounce flushed immediately due to ${action.toUpperCase()}`, 'info');
+                reportEvent(EVENTS.SEEK);
+            }
+        }

+

+        const video = findVideo();

+        if (!video) return;

+

+        const current = getSyncCurrentTime(video);
+        if (current === null) return;
+

+        const eventState = action === EVENTS.PLAY ? 'playing' : (action === EVENTS.PAUSE ? 'paused' : (action === EVENTS.SEEK ? 'seek' : null));

+

+        // Echo-suppression for remotely-applied commands. MUST stay synchronous

+        // on event arrival: the suppress timer is short-lived (300ms) and would

+        // expire if deferred, leaking an echo back to peers.

+        if (_suppressTimers[eventState]) {

+            _clearSuppress(eventState);

+            return;

+        }

+

+        // Suppress only SEEK during visibility grace period (tab re-focus ghost jump).

+        // Play/Pause pass through — user may want to immediately pause after tabbing back.

+        if (Date.now() < visibilityGraceUntil && action === EVENTS.SEEK) return;

+

+        // Coalesce play/pause bursts (source swaps, ABR, ads, teardown). The

+        // synchronous gates above have already run; only the network emit is

+        // governed here. Leading edge sends the first event instantly; further

+        // events within the window are collapsed to the final state by the

+        // trailing flush. A pending burst is REPLACED, never dropped — the last

+        // event in the window always wins.

+        if (action === EVENTS.PLAY || action === EVENTS.PAUSE) {

+            if (playPauseCoalesceTimer === null) {

+                // Window closed → fresh action. Emit now (zero added latency).

+                sendContentEvent(action);

+                pendingPlayPauseAction = null;

+            } else {

+                // Window open → part of a burst. Defer to the trailing flush.

+                pendingPlayPauseAction = action;

+                clearTimeout(playPauseCoalesceTimer);

+            }

+            playPauseCoalesceTimer = setTimeout(flushPlayPause, PLAY_PAUSE_COALESCE_MS);

+            return;

+        }

+

+        // SEEK (and any non play/pause action): emit immediately.

+        sendContentEvent(action);

+    }

+

+    // --- Tab Visibility Handling ---

+    // Browsers (especially Firefox) aggressively throttle background tabs.

+    // When the user returns to a video tab, the video element may have lost

+    // time-sync and fires spurious seek events as it recovers (jumping back).

+    // We suppress only SEEK for a short grace period after tab re-focus.

+    // Play/Pause are NOT suppressed — the user may legitimately want to

+    // pause immediately after switching back.

+    let pageVisible = !document.hidden;

+    let visibilityGraceUntil = 0;

+    const VISIBILITY_GRACE_MS = 300;

+

+    document.addEventListener('visibilitychange', () => {

+        if (document.hidden) {

+            pageVisible = false;

+        } else if (!pageVisible) {

+            pageVisible = true;

+            visibilityGraceUntil = Date.now() + VISIBILITY_GRACE_MS;

+            reportLog(`Tab re-focused — suppressing seeks for ${VISIBILITY_GRACE_MS / 1000}s to prevent ghost relay`, 'warn');

+        }

+    });

+

+    // Reset on page hide/show (bfcache, tab discard)

+    window.addEventListener('pagehide', () => {

+        pageVisible = false;

+        closeAudioContext();

+        if (keepAlivePort) { try { keepAlivePort.disconnect(); } catch (_e) { /* ignore */ } keepAlivePort = null; }

+        if (lobbyPollTimer) { clearInterval(lobbyPollTimer); lobbyPollTimer = null; }

+        if (heartbeatTimeout) { clearTimeout(heartbeatTimeout); heartbeatTimeout = null; }

+        if (proactiveHeartbeatTimeout) { clearTimeout(proactiveHeartbeatTimeout); proactiveHeartbeatTimeout = null; }

+        // Drop any pending coalesced play/pause: we are tearing down and will

+        // disconnect — peers learn we are gone via PEER_STATUS 'left'. This also

+        // intentionally suppresses the teardown play/pause burst at the source.

+        if (playPauseCoalesceTimer) { clearTimeout(playPauseCoalesceTimer); playPauseCoalesceTimer = null; pendingPlayPauseAction = null; }

+        observer.disconnect();

+    });

+    window.addEventListener('pageshow', (event) => {

+        // event.persisted is true ONLY when restored from bfcache, not on initial load

+        if (event.persisted && !pageVisible) {

+            pageVisible = true;

+            visibilityGraceUntil = Date.now() + VISIBILITY_GRACE_MS;

+            reportLog(`Page restored from cache — suppressing seeks for ${VISIBILITY_GRACE_MS / 1000}s`, 'warn');

+        }

+    });

+

+    const handlePlay = () => reportEvent(EVENTS.PLAY);

+    const handlePause = () => reportEvent(EVENTS.PAUSE);

+    // Host Control Mode: a 'waiting' (buffering) event opens a grace window so the

+    // pause it may trigger isn't misread as a deliberate guest action (EC-1).

+    const handleWaiting = () => { hcmBufferingUntil = Date.now() + HCM_BUFFERING_GRACE_MS; };

+

+    // Seek filtering: ignore HLS/DASH buffering micro-seeks.

+    // Only relay if delta >= MIN_SEEK_DELTA AND not already debouncing.

+    const handleSeeked = () => {

+        const video = findVideo();

+        if (!video) return;

+        const current = getSyncCurrentTime(video);
+        if (current === null) return;
+

+        // Step 1: Check expectedSeekTime (programmatic seek from remote peer)

+        if (expectedSeekTime !== null) {

+            if (Math.abs(current - expectedSeekTime) < 1.0) {

+                // Video arrived at expected time. Safely clear and ignore.

+                expectedSeekTime = null;

+                lastReportedSeekTime = current;

+                return;

+            } else {

+                // User manually scrubbed to a DIFFERENT time while we were buffering

+                expectedSeekTime = null;

+            }

+        }

+

+        // Step 2: Suppress during visibility grace period (tab re-focus ghost events)

+        if (Date.now() < visibilityGraceUntil) return;

+

+        const delta = lastReportedSeekTime !== null ? Math.abs(current - lastReportedSeekTime) : null;

+        const deltaStr = delta !== null ? `Δ${delta.toFixed(2)}s` : 'Δ?';

+

+        // Step 3: Delta check — skip micro-seeks (buffering, chapter markers, etc.)

+        if (lastReportedSeekTime !== null && delta < MIN_SEEK_DELTA) {

+            reportLog(`[Seek] Filtered (${deltaStr} < ${MIN_SEEK_DELTA}s threshold) @ ${current.toFixed(2)}s — not relayed`, 'warn');

+            return;

+        }

+

+        // Step 4: Debounce rapid consecutive seeks (e.g. scrubbing)

+        // — wait 300ms for the user to settle before relaying

+        if (seekDebounceTimer) clearTimeout(seekDebounceTimer);

+        seekDebounceTimer = setTimeout(() => {

+            seekDebounceTimer = null;

+            const v = findVideo();

+            if (!v) return;

+            const settled = getSyncCurrentTime(v);
+            if (settled === null) return;
+            const finalDelta = lastReportedSeekTime !== null ? Math.abs(settled - lastReportedSeekTime) : null;

+            const finalDeltaStr = finalDelta !== null ? `Δ${finalDelta.toFixed(2)}s` : 'Δ?';

+            lastReportedSeekTime = settled;

+            reportLog(`[Seek] Relayed @ ${settled.toFixed(2)}s (${finalDeltaStr})`, 'info');

+            reportEvent(EVENTS.SEEK);

+        }, 300);

+    };

+

+

+    let lastVideoSrc = undefined;

+

+    // Episode detection handler for loadeddata event

+    const handleLoadedData = () => {

+        checkEpisodeTransition();

+    };

+

+    function setupListeners() {

+        const video = findVideo();

+        if (video) {

+            if (currentAudioVideo && currentAudioVideo !== video) {

+                bypassCurrentAudioProcessing();

+            }

+            const existing = video._koalaHandlers;

+            if (existing) {

+                video.removeEventListener('play', existing.play);

+                video.removeEventListener('pause', existing.pause);

+                video.removeEventListener('seeked', existing.seeked);

+                video.removeEventListener('loadeddata', existing.loadeddata);

+                if (existing.waiting) video.removeEventListener('waiting', existing.waiting);

+            }

+            video._koalaHandlers = { play: handlePlay, pause: handlePause, seeked: handleSeeked, loadeddata: handleLoadedData, waiting: handleWaiting };

+

+            video.addEventListener('play', handlePlay);

+            video.addEventListener('pause', handlePause);

+            video.addEventListener('seeked', handleSeeked);

+            video.addEventListener('loadeddata', handleLoadedData);

+            video.addEventListener('waiting', handleWaiting);

+            video.dataset.koalaAttached = 'true';

+            lastVideoSrc = video.currentSrc || video.src || null;

+

+            if (!lastKnownMediaTitle) {

+                lastKnownMediaTitle = getMediaTitle();

+            }

+

+            if (_audioSettings && _audioProcessingAllowed) applyAudioSettings(video, _audioSettings);

+        }

+    }

+

+    // SPA Navigation Handler (MutationObserver)

+    let lastMutate = 0;

+    let observerTimeout = null;

+

+    function checkVideo() {

+        lastMutate = Date.now();

+        const video = findVideo();

+

+        if (!video && lastVideoSrc !== undefined) {

+            reportLog('Video element removed from page', 'warn');

+            lastVideoSrc = undefined;

+            closeAudioContext();

+            return;

+        }

+

+        if (!video) return;

+

+        const currentSrc = video.currentSrc || video.src || null;

+

+        if (!video.dataset.koalaAttached || (lastVideoSrc !== undefined && currentSrc && lastVideoSrc !== currentSrc)) {

+            if (lastVideoSrc !== undefined && currentSrc && lastVideoSrc !== currentSrc) {

+                checkEpisodeTransition();

+            }

+            setupListeners();

+        }

+    }

+

+    const observer = new MutationObserver(() => {

+        const now = Date.now();

+        if (now - lastMutate >= 1000) {

+            checkVideo();

+        } else {

+            if (observerTimeout) clearTimeout(observerTimeout);

+            observerTimeout = setTimeout(checkVideo, 1000 - (now - lastMutate));

+        }

+    });

+    observer.observe(document.documentElement, { childList: true, subtree: true });

+

+    // --- SHARED_HEARTBEAT_INJECT_START ---

+    const HEARTBEAT_INTERVAL_VAL = 15000;

+    // --- SHARED_HEARTBEAT_INJECT_END ---

+

+    // Heartbeat Refactoring (Self-scheduling setTimeout with proactive heartbeat scheduling)

+    let heartbeatTimeout = null;

+    let proactiveHeartbeatTimeout = null;

+    let heartbeatErrorCount = 0;

+

+    function sendHeartbeat() {

+        const video = findVideo();

+        if (!video) return;

+

+        const mediaTitle = (navigator.mediaSession && navigator.mediaSession.metadata) ? navigator.mediaSession.metadata.title : null;

+        chrome.runtime.sendMessage({

+            type: 'HEARTBEAT',

+            payload: {

+                playbackState: video.paused ? 'paused' : 'playing',

+                currentTime: getSyncCurrentTime(video),
+                mediaTitle: mediaTitle,

+                volume: video.volume,

+                muted: video.muted

+            }

+        }).catch(err => {

+            if (err.message.includes('Extension context invalidated')) {

+                heartbeatErrorCount++;

+                if (heartbeatErrorCount === 1) {

+                    reportLog('Extension reloaded. Please refresh the page if sync stops working.', 'warn');

+                }

+                if (heartbeatTimeout) clearTimeout(heartbeatTimeout);

+                if (proactiveHeartbeatTimeout) clearTimeout(proactiveHeartbeatTimeout);

+                observer.disconnect();

+            }

+        });

+    }

+

+    function schedulePeriodicHeartbeat() {

+        if (heartbeatTimeout) clearTimeout(heartbeatTimeout);

+        heartbeatTimeout = setTimeout(() => {

+            sendHeartbeat();

+            schedulePeriodicHeartbeat();

+        }, HEARTBEAT_INTERVAL_VAL);

+    }

+

+    function scheduleProactiveHeartbeat() {

+        if (proactiveHeartbeatTimeout) clearTimeout(proactiveHeartbeatTimeout);

+        proactiveHeartbeatTimeout = setTimeout(() => {

+            sendHeartbeat();

+            schedulePeriodicHeartbeat(); // Reschedules the next periodic check to be exactly 15s from now

+        }, 500); // 500ms stabilization delay

+    }

+

+    // Initial Setup

+    setupListeners();

+

+    // Maintain a persistent keep-alive port connection to prevent background SW suspension

+    let keepAlivePort = null;

+    function connectKeepAlivePort() {

+        try {

+            if (chrome.runtime.id) {

+                keepAlivePort = chrome.runtime.connect({ name: 'keepAlive' });

+                keepAlivePort.onDisconnect.addListener(() => {

+                    keepAlivePort = null;

+                    setTimeout(connectKeepAlivePort, 1000);

+                });

+            }

+        } catch (_e) {

+            // Extension context invalidated or disabled

+        }

+    }

+    connectKeepAlivePort();

+

+    schedulePeriodicHeartbeat();

+

+    // Immediate heartbeat on injection — populate peer data without waiting 15s

+    setTimeout(() => sendHeartbeat(), 300);

+

+    // Episode Auto-Sync: Boot recovery — check if background has an active lobby

+    chrome.runtime.sendMessage({ type: 'CONTENT_BOOT' }, (res) => {

+        if (chrome.runtime.lastError) return;

+        if (res && res.lobbyActive && res.expectedTitle) {

+            reportLog(`Boot: Active lobby detected for "${res.expectedTitle}"`, 'info');

+            startLobbyPoll(res.expectedTitle);

+        }

+    });

+

+    // Host Control Mode: fetch current room mode/role on injection (we may have

+    // been injected after ROOM_DATA already arrived, missing the broadcast).

+    chrome.runtime.sendMessage({ type: 'GET_CONTROL_MODE' }, (res) => {

+        if (chrome.runtime.lastError || !res) return;

+        hcmControlMode = res.controlMode || 'everyone';

+        hcmAmController = !!res.amController;

+        hcmHostPeerId = res.hostPeerId || null;

+        // Re-adopt persisted desync after a page reload so we don't start synced

+        // while background still relays us as "Solo" to the host (split-brain).

+        // Only when we're actually a gated guest — never adopt a stale flag as a

+        // controller or in 'everyone' mode (would self-label "Solo" / ignore commands).

+        if (res.desynced && res.controlMode === 'host-only' && !res.amController && !hcmDesynced) {

+            hcmDesynced = true;

+            hcmShowBadge();

+        }

+    });

+

+    // Pull localized strings for the in-page dialog/badge (English fallback above).

+    chrome.runtime.sendMessage({ type: 'GET_HCM_STRINGS' }, (res) => {

+        if (chrome.runtime.lastError || !res) return;

+        Object.keys(hcmStrings).forEach(k => { if (res[k]) hcmStrings[k] = res[k]; });

+        // If the badge is already showing (early desync), refresh its text in place.

+        // Re-creating the host element nukes the click target mid-poll and can drop a

+        // click that landed between remove() and the re-create (L-4).

+        if (hcmBadgeHost) {

+            const span = hcmBadgeHost.shadowRoot && hcmBadgeHost.shadowRoot.querySelector('span');

+            if (span) span.textContent = '● ' + hcmStrings.badge;

+        }

+    });

+

+})();

diff --git a/extension/page-api-seek-overrides.js b/extension/page-api-seek-overrides.js
index 58532ed..60c9041 100644
--- a/extension/page-api-seek-overrides.js
+++ b/extension/page-api-seek-overrides.js
@@ -1,6 +1,10 @@
 (function(root) {
-    const PAGE_API_SEEK_PROVIDERS = [
-        { domain: 'netflix.com', provider: 'netflix' } // Avoids M7375 when seeking via video.currentTime.
+    const PAGE_API_SEEK_FIXES = [
+        {
+            name: 'netflix-page-api-seek',
+            urls: ['netflix.com'],
+            provider: 'netflix'
+        }
     ];
 
     function normalizeHost(input) {
@@ -12,12 +16,16 @@
     }
 
     function matchesDomain(host, domain) {
-        return host === domain || host.endsWith(`.${domain}`);
+        const normalizedDomain = normalizeHost(domain);
+        return normalizedDomain && (host === normalizedDomain || host.endsWith(`.${normalizedDomain}`));
     }
 
-    root.KOALA_PAGE_API_SEEK_PROVIDERS = PAGE_API_SEEK_PROVIDERS;
+    root.KOALA_PAGE_API_SEEK_FIXES = PAGE_API_SEEK_FIXES;
+    root.KOALA_PAGE_API_SEEK_PROVIDERS = PAGE_API_SEEK_FIXES;
     root.koalaFindPageApiSeekProvider = (input) => {
         const host = normalizeHost(input);
-        return PAGE_API_SEEK_PROVIDERS.find(entry => matchesDomain(host, entry.domain)) || null;
+        return PAGE_API_SEEK_FIXES.find(entry =>
+            Array.isArray(entry.urls) && entry.urls.some(url => matchesDomain(host, url))
+        ) || null;
     };
 })(globalThis);
diff --git a/extension/popup.js b/extension/popup.js
index 294dcb6..6cbb31e 100644
--- a/extension/popup.js
+++ b/extension/popup.js
@@ -74,7 +74,8 @@ const elements = {
     syncTabCopyInvite: document.getElementById('syncTabCopyInvite'),
     devToolsTabBtn: document.getElementById('devToolsTabBtn'),
     remoteSeekBack: document.getElementById('remoteSeekBack'),
-    remoteSeekForward: document.getElementById('remoteSeekForward')
+    remoteSeekForward: document.getElementById('remoteSeekForward'),
+    remoteSeekFiveMin: document.getElementById('remoteSeekFiveMin')
 };
 
 let localPeerId = null;
@@ -1708,8 +1709,8 @@ elements.pauseBtn.addEventListener('click', () => {
     }, 2500);
 });
 
-function simulateRemoteSeek(delta) {
-    chrome.runtime.sendMessage({ type: 'DEV_SIMULATE_REMOTE_SEEK', delta }, (res) => {
+function simulateRemoteSeek({ delta = null, targetTime = null }) {
+    chrome.runtime.sendMessage({ type: 'DEV_SIMULATE_REMOTE_SEEK', delta, targetTime }, (res) => {
         if (chrome.runtime.lastError || !res || res.status !== 'ok') {
             showToast(res?.message || 'Remote seek failed', 'error');
             return;
@@ -1720,10 +1721,13 @@ function simulateRemoteSeek(delta) {
 }
 
 if (elements.remoteSeekBack) {
-    elements.remoteSeekBack.addEventListener('click', () => simulateRemoteSeek(-30));
+    elements.remoteSeekBack.addEventListener('click', () => simulateRemoteSeek({ delta: -30 }));
 }
 if (elements.remoteSeekForward) {
-    elements.remoteSeekForward.addEventListener('click', () => simulateRemoteSeek(30));
+    elements.remoteSeekForward.addEventListener('click', () => simulateRemoteSeek({ delta: 30 }));
+}
+if (elements.remoteSeekFiveMin) {
+    elements.remoteSeekFiveMin.addEventListener('click', () => simulateRemoteSeek({ targetTime: 300 }));
 }
 
 elements.clearLogs.addEventListener('click', () => {
@@ -2083,6 +2087,26 @@ elements.copyLogs.addEventListener('click', () => {
             lines.push(`- **ReadyState:** ${readyOk ? '\u2705' : '\u26A0\uFE0F'} ${safe(vs.readyState, '?')} (${readyLabel})`);
             lines.push(`- **Network:** ${safe(vs.networkState, '?')} (${netLabel})`);
             lines.push(`- **Buffered:** ${safe(vs.buffered, '?')}`);
+            if (vs.nativeCurrentTime != null || vs.nativeDuration != null) {
+                lines.push(`- **Native Time:** ${safe(vs.nativeCurrentTime, '?')}s / ${safe(vs.nativeDuration, '?')}s`);
+            }
+            if (vs.siteQuirk) {
+                const quirk = vs.siteQuirk;
+                const label = quirk.name || quirk.key || 'site';
+                if (quirk.timeline) {
+                    lines.push(`- **${label} Timeline:** ${safe(quirk.timeline.current, '?')}s / ${safe(quirk.timeline.duration, '?')}s`);
+                }
+                const candidates = Array.isArray(quirk.timelineCandidates) ? quirk.timelineCandidates : [];
+                if (candidates.length > 0) {
+                    lines.push(`- **${label} Timeline Candidates:**`);
+                    candidates.forEach(c => lines.push(`  - ${safe(c.source, '?')}: ${safe(c.current, '?')}s / ${safe(c.duration, '?')}s`));
+                }
+                const buttons = Array.isArray(quirk.seekButtons) ? quirk.seekButtons : [];
+                if (buttons.length > 0) {
+                    lines.push(`- **${label} Buttons:**`);
+                    buttons.forEach(label => lines.push(`  - ${label}`));
+                }
+            }
             lines.push(`- **Dimensions:** ${safe(vs.videoWidth, '?')}x${safe(vs.videoHeight, '?')}${dimOk ? '' : ' \u26A0\uFE0F 0x0'}`);
             lines.push(`- **Muted:** ${safe(vs.muted, '?')} | **Volume:** ${safe(vs.volume, '?')} | **Speed:** ${safe(vs.playbackRate, '?')}x`);
             lines.push(`- **Seeking:** ${safe(vs.seeking, '?')} | **Ended:** ${safe(vs.ended, '?')} | **Loop:** ${safe(vs.loop, '?')}`);
@@ -2256,6 +2280,18 @@ function refreshDebugInfo() {
                 addField('Network', `${state.networkState} (${state.networkStateLabel || '?'})`,
                     state.networkState === 1 ? '#22c55e' : state.networkState === 3 ? '#ef4444' : 'var(--text-muted)');
                 addField('Buffered', state.buffered || '?');
+                if (state.nativeCurrentTime != null || state.nativeDuration != null) {
+                    addField('Native Time', `${state.nativeCurrentTime ?? '?'}s / ${state.nativeDuration ?? '?'}s`);
+                }
+                if (state.siteQuirk) {
+                    const quirk = state.siteQuirk;
+                    const label = quirk.name || quirk.key || 'Site';
+                    if (quirk.timeline) {
+                        addField(`${label} Timeline`, `${quirk.timeline.current ?? '?'}s / ${quirk.timeline.duration ?? '?'}s`);
+                    }
+                    const buttons = Array.isArray(quirk.seekButtons) ? quirk.seekButtons.slice(0, 4).join(' | ') : '';
+                    if (buttons) addField(`${label} Buttons`, buttons);
+                }
 
                 addSection('Properties');
                 addField('Seeking', String(state.seeking));
diff --git a/scripts/test-content-video-finder.cjs b/scripts/test-content-video-finder.cjs
index a80443b..b9c5e3c 100644
--- a/scripts/test-content-video-finder.cjs
+++ b/scripts/test-content-video-finder.cjs
@@ -19,6 +19,14 @@ function extractFunction(name, text) {
   throw new Error(`${name} body did not terminate`);
 }
 
+function makeSeekable(ranges = []) {
+  return {
+    length: ranges.length,
+    start(i) { return ranges[i][0]; },
+    end(i) { return ranges[i][1]; }
+  };
+}
+
 function makeVideo(name, width, height, options = {}) {
   return {
     name,
@@ -28,7 +36,9 @@ function makeVideo(name, width, height, options = {}) {
     offsetWidth: width,
     offsetHeight: height,
     muted: options.muted ?? true,
-    duration: options.duration ?? 0
+    duration: options.duration ?? 0,
+    currentTime: options.currentTime ?? 0,
+    seekable: options.seekable ?? makeSeekable()
   };
 }
 
@@ -61,4 +71,100 @@ assert.strictEqual(
   'findVideo should score Shadow DOM videos together with light DOM videos'
 );
 
+function makeDocument(nodes = []) {
+  return {
+    querySelectorAll() { return nodes; }
+  };
+}
+
+function makeNode(attrs = {}, textContent = '') {
+  return {
+    textContent,
+    value: attrs.value,
+    max: attrs.max,
+    clicked: 0,
+    click() { this.clicked += 1; },
+    getAttribute(name) { return attrs[name] ?? null; }
+  };
+}
+
+function loadTimelineFns(hostname, document = makeDocument()) {
+  return Function('window', 'document', [
+    'let lastDisneyPlusTimelineCandidates = [];',
+    extractFunction('hostMatchesUrl', source),
+    extractFunction('matchesPlayerUrls', source),
+    extractFunction('isDisneyPlusHost', source),
+    extractFunction('getSeekableRange', source),
+    extractFunction('parseClockTime', source),
+    extractFunction('parseTimelineText', source),
+    extractFunction('getDisneyPlusUiTimeline', source),
+    extractFunction('getElementLabel', source),
+    extractFunction('getDisneyPlusSeekButtonLabels', source),
+    extractFunction('clickDisneyPlusRelativeSeek', source),
+    extractFunction('getDisneyPlusTimeline', source),
+    extractFunction('getSiteQuirkAdapters', source),
+    extractFunction('getActiveSiteQuirk', source),
+    extractFunction('getSiteQuirkTimeline', source),
+    extractFunction('getSiteQuirkDebug', source),
+    extractFunction('getSyncCurrentTime', source),
+    extractFunction('getSyncDuration', source),
+    extractFunction('toNativeSeekTime', source),
+    'return { getActiveSiteQuirk, getSyncCurrentTime, getSyncDuration, toNativeSeekTime, clickDisneyPlusRelativeSeek };'
+  ].join('\n'))({ location: { hostname } }, document);
+}
+
+function loadPlayerFixFns(hostname) {
+  return Function('window', [
+    extractFunction('hostMatchesUrl', source),
+    extractFunction('matchesPlayerUrls', source),
+    extractFunction('getPlayerActionFixes', source),
+    extractFunction('getActivePlayerActionFix', source),
+    'return { getPlayerActionFixes, getActivePlayerActionFix };'
+  ].join('\n'))({ location: { hostname } });
+}
+
+const disneyUiDocument = makeDocument([
+  makeNode({ 'aria-valuetext': '0:09 / 180:00' })
+]);
+const disneyFns = loadTimelineFns('www.disneyplus.com', disneyUiDocument);
+assert.equal(disneyFns.getActiveSiteQuirk().name, 'disneyplus-timeline-and-buttons');
+assert.deepEqual(disneyFns.getActiveSiteQuirk().urls, ['disneyplus.com']);
+const disneyVideo = makeVideo('disney-offset', 1920, 1080, {
+  currentTime: 29,
+  duration: 0,
+  seekable: makeSeekable([[0, 32400]])
+});
+assert.equal(disneyFns.getSyncCurrentTime(disneyVideo), 9);
+assert.equal(disneyFns.getSyncDuration(disneyVideo), 10800);
+assert.equal(disneyFns.toNativeSeekTime(disneyVideo, 39), 119);
+
+const disneySeekableFallbackFns = loadTimelineFns('www.disneyplus.com');
+const disneyOffsetVideo = makeVideo('disney-offset', 1920, 1080, {
+  currentTime: 29,
+  duration: 0,
+  seekable: makeSeekable([[20, 10820]])
+});
+assert.equal(disneySeekableFallbackFns.getSyncCurrentTime(disneyOffsetVideo), 9);
+assert.equal(disneySeekableFallbackFns.getSyncDuration(disneyOffsetVideo), 10800);
+assert.equal(disneySeekableFallbackFns.toNativeSeekTime(disneyOffsetVideo, 39), 59);
+
+const genericFns = loadTimelineFns('example.com');
+assert.equal(genericFns.getActiveSiteQuirk(), null);
+assert.equal(genericFns.getSyncCurrentTime(disneyVideo), 29);
+assert.equal(genericFns.getSyncDuration(disneyVideo), 0);
+assert.equal(genericFns.toNativeSeekTime(disneyVideo, 39), 39);
+
+const backButton = makeNode({ 'aria-label': '10 Sekunden zurück' });
+const forwardButton = makeNode({ 'aria-label': '10 Sekunden vorspulen' });
+const disneyButtonFns = loadTimelineFns('www.disneyplus.com', makeDocument([backButton, forwardButton]));
+assert.equal(disneyButtonFns.clickDisneyPlusRelativeSeek(-30), true);
+assert.equal(disneyButtonFns.clickDisneyPlusRelativeSeek(30), true);
+
+const twitchFixFns = loadPlayerFixFns('player.twitch.tv');
+assert.equal(twitchFixFns.getActivePlayerActionFix().name, 'twitch-player-buttons');
+assert.deepEqual(twitchFixFns.getActivePlayerActionFix().urls, ['twitch.tv']);
+
+const genericFixFns = loadPlayerFixFns('example.com');
+assert.equal(genericFixFns.getActivePlayerActionFix(), null);
+
 console.log('content video finder tests passed');
diff --git a/website/assets/NewLogoIcon_64.webp b/website/assets/NewLogoIcon_64.webp
index 660ffe28987821948744dafb8543121d3c9924ee..b1f4e43ede2c8f7304360593b419303eb296c0d2 100644
GIT binary patch
delta 175
zcmV;g08sye3W5r-j{*uP3wTE6hMStHV6&M5(*b{}TcN{oo+V6*L_a%Yrc!p2D?t#c
zOKs7r7~J4m$Dv1=mJaDq77GQQQ>rw7XYD@K>HoHNx9RHcyI5?-@+?sg|AU>&-G4md
zD$=Kt1fjo2eO@GCUGUCe6T6+N5TM#$rGCu%%0C_&{K4-ZrketIuEE5-AGFN%Jt!V_
dA-)%z8o>$A#3xK?o>SG_`v#;TD2(v9006+KRrvq_

delta 175
zcmV;g08sye3W5r-j{*uRbh!h)p{C}lShJY|(*b{`0tbHB-=W1lvs8JmTg?5P$6NU|
zO#PNrF}c9Ck3x?#EFIFIEEWqqr&MVE&)R*f)BkMkZ`0M?cCguv<XEB~{|7sly8d~@
zRi#fP2}6F4`n*WOyWyO`=q~VL0Ooo5E9abon$}J<ILvCrjPmN9T=EIoYf$hn#5QI8
dPuCa041mkIUP&THprz?#XmVYp*&&Yr001i7TQdLv


From ce522e2ab7bc5a29f0926556cafbd976f92ad8ab Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:01:14 +0200
Subject: [PATCH 08/22] Safeguard Netflix player session ID lookup in
 background.js

---
 extension/background.js | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/extension/background.js b/extension/background.js
index 5f95b5d..d0c8543 100644
--- a/extension/background.js
+++ b/extension/background.js
@@ -1672,7 +1672,8 @@ function installPageApiSeekBridge() {
         try {
             if (match.provider === 'netflix') {
                 const videoPlayer = window.netflix?.appContext?.state?.playerApp?.getAPI?.().videoPlayer;
-                const sessionId = videoPlayer?.getAllPlayerSessionIds?.()[0];
+                const ids = videoPlayer?.getAllPlayerSessionIds?.();
+                const sessionId = ids ? ids[0] : null;
                 const player = sessionId ? videoPlayer.getVideoPlayerBySessionId(sessionId) : null;
                 player?.seek(Math.round(time * 1000));
             }

From 066d2c9407b50ae08dee36938392f89948166d71 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:19:47 +0200
Subject: [PATCH 09/22] Implement temporary Media Session interceptor
 diagnostics for Disney+ and restore Netflix sessionId lookup guard

---
 extension/background.js | 53 ++++++++++++++++++++++++++++++++++++++++-
 extension/content.js    | 11 ++++++++-
 extension/popup.js      |  4 ++++
 3 files changed, 66 insertions(+), 2 deletions(-)

diff --git a/extension/background.js b/extension/background.js
index d0c8543..a33ca9c 100644
--- a/extension/background.js
+++ b/extension/background.js
@@ -1654,6 +1654,42 @@ async function devRemoteToolsAllowed() {
     return data.username === 'KoalaDev';
 }
 
+const mediaSessionInterceptorHosts = [
+    'disneyplus.com'
+];
+
+function shouldInstallMediaSessionInterceptor(url) {
+    try {
+        const host = new URL(url).hostname.toLowerCase();
+        return mediaSessionInterceptorHosts.some(h => host === h || host.endsWith('.' + h));
+    } catch (_e) {
+        return false;
+    }
+}
+
+function installMediaSessionInterceptor() {
+    if (window.__koalaMediaSessionInterceptorInstalled) return;
+    window.__koalaMediaSessionInterceptorInstalled = true;
+    if (!navigator.mediaSession || typeof navigator.mediaSession.setPositionState !== 'function') return;
+
+    const originalSet = navigator.mediaSession.setPositionState;
+    navigator.mediaSession.setPositionState = function(state) {
+        try {
+            window.postMessage({
+                __koalaMediaSessionCapture: 1,
+                state: {
+                    duration: state?.duration,
+                    playbackRate: state?.playbackRate,
+                    position: state?.position
+                }
+            }, '*');
+        } catch (_e) {
+            // Suppress errors to not interfere with player
+        }
+        return originalSet.apply(navigator.mediaSession, arguments);
+    };
+}
+
 function shouldUsePageApiSeek(url) {
     return typeof globalThis.koalaFindPageApiSeekProvider === 'function' &&
         !!globalThis.koalaFindPageApiSeekProvider(url);
@@ -1697,9 +1733,12 @@ function setPageApiSeekEnabled(enabled) {
 async function injectContentScript(tabId) {
     let needsPageApiSeek = false;
     let pageApiSeekReady = false;
+    let isMediaSessionCapable = false;
     try {
         const tab = await chrome.tabs.get(tabId);
-        needsPageApiSeek = shouldUsePageApiSeek(tab?.url || '');
+        const url = tab?.url || '';
+        needsPageApiSeek = shouldUsePageApiSeek(url);
+        isMediaSessionCapable = shouldInstallMediaSessionInterceptor(url);
     } catch (_e) {
         // Fall through to the generic content script injection.
     }
@@ -1722,6 +1761,18 @@ async function injectContentScript(tabId) {
         }
     }
 
+    if (isMediaSessionCapable) {
+        try {
+            await chrome.scripting.executeScript({
+                target: { tabId },
+                world: 'MAIN',
+                func: installMediaSessionInterceptor
+            });
+        } catch (err) {
+            addLog(`Media Session interceptor injection failed: ${err.message}`, 'warn');
+        }
+    }
+
     await chrome.scripting.executeScript({
         target: { tabId },
         files: ['page-api-seek-overrides.js']
diff --git a/extension/content.js b/extension/content.js
index 70d7315..a64d1d0 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -1396,6 +1396,7 @@
                     inShadowDom,

                     platform,
                     siteQuirk: getSiteQuirkDebug(video),
+                    mediaSessionPosition: window.__koalaLastCapturedMediaPosition || null,
                     allVideos
                 });
             } else {

@@ -1406,7 +1407,8 @@
                     platform,

                     allVideos,

                     url: window.location.href,

-                    pageTitle: document.title,

+                    pageTitle: document.title,
+                    mediaSessionPosition: window.__koalaLastCapturedMediaPosition || null,

                     metadata: (navigator.mediaSession && navigator.mediaSession.metadata) ? {

                         title: navigator.mediaSession.metadata.title,

                         artist: navigator.mediaSession.metadata.artist,

@@ -1804,6 +1806,13 @@
         // If the badge is already showing (early desync), refresh its text in place.

         // Re-creating the host element nukes the click target mid-poll and can drop a

         // click that landed between remove() and the re-create (L-4).

+        window.addEventListener('message', (event) => {
+            if (event.source !== window) return;
+            const data = event.data;
+            if (data && data.__koalaMediaSessionCapture === 1) {
+                window.__koalaLastCapturedMediaPosition = data.state;
+            }
+        });
         if (hcmBadgeHost) {

             const span = hcmBadgeHost.shadowRoot && hcmBadgeHost.shadowRoot.querySelector('span');

             if (span) span.textContent = '● ' + hcmStrings.badge;

diff --git a/extension/popup.js b/extension/popup.js
index 6cbb31e..cd183f5 100644
--- a/extension/popup.js
+++ b/extension/popup.js
@@ -2283,6 +2283,10 @@ function refreshDebugInfo() {
                 if (state.nativeCurrentTime != null || state.nativeDuration != null) {
                     addField('Native Time', `${state.nativeCurrentTime ?? '?'}s / ${state.nativeDuration ?? '?'}s`);
                 }
+                if (state.mediaSessionPosition) {
+                    const pos = state.mediaSessionPosition;
+                    addField('MediaSession Captured', `${pos.position ?? '?'}s / ${pos.duration ?? '?'}s (@ ${pos.playbackRate ?? 1}x)`, '#a855f7');
+                }
                 if (state.siteQuirk) {
                     const quirk = state.siteQuirk;
                     const label = quirk.name || quirk.key || 'Site';

From 54b806d2708ec6f0b0ca6dbc39283d6905a2e10f Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:23:14 +0200
Subject: [PATCH 10/22] Fix Media Session listener scoping by moving it to root
 IIFE level in content.js

---
 extension/content.js | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index a64d1d0..d9414ef 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -1799,6 +1799,14 @@
         }

     });

 

+    window.addEventListener('message', (event) => {
+        if (event.source !== window) return;
+        const data = event.data;
+        if (data && data.__koalaMediaSessionCapture === 1) {
+            window.__koalaLastCapturedMediaPosition = data.state;
+        }
+    });
+
     // Pull localized strings for the in-page dialog/badge (English fallback above).

     chrome.runtime.sendMessage({ type: 'GET_HCM_STRINGS' }, (res) => {

         if (chrome.runtime.lastError || !res) return;

@@ -1806,13 +1814,6 @@
         // If the badge is already showing (early desync), refresh its text in place.

         // Re-creating the host element nukes the click target mid-poll and can drop a

         // click that landed between remove() and the re-create (L-4).

-        window.addEventListener('message', (event) => {
-            if (event.source !== window) return;
-            const data = event.data;
-            if (data && data.__koalaMediaSessionCapture === 1) {
-                window.__koalaLastCapturedMediaPosition = data.state;
-            }
-        });
         if (hcmBadgeHost) {

             const span = hcmBadgeHost.shadowRoot && hcmBadgeHost.shadowRoot.querySelector('span');

             if (span) span.textContent = '● ' + hcmStrings.badge;


From 71fa6e7315447c8cc72a21cc294d33e3e4d79dab Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:25:11 +0200
Subject: [PATCH 11/22] Support absolute seeks on Disney+ by automatically
 translating them to relative jumps

---
 extension/content.js | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/extension/content.js b/extension/content.js
index d9414ef..7287b5d 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -323,7 +323,14 @@
 
     function seekVideo(video, targetTime, relativeDelta = null) {
         const siteQuirk = getActiveSiteQuirk();
-        if (siteQuirk && !siteQuirk.getTimeline(video) && siteQuirk.clickRelativeSeek(relativeDelta)) {
+        let delta = relativeDelta;
+        if (delta === null && siteQuirk) {
+            const current = getSyncCurrentTime(video);
+            if (current !== null) {
+                delta = targetTime - current;
+            }
+        }
+        if (siteQuirk && siteQuirk.clickRelativeSeek(delta)) {
             expectedSeekTime = null;
             return;
         }

From bea0f6925c0fe5a079f7890dcabff1eda7a31232 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:27:53 +0200
Subject: [PATCH 12/22] Implement cached duration fallback and simulate
 keyboard events fallback for Disney+ seeks when controls are hidden

---
 extension/content.js                  | 38 +++++++++++++++++++++++++--
 scripts/test-content-video-finder.cjs |  1 +
 2 files changed, 37 insertions(+), 2 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index 7287b5d..95d6dad 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -59,6 +59,7 @@
 

     const PAGE_API_SEEK_BRIDGE = 1;
     let lastDisneyPlusTimelineCandidates = [];
+    let lastKnownDisneyPlusDuration = 0;
 
     function hostMatchesUrl(host, url) {
         const normalized = String(url || '')
@@ -218,10 +219,31 @@
             return backward ? backRe.test(label) : forwardRe.test(label);
         });
 
-        if (!button || typeof button.click !== 'function') return false;
+        if (button && typeof button.click === 'function') {
+            const clicks = Math.max(1, Math.min(12, Math.round(Math.abs(delta) / 10)));
+            for (let i = 0; i < clicks; i++) {
+                setTimeout(() => button.click(), i * 60);
+            }
+            return true;
+        }
+
+        // Fallback: Simulate ArrowLeft / ArrowRight keyboard events
         const clicks = Math.max(1, Math.min(12, Math.round(Math.abs(delta) / 10)));
+        const eventInit = {
+            key: backward ? 'ArrowLeft' : 'ArrowRight',
+            code: backward ? 'ArrowLeft' : 'ArrowRight',
+            keyCode: backward ? 37 : 39,
+            which: backward ? 37 : 39,
+            bubbles: true,
+            cancelable: true,
+            view: window
+        };
+        const target = document.querySelector('.hive-video') || document.activeElement || document.body;
         for (let i = 0; i < clicks; i++) {
-            setTimeout(() => button.click(), i * 60);
+            setTimeout(() => {
+                target.dispatchEvent(new window.KeyboardEvent('keydown', eventInit));
+                target.dispatchEvent(new window.KeyboardEvent('keyup', eventInit));
+            }, i * 60);
         }
         return true;
     }
@@ -233,6 +255,7 @@
         const ui = getDisneyPlusUiTimeline();
 
         if (ui) {
+            lastKnownDisneyPlusDuration = ui.duration;
             let nativeScale = 1;
             if (range && range.duration > ui.duration * 1.2) {
                 nativeScale = range.duration / ui.duration;
@@ -251,6 +274,17 @@
             };
         }
 
+        if (lastKnownDisneyPlusDuration > 0) {
+            return {
+                start: 0,
+                end: lastKnownDisneyPlusDuration,
+                duration: lastKnownDisneyPlusDuration,
+                current: Number.isFinite(current) ? current : 0,
+                nativeScale: 1,
+                nativeStart: 0
+            };
+        }
+
         if (!range || range.start < 1 || range.duration < 60) return null;
         if (!Number.isFinite(current) || current < range.start - 1 || current > range.end + 1) return null;
         return { ...range, current: Math.max(0, current - range.start), nativeScale: 1, nativeStart: range.start };
diff --git a/scripts/test-content-video-finder.cjs b/scripts/test-content-video-finder.cjs
index b9c5e3c..f7d0bc6 100644
--- a/scripts/test-content-video-finder.cjs
+++ b/scripts/test-content-video-finder.cjs
@@ -91,6 +91,7 @@ function makeNode(attrs = {}, textContent = '') {
 function loadTimelineFns(hostname, document = makeDocument()) {
   return Function('window', 'document', [
     'let lastDisneyPlusTimelineCandidates = [];',
+    'let lastKnownDisneyPlusDuration = 0;',
     extractFunction('hostMatchesUrl', source),
     extractFunction('matchesPlayerUrls', source),
     extractFunction('isDisneyPlusHost', source),

From 32994aaaa5e1e08f133f6745d657f290f08f51e8 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:30:20 +0200
Subject: [PATCH 13/22] Support dynamic Disney+ timeline offset/scale caching
 for accurate seek sync

---
 extension/content.js                  | 13 ++++++++++---
 scripts/test-content-video-finder.cjs |  2 ++
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index 95d6dad..22412db 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -60,6 +60,8 @@
     const PAGE_API_SEEK_BRIDGE = 1;
     let lastDisneyPlusTimelineCandidates = [];
     let lastKnownDisneyPlusDuration = 0;
+    let lastKnownDisneyPlusScale = 1;
+    let lastKnownDisneyPlusStart = 0;
 
     function hostMatchesUrl(host, url) {
         const normalized = String(url || '')
@@ -265,6 +267,8 @@
             const nativeStart = Number.isFinite(current)
                 ? current - ui.current * nativeScale
                 : (range ? range.start : 0);
+            lastKnownDisneyPlusScale = nativeScale;
+            lastKnownDisneyPlusStart = nativeStart;
             return {
                 ...(range || {}),
                 current: ui.current,
@@ -275,13 +279,16 @@
         }
 
         if (lastKnownDisneyPlusDuration > 0) {
+            const calculatedCurrent = (Number.isFinite(current) && lastKnownDisneyPlusScale > 0)
+                ? (current - lastKnownDisneyPlusStart) / lastKnownDisneyPlusScale
+                : 0;
             return {
                 start: 0,
                 end: lastKnownDisneyPlusDuration,
                 duration: lastKnownDisneyPlusDuration,
-                current: Number.isFinite(current) ? current : 0,
-                nativeScale: 1,
-                nativeStart: 0
+                current: Math.max(0, Math.min(lastKnownDisneyPlusDuration, calculatedCurrent)),
+                nativeScale: lastKnownDisneyPlusScale,
+                nativeStart: lastKnownDisneyPlusStart
             };
         }
 
diff --git a/scripts/test-content-video-finder.cjs b/scripts/test-content-video-finder.cjs
index f7d0bc6..113f8e6 100644
--- a/scripts/test-content-video-finder.cjs
+++ b/scripts/test-content-video-finder.cjs
@@ -92,6 +92,8 @@ function loadTimelineFns(hostname, document = makeDocument()) {
   return Function('window', 'document', [
     'let lastDisneyPlusTimelineCandidates = [];',
     'let lastKnownDisneyPlusDuration = 0;',
+    'let lastKnownDisneyPlusScale = 1;',
+    'let lastKnownDisneyPlusStart = 0;',
     extractFunction('hostMatchesUrl', source),
     extractFunction('matchesPlayerUrls', source),
     extractFunction('isDisneyPlusHost', source),

From 09d35f3e489e0c80c0724865e265e07def7ef18f Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:35:08 +0200
Subject: [PATCH 14/22] TEMPORARY DIAGNOSTICS: Implement Proposal 2 and 3 logs
 in Dev tools tab

---
 extension/content.js | 56 ++++++++++++++++++++++++++++++++++++++++++--
 extension/popup.html | 12 ++++++++++
 extension/popup.js   | 12 ++++++++++
 3 files changed, 78 insertions(+), 2 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index 22412db..a36cc7f 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -62,6 +62,7 @@
     let lastKnownDisneyPlusDuration = 0;
     let lastKnownDisneyPlusScale = 1;
     let lastKnownDisneyPlusStart = 0;
+    let videoEventsLog = [];
 
     function hostMatchesUrl(host, url) {
         const normalized = String(url || '')
@@ -1445,6 +1446,8 @@
                     platform,
                     siteQuirk: getSiteQuirkDebug(video),
                     mediaSessionPosition: window.__koalaLastCapturedMediaPosition || null,
+                    scrapedTimestamps: getScrapedTimestamps(),
+                    videoEventsLog: videoEventsLog,
                     allVideos
                 });
             } else {

@@ -1456,7 +1459,9 @@
                     allVideos,

                     url: window.location.href,

                     pageTitle: document.title,
-                    mediaSessionPosition: window.__koalaLastCapturedMediaPosition || null,

+                    mediaSessionPosition: window.__koalaLastCapturedMediaPosition || null,
+                    scrapedTimestamps: getScrapedTimestamps(),
+                    videoEventsLog: videoEventsLog,

                     metadata: (navigator.mediaSession && navigator.mediaSession.metadata) ? {

                         title: navigator.mediaSession.metadata.title,

                         artist: navigator.mediaSession.metadata.artist,

@@ -1674,6 +1679,46 @@
         checkEpisodeTransition();

     };

 

+    function getScrapedTimestamps() {
+        if (typeof document === 'undefined') return [];
+        try {
+            const elms = Array.from(document.querySelectorAll('div,span,p,button,a,[role="button"]'));
+            const unique = new Set();
+            const results = [];
+            for (const el of elms) {
+                if (el.children.length > 3) continue;
+                const txt = (el.textContent || '').trim();
+                if (!txt || txt.length > 50) continue;
+                if (unique.has(txt)) continue;
+                const match = txt.match(/(\d{1,2}:)?\d{1,2}:\d{2}/);
+                if (match) {
+                    unique.add(txt);
+                    const tag = el.tagName.toLowerCase();
+                    const cls = el.className ? `.${el.className.split(' ')[0]}` : '';
+                    results.push(`${tag}${cls}: "${txt}"`);
+                }
+            }
+            return results.slice(0, 15);
+        } catch (_e) {
+            return [];
+        }
+    }
+
+    function logVideoEvent(name, video) {
+        try {
+            const time = Number.isFinite(video?.currentTime) ? video.currentTime.toFixed(2) : '?';
+            const dur = Number.isFinite(video?.duration) ? video.duration.toFixed(2) : '?';
+            const timeStr = new Date().toTimeString().split(' ')[0];
+            const msg = `[${timeStr}] ${name} (t=${time}s, d=${dur}s)`;
+            videoEventsLog.unshift(msg);
+            if (videoEventsLog.length > 15) {
+                videoEventsLog.pop();
+            }
+        } catch (_e) {
+            // safe
+        }
+    }
+
     function setupListeners() {

         const video = findVideo();

         if (video) {

@@ -1688,7 +1733,14 @@
                 video.removeEventListener('loadeddata', existing.loadeddata);

                 if (existing.waiting) video.removeEventListener('waiting', existing.waiting);

             }

-            video._koalaHandlers = { play: handlePlay, pause: handlePause, seeked: handleSeeked, loadeddata: handleLoadedData, waiting: handleWaiting };

+            video._koalaHandlers = { play: handlePlay, pause: handlePause, seeked: handleSeeked, loadeddata: handleLoadedData, waiting: handleWaiting };
+            if (!video._koalaLoggingAttached) {
+                video._koalaLoggingAttached = true;
+                const logEvents = ['play', 'pause', 'seeking', 'seeked', 'durationchange', 'ratechange', 'volumechange', 'waiting', 'playing'];
+                logEvents.forEach(evt => {
+                    video.addEventListener(evt, () => logVideoEvent(evt.toUpperCase(), video));
+                });
+            }

 

             video.addEventListener('play', handlePlay);

             video.addEventListener('pause', handlePause);

diff --git a/extension/popup.html b/extension/popup.html
index df2188c..b84debb 100644
--- a/extension/popup.html
+++ b/extension/popup.html
@@ -700,6 +700,18 @@
             <button id="remoteSeekForward" class="secondary" style="flex:1; font-size:12px;">+30s</button>
         </div>
         <button id="remoteSeekFiveMin" class="secondary" style="width:100%; font-size:12px; margin-bottom:15px;">Seek 5:00</button>
+        <div style="margin-top: 15px;">
+            <label style="font-size:10px; font-weight:700; text-transform:uppercase; letter-spacing:0.5px;">DOM Timestamps (Scraped)</label>
+            <div class="info-card" id="devtoolsDomScraperList" style="font-size:10px; max-height:100px; overflow-y:auto; font-family:monospace; line-height:1.2; padding:6px; background:rgba(0,0,0,0.2); white-space:pre-wrap; border: 1px solid #334155;">
+                No timestamps scraped.
+            </div>
+        </div>
+        <div style="margin-top: 15px; margin-bottom:15px;">
+            <label style="font-size:10px; font-weight:700; text-transform:uppercase; letter-spacing:0.5px;">Video Event Log</label>
+            <div class="info-card" id="devtoolsVideoEventLogList" style="font-size:10px; max-height:150px; overflow-y:auto; font-family:monospace; line-height:1.2; padding:6px; background:rgba(0,0,0,0.2); white-space:pre-wrap; border: 1px solid #334155;">
+                No events logged.
+            </div>
+        </div>
         <div style="font-size:10px; color:var(--text-muted); text-align:center; margin-top:10px; opacity:0.7;">
             Build: <span id="buildIdentifier">__BUILD_TIMESTAMP__</span>
         </div>
diff --git a/extension/popup.js b/extension/popup.js
index cd183f5..765a64e 100644
--- a/extension/popup.js
+++ b/extension/popup.js
@@ -2296,6 +2296,18 @@ function refreshDebugInfo() {
                     const buttons = Array.isArray(quirk.seekButtons) ? quirk.seekButtons.slice(0, 4).join(' | ') : '';
                     if (buttons) addField(`${label} Buttons`, buttons);
                 }
+                const domScraperEl = document.getElementById('devtoolsDomScraperList');
+                const eventLogEl = document.getElementById('devtoolsVideoEventLogList');
+                if (domScraperEl && state.scrapedTimestamps) {
+                    domScraperEl.textContent = state.scrapedTimestamps.length > 0 
+                        ? state.scrapedTimestamps.join('\n') 
+                        : 'No timestamps scraped.';
+                }
+                if (eventLogEl && state.videoEventsLog) {
+                    eventLogEl.textContent = state.videoEventsLog.length > 0 
+                        ? state.videoEventsLog.join('\n') 
+                        : 'No events logged.';
+                }
 
                 addSection('Properties');
                 addField('Seeking', String(state.seeking));

From 705fbc146be8038dc549483d9e265a8382befec6 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:42:25 +0200
Subject: [PATCH 15/22] TEMPORARY DIAGNOSTICS: Upgrade DOM scraper to support
 Shadow DOM recursion

---
 extension/content.js | 41 ++++++++++++++++++++++++++++-------------
 1 file changed, 28 insertions(+), 13 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index a36cc7f..f7fb5c0 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -1682,22 +1682,37 @@
     function getScrapedTimestamps() {
         if (typeof document === 'undefined') return [];
         try {
-            const elms = Array.from(document.querySelectorAll('div,span,p,button,a,[role="button"]'));
-            const unique = new Set();
             const results = [];
-            for (const el of elms) {
-                if (el.children.length > 3) continue;
-                const txt = (el.textContent || '').trim();
-                if (!txt || txt.length > 50) continue;
-                if (unique.has(txt)) continue;
-                const match = txt.match(/(\d{1,2}:)?\d{1,2}:\d{2}/);
-                if (match) {
-                    unique.add(txt);
-                    const tag = el.tagName.toLowerCase();
-                    const cls = el.className ? `.${el.className.split(' ')[0]}` : '';
-                    results.push(`${tag}${cls}: "${txt}"`);
+            const unique = new Set();
+
+            function scan(node) {
+                if (!node) return;
+                if (node.querySelectorAll) {
+                    const elms = Array.from(node.querySelectorAll('div,span,p,button,a,[role="button"]'));
+                    for (const el of elms) {
+                        if (el.children.length > 3) continue;
+                        const txt = (el.textContent || '').trim();
+                        if (!txt || txt.length > 50) continue;
+                        if (unique.has(txt)) continue;
+                        const match = txt.match(/(\d{1,2}:)?\d{1,2}:\d{2}/);
+                        if (match) {
+                            unique.add(txt);
+                            const tag = el.tagName.toLowerCase();
+                            const cls = el.className ? `.${el.className.split(' ')[0]}` : '';
+                            results.push(`${tag}${cls}: "${txt}"`);
+                        }
+                    }
+                }
+                const children = node.childNodes || [];
+                for (let i = 0; i < children.length; i++) {
+                    scan(children[i]);
+                }
+                if (node.shadowRoot) {
+                    scan(node.shadowRoot);
                 }
             }
+
+            scan(document.body);
             return results.slice(0, 15);
         } catch (_e) {
             return [];

From a9f5c0b9bff4d4b53b6c75a00ffde9c7cbd78a1f Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 13:45:36 +0200
Subject: [PATCH 16/22] TEMPORARY DIAGNOSTICS: Integrate querySelectorAllShadow
 in Disney+ specific functions

---
 extension/content.js                  | 89 ++++++++++++++++++---------
 scripts/test-content-video-finder.cjs |  2 +
 2 files changed, 63 insertions(+), 28 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index f7fb5c0..93442af 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -140,7 +140,7 @@
             'p',
             'div'
         ].join(',');
-        const nodes = Array.from(document.querySelectorAll(selectors)).slice(0, 2000);
+        const nodes = querySelectorAllShadow(selectors).slice(0, 2000);
         const textParts = [];
         const candidates = [];
         let best = null;
@@ -199,7 +199,7 @@
 
     function getDisneyPlusSeekButtonLabels() {
         if (!isDisneyPlusHost() || typeof document === 'undefined') return [];
-        return Array.from(document.querySelectorAll('button,[role="button"]'))
+        return querySelectorAllShadow('button,[role="button"]')
             .map(getElementLabel)
             .filter(Boolean)
             .slice(0, 20);
@@ -208,7 +208,7 @@
     function clickDisneyPlusRelativeSeek(delta) {
         if (!isDisneyPlusHost() || !Number.isFinite(delta) || Math.abs(delta) < 1 || typeof document === 'undefined') return false;
         const backward = delta < 0;
-        const candidates = Array.from(document.querySelectorAll('button,[role="button"]'));
+        const candidates = querySelectorAllShadow('button,[role="button"]');
         const backRe = /rewind|backward|back\b|zurück|zurueck|rück|rueck|retour|recul|retroced|atrás|voltar|indietro/i;
         const forwardRe = /forward|ahead|skip|vorwärts|vorwaerts|vorsp|weiter|avancer|adelant|avançar|avancar|avanti/i;
         const timeRe = /\b(5|10|15|30)\b|sec|sek|second/i;
@@ -1679,40 +1679,73 @@
         checkEpisodeTransition();

     };

 

+    function scanShadowDom(node, callback) {
+        if (!node) return;
+        callback(node);
+        const children = node.childNodes || [];
+        for (let i = 0; i < children.length; i++) {
+            scanShadowDom(children[i], callback);
+        }
+        if (node.shadowRoot) {
+            scanShadowDom(node.shadowRoot, callback);
+        }
+    }
+
+    function querySelectorAllShadow(selector) {
+        if (typeof document === 'undefined') return [];
+        if (!document.body && typeof document.querySelectorAll === 'function') {
+            try {
+                return Array.from(document.querySelectorAll(selector));
+            } catch (_e) {
+                return [];
+            }
+        }
+        const results = [];
+        scanShadowDom(document.body || document, (node) => {
+            if (node.nodeType === 1 && typeof node.matches === 'function' && node.matches(selector)) {
+                results.push(node);
+            }
+        });
+        return results;
+    }
+
     function getScrapedTimestamps() {
         if (typeof document === 'undefined') return [];
         try {
             const results = [];
             const unique = new Set();
 
-            function scan(node) {
-                if (!node) return;
-                if (node.querySelectorAll) {
-                    const elms = Array.from(node.querySelectorAll('div,span,p,button,a,[role="button"]'));
-                    for (const el of elms) {
-                        if (el.children.length > 3) continue;
-                        const txt = (el.textContent || '').trim();
-                        if (!txt || txt.length > 50) continue;
-                        if (unique.has(txt)) continue;
-                        const match = txt.match(/(\d{1,2}:)?\d{1,2}:\d{2}/);
-                        if (match) {
-                            unique.add(txt);
-                            const tag = el.tagName.toLowerCase();
-                            const cls = el.className ? `.${el.className.split(' ')[0]}` : '';
-                            results.push(`${tag}${cls}: "${txt}"`);
-                        }
+            scanShadowDom(document.body, (node) => {
+                if (node.nodeType !== 1) return;
+                
+                const txt = (node.textContent || '').trim();
+                if (txt && txt.length < 50 && !unique.has(txt)) {
+                    const match = txt.match(/(\d{1,2}:)?\d{1,2}:\d{2}/);
+                    if (match) {
+                        unique.add(txt);
+                        const tag = node.tagName.toLowerCase();
+                        const cls = node.className ? `.${node.className.split(' ')[0]}` : '';
+                        results.push(`${tag}${cls}: "${txt}"`);
                     }
                 }
-                const children = node.childNodes || [];
-                for (let i = 0; i < children.length; i++) {
-                    scan(children[i]);
-                }
-                if (node.shadowRoot) {
-                    scan(node.shadowRoot);
-                }
-            }
 
-            scan(document.body);
+                const isSlider = node.getAttribute('role') === 'slider' || 
+                                 node.getAttribute('role') === 'progressbar' ||
+                                 node.hasAttribute('aria-valuenow') ||
+                                 node.tagName.toLowerCase() === 'progress' ||
+                                 (node.tagName.toLowerCase() === 'input' && node.type === 'range');
+                
+                if (isSlider) {
+                    const tag = node.tagName.toLowerCase();
+                    const cls = node.className ? `.${node.className.split(' ')[0]}` : '';
+                    const now = node.getAttribute('aria-valuenow') || node.value || '?';
+                    const max = node.getAttribute('aria-valuemax') || node.max || '?';
+                    const text = node.getAttribute('aria-valuetext') || '?';
+                    const width = node.style?.width || '?';
+                    results.push(`[SLIDER] ${tag}${cls}: now=${now}, max=${max}, text="${text}", width=${width}`);
+                }
+            });
+
             return results.slice(0, 15);
         } catch (_e) {
             return [];
diff --git a/scripts/test-content-video-finder.cjs b/scripts/test-content-video-finder.cjs
index 113f8e6..453995f 100644
--- a/scripts/test-content-video-finder.cjs
+++ b/scripts/test-content-video-finder.cjs
@@ -94,6 +94,8 @@ function loadTimelineFns(hostname, document = makeDocument()) {
     'let lastKnownDisneyPlusDuration = 0;',
     'let lastKnownDisneyPlusScale = 1;',
     'let lastKnownDisneyPlusStart = 0;',
+    extractFunction('scanShadowDom', source),
+    extractFunction('querySelectorAllShadow', source),
     extractFunction('hostMatchesUrl', source),
     extractFunction('matchesPlayerUrls', source),
     extractFunction('isDisneyPlusHost', source),

From 51da169d6911a68ddaf3bd0b08c82700c24e6193 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 14:18:50 +0200
Subject: [PATCH 17/22] Remove temporary Media Session interceptor and Video
 Event Log diagnostics

Clean up the exploratory Disney+ diagnostics now that the Shadow DOM
timeline/seek integration is in place:

- Remove Proposal 1 (Media Session interceptor): the background.js
  interceptor injection and the content.js message listener capturing
  __koalaMediaSessionCapture, plus the now-unused mediaSessionPosition
  reporting in content.js and popup.js.
- Remove Proposal 3 (Video Event Log): videoEventsLog, logVideoEvent(),
  the per-video event logging listeners, and the popup.html/popup.js UI.
- Keep Proposal 2 (DOM timestamp scraper) for ongoing diagnostics.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 extension/background.js | 50 -----------------------------------------
 extension/content.js    | 36 -----------------------------
 extension/popup.html    |  6 -----
 extension/popup.js      | 14 ++----------
 4 files changed, 2 insertions(+), 104 deletions(-)

diff --git a/extension/background.js b/extension/background.js
index a33ca9c..54da4ae 100644
--- a/extension/background.js
+++ b/extension/background.js
@@ -1654,42 +1654,6 @@ async function devRemoteToolsAllowed() {
     return data.username === 'KoalaDev';
 }
 
-const mediaSessionInterceptorHosts = [
-    'disneyplus.com'
-];
-
-function shouldInstallMediaSessionInterceptor(url) {
-    try {
-        const host = new URL(url).hostname.toLowerCase();
-        return mediaSessionInterceptorHosts.some(h => host === h || host.endsWith('.' + h));
-    } catch (_e) {
-        return false;
-    }
-}
-
-function installMediaSessionInterceptor() {
-    if (window.__koalaMediaSessionInterceptorInstalled) return;
-    window.__koalaMediaSessionInterceptorInstalled = true;
-    if (!navigator.mediaSession || typeof navigator.mediaSession.setPositionState !== 'function') return;
-
-    const originalSet = navigator.mediaSession.setPositionState;
-    navigator.mediaSession.setPositionState = function(state) {
-        try {
-            window.postMessage({
-                __koalaMediaSessionCapture: 1,
-                state: {
-                    duration: state?.duration,
-                    playbackRate: state?.playbackRate,
-                    position: state?.position
-                }
-            }, '*');
-        } catch (_e) {
-            // Suppress errors to not interfere with player
-        }
-        return originalSet.apply(navigator.mediaSession, arguments);
-    };
-}
-
 function shouldUsePageApiSeek(url) {
     return typeof globalThis.koalaFindPageApiSeekProvider === 'function' &&
         !!globalThis.koalaFindPageApiSeekProvider(url);
@@ -1733,12 +1697,10 @@ function setPageApiSeekEnabled(enabled) {
 async function injectContentScript(tabId) {
     let needsPageApiSeek = false;
     let pageApiSeekReady = false;
-    let isMediaSessionCapable = false;
     try {
         const tab = await chrome.tabs.get(tabId);
         const url = tab?.url || '';
         needsPageApiSeek = shouldUsePageApiSeek(url);
-        isMediaSessionCapable = shouldInstallMediaSessionInterceptor(url);
     } catch (_e) {
         // Fall through to the generic content script injection.
     }
@@ -1761,18 +1723,6 @@ async function injectContentScript(tabId) {
         }
     }
 
-    if (isMediaSessionCapable) {
-        try {
-            await chrome.scripting.executeScript({
-                target: { tabId },
-                world: 'MAIN',
-                func: installMediaSessionInterceptor
-            });
-        } catch (err) {
-            addLog(`Media Session interceptor injection failed: ${err.message}`, 'warn');
-        }
-    }
-
     await chrome.scripting.executeScript({
         target: { tabId },
         files: ['page-api-seek-overrides.js']
diff --git a/extension/content.js b/extension/content.js
index 93442af..c7cbb76 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -62,7 +62,6 @@
     let lastKnownDisneyPlusDuration = 0;
     let lastKnownDisneyPlusScale = 1;
     let lastKnownDisneyPlusStart = 0;
-    let videoEventsLog = [];
 
     function hostMatchesUrl(host, url) {
         const normalized = String(url || '')
@@ -1445,9 +1444,7 @@
                     inShadowDom,

                     platform,
                     siteQuirk: getSiteQuirkDebug(video),
-                    mediaSessionPosition: window.__koalaLastCapturedMediaPosition || null,
                     scrapedTimestamps: getScrapedTimestamps(),
-                    videoEventsLog: videoEventsLog,
                     allVideos
                 });
             } else {

@@ -1459,9 +1456,7 @@
                     allVideos,

                     url: window.location.href,

                     pageTitle: document.title,
-                    mediaSessionPosition: window.__koalaLastCapturedMediaPosition || null,
                     scrapedTimestamps: getScrapedTimestamps(),
-                    videoEventsLog: videoEventsLog,

                     metadata: (navigator.mediaSession && navigator.mediaSession.metadata) ? {

                         title: navigator.mediaSession.metadata.title,

                         artist: navigator.mediaSession.metadata.artist,

@@ -1752,21 +1747,6 @@
         }
     }
 
-    function logVideoEvent(name, video) {
-        try {
-            const time = Number.isFinite(video?.currentTime) ? video.currentTime.toFixed(2) : '?';
-            const dur = Number.isFinite(video?.duration) ? video.duration.toFixed(2) : '?';
-            const timeStr = new Date().toTimeString().split(' ')[0];
-            const msg = `[${timeStr}] ${name} (t=${time}s, d=${dur}s)`;
-            videoEventsLog.unshift(msg);
-            if (videoEventsLog.length > 15) {
-                videoEventsLog.pop();
-            }
-        } catch (_e) {
-            // safe
-        }
-    }
-
     function setupListeners() {

         const video = findVideo();

         if (video) {

@@ -1782,14 +1762,6 @@
                 if (existing.waiting) video.removeEventListener('waiting', existing.waiting);

             }

             video._koalaHandlers = { play: handlePlay, pause: handlePause, seeked: handleSeeked, loadeddata: handleLoadedData, waiting: handleWaiting };
-            if (!video._koalaLoggingAttached) {
-                video._koalaLoggingAttached = true;
-                const logEvents = ['play', 'pause', 'seeking', 'seeked', 'durationchange', 'ratechange', 'volumechange', 'waiting', 'playing'];
-                logEvents.forEach(evt => {
-                    video.addEventListener(evt, () => logVideoEvent(evt.toUpperCase(), video));
-                });
-            }

-

             video.addEventListener('play', handlePlay);

             video.addEventListener('pause', handlePause);

             video.addEventListener('seeked', handleSeeked);

@@ -1947,14 +1919,6 @@
         }

     });

 

-    window.addEventListener('message', (event) => {
-        if (event.source !== window) return;
-        const data = event.data;
-        if (data && data.__koalaMediaSessionCapture === 1) {
-            window.__koalaLastCapturedMediaPosition = data.state;
-        }
-    });
-
     // Pull localized strings for the in-page dialog/badge (English fallback above).

     chrome.runtime.sendMessage({ type: 'GET_HCM_STRINGS' }, (res) => {

         if (chrome.runtime.lastError || !res) return;

diff --git a/extension/popup.html b/extension/popup.html
index b84debb..8a792e9 100644
--- a/extension/popup.html
+++ b/extension/popup.html
@@ -706,12 +706,6 @@
                 No timestamps scraped.
             </div>
         </div>
-        <div style="margin-top: 15px; margin-bottom:15px;">
-            <label style="font-size:10px; font-weight:700; text-transform:uppercase; letter-spacing:0.5px;">Video Event Log</label>
-            <div class="info-card" id="devtoolsVideoEventLogList" style="font-size:10px; max-height:150px; overflow-y:auto; font-family:monospace; line-height:1.2; padding:6px; background:rgba(0,0,0,0.2); white-space:pre-wrap; border: 1px solid #334155;">
-                No events logged.
-            </div>
-        </div>
         <div style="font-size:10px; color:var(--text-muted); text-align:center; margin-top:10px; opacity:0.7;">
             Build: <span id="buildIdentifier">__BUILD_TIMESTAMP__</span>
         </div>
diff --git a/extension/popup.js b/extension/popup.js
index 765a64e..0917a3e 100644
--- a/extension/popup.js
+++ b/extension/popup.js
@@ -2283,10 +2283,6 @@ function refreshDebugInfo() {
                 if (state.nativeCurrentTime != null || state.nativeDuration != null) {
                     addField('Native Time', `${state.nativeCurrentTime ?? '?'}s / ${state.nativeDuration ?? '?'}s`);
                 }
-                if (state.mediaSessionPosition) {
-                    const pos = state.mediaSessionPosition;
-                    addField('MediaSession Captured', `${pos.position ?? '?'}s / ${pos.duration ?? '?'}s (@ ${pos.playbackRate ?? 1}x)`, '#a855f7');
-                }
                 if (state.siteQuirk) {
                     const quirk = state.siteQuirk;
                     const label = quirk.name || quirk.key || 'Site';
@@ -2297,17 +2293,11 @@ function refreshDebugInfo() {
                     if (buttons) addField(`${label} Buttons`, buttons);
                 }
                 const domScraperEl = document.getElementById('devtoolsDomScraperList');
-                const eventLogEl = document.getElementById('devtoolsVideoEventLogList');
                 if (domScraperEl && state.scrapedTimestamps) {
-                    domScraperEl.textContent = state.scrapedTimestamps.length > 0 
-                        ? state.scrapedTimestamps.join('\n') 
+                    domScraperEl.textContent = state.scrapedTimestamps.length > 0
+                        ? state.scrapedTimestamps.join('\n')
                         : 'No timestamps scraped.';
                 }
-                if (eventLogEl && state.videoEventsLog) {
-                    eventLogEl.textContent = state.videoEventsLog.length > 0 
-                        ? state.videoEventsLog.join('\n') 
-                        : 'No events logged.';
-                }
 
                 addSection('Properties');
                 addField('Seeking', String(state.seeking));

From 8fe1c6dfbc4a6e0ff03f982b185f9be220a2adb4 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 14:26:53 +0200
Subject: [PATCH 18/22] Fix laggy Disney+ time by preferring the live "time
 remaining" indicator
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Disney+ throttles the scrubber slider's aria-valuenow, so it can lag real
playback by several seconds (and its value snaps back when the control
overlay reappears on pause). The player's "time remaining" indicator,
however, updates live.

getDisneyPlusUiTimeline() now captures any element whose class/testid
mentions "remain", parses its clock text, and — when a reliable duration
is known — derives current = duration - remaining and prefers it over the
laggy slider value. Falls back to the previous behavior when no remaining
indicator is present.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 extension/content.js | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/extension/content.js b/extension/content.js
index c7cbb76..115f08f 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -144,6 +144,7 @@
         const candidates = [];
         let best = null;
         let bestScore = -1;
+        let remainingSeconds = null;
 
         function considerTimeline(parsed, source, weight = 0) {
             if (!parsed) return;
@@ -175,9 +176,24 @@
                 const parsed = parseTimelineText(text);
                 considerTimeline(parsed, 'text', 100);
                 textParts.push(text);
+            }
+            // Disney's scrubber aria-valuenow can lag several seconds behind
+            // real playback; a "time remaining" indicator updates live, so
+            // capture it and later derive current = duration - remaining.
+            const remClass = String(node.getAttribute?.('class') || '') + ' ' + String(node.getAttribute?.('data-testid') || '');
+            if (/remain/i.test(remClass)) {
+                const remMatch = String(node.textContent || '').match(/\d{1,3}:\d{2}(?::\d{2})?/);
+                const rem = remMatch ? parseClockTime(remMatch[0]) : null;
+                if (Number.isFinite(rem) && rem >= 0) remainingSeconds = rem;
             }
         }
 
+        if (best && remainingSeconds !== null && best.duration > 0) {
+            const liveCurrent = best.duration - remainingSeconds;
+            if (liveCurrent >= 0 && liveCurrent <= best.duration + 5) {
+                considerTimeline({ current: Math.min(liveCurrent, best.duration), duration: best.duration }, 'time-remaining', 1000);
+            }
+        }
         considerTimeline(parseTimelineText(textParts.join(' ')), 'combined-text', 25);
         lastDisneyPlusTimelineCandidates = candidates
             .sort((a, b) => b.score - a.score)

From 2fbcbc4f83dcdf7c109c6b83c79adb17897a52e6 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 14:38:26 +0200
Subject: [PATCH 19/22] Harden Disney+ time fallback against <video> element
 recreation

When the control overlay (and its live time readout) is briefly absent,
the old fallback recomputed the timeline from the raw blob-relative
video.currentTime via a cached scale/start. Disney recreates the <video>
element on some play/pause transitions, which resets currentTime, so that
math produced a wildly wrong time ("loses the time" after a pause).

The native clock advances 1:1 with real playback, so instead anchor the
last live UI position to video.currentTime and extrapolate by the elapsed
native delta. If the delta is negative or implausibly large (element
recreated / seek), freeze at the last known position rather than emitting
a garbage time.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 extension/content.js                  | 37 ++++++++++++++++++---------
 scripts/test-content-video-finder.cjs |  2 ++
 2 files changed, 27 insertions(+), 12 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index 115f08f..e8b9c96 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -62,6 +62,8 @@
     let lastKnownDisneyPlusDuration = 0;
     let lastKnownDisneyPlusScale = 1;
     let lastKnownDisneyPlusStart = 0;
+    let lastDisneyPlusUiCurrent = null;
+    let lastDisneyPlusNativeAtUi = null;
 
     function hostMatchesUrl(host, url) {
         const normalized = String(url || '')
@@ -285,6 +287,8 @@
                 : (range ? range.start : 0);
             lastKnownDisneyPlusScale = nativeScale;
             lastKnownDisneyPlusStart = nativeStart;
+            lastDisneyPlusUiCurrent = ui.current;
+            lastDisneyPlusNativeAtUi = Number.isFinite(current) ? current : null;
             return {
                 ...(range || {}),
                 current: ui.current,
@@ -294,18 +298,27 @@
             };
         }
 
-        if (lastKnownDisneyPlusDuration > 0) {
-            const calculatedCurrent = (Number.isFinite(current) && lastKnownDisneyPlusScale > 0)
-                ? (current - lastKnownDisneyPlusStart) / lastKnownDisneyPlusScale
-                : 0;
-            return {
-                start: 0,
-                end: lastKnownDisneyPlusDuration,
-                duration: lastKnownDisneyPlusDuration,
-                current: Math.max(0, Math.min(lastKnownDisneyPlusDuration, calculatedCurrent)),
-                nativeScale: lastKnownDisneyPlusScale,
-                nativeStart: lastKnownDisneyPlusStart
-            };
+        // No live UI readout (control overlay hidden or mid-rebuild). Extrapolate
+        // from the last live UI position using the native clock, which advances 1:1
+        // with real playback. Disney recreates the <video> on some play/pause
+        // transitions, which resets currentTime; if the native clock jumped back or
+        // leapt implausibly, freeze at the last known position instead of a garbage time.
+        if (lastDisneyPlusUiCurrent !== null && lastKnownDisneyPlusDuration > 0) {
+            let estimated = lastDisneyPlusUiCurrent;
+            if (Number.isFinite(current) && lastDisneyPlusNativeAtUi !== null) {
+                const delta = current - lastDisneyPlusNativeAtUi;
+                if (delta >= 0 && delta < 60) {
+                    estimated = lastDisneyPlusUiCurrent + delta;
+                }
+            }
+            return {
+                start: 0,
+                end: lastKnownDisneyPlusDuration,
+                duration: lastKnownDisneyPlusDuration,
+                current: Math.max(0, Math.min(lastKnownDisneyPlusDuration, estimated)),
+                nativeScale: lastKnownDisneyPlusScale,
+                nativeStart: lastKnownDisneyPlusStart
+            };
         }
 
         if (!range || range.start < 1 || range.duration < 60) return null;
diff --git a/scripts/test-content-video-finder.cjs b/scripts/test-content-video-finder.cjs
index 453995f..804e2f3 100644
--- a/scripts/test-content-video-finder.cjs
+++ b/scripts/test-content-video-finder.cjs
@@ -94,6 +94,8 @@ function loadTimelineFns(hostname, document = makeDocument()) {
     'let lastKnownDisneyPlusDuration = 0;',
     'let lastKnownDisneyPlusScale = 1;',
     'let lastKnownDisneyPlusStart = 0;',
+    'let lastDisneyPlusUiCurrent = null;',
+    'let lastDisneyPlusNativeAtUi = null;',
     extractFunction('scanShadowDom', source),
     extractFunction('querySelectorAllShadow', source),
     extractFunction('hostMatchesUrl', source),

From 236da46f5dd7cdcd0264684132548fe815ba59b1 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 14:45:12 +0200
Subject: [PATCH 20/22] Lift the 120s cap on Disney+ relative-seek so large
 seeks reach target
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Disney+ has no absolute seek on its blob <video>, so absolute seeks are
translated into repeated clicks of the player's relative skip button. The
click count was capped at 12 (=120s at 10s/step), so any seek further than
two minutes away silently landed short — breaking absolute-position sync
(e.g. syncing to 5:00 from far away never arrived).

Derive the step size from the matched button's own label (10s default,
some UIs use 5/15/30) and issue enough clicks to cover the full delta,
bounded at a sane maximum.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 extension/content.js | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index e8b9c96..02a749c 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -239,12 +239,19 @@
             return backward ? backRe.test(label) : forwardRe.test(label);
         });
 
-        if (button && typeof button.click === 'function') {
-            const clicks = Math.max(1, Math.min(12, Math.round(Math.abs(delta) / 10)));
-            for (let i = 0; i < clicks; i++) {
-                setTimeout(() => button.click(), i * 60);
-            }
-            return true;
+        if (button && typeof button.click === 'function') {
+            // Disney offers no absolute seek on its blob <video>, so we click its
+            // relative skip button. Derive the step from the button's own label
+            // (usually 10s; some UIs 5/15/30) and issue enough clicks to cover the
+            // full delta. The previous 120s cap truncated any larger seek, which
+            // broke absolute-position sync (e.g. seeking to 5:00 from far away).
+            const stepMatch = getElementLabel(button).match(/\b(5|10|15|30)\b/);
+            const step = stepMatch ? Number(stepMatch[1]) : 10;
+            const clicks = Math.max(1, Math.min(90, Math.round(Math.abs(delta) / step)));
+            for (let i = 0; i < clicks; i++) {
+                setTimeout(() => button.click(), i * 60);
+            }
+            return true;
         }
 
         // Fallback: Simulate ArrowLeft / ArrowRight keyboard events

From 076157fef1c3e1a6aa83ac8dae301a9ec219a3c1 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 14:56:02 +0200
Subject: [PATCH 21/22] Sync Disney+ via the page media player API (precise
 time + seek)

Disney+'s <video> is blob-relative (unusable as an absolute clock) and its
scrubber aria-value freezes during playback, so DOM scraping lagged and the
+/-10s button seek could neither reach far targets nor land precisely. The
real player hangs off the <disney-web-player> custom element as
`.mediaPlayer`, exposing seek(ms) and timeline.info (playhead/duration ms).

Since the isolated content world can't read that page object, route it
through the existing MAIN-world page-API bridge (as Netflix already does):

- page-api-seek-overrides.js: register a 'disney' provider.
- background.js installPageApiSeekBridge: seek Disney via mediaPlayer.seek(),
  and post the exact playhead/duration (seconds) to the content world every
  250ms. Both are gated on provider === 'disney'; Netflix path unchanged.
- content.js: cache the pushed playhead, prefer it in getDisneyPlusTimeline
  (DOM scraping stays as fallback), and check the page-API seek first in
  seekVideo. Outcome is identical for Netflix and generic sites.

Verified live on Disney+: reported time matches the player exactly and
seek lands within ~1s of the target.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 extension/background.js               | 41 +++++++++++++++-
 extension/content.js                  | 67 ++++++++++++++++++---------
 extension/page-api-seek-overrides.js  |  5 ++
 scripts/test-content-video-finder.cjs |  1 +
 4 files changed, 90 insertions(+), 24 deletions(-)

diff --git a/extension/background.js b/extension/background.js
index 54da4ae..96972a2 100644
--- a/extension/background.js
+++ b/extension/background.js
@@ -1663,10 +1663,22 @@ function installPageApiSeekBridge() {
     if (window.__koalaPageApiSeekBridgeInstalled) return;
     window.__koalaPageApiSeekBridgeInstalled = true;
 
-    function seekWithPageApi(time) {
-        const match = typeof window.koalaFindPageApiSeekProvider === 'function'
+    function currentMatch() {
+        return typeof window.koalaFindPageApiSeekProvider === 'function'
             ? window.koalaFindPageApiSeekProvider(window.location.hostname)
             : null;
+    }
+
+    // Disney+ ("hive"/BAM) player: the real media player hangs off the
+    // <disney-web-player> custom element as `.mediaPlayer`, exposing precise
+    // seek(ms) and timeline.info (playhead/duration in ms).
+    function disneyMediaPlayer() {
+        const el = document.querySelector('disney-web-player');
+        return el && el.mediaPlayer ? el.mediaPlayer : null;
+    }
+
+    function seekWithPageApi(time) {
+        const match = currentMatch();
         if (!match) return;
 
         try {
@@ -1676,6 +1688,9 @@ function installPageApiSeekBridge() {
                 const sessionId = ids ? ids[0] : null;
                 const player = sessionId ? videoPlayer.getVideoPlayerBySessionId(sessionId) : null;
                 player?.seek(Math.round(time * 1000));
+            } else if (match.provider === 'disney') {
+                const mp = disneyMediaPlayer();
+                if (mp && typeof mp.seek === 'function') mp.seek(Math.round(time * 1000));
             }
         } catch (_e) {
             // Player not ready or private API changed; the next sync tick can retry.
@@ -1688,6 +1703,28 @@ function installPageApiSeekBridge() {
         if (!data || data.__koalaPageApiSeek !== 1 || data.kind !== 'seek' || typeof data.time !== 'number') return;
         seekWithPageApi(data.time);
     });
+
+    // Disney+'s <video> currentTime is blob-relative and its scrubber lags, so
+    // the isolated-world content script can't read an accurate position. Push
+    // the real playhead/duration (seconds) from the page's media player.
+    setInterval(() => {
+        try {
+            const match = currentMatch();
+            if (!match || match.provider !== 'disney') return;
+            const mp = disneyMediaPlayer();
+            const info = mp && mp.timeline && mp.timeline.info;
+            if (!info || typeof info.playheadPositionMs !== 'number' || typeof info.programDurationMs !== 'number') return;
+            if (info.programDurationMs <= 0) return;
+            window.postMessage({
+                __koalaPlayerTime: 1,
+                provider: 'disney',
+                position: info.playheadPositionMs / 1000,
+                duration: info.programDurationMs / 1000
+            }, '*');
+        } catch (_e) {
+            // Ignore transient errors (player teardown / element swap).
+        }
+    }, 250);
 }
 
 function setPageApiSeekEnabled(enabled) {
diff --git a/extension/content.js b/extension/content.js
index 02a749c..2128e7a 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -63,7 +63,21 @@
     let lastKnownDisneyPlusScale = 1;
     let lastKnownDisneyPlusStart = 0;
     let lastDisneyPlusUiCurrent = null;
-    let lastDisneyPlusNativeAtUi = null;
+    let lastDisneyPlusNativeAtUi = null;
+    // Accurate Disney+ playhead pushed by the MAIN-world page-API bridge
+    // (background.js installPageApiSeekBridge). The isolated content world
+    // can't read the page's media player directly.
+    let disneyPageApiTime = null;
+    if (typeof window !== 'undefined' && typeof window.addEventListener === 'function') {
+        window.addEventListener('message', (event) => {
+            if (event.source !== window) return;
+            const data = event.data;
+            if (data && data.__koalaPlayerTime === 1 && data.provider === 'disney'
+                && Number.isFinite(data.position) && Number.isFinite(data.duration) && data.duration > 0) {
+                disneyPageApiTime = { position: data.position, duration: data.duration, at: Date.now() };
+            }
+        });
+    }
 
     function hostMatchesUrl(host, url) {
         const normalized = String(url || '')
@@ -276,7 +290,14 @@
     }
 
     function getDisneyPlusTimeline(video) {
-        if (!isDisneyPlusHost()) return null;
+        if (!isDisneyPlusHost()) return null;
+        // Preferred: exact playhead/duration from the page media player,
+        // relayed by the MAIN-world bridge. Authoritative while fresh.
+        if (disneyPageApiTime && (Date.now() - disneyPageApiTime.at) < 2000 && disneyPageApiTime.duration > 0) {
+            lastKnownDisneyPlusDuration = disneyPageApiTime.duration;
+            const cur = Math.max(0, Math.min(disneyPageApiTime.duration, disneyPageApiTime.position));
+            return { start: 0, end: disneyPageApiTime.duration, duration: disneyPageApiTime.duration, current: cur, nativeScale: 1, nativeStart: 0 };
+        }
         const range = getSeekableRange(video);
         const current = video.currentTime;
         const ui = getDisneyPlusUiTimeline();
@@ -398,26 +419,28 @@
             !!window.koalaFindPageApiSeekProvider(window.location.hostname);
     }
 
-    function seekVideo(video, targetTime, relativeDelta = null) {
-        const siteQuirk = getActiveSiteQuirk();
-        let delta = relativeDelta;
-        if (delta === null && siteQuirk) {
-            const current = getSyncCurrentTime(video);
-            if (current !== null) {
-                delta = targetTime - current;
-            }
-        }
-        if (siteQuirk && siteQuirk.clickRelativeSeek(delta)) {
-            expectedSeekTime = null;
-            return;
-        }
-        const nativeTargetTime = toNativeSeekTime(video, targetTime);
-        expectedSeekTime = targetTime;
-        if (shouldUsePageApiSeek()) {
-            window.postMessage({ __koalaPageApiSeek: PAGE_API_SEEK_BRIDGE, kind: 'seek', time: targetTime }, '*');
-            return;
-        }
-        video.currentTime = nativeTargetTime;
+    function seekVideo(video, targetTime, relativeDelta = null) {
+        // Prefer a precise page-level seek API when available (Netflix, Disney+);
+        // for those players the DOM/button seek path is imprecise or impossible.
+        if (shouldUsePageApiSeek()) {
+            expectedSeekTime = targetTime;
+            window.postMessage({ __koalaPageApiSeek: PAGE_API_SEEK_BRIDGE, kind: 'seek', time: targetTime }, '*');
+            return;
+        }
+        const siteQuirk = getActiveSiteQuirk();
+        let delta = relativeDelta;
+        if (delta === null && siteQuirk) {
+            const current = getSyncCurrentTime(video);
+            if (current !== null) {
+                delta = targetTime - current;
+            }
+        }
+        if (siteQuirk && siteQuirk.clickRelativeSeek(delta)) {
+            expectedSeekTime = null;
+            return;
+        }
+        expectedSeekTime = targetTime;
+        video.currentTime = toNativeSeekTime(video, targetTime);
     }
 

     // --- Play/Pause Coalescing (leading + trailing) ---

diff --git a/extension/page-api-seek-overrides.js b/extension/page-api-seek-overrides.js
index 60c9041..7f0c847 100644
--- a/extension/page-api-seek-overrides.js
+++ b/extension/page-api-seek-overrides.js
@@ -4,6 +4,11 @@
             name: 'netflix-page-api-seek',
             urls: ['netflix.com'],
             provider: 'netflix'
+        },
+        {
+            name: 'disney-page-api-seek',
+            urls: ['disneyplus.com'],
+            provider: 'disney'
         }
     ];
 
diff --git a/scripts/test-content-video-finder.cjs b/scripts/test-content-video-finder.cjs
index 804e2f3..2d9ae7a 100644
--- a/scripts/test-content-video-finder.cjs
+++ b/scripts/test-content-video-finder.cjs
@@ -96,6 +96,7 @@ function loadTimelineFns(hostname, document = makeDocument()) {
     'let lastKnownDisneyPlusStart = 0;',
     'let lastDisneyPlusUiCurrent = null;',
     'let lastDisneyPlusNativeAtUi = null;',
+    'let disneyPageApiTime = null;',
     extractFunction('scanShadowDom', source),
     extractFunction('querySelectorAllShadow', source),
     extractFunction('hostMatchesUrl', source),

From 9ac8c28442575cf9eb6016ec273ff0221de22544 Mon Sep 17 00:00:00 2001
From: Timo <6156589+Shik3i@users.noreply.github.com>
Date: Thu, 2 Jul 2026 15:08:54 +0200
Subject: [PATCH 22/22] Remove Disney+ DOM scraping fallback

---
 extension/content.js                  | 405 ++------------------------
 extension/popup.html                  |   6 -
 extension/popup.js                    |   7 -
 scripts/test-content-video-finder.cjs |  61 +---
 4 files changed, 47 insertions(+), 432 deletions(-)

diff --git a/extension/content.js b/extension/content.js
index 2128e7a..adc3e52 100644
--- a/extension/content.js
+++ b/extension/content.js
@@ -57,13 +57,7 @@
     let seekDebounceTimer = null;     // debounce timer for rapid seek events

     let expectedSeekTime = null;      // strictly track programmatic seeks

 

-    const PAGE_API_SEEK_BRIDGE = 1;
-    let lastDisneyPlusTimelineCandidates = [];
-    let lastKnownDisneyPlusDuration = 0;
-    let lastKnownDisneyPlusScale = 1;
-    let lastKnownDisneyPlusStart = 0;
-    let lastDisneyPlusUiCurrent = null;
-    let lastDisneyPlusNativeAtUi = null;
+    const PAGE_API_SEEK_BRIDGE = 1;
     // Accurate Disney+ playhead pushed by the MAIN-world page-API bridge
     // (background.js installPageApiSeekBridge). The isolated content world
     // can't read the page's media player directly.
@@ -96,284 +90,34 @@
         return matchesPlayerUrls(['disneyplus.com']);
     }
 
-    function getSeekableRange(video) {
-        try {
-            const ranges = video.seekable;
-            if (!ranges || ranges.length === 0) return null;
-            const current = video.currentTime;
-            let index = ranges.length - 1;
-            if (Number.isFinite(current)) {
-                for (let i = 0; i < ranges.length; i++) {
-                    if (current >= ranges.start(i) && current <= ranges.end(i)) {
-                        index = i;
-                        break;
-                    }
-                }
-            }
-            const start = ranges.start(index);
-            const end = ranges.end(index);
-            if (!Number.isFinite(start) || !Number.isFinite(end) || end <= start) return null;
-            return { start, end, duration: end - start };
-        } catch (_e) {
-            return null;
-        }
-    }
-
-    function parseClockTime(value) {
-        const parts = String(value || '').trim().split(':').map(Number);
-        if (parts.length < 2 || parts.length > 3 || parts.some(n => !Number.isFinite(n))) return null;
-        return parts.length === 2
-            ? parts[0] * 60 + parts[1]
-            : parts[0] * 3600 + parts[1] * 60 + parts[2];
-    }
-
-    function parseTimelineText(text) {
-        const matches = String(text || '').match(/\b\d{1,3}:\d{2}(?::\d{2})?\b/g);
-        if (!matches || matches.length < 2) return null;
-        const current = parseClockTime(matches[0]);
-        const duration = parseClockTime(matches[matches.length - 1]);
-        if (!Number.isFinite(current) || !Number.isFinite(duration) || duration < 60 || current > duration + 5) return null;
-        return { current, duration };
-    }
-
-    function getDisneyPlusUiTimeline() {
-        if (typeof document === 'undefined') return null;
-        const selectors = [
-            '[role="slider"]',
-            '[role="progressbar"]',
-            '[aria-valuenow][aria-valuemax]',
-            '[aria-valuetext]',
-            '[aria-label]',
-            '[data-testid]',
-            '[data-test]',
-            '[class*="time" i]',
-            '[class*="progress" i]',
-            'time',
-            'output',
-            'button',
-            'span',
-            'p',
-            'div'
-        ].join(',');
-        const nodes = querySelectorAllShadow(selectors).slice(0, 2000);
-        const textParts = [];
-        const candidates = [];
-        let best = null;
-        let bestScore = -1;
-        let remainingSeconds = null;
-
-        function considerTimeline(parsed, source, weight = 0) {
-            if (!parsed) return;
-            const score = weight +
-                (parsed.duration >= 20 * 60 ? 200 : 0) +
-                (parsed.current > 0 ? 50 : 0) -
-                Math.abs((parsed.duration / 2) - parsed.current) / 100;
-            candidates.push({ ...parsed, source, score: Math.round(score) });
-            if (score > bestScore) {
-                bestScore = score;
-                best = parsed;
-            }
-        }
-
-        for (const node of nodes) {
-            const now = Number(node.getAttribute?.('aria-valuenow') ?? node.value);
-            const max = Number(node.getAttribute?.('aria-valuemax') ?? node.max);
-            if (Number.isFinite(now) && Number.isFinite(max) && max >= 60 && now >= 0 && now <= max + 5) {
-                considerTimeline({ current: now, duration: max }, 'aria-value', 300);
-            }
-
-            for (const attr of ['aria-valuetext', 'aria-label', 'title', 'data-testid', 'data-test']) {
-                const parsed = parseTimelineText(node.getAttribute?.(attr));
-                considerTimeline(parsed, attr, 200);
-            }
-
-            const text = String(node.textContent || '').trim();
-            if (text && text.length < 200) {
-                const parsed = parseTimelineText(text);
-                considerTimeline(parsed, 'text', 100);
-                textParts.push(text);
-            }
-            // Disney's scrubber aria-valuenow can lag several seconds behind
-            // real playback; a "time remaining" indicator updates live, so
-            // capture it and later derive current = duration - remaining.
-            const remClass = String(node.getAttribute?.('class') || '') + ' ' + String(node.getAttribute?.('data-testid') || '');
-            if (/remain/i.test(remClass)) {
-                const remMatch = String(node.textContent || '').match(/\d{1,3}:\d{2}(?::\d{2})?/);
-                const rem = remMatch ? parseClockTime(remMatch[0]) : null;
-                if (Number.isFinite(rem) && rem >= 0) remainingSeconds = rem;
-            }
-        }
-
-        if (best && remainingSeconds !== null && best.duration > 0) {
-            const liveCurrent = best.duration - remainingSeconds;
-            if (liveCurrent >= 0 && liveCurrent <= best.duration + 5) {
-                considerTimeline({ current: Math.min(liveCurrent, best.duration), duration: best.duration }, 'time-remaining', 1000);
-            }
-        }
-        considerTimeline(parseTimelineText(textParts.join(' ')), 'combined-text', 25);
-        lastDisneyPlusTimelineCandidates = candidates
-            .sort((a, b) => b.score - a.score)
-            .slice(0, 8)
-            .map(({ source, current, duration }) => ({ source, current, duration }));
-        return best;
-    }
-
-    function getElementLabel(el) {
-        return [
-            el.getAttribute?.('aria-label'),
-            el.getAttribute?.('title'),
-            el.getAttribute?.('data-testid'),
-            el.getAttribute?.('data-test'),
-            el.textContent
-        ].filter(Boolean).join(' ').replace(/\s+/g, ' ').trim();
-    }
-
-    function getDisneyPlusSeekButtonLabels() {
-        if (!isDisneyPlusHost() || typeof document === 'undefined') return [];
-        return querySelectorAllShadow('button,[role="button"]')
-            .map(getElementLabel)
-            .filter(Boolean)
-            .slice(0, 20);
-    }
-
-    function clickDisneyPlusRelativeSeek(delta) {
-        if (!isDisneyPlusHost() || !Number.isFinite(delta) || Math.abs(delta) < 1 || typeof document === 'undefined') return false;
-        const backward = delta < 0;
-        const candidates = querySelectorAllShadow('button,[role="button"]');
-        const backRe = /rewind|backward|back\b|zurück|zurueck|rück|rueck|retour|recul|retroced|atrás|voltar|indietro/i;
-        const forwardRe = /forward|ahead|skip|vorwärts|vorwaerts|vorsp|weiter|avancer|adelant|avançar|avancar|avanti/i;
-        const timeRe = /\b(5|10|15|30)\b|sec|sek|second/i;
-
-        const button = candidates.find(btn => {
-            const label = getElementLabel(btn);
-            const matchesDirection = backward ? backRe.test(label) : forwardRe.test(label);
-            return matchesDirection && timeRe.test(label);
-        }) || candidates.find(btn => {
-            const label = getElementLabel(btn);
-            return backward ? backRe.test(label) : forwardRe.test(label);
-        });
-
-        if (button && typeof button.click === 'function') {
-            // Disney offers no absolute seek on its blob <video>, so we click its
-            // relative skip button. Derive the step from the button's own label
-            // (usually 10s; some UIs 5/15/30) and issue enough clicks to cover the
-            // full delta. The previous 120s cap truncated any larger seek, which
-            // broke absolute-position sync (e.g. seeking to 5:00 from far away).
-            const stepMatch = getElementLabel(button).match(/\b(5|10|15|30)\b/);
-            const step = stepMatch ? Number(stepMatch[1]) : 10;
-            const clicks = Math.max(1, Math.min(90, Math.round(Math.abs(delta) / step)));
-            for (let i = 0; i < clicks; i++) {
-                setTimeout(() => button.click(), i * 60);
-            }
-            return true;
-        }
-
-        // Fallback: Simulate ArrowLeft / ArrowRight keyboard events
-        const clicks = Math.max(1, Math.min(12, Math.round(Math.abs(delta) / 10)));
-        const eventInit = {
-            key: backward ? 'ArrowLeft' : 'ArrowRight',
-            code: backward ? 'ArrowLeft' : 'ArrowRight',
-            keyCode: backward ? 37 : 39,
-            which: backward ? 37 : 39,
-            bubbles: true,
-            cancelable: true,
-            view: window
-        };
-        const target = document.querySelector('.hive-video') || document.activeElement || document.body;
-        for (let i = 0; i < clicks; i++) {
-            setTimeout(() => {
-                target.dispatchEvent(new window.KeyboardEvent('keydown', eventInit));
-                target.dispatchEvent(new window.KeyboardEvent('keyup', eventInit));
-            }, i * 60);
-        }
-        return true;
-    }
-
-    function getDisneyPlusTimeline(video) {
+    function getDisneyPlusTimeline() {
         if (!isDisneyPlusHost()) return null;
-        // Preferred: exact playhead/duration from the page media player,
-        // relayed by the MAIN-world bridge. Authoritative while fresh.
+        // Exact playhead/duration from the page media player, relayed by the
+        // MAIN-world bridge. No Disney DOM scraping fallback.
         if (disneyPageApiTime && (Date.now() - disneyPageApiTime.at) < 2000 && disneyPageApiTime.duration > 0) {
-            lastKnownDisneyPlusDuration = disneyPageApiTime.duration;
             const cur = Math.max(0, Math.min(disneyPageApiTime.duration, disneyPageApiTime.position));
             return { start: 0, end: disneyPageApiTime.duration, duration: disneyPageApiTime.duration, current: cur, nativeScale: 1, nativeStart: 0 };
-        }
-        const range = getSeekableRange(video);
-        const current = video.currentTime;
-        const ui = getDisneyPlusUiTimeline();
-
-        if (ui) {
-            lastKnownDisneyPlusDuration = ui.duration;
-            let nativeScale = 1;
-            if (range && range.duration > ui.duration * 1.2) {
-                nativeScale = range.duration / ui.duration;
-            } else if (Number.isFinite(current) && ui.current > 1 && current > ui.current * 1.5) {
-                nativeScale = current / ui.current;
-            }
-            const nativeStart = Number.isFinite(current)
-                ? current - ui.current * nativeScale
-                : (range ? range.start : 0);
-            lastKnownDisneyPlusScale = nativeScale;
-            lastKnownDisneyPlusStart = nativeStart;
-            lastDisneyPlusUiCurrent = ui.current;
-            lastDisneyPlusNativeAtUi = Number.isFinite(current) ? current : null;
-            return {
-                ...(range || {}),
-                current: ui.current,
-                duration: ui.duration,
-                nativeScale,
-                nativeStart
-            };
-        }
-
-        // No live UI readout (control overlay hidden or mid-rebuild). Extrapolate
-        // from the last live UI position using the native clock, which advances 1:1
-        // with real playback. Disney recreates the <video> on some play/pause
-        // transitions, which resets currentTime; if the native clock jumped back or
-        // leapt implausibly, freeze at the last known position instead of a garbage time.
-        if (lastDisneyPlusUiCurrent !== null && lastKnownDisneyPlusDuration > 0) {
-            let estimated = lastDisneyPlusUiCurrent;
-            if (Number.isFinite(current) && lastDisneyPlusNativeAtUi !== null) {
-                const delta = current - lastDisneyPlusNativeAtUi;
-                if (delta >= 0 && delta < 60) {
-                    estimated = lastDisneyPlusUiCurrent + delta;
-                }
-            }
-            return {
-                start: 0,
-                end: lastKnownDisneyPlusDuration,
-                duration: lastKnownDisneyPlusDuration,
-                current: Math.max(0, Math.min(lastKnownDisneyPlusDuration, estimated)),
-                nativeScale: lastKnownDisneyPlusScale,
-                nativeStart: lastKnownDisneyPlusStart
-            };
-        }
-
-        if (!range || range.start < 1 || range.duration < 60) return null;
-        if (!Number.isFinite(current) || current < range.start - 1 || current > range.end + 1) return null;
-        return { ...range, current: Math.max(0, current - range.start), nativeScale: 1, nativeStart: range.start };
-    }
+        }
+        return null;
+    }
 
     // Site-specific player exceptions live here. The default HTML5 path stays below.
     function getSiteQuirkAdapters() {
         return [{
-            name: 'disneyplus-timeline-and-buttons',
-            key: 'disneyPlus',
-            urls: ['disneyplus.com'],
-            matches() { return matchesPlayerUrls(this.urls); },
-            getTimeline: getDisneyPlusTimeline,
-            clickRelativeSeek: clickDisneyPlusRelativeSeek,
-            getDebug(video) {
-                return {
-                    name: this.name,
-                    key: 'disneyPlus',
-                    urls: this.urls,
-                    timeline: getDisneyPlusTimeline(video),
-                    timelineCandidates: lastDisneyPlusTimelineCandidates,
-                    seekButtons: getDisneyPlusSeekButtonLabels()
-                };
-            }
-        }];
+            name: 'disneyplus-page-api',
+            key: 'disneyPlus',
+            urls: ['disneyplus.com'],
+            matches() { return matchesPlayerUrls(this.urls); },
+            getTimeline: getDisneyPlusTimeline,
+            getDebug(video) {
+                return {
+                    name: this.name,
+                    key: 'disneyPlus',
+                    urls: this.urls,
+                    timeline: getDisneyPlusTimeline(video)
+                };
+            }
+        }];
     }
 
     function getActiveSiteQuirk() {
@@ -419,7 +163,7 @@
             !!window.koalaFindPageApiSeekProvider(window.location.hostname);
     }
 
-    function seekVideo(video, targetTime, relativeDelta = null) {
+    function seekVideo(video, targetTime) {
         // Prefer a precise page-level seek API when available (Netflix, Disney+);
         // for those players the DOM/button seek path is imprecise or impossible.
         if (shouldUsePageApiSeek()) {
@@ -427,21 +171,9 @@
             window.postMessage({ __koalaPageApiSeek: PAGE_API_SEEK_BRIDGE, kind: 'seek', time: targetTime }, '*');
             return;
         }
-        const siteQuirk = getActiveSiteQuirk();
-        let delta = relativeDelta;
-        if (delta === null && siteQuirk) {
-            const current = getSyncCurrentTime(video);
-            if (current !== null) {
-                delta = targetTime - current;
-            }
-        }
-        if (siteQuirk && siteQuirk.clickRelativeSeek(delta)) {
-            expectedSeekTime = null;
-            return;
-        }
         expectedSeekTime = targetTime;
         video.currentTime = toNativeSeekTime(video, targetTime);
-    }
+    }
 

     // --- Play/Pause Coalescing (leading + trailing) ---

     // Media players (HLS/DASH, ad insertion, ABR/quality switches, source swaps,

@@ -1501,11 +1233,10 @@
                     metadata,

                     videoCount,

                     inShadowDom,

-                    platform,
-                    siteQuirk: getSiteQuirkDebug(video),
-                    scrapedTimestamps: getScrapedTimestamps(),
-                    allVideos
-                });
+                    platform,
+                    siteQuirk: getSiteQuirkDebug(video),
+                    allVideos
+                });
             } else {

                 sendResponse({

                     found: false,

@@ -1513,10 +1244,9 @@
                     inShadowDom,

                     platform,

                     allVideos,

-                    url: window.location.href,

-                    pageTitle: document.title,
-                    scrapedTimestamps: getScrapedTimestamps(),
-                    metadata: (navigator.mediaSession && navigator.mediaSession.metadata) ? {

+                    url: window.location.href,
+                    pageTitle: document.title,
+                    metadata: (navigator.mediaSession && navigator.mediaSession.metadata) ? {
                         title: navigator.mediaSession.metadata.title,

                         artist: navigator.mediaSession.metadata.artist,

                         album: navigator.mediaSession.metadata.album

@@ -1733,80 +1463,7 @@
         checkEpisodeTransition();

     };

 

-    function scanShadowDom(node, callback) {
-        if (!node) return;
-        callback(node);
-        const children = node.childNodes || [];
-        for (let i = 0; i < children.length; i++) {
-            scanShadowDom(children[i], callback);
-        }
-        if (node.shadowRoot) {
-            scanShadowDom(node.shadowRoot, callback);
-        }
-    }
-
-    function querySelectorAllShadow(selector) {
-        if (typeof document === 'undefined') return [];
-        if (!document.body && typeof document.querySelectorAll === 'function') {
-            try {
-                return Array.from(document.querySelectorAll(selector));
-            } catch (_e) {
-                return [];
-            }
-        }
-        const results = [];
-        scanShadowDom(document.body || document, (node) => {
-            if (node.nodeType === 1 && typeof node.matches === 'function' && node.matches(selector)) {
-                results.push(node);
-            }
-        });
-        return results;
-    }
-
-    function getScrapedTimestamps() {
-        if (typeof document === 'undefined') return [];
-        try {
-            const results = [];
-            const unique = new Set();
-
-            scanShadowDom(document.body, (node) => {
-                if (node.nodeType !== 1) return;
-                
-                const txt = (node.textContent || '').trim();
-                if (txt && txt.length < 50 && !unique.has(txt)) {
-                    const match = txt.match(/(\d{1,2}:)?\d{1,2}:\d{2}/);
-                    if (match) {
-                        unique.add(txt);
-                        const tag = node.tagName.toLowerCase();
-                        const cls = node.className ? `.${node.className.split(' ')[0]}` : '';
-                        results.push(`${tag}${cls}: "${txt}"`);
-                    }
-                }
-
-                const isSlider = node.getAttribute('role') === 'slider' || 
-                                 node.getAttribute('role') === 'progressbar' ||
-                                 node.hasAttribute('aria-valuenow') ||
-                                 node.tagName.toLowerCase() === 'progress' ||
-                                 (node.tagName.toLowerCase() === 'input' && node.type === 'range');
-                
-                if (isSlider) {
-                    const tag = node.tagName.toLowerCase();
-                    const cls = node.className ? `.${node.className.split(' ')[0]}` : '';
-                    const now = node.getAttribute('aria-valuenow') || node.value || '?';
-                    const max = node.getAttribute('aria-valuemax') || node.max || '?';
-                    const text = node.getAttribute('aria-valuetext') || '?';
-                    const width = node.style?.width || '?';
-                    results.push(`[SLIDER] ${tag}${cls}: now=${now}, max=${max}, text="${text}", width=${width}`);
-                }
-            });
-
-            return results.slice(0, 15);
-        } catch (_e) {
-            return [];
-        }
-    }
-
-    function setupListeners() {

+    function setupListeners() {
         const video = findVideo();

         if (video) {

             if (currentAudioVideo && currentAudioVideo !== video) {

diff --git a/extension/popup.html b/extension/popup.html
index 8a792e9..df2188c 100644
--- a/extension/popup.html
+++ b/extension/popup.html
@@ -700,12 +700,6 @@
             <button id="remoteSeekForward" class="secondary" style="flex:1; font-size:12px;">+30s</button>
         </div>
         <button id="remoteSeekFiveMin" class="secondary" style="width:100%; font-size:12px; margin-bottom:15px;">Seek 5:00</button>
-        <div style="margin-top: 15px;">
-            <label style="font-size:10px; font-weight:700; text-transform:uppercase; letter-spacing:0.5px;">DOM Timestamps (Scraped)</label>
-            <div class="info-card" id="devtoolsDomScraperList" style="font-size:10px; max-height:100px; overflow-y:auto; font-family:monospace; line-height:1.2; padding:6px; background:rgba(0,0,0,0.2); white-space:pre-wrap; border: 1px solid #334155;">
-                No timestamps scraped.
-            </div>
-        </div>
         <div style="font-size:10px; color:var(--text-muted); text-align:center; margin-top:10px; opacity:0.7;">
             Build: <span id="buildIdentifier">__BUILD_TIMESTAMP__</span>
         </div>
diff --git a/extension/popup.js b/extension/popup.js
index 0917a3e..ce66f71 100644
--- a/extension/popup.js
+++ b/extension/popup.js
@@ -2292,13 +2292,6 @@ function refreshDebugInfo() {
                     const buttons = Array.isArray(quirk.seekButtons) ? quirk.seekButtons.slice(0, 4).join(' | ') : '';
                     if (buttons) addField(`${label} Buttons`, buttons);
                 }
-                const domScraperEl = document.getElementById('devtoolsDomScraperList');
-                if (domScraperEl && state.scrapedTimestamps) {
-                    domScraperEl.textContent = state.scrapedTimestamps.length > 0
-                        ? state.scrapedTimestamps.join('\n')
-                        : 'No timestamps scraped.';
-                }
-
                 addSection('Properties');
                 addField('Seeking', String(state.seeking));
                 addField('Ended', String(state.ended));
diff --git a/scripts/test-content-video-finder.cjs b/scripts/test-content-video-finder.cjs
index 2d9ae7a..6c4a7db 100644
--- a/scripts/test-content-video-finder.cjs
+++ b/scripts/test-content-video-finder.cjs
@@ -77,38 +77,15 @@ function makeDocument(nodes = []) {
   };
 }
 
-function makeNode(attrs = {}, textContent = '') {
-  return {
-    textContent,
-    value: attrs.value,
-    max: attrs.max,
-    clicked: 0,
-    click() { this.clicked += 1; },
-    getAttribute(name) { return attrs[name] ?? null; }
-  };
-}
-
-function loadTimelineFns(hostname, document = makeDocument()) {
+function loadTimelineFns(hostname, document = makeDocument(), pageApiTime = null) {
+  const disneyPageApiTime = pageApiTime
+    ? `let disneyPageApiTime = { position: ${pageApiTime.position}, duration: ${pageApiTime.duration}, at: Date.now() - ${pageApiTime.ageMs || 0} };`
+    : 'let disneyPageApiTime = null;';
   return Function('window', 'document', [
-    'let lastDisneyPlusTimelineCandidates = [];',
-    'let lastKnownDisneyPlusDuration = 0;',
-    'let lastKnownDisneyPlusScale = 1;',
-    'let lastKnownDisneyPlusStart = 0;',
-    'let lastDisneyPlusUiCurrent = null;',
-    'let lastDisneyPlusNativeAtUi = null;',
-    'let disneyPageApiTime = null;',
-    extractFunction('scanShadowDom', source),
-    extractFunction('querySelectorAllShadow', source),
+    disneyPageApiTime,
     extractFunction('hostMatchesUrl', source),
     extractFunction('matchesPlayerUrls', source),
     extractFunction('isDisneyPlusHost', source),
-    extractFunction('getSeekableRange', source),
-    extractFunction('parseClockTime', source),
-    extractFunction('parseTimelineText', source),
-    extractFunction('getDisneyPlusUiTimeline', source),
-    extractFunction('getElementLabel', source),
-    extractFunction('getDisneyPlusSeekButtonLabels', source),
-    extractFunction('clickDisneyPlusRelativeSeek', source),
     extractFunction('getDisneyPlusTimeline', source),
     extractFunction('getSiteQuirkAdapters', source),
     extractFunction('getActiveSiteQuirk', source),
@@ -117,7 +94,7 @@ function loadTimelineFns(hostname, document = makeDocument()) {
     extractFunction('getSyncCurrentTime', source),
     extractFunction('getSyncDuration', source),
     extractFunction('toNativeSeekTime', source),
-    'return { getActiveSiteQuirk, getSyncCurrentTime, getSyncDuration, toNativeSeekTime, clickDisneyPlusRelativeSeek };'
+    'return { getActiveSiteQuirk, getSyncCurrentTime, getSyncDuration, toNativeSeekTime };'
   ].join('\n'))({ location: { hostname } }, document);
 }
 
@@ -131,11 +108,11 @@ function loadPlayerFixFns(hostname) {
   ].join('\n'))({ location: { hostname } });
 }
 
-const disneyUiDocument = makeDocument([
-  makeNode({ 'aria-valuetext': '0:09 / 180:00' })
-]);
-const disneyFns = loadTimelineFns('www.disneyplus.com', disneyUiDocument);
-assert.equal(disneyFns.getActiveSiteQuirk().name, 'disneyplus-timeline-and-buttons');
+const disneyFns = loadTimelineFns('www.disneyplus.com', makeDocument(), {
+  position: 9,
+  duration: 10800
+});
+assert.equal(disneyFns.getActiveSiteQuirk().name, 'disneyplus-page-api');
 assert.deepEqual(disneyFns.getActiveSiteQuirk().urls, ['disneyplus.com']);
 const disneyVideo = makeVideo('disney-offset', 1920, 1080, {
   currentTime: 29,
@@ -144,17 +121,17 @@ const disneyVideo = makeVideo('disney-offset', 1920, 1080, {
 });
 assert.equal(disneyFns.getSyncCurrentTime(disneyVideo), 9);
 assert.equal(disneyFns.getSyncDuration(disneyVideo), 10800);
-assert.equal(disneyFns.toNativeSeekTime(disneyVideo, 39), 119);
+assert.equal(disneyFns.toNativeSeekTime(disneyVideo, 39), 39);
 
-const disneySeekableFallbackFns = loadTimelineFns('www.disneyplus.com');
+const disneyNoPageApiFns = loadTimelineFns('www.disneyplus.com');
 const disneyOffsetVideo = makeVideo('disney-offset', 1920, 1080, {
   currentTime: 29,
   duration: 0,
   seekable: makeSeekable([[20, 10820]])
 });
-assert.equal(disneySeekableFallbackFns.getSyncCurrentTime(disneyOffsetVideo), 9);
-assert.equal(disneySeekableFallbackFns.getSyncDuration(disneyOffsetVideo), 10800);
-assert.equal(disneySeekableFallbackFns.toNativeSeekTime(disneyOffsetVideo, 39), 59);
+assert.equal(disneyNoPageApiFns.getSyncCurrentTime(disneyOffsetVideo), 29);
+assert.equal(disneyNoPageApiFns.getSyncDuration(disneyOffsetVideo), 0);
+assert.equal(disneyNoPageApiFns.toNativeSeekTime(disneyOffsetVideo, 39), 39);
 
 const genericFns = loadTimelineFns('example.com');
 assert.equal(genericFns.getActiveSiteQuirk(), null);
@@ -162,12 +139,6 @@ assert.equal(genericFns.getSyncCurrentTime(disneyVideo), 29);
 assert.equal(genericFns.getSyncDuration(disneyVideo), 0);
 assert.equal(genericFns.toNativeSeekTime(disneyVideo, 39), 39);
 
-const backButton = makeNode({ 'aria-label': '10 Sekunden zurück' });
-const forwardButton = makeNode({ 'aria-label': '10 Sekunden vorspulen' });
-const disneyButtonFns = loadTimelineFns('www.disneyplus.com', makeDocument([backButton, forwardButton]));
-assert.equal(disneyButtonFns.clickDisneyPlusRelativeSeek(-30), true);
-assert.equal(disneyButtonFns.clickDisneyPlusRelativeSeek(30), true);
-
 const twitchFixFns = loadPlayerFixFns('player.twitch.tv');
 assert.equal(twitchFixFns.getActivePlayerActionFix().name, 'twitch-player-buttons');
 assert.deepEqual(twitchFixFns.getActivePlayerActionFix().urls, ['twitch.tv']);