From c25da2e011bc2b7ed5c608b6f9a088aa8ae65a03 Mon Sep 17 00:00:00 2001
From: Trevor Mears <trevor.mears@gmail.com>
Date: Sat, 27 Dec 2025 23:36:27 -0800
Subject: [PATCH] Improved HLS buffer settings to prevent audio underruns

---
 public/js/components/VideoPlayer.js | 27 ++++++++++++++++++++++-----
 1 file changed, 22 insertions(+), 5 deletions(-)

diff --git a/public/js/components/VideoPlayer.js b/public/js/components/VideoPlayer.js
index 8ece5de..5d0c063 100644
--- a/public/js/components/VideoPlayer.js
+++ b/public/js/components/VideoPlayer.js
@@ -56,6 +56,26 @@ class VideoPlayer {
         }
     }
 
+    /**
+     * Get HLS.js configuration with buffer settings optimized for stable playback
+     */
+    getHlsConfig() {
+        return {
+            enableWorker: true,
+            // Buffer settings to prevent underruns during background tab throttling
+            maxBufferLength: 30,           // Buffer up to 30 seconds of content
+            maxMaxBufferLength: 60,        // Absolute max buffer 60 seconds
+            maxBufferSize: 60 * 1000 * 1000, // 60MB max buffer size
+            // Live stream settings - stay further from live edge for stability
+            liveSyncDurationCount: 3,      // Stay 3 segments behind live
+            liveMaxLatencyDurationCount: 10, // Allow up to 10 segments behind before catching up
+            // Faster recovery from errors
+            levelLoadingMaxRetry: 4,
+            manifestLoadingMaxRetry: 4,
+            fragLoadingMaxRetry: 6
+        };
+    }
+
     init() {
         // Apply default/remembered volume
         const volume = this.settings.rememberVolume ? this.settings.lastVolume : this.settings.defaultVolume;
@@ -71,10 +91,7 @@ class VideoPlayer {
 
         // Initialize HLS.js if supported
         if (Hls.isSupported()) {
-            this.hls = new Hls({
-                enableWorker: true,
-                lowLatencyMode: true
-            });
+            this.hls = new Hls(this.getHlsConfig());
 
             this.hls.on(Hls.Events.ERROR, (event, data) => {
                 console.error('HLS error:', data);
@@ -171,7 +188,7 @@ class VideoPlayer {
 
             // Priority 1: Use HLS.js for all browsers that support it (Chrome, Firefox, Edge, etc.)
             if (Hls.isSupported()) {
-                this.hls = new Hls();
+                this.hls = new Hls(this.getHlsConfig());
                 this.hls.loadSource(finalUrl);
                 this.hls.attachMedia(this.video);