Update 5.2.0 - See changelog.txt for details

Author: FoggyBytes

Installer.iss

@@ -1,8 +1,8 @@
 ; =====================================================
-; StreamTweak v5.1.1 - GitHub Release Installer
+; StreamTweak v5.2.0 - GitHub Release Installer
 ; =====================================================
 #define MyAppName "StreamTweak"
-#define MyAppVersion "5.1.1"
+#define MyAppVersion "5.2.0"
 #define MyAppPublisher "FoggyBytes"
 #define MyAppExeName "StreamTweak.exe"
 #define MyAppURL "https://github.com/FoggyBytes/StreamTweak"

README.md

@@ -66,9 +66,17 @@ StreamLight and StreamTweak are designed to work together, giving you full contr
 
 ### 📚 System Info & Diagnostics
 - **Logs Tab:** Full session history — every streaming session is recorded regardless of whether NIC throttle was applied, with NIC Throttle (Yes/No), Original NIC Speed, and timestamped date including year.
+- **Session quality report:** click the chart button on any session row to open a full-panel telemetry overlay with CLIENT stats (FPS, Drops, RTT, Decode, Bitrate), HOST stats (GPU, Encoder, GPU Temp, CPU, Net TX), four time-series sparkline charts with axes and scale labels, and a quality grade badge (High / Medium / Low).
 - **Home Dashboard:** Version info, GitHub link, license badge, donation button, and a real-time status overview for all six managed settings — all in the Home panel.
 
-## ✨ What's New in Version 5.1.1 — The "Code Quality Update"
+## ✨ What's New in Version 5.2.0 — The "Session Quality Update"
+
+* **Session quality report —** click the chart button on any session row in the Logs tab to open a full-panel telemetry overlay; CLIENT stats (FPS, Drops, RTT, Decode, Bitrate) and HOST stats (GPU, Encoder, GPU Temp, CPU, Net TX) appear side by side, followed by four time-series sparkline charts and a quality grade badge
+* **Four sparkline charts —** FPS, RTT (ms), Drops, and Bitrate (Mbps) rendered with Cartesian axes, Y-scale labels (max/mid/min), and X-axis time labels; the section is clearly labeled CLIENT (StreamLight) to distinguish client-side data from host metrics
+* **Quality grade system —** sessions are graded Excellent, Accettable, or Poor based on drop rate, RTT, and GPU encoder utilization; FPS is excluded because static screens and loading screens produce artificially low frame counts that do not reflect actual streaming quality
+* **Animated overlay —** the telemetry panel opens and closes with a smooth CubicEase animation (200 ms / 150 ms) and covers the full Logs panel with an opaque background
+
+### Previously in 5.1.1 — The "Code Quality Update"
 
 * **Bug fixes and hardening —** resource leaks, thread-safety issues, sync reentrancy guards, WQL/PowerShell injection prevention, and atomic file writes for cover art cache
 * **Dead code removed —** unused methods, orphan variables and comments cleaned up
@@ -315,7 +323,7 @@ LogParser.FindStreamingAppInfo()
 
 ## 📝 Installation
 1. Go to the **Releases** page of this repository.
-2. Download the latest `StreamTweak_5.1.1_Installer.exe`
+2. Download the latest `StreamTweak_5.2.0_Installer.exe`
 3. Run the installer and enjoy seamless streaming.
 
 ## 🙏 Support the Project

StreamTweak/App.xaml.cs

@@ -55,6 +55,9 @@ public partial class App : Application
         // Real-time host metrics (GPU, CPU, VRAM, network) for the STATS command
         private readonly HostMetricsCollector _metricsCollector = new();
 
+        // Session quality telemetry — accumulates client metrics sent by StreamLight
+        private readonly TelemetryAccumulator _telemetryAccumulator = new();
+
         // Inactivity timer — prevents restoring speed on temporary reconnect disconnects
         private System.Windows.Threading.DispatcherTimer? inactivityTimer = null;
         private const int INACTIVITY_TIMEOUT_MS = 30000;
@@ -86,8 +89,9 @@ protected override void OnStartup(StartupEventArgs e)
             _ = InitHdrStateAsync();
 
             // Start Moonlight fork TCP bridge
-            _bridge.PrepareRequested += OnBridgePrepareRequested;
-            _bridge.RestoreRequested += OnBridgeRestoreRequested;
+            _bridge.PrepareRequested   += OnBridgePrepareRequested;
+            _bridge.RestoreRequested   += OnBridgeRestoreRequested;
+            _bridge.SessionDataReceived += OnSessionDataReceived;
             _bridge.Start();
             _bridge.StatusProvider = () => {
                 var (mbps, connected) = GetCurrentSpeed();
@@ -613,8 +617,9 @@ private void MenuExit_Click(object sender, RoutedEventArgs e)
         {
             if (_isAutoSessionActive)
                 SessionLogger.EndSession("App Closed");
-            _bridge.PrepareRequested -= OnBridgePrepareRequested;
-            _bridge.RestoreRequested -= OnBridgeRestoreRequested;
+            _bridge.PrepareRequested    -= OnBridgePrepareRequested;
+            _bridge.RestoreRequested    -= OnBridgeRestoreRequested;
+            _bridge.SessionDataReceived -= OnSessionDataReceived;
             _bridge.Dispose();
             _metricsCollector.Dispose();
             StopLogMonitorForced();
@@ -744,6 +749,7 @@ private async void HandleAutoStreamStart(bool skipNicThrottle = false)
                 }
 
                 // Always log the session, with or without NIC throttle
+                _telemetryAccumulator.Reset();
                 _appsToRelaunch = ManagedAppController.KillRunning();
                 _isAutoSessionActive = true;
                 UpdateTrayIcon();
@@ -788,6 +794,19 @@ private async void HandleAutoStreamStop(string endReason = "User")
 
                 if (_isAutoSessionActive)
                 {
+                    // Persist telemetry before EndSession clears the active session ID
+                    string? sessionId = SessionLogger.ActiveSessionId;
+                    if (sessionId != null)
+                    {
+                        var (stats, fpsSeries, rttSeries, dropsSeries, bitrateSeries) = _telemetryAccumulator.Finalize();
+                        if (stats.SampleCount >= 2)
+                        {
+                            var grade = QualityGradeCalculator.Evaluate(stats, _telemetryAccumulator.TargetFps);
+                            SessionLogger.UpdateSessionTelemetry(sessionId, stats, grade, fpsSeries, rttSeries, dropsSeries, bitrateSeries);
+                        }
+                        _telemetryAccumulator.Reset();
+                    }
+
                     SessionLogger.EndSession(endReason);
                     ManagedAppController.StartApps(_appsToRelaunch);
                     _appsToRelaunch.Clear();
@@ -878,6 +897,7 @@ private void OnBridgePrepareRequested()
                     isAutoStreamingActive = true;
                     isStreamingModeActive = true;
                     _isAutoSessionActive = true;
+                    _telemetryAccumulator.Reset();
                     SaveStreamingStateToConfig(true, originalSpeedForAutoStreaming ?? string.Empty);
                     _appsToRelaunch = ManagedAppController.KillRunning();
                     SessionLogger.StartSession("Bridge", originalSpeedForAutoStreaming ?? string.Empty);
@@ -906,6 +926,29 @@ private void OnBridgePrepareRequested()
             });
         }
 
+        /// <summary>
+        /// Called on a thread-pool thread when StreamLight sends a SESSIONDATA batch.
+        /// Guards on active session and session ID cross-check before accumulating.
+        /// </summary>
+        private void OnSessionDataReceived(ClientBatch batch)
+        {
+            try
+            {
+                // Accept batches whenever a session is being logged, regardless of NIC
+                // throttle mode or _isAutoSessionActive state. This ensures telemetry
+                // works even when auto streaming is disabled.
+                if (SessionLogger.ActiveSessionId == null) return;
+
+                var hostSample = _metricsCollector.GetLatestSample();
+                _telemetryAccumulator.AddBatch(batch, hostSample);
+                DebugLog($"Bridge: SESSIONDATA received — {batch.Samples.Count} samples");
+            }
+            catch (Exception ex)
+            {
+                DebugLog($"Bridge: SESSIONDATA handler error — {ex.Message}");
+            }
+        }
+
         /// <summary>
         /// Called when Moonlight fork sends RESTORE after session ends.
         /// Acts as an explicit fallback alongside the log monitor.

StreamTweak/SessionLogger.cs

@@ -17,6 +17,27 @@ public class SessionEntry
 
         public string? EndReason { get; set; }
 
+        // ── Telemetria qualità sessione (null se nessun dato client ricevuto) ──
+        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+        public SessionQualityStats? QualityStats { get; set; }
+
+        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+        public QualityGrade? Grade { get; set; }
+
+        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+        public List<float>? FpsTimeSeries { get; set; }
+
+        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+        public List<float>? RttTimeSeries { get; set; }
+
+        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+        public List<float>? DropsTimeSeries { get; set; }
+
+        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+        public List<float>? BitrateTimeSeries { get; set; }
+
+        // ── Display properties ────────────────────────────────────────────────
+
         [JsonIgnore]
         public string DurationDisplay
         {
@@ -35,6 +56,19 @@ public string DurationDisplay
         [JsonIgnore]
         public string StartTimeDisplay => StartTime.ToString("dd/MM/yyyy  HH:mm");
 
+        [JsonIgnore]
+        public string TelemetryDurationDisplay
+        {
+            get
+            {
+                int secs = FpsTimeSeries?.Count ?? RttTimeSeries?.Count ?? 0;
+                if (secs == 0) return DurationDisplay;
+                return secs >= 60
+                    ? $"{secs / 60}m {secs % 60}s"
+                    : $"{secs}s";
+            }
+        }
+
         [JsonIgnore]
         public string NicThrottleDisplay => string.IsNullOrEmpty(OriginalSpeed) ? "No" : "Yes";
 
@@ -51,6 +85,8 @@ public static class SessionLogger
 
         private static string? _activeSessionId = null;
 
+        public static string? ActiveSessionId => _activeSessionId;
+
         public static void StartSession(string triggerMode, string originalSpeed)
         {
             try
@@ -102,6 +138,32 @@ public static void Initialize()
             catch { }
         }
 
+        public static void UpdateSessionTelemetry(
+            string sessionId,
+            SessionQualityStats stats,
+            QualityGrade grade,
+            List<float> fpsSeries,
+            List<float> rttSeries,
+            List<float> dropsSeries,
+            List<float> bitrateSeries)
+        {
+            try
+            {
+                var sessions = Load();
+                var entry = sessions.FirstOrDefault(s => s.Id == sessionId);
+                if (entry == null) return;
+
+                entry.QualityStats      = stats;
+                entry.Grade             = grade;
+                entry.FpsTimeSeries     = fpsSeries.Count     > 0 ? fpsSeries     : null;
+                entry.RttTimeSeries     = rttSeries.Count     > 0 ? rttSeries     : null;
+                entry.DropsTimeSeries   = dropsSeries.Count   > 0 ? dropsSeries   : null;
+                entry.BitrateTimeSeries = bitrateSeries.Count > 0 ? bitrateSeries : null;
+                Save(sessions);
+            }
+            catch { }
+        }
+
         public static void EndSession(string endReason = "User")
         {
             // Atomically capture and clear the session ID so concurrent callers