Release v1.1.7 — pacing, 3.6K, UI cleanup, surround fix

Ship always-on smooth pacing with panel-refresh anchoring and 0.5-frame
drift, restore 3.6K for C5, move About into help, drop soft-recovery /
pacing toggles, and keep conditional 5.1 remap from v1.1.6.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: GuiDev1994

CMakeLists.txt

@@ -1,7 +1,7 @@
 cmake_minimum_required(VERSION 3.19)
 set(CMAKE_POLICY_VERSION_MINIMUM 3.5)
 
-set(MOONLIGHT_VERSION "1.1.6")
+set(MOONLIGHT_VERSION "1.1.7")
 
 project(moonlight VERSION ${MOONLIGHT_VERSION} LANGUAGES C CXX)
 

README.md

@@ -7,7 +7,7 @@ Unofficial fork of [Moonlight TV](https://github.com/mariotaku/moonlight-tv) for
 ## Highlights
 
 - **AMOLED layout** — pure black background, dark surfaces, violet accent.
-- **Native 4K (3840×2160)** streaming with HDR10 when supported.
+- **3.6K (3584×2016)** recommended on LG C5 (stable quality without native-4K cumulative delay); **4K** when the set handles it.
 - **HDR10 (PQ)** over HEVC Main10 (when supported).
 - Bitrate slider up to **300 Mbps**; above **250 Mbps** there is usually no visible gain and packet loss becomes more likely as the link becomes less stable.
 - **Performance stats overlay**, **full on-screen keyboard**, and **virtual mouse** during streaming.
@@ -28,7 +28,7 @@ Unofficial fork of [Moonlight TV](https://github.com/mariotaku/moonlight-tv) for
 
 | Setting | Suggestion |
 |---------|------------|
-| Resolution | **4K** (3840×2160) |
+| Resolution | **3.6K** (3584×2016) on LG C5; **4K** if your set is stable at native 4K |
 | FPS | 60 or 120 |
 | Codec | HEVC (H.265) |
 | Bitrate | Start at **120–180 Mbps**; stay at or below **250 Mbps** for a stable link. Higher values rarely help and can increase packet loss. |

docs/superpowers/specs/2026-07-20-aggressive-pacing-and-ui-cleanup-design.md

@@ -0,0 +1,21 @@
+# Aggressive pacing + UI cleanup (3.6K, About, stats)
+
+**Date:** 2026-07-20  
+**Status:** Shipped in v1.1.7  
+**Pacing choice:** Tight PTS grid (0.5 frame max drift) + panel-refresh interval when near stream fps. P-frame dropping was rejected (HEVC corruption).
+
+## Scope
+
+1. Restore **3.6K (3584×2016)** resolution preset (C5 practical limit).
+2. Remove settings: Soft recovery, Pause at decode time, Smooth frame pacing (legacy INI keys ignored).
+3. Always-on aggressive frame pacing (NDL webOS5 + SMP): `SS4S_SMOOTH_PACING_MAX_DRIFT_FRAMES=0.5`; interval from panel Hz when within ±2 of stream.
+4. Remove controller battery from performance overlay.
+5. Move About from settings tabs into launcher **?** help popup.
+
+## Non-goals
+
+- Reintroduce Flush+IDR / SMP force / Starfish A-B-C / destructive P-frame drops.
+
+## Success
+
+3.6K selectable; Video pane without the three dead toggles; less microstutter at 1080p/2K/3.6K; clean stats; About under ?.

src/app/app_settings.c

@@ -165,15 +165,6 @@ void settings_initialize(app_settings_t *config, char *conf_dir) {
     config->stick_deadzone = 7;
     config->client_refresh_rate_x100 = 0;
     config->use_ntsc_refresh = false;
-#if defined(TARGET_WEBOS)
-    config->smooth_frame_pacing = true;
-    config->pause_at_decode_time = true;
-    config->soft_recovery = true;
-#else
-    config->smooth_frame_pacing = false;
-    config->pause_at_decode_time = true;
-    config->soft_recovery = false;
-#endif
     config->auto_adjust_bitrate = false;
     config->abr_mode = 0;
 
@@ -245,9 +236,6 @@ bool settings_save(app_settings_t *config) {
     ini_write_bool(fp, "show_stats_compact", config->show_stats_compact);
     ini_write_int(fp, "client_refresh_rate_x100", config->client_refresh_rate_x100);
     ini_write_bool(fp, "use_ntsc_refresh", config->use_ntsc_refresh);
-    ini_write_bool(fp, "smooth_frame_pacing", config->smooth_frame_pacing);
-    ini_write_bool(fp, "pause_at_decode_time", config->pause_at_decode_time);
-    ini_write_bool(fp, "soft_recovery", config->soft_recovery);
 
     ini_write_section(fp, "audio");
     ini_write_string(fp, "backend", config->audio_backend);
@@ -391,12 +379,10 @@ static int settings_parse(app_settings_t *config, const char *section, const cha
         }
     } else if (INI_FULL_MATCH("video", "use_ntsc_refresh")) {
         config->use_ntsc_refresh = INI_IS_TRUE(value);
-    } else if (INI_FULL_MATCH("video", "smooth_frame_pacing")) {
-        config->smooth_frame_pacing = INI_IS_TRUE(value);
-    } else if (INI_FULL_MATCH("video", "pause_at_decode_time")) {
-        config->pause_at_decode_time = INI_IS_TRUE(value);
-    } else if (INI_FULL_MATCH("video", "soft_recovery")) {
-        config->soft_recovery = INI_IS_TRUE(value);
+    } else if (INI_FULL_MATCH("video", "smooth_frame_pacing") ||
+               INI_FULL_MATCH("video", "pause_at_decode_time") ||
+               INI_FULL_MATCH("video", "soft_recovery")) {
+        /* Legacy keys ignored (removed from settings). */
     } else if (INI_FULL_MATCH("video", "force_full_color_range")) {
         config->force_full_color_range = INI_IS_TRUE(value);
     } else if (INI_NAME_MATCH("surround")) {

src/app/app_settings.h

@@ -66,22 +66,6 @@ typedef struct app_settings_t {
      * (e.g. 120 → 11988). When false, presets use integer fps (client_refresh_rate_x100 = 0).
      */
     bool use_ntsc_refresh;
-    /**
-     * webOS NDL/SMP: stamp video PTS on a virtual frame grid instead of wall-clock feed time.
-     * Reduces pan hitching when encode/arrival jitter is high (default true).
-     * When enabled, host presentationTimeUs is mapped into the player PTS when available.
-     */
-    bool smooth_frame_pacing;
-    /**
-     * webOS SMP/Starfish: pass pauseAtDecodeTime in Load payload (default true).
-     * Independent of smooth_frame_pacing (PTS grid). Set false only for latency experiments.
-     */
-    bool pause_at_decode_time;
-    /**
-     * webOS: Phase B soft recovery for ≥4K decode backlog (temporary bitrate drop).
-     * Independent of Flush+IDR. Default true for 1.1.5 device testing.
-     */
-    bool soft_recovery;
     bool auto_adjust_bitrate;
     int abr_mode;
     char *conf_dir;
@@ -109,6 +93,8 @@ extern const size_t audio_config_len;
 #define RES_1080P RES_MERGE(1920, 1080)
 #define RES_1440P RES_MERGE(2560, 1440)
 #define RES_1800P RES_MERGE(3200, 1800)
+/** ~90% of 4K (3584×2016); practical limit on LG C5 without cumulative 4K delay */
+#define RES_3_6K RES_MERGE(3584, 2016)
 #define RES_4K RES_MERGE(3840, 2160)
 
 /** Fixed decode-unit reassembly buffer (megabytes). */

src/app/stream/session.c

@@ -280,7 +280,6 @@ void session_config_init(app_t *app, session_config_t *config, const SERVER_DATA
     }
     config->auto_adjust_bitrate = app_config->auto_adjust_bitrate;
     config->abr_mode = app_config->abr_mode;
-    config->soft_recovery = app_config->soft_recovery;
 
     SS4S_VideoCapabilities video_cap = app->ss4s.video_cap;
     SS4S_AudioCapabilities audio_cap = app->ss4s.audio_cap;

src/app/stream/session.h

@@ -68,7 +68,6 @@ typedef struct session_config_t {
     uint8_t stick_deadzone;
     bool auto_adjust_bitrate;
     int abr_mode;
-    bool soft_recovery;
 } session_config_t;
 
 extern int streaming_errno;

src/app/stream/session_worker.c

@@ -17,30 +17,59 @@
 #include <stdlib.h>
 #include <stdio.h>
 
+#if TARGET_WEBOS
+#include <SDL.h>
+#endif
+
 static void session_apply_smooth_pacing_env(const session_t *session) {
 #if TARGET_WEBOS
-    const app_settings_t *cfg = app_configuration;
-    bool smooth = cfg != NULL ? cfg->smooth_frame_pacing : true;
-    const char *smooth_val = smooth ? "1" : "0";
-    /* Shared names for SMP + NDL; keep NDL_* aliases for older module builds. */
-    setenv("SS4S_SMOOTH_PACING", smooth_val, 1);
-    setenv("SS4S_NDL_SMOOTH_PACING", smooth_val, 1);
-
-    int x100 = session->config.stream.clientRefreshRateX100;
+    /* Always-on aggressive pacing (no user toggle). */
+    setenv("SS4S_SMOOTH_PACING", "1", 1);
+    setenv("SS4S_NDL_SMOOTH_PACING", "1", 1);
+    /* Historical Starfish default; not exposed in settings. */
+    setenv("SS4S_PAUSE_AT_DECODE_TIME", "1", 1);
+    /* Tight drift: 0.5 frame (SS4S reads as percent of interval via maxDrift factor). */
+    setenv("SS4S_SMOOTH_PACING_MAX_DRIFT_FRAMES", "0.5", 1);
+
+    /* Prefer measured panel refresh for the PTS grid so display cadence matches the OLED,
+     * not only the host's clientRefreshRateX100 / stream fps (common microstutter source). */
+    int stream_x100 = session->config.stream.clientRefreshRateX100;
+    if (stream_x100 <= 0 && session->config.stream.fps > 0) {
+        stream_x100 = session->config.stream.fps * 100;
+    }
+
+    int x100 = stream_x100;
+    int panel_hz = 0;
+    const char *source = "stream";
+    if (SDL_webOSGetRefreshRate(&panel_hz) && panel_hz >= 20 && panel_hz <= 240) {
+        int panel_x100 = panel_hz * 100;
+        if (stream_x100 <= 0) {
+            x100 = panel_x100;
+            source = "panel";
+        } else {
+            int stream_hz = (stream_x100 + 50) / 100;
+            /* Same ballpark (±2 Hz): anchor PTS to the panel. Far apart: keep stream. */
+            if (abs(stream_hz - panel_hz) <= 2) {
+                x100 = panel_x100;
+                source = "panel";
+            }
+        }
+    }
+
     if (x100 > 0) {
-        /* interval_us = 1e6 * 100 / x100  (e.g. 11988 → ~8341 µs) */
+        /* interval_us = 1e6 * 100 / x100  (e.g. 12000 → 8333 µs) */
         long interval_us = (100000000L + (x100 / 2)) / x100;
         char buf[32];
         snprintf(buf, sizeof(buf), "%ld", interval_us);
         setenv("SS4S_SMOOTH_PACING_INTERVAL_US", buf, 1);
         setenv("SS4S_NDL_PACING_INTERVAL_US", buf, 1);
+        commons_log_info("Session",
+                         "Smooth pacing interval %ld µs from %s (x100=%d, stream_x100=%d, panel=%d Hz)",
+                         interval_us, source, x100, stream_x100, panel_hz);
     } else {
         unsetenv("SS4S_SMOOTH_PACING_INTERVAL_US");
         unsetenv("SS4S_NDL_PACING_INTERVAL_US");
     }
-
-    bool pause_at_decode = cfg == NULL || cfg->pause_at_decode_time;
-    setenv("SS4S_PAUSE_AT_DECODE_TIME", pause_at_decode ? "1" : "0", 1);
 #else
     (void) session;
 #endif
@@ -140,13 +169,13 @@ int session_worker(session_t *session) {
     }
     session_set_state(session, STREAMING_STREAMING);
     bus_pushevent(USER_STREAM_OPEN, NULL, NULL);
-    if (session->config.auto_adjust_bitrate || session->config.soft_recovery) {
+    if (session->config.auto_adjust_bitrate) {
         adaptive_bitrate_config_t abr_config = {
             .gs_client = client,
             .server = server,
             .initial_bitrate = session->config.stream.bitrate,
             .mode = (abr_mode_t) session->config.abr_mode,
-            .recovery_only = session->config.soft_recovery && !session->config.auto_adjust_bitrate,
+            .recovery_only = false,
         };
         session->abr = adaptive_bitrate_start(&abr_config);
     }

src/app/stream/video/session_video.c

@@ -19,7 +19,6 @@
 #include "ss4s.h"
 #include "stream/connection/session_connection.h"
 #include "stream/session_priv.h"
-#include "stream/adaptive_bitrate.h"
 #include "app.h"
 
 #include <SDL.h>
@@ -69,85 +68,6 @@ VIDEO_STATS vdec_summary_stats;
 static unsigned vdec_stats_seq;
 VIDEO_INFO vdec_stream_info;
 
-#if defined(TARGET_WEBOS)
-#define SOFT_REC_SUSTAIN_MS 3000u
-#define SOFT_REC_COOLDOWN_MS 20000u
-#define SOFT_REC_HOLD_MS 15000
-#define SOFT_REC_DROP_PERCENT 75
-#define SOFT_REC_RQ_THRESHOLD 2
-#define SOFT_REC_LATENCY_MS 80.0f
-
-static Uint32 soft_rec_high_since = 0;
-static Uint32 soft_rec_cooldown_until = 0;
-
-static void soft_recovery_reset(void) {
-    soft_rec_high_since = 0;
-    soft_rec_cooldown_until = 0;
-}
-
-static bool soft_recovery_is_4k(void) {
-    int w = session != NULL ? session->config.stream.width : 0;
-    int h = session != NULL ? session->config.stream.height : 0;
-    if (vdec_stream_info.width > 0 && vdec_stream_info.height > 0) {
-        w = vdec_stream_info.width;
-        h = vdec_stream_info.height;
-    }
-    return ((int64_t) w * (int64_t) h) >= ((int64_t) 3840 * 2160);
-}
-
-static bool soft_recovery_pressure(const struct VIDEO_STATS *dst) {
-    if (dst->videoRenderQueue >= SOFT_REC_RQ_THRESHOLD) {
-        return true;
-    }
-    float target = (float) vdec_stream_target_fps;
-    if (target < 1.0f) {
-        target = 60.0f;
-    }
-    if (dst->receivedFps >= target * 0.9f && dst->decodedFps < target * 0.85f && dst->submittedFrames > 0) {
-        return true;
-    }
-    if (vdec_stream_info.has_decoder_latency && dst->avgDecoderLatency > SOFT_REC_LATENCY_MS) {
-        return true;
-    }
-    return false;
-}
-
-static void soft_recovery_tick(const struct VIDEO_STATS *dst) {
-    if (session == NULL || !session->config.soft_recovery || session->abr == NULL) {
-        return;
-    }
-    if (!soft_recovery_is_4k()) {
-        soft_rec_high_since = 0;
-        return;
-    }
-    Uint32 now = SDL_GetTicks();
-    if (soft_rec_cooldown_until != 0 && now < soft_rec_cooldown_until) {
-        return;
-    }
-    if (!soft_recovery_pressure(dst)) {
-        soft_rec_high_since = 0;
-        return;
-    }
-    if (soft_rec_high_since == 0) {
-        soft_rec_high_since = now;
-        return;
-    }
-    if (now - soft_rec_high_since < SOFT_REC_SUSTAIN_MS) {
-        return;
-    }
-    if (adaptive_bitrate_request_drop(session->abr, SOFT_REC_DROP_PERCENT, SOFT_REC_HOLD_MS,
-                                      "4K decode backlog")) {
-        commons_log_info("Session",
-                         "Soft recovery: sustained 4K backlog (RQ=%d decodedFps=%.1f latency=%.1fms) "
-                         "→ request %d%% bitrate",
-                         dst->videoRenderQueue, dst->decodedFps, dst->avgDecoderLatency,
-                         SOFT_REC_DROP_PERCENT);
-        soft_rec_cooldown_until = now + SOFT_REC_COOLDOWN_MS;
-    }
-    soft_rec_high_since = 0;
-}
-#endif
-
 static int vdec_delegate_setup(int videoFormat, int width, int height, int redrawRate, void *context, int drFlags);
 
 static void vdec_delegate_cleanup(void);
@@ -230,9 +150,6 @@ int vdec_delegate_setup(int videoFormat, int width, int height, int redrawRate,
     frames_since_idr = 0;
     vdec_stream_target_fps = redrawRate > 0 ? redrawRate : 60;
     vdec_warned_near_buffer_limit = false;
-#if defined(TARGET_WEBOS)
-    soft_recovery_reset();
-#endif
 
     if (videoFormat & VIDEO_FORMAT_MASK_AV1) {
         vdec_stream_info.width = width;
@@ -299,9 +216,6 @@ void vdec_delegate_cleanup(void) {
     buffer = NULL;
     buffer_size = 0;
     buffer_initial_size = 0;
-#if defined(TARGET_WEBOS)
-    soft_recovery_reset();
-#endif
     SS4S_PlayerVideoClose(player);
     session = NULL;
 }
@@ -458,7 +372,7 @@ void vdec_stat_submit(const struct VIDEO_STATS *src, unsigned long now) {
         LiGetEstimatedRttInfo(&dst->rtt, &dst->rttVariance);
     }
 
-    /* Always sample latency/RQ so soft recovery works with the overlay hidden. */
+    /* Always sample latency/RQ for overlay when shown. */
     int latencyUS = 0;
     if (player != NULL && SS4S_PlayerGetVideoLatency(player, 0, &latencyUS)) {
         dst->avgDecoderLatency = (float) latencyUS / 1000.0f;
@@ -475,10 +389,6 @@ void vdec_stat_submit(const struct VIDEO_STATS *src, unsigned long now) {
     }
     vdec_stats_write_end();
 
-#if defined(TARGET_WEBOS)
-    soft_recovery_tick(dst);
-#endif
-
     if (show_stats) {
         app_bus_post(session->app, (bus_actionfunc) streaming_refresh_stats, NULL);
     }