Update 5.2.1 - See changelog.txt for details

Author: FoggyBytes

Installer.iss

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

README.md

@@ -66,14 +66,20 @@ 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).
+- **Session quality report:** click the chart button on any session row to open a full-panel telemetry overlay with CLIENT stats (Jitter, Drops, RTT, Decode, Bitrate), HOST stats (GPU, Encoder, GPU Temp, CPU, Net TX), four time-series sparkline charts (RTT, Frame Drops, Bitrate, Decode Latency) with axes and scale labels, and a quality grade badge (Excellent / Good / Poor).
 - **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.2.0 — The "Session Quality Update"
+## ✨ What's New in Version 5.2.1 — The "Chart 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
+* **Session telemetry charts revised —** the four sparklines now show RTT (ms), Frame Drops, Bitrate (Mbps), and Decode Latency (ms); FPS has been replaced by Decode Latency because FPS collapses to near-zero on static screens regardless of streaming quality, making it an unreliable indicator; the four retained metrics jointly cover the full quality picture: RTT (network latency), Frame Drops (packet loss), Bitrate (encoder output and bandwidth headroom), Decode Latency (client hardware load)
+* **Jitter in session stats —** RTT variance is now collected per sample from StreamLight 2.1.1+ and stored as jitter_avg / jitter_max per session; displayed in the CLIENT stats panel alongside RTT
+* **SparklineControl improvements —** bucket-average downsampling for long sessions; chart label rendered above the polyline with a semi-transparent background for readability at all times
+* **Glossary tab —** new dedicated tab in Settings with definitions of all technical terms used across StreamTweak and StreamLight, grouped by category in a terminal-style panel
+
+### Previously in 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 and HOST stats appear side by side, followed by four time-series sparkline charts and a quality grade badge
+* **Quality grade system —** sessions are graded Excellent, Good, or Poor based on drop rate, RTT, and GPU encoder utilization
 * **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"

StreamTweak/App.xaml.cs

@@ -798,11 +798,11 @@ private async void HandleAutoStreamStop(string endReason = "User")
                     string? sessionId = SessionLogger.ActiveSessionId;
                     if (sessionId != null)
                     {
-                        var (stats, fpsSeries, rttSeries, dropsSeries, bitrateSeries) = _telemetryAccumulator.Finalize();
+                        var (stats, rttSeries, dropsSeries, bitrateSeries, decodeSeries) = _telemetryAccumulator.Finalize();
                         if (stats.SampleCount >= 2)
                         {
                             var grade = QualityGradeCalculator.Evaluate(stats, _telemetryAccumulator.TargetFps);
-                            SessionLogger.UpdateSessionTelemetry(sessionId, stats, grade, fpsSeries, rttSeries, dropsSeries, bitrateSeries);
+                            SessionLogger.UpdateSessionTelemetry(sessionId, stats, grade, rttSeries, dropsSeries, bitrateSeries, decodeSeries);
                         }
                         _telemetryAccumulator.Reset();
                     }

StreamTweak/ChartDetailWindow.xaml

@@ -0,0 +1,36 @@
+<Window x:Class="StreamTweak.ChartDetailWindow"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:local="clr-namespace:StreamTweak"
+        MinWidth="600" MinHeight="400"
+        Width="920" Height="580"
+        Background="#FF202020"
+        WindowStyle="SingleBorderWindow"
+        ResizeMode="CanResizeWithGrip"
+        WindowStartupLocation="CenterOwner"
+        Loaded="Window_Loaded">
+    <Grid Margin="20,16,20,20">
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto"/>
+            <RowDefinition Height="4"/>
+            <RowDefinition Height="Auto"/>
+            <RowDefinition Height="14"/>
+            <RowDefinition Height="*"/>
+        </Grid.RowDefinitions>
+
+        <TextBlock x:Name="MetricLabel" Grid.Row="0"
+                   FontSize="15" FontWeight="SemiBold" Foreground="White"
+                   HorizontalAlignment="Center"/>
+
+        <TextBlock x:Name="SubtitleLabel" Grid.Row="2"
+                   FontSize="11"
+                   Foreground="#99FFFFFF"
+                   HorizontalAlignment="Center"/>
+
+        <Border Grid.Row="4"
+                BorderBrush="#33FFFFFF" BorderThickness="1" CornerRadius="6"
+                Padding="6,4">
+            <local:SparklineControl x:Name="DetailChart"/>
+        </Border>
+    </Grid>
+</Window>

StreamTweak/ChartDetailWindow.xaml.cs

@@ -0,0 +1,41 @@
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using System.Windows;
+using System.Windows.Interop;
+using System.Windows.Media;
+
+namespace StreamTweak
+{
+    public partial class ChartDetailWindow : Window
+    {
+        [DllImport("DwmApi")]
+        private static extern int DwmSetWindowAttribute(IntPtr hwnd, int attr, int[] attrValue, int attrSize);
+        private const int DWMWA_USE_IMMERSIVE_DARK_MODE = 20;
+
+        public ChartDetailWindow(IReadOnlyList<float> data, string label, Brush color, SessionEntry session)
+        {
+            InitializeComponent();
+
+            Title = $"{label} — StreamTweak";
+            MetricLabel.Text = label;
+
+            int secs = data.Count;
+            string dur = secs >= 3600
+                ? $"{secs / 3600}h {(secs % 3600) / 60}m {secs % 60:00}s"
+                : secs >= 60
+                    ? $"{secs / 60}m {secs % 60:00}s"
+                    : $"{secs}s";
+            SubtitleLabel.Text = $"{session.StartTimeDisplay}  ·  {dur}";
+
+            DetailChart.Points      = data;
+            DetailChart.Label       = label;
+            DetailChart.StrokeBrush = color;
+        }
+
+        private void Window_Loaded(object sender, RoutedEventArgs e)
+        {
+            var helper = new WindowInteropHelper(this);
+            DwmSetWindowAttribute(helper.Handle, DWMWA_USE_IMMERSIVE_DARK_MODE, new[] { 1 }, sizeof(int));
+        }
+    }
+}

StreamTweak/SessionLogger.cs

@@ -36,6 +36,9 @@ public class SessionEntry
         [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
         public List<float>? BitrateTimeSeries { get; set; }
 
+        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
+        public List<float>? DecodeTimeSeries { get; set; }
+
         // ── Display properties ────────────────────────────────────────────────
 
         [JsonIgnore]
@@ -61,7 +64,7 @@ public string TelemetryDurationDisplay
         {
             get
             {
-                int secs = FpsTimeSeries?.Count ?? RttTimeSeries?.Count ?? 0;
+                int secs = RttTimeSeries?.Count ?? DecodeTimeSeries?.Count ?? 0;
                 if (secs == 0) return DurationDisplay;
                 return secs >= 60
                     ? $"{secs / 60}m {secs % 60}s"
@@ -142,10 +145,10 @@ public static void UpdateSessionTelemetry(
             string sessionId,
             SessionQualityStats stats,
             QualityGrade grade,
-            List<float> fpsSeries,
             List<float> rttSeries,
             List<float> dropsSeries,
-            List<float> bitrateSeries)
+            List<float> bitrateSeries,
+            List<float> decodeSeries)
         {
             try
             {
@@ -155,10 +158,10 @@ public static void UpdateSessionTelemetry(
 
                 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;
+                entry.DecodeTimeSeries  = decodeSeries.Count  > 0 ? decodeSeries  : null;
                 Save(sessions);
             }
             catch { }

StreamTweak/SessionTelemetry.cs

@@ -24,6 +24,8 @@ public sealed class ClientSample
         [JsonPropertyName("drops")]        public int   Drops          { get; set; }
         [JsonPropertyName("rtt_avg")]      public float RttAvg         { get; set; }
         [JsonPropertyName("rtt_max")]      public float RttMax         { get; set; }
+        [JsonPropertyName("jitter_avg")]   public float JitterAvg      { get; set; }
+        [JsonPropertyName("jitter_max")]   public float JitterMax      { get; set; }
         [JsonPropertyName("decode_ms")]    public float DecodeMs       { get; set; }
         [JsonPropertyName("bitrate_mbps")] public float BitrateAvgMbps { get; set; }
     }
@@ -45,6 +47,8 @@ public sealed class SessionQualityStats
         public float DropRatePct     { get; set; }
         public float RttAvgMs        { get; set; }
         public float RttMaxMs        { get; set; }
+        public float JitterAvgMs     { get; set; }
+        public float JitterMaxMs     { get; set; }
         public float DecodeAvgMs     { get; set; }
         public float BitrateAvgMbps  { get; set; }
 
@@ -74,6 +78,8 @@ public sealed class TelemetryAccumulator
         private readonly List<int>   _dropSamples     = new();
         private readonly List<float> _rttAvgSamples   = new();
         private readonly List<float> _rttMaxSamples   = new();
+        private readonly List<float> _jitterSamples   = new();
+        private readonly List<float> _jitterMaxSamples = new();
         private readonly List<float> _decodeSamples   = new();
         private readonly List<float> _bitrateSamples  = new();
 
@@ -89,6 +95,7 @@ public sealed class TelemetryAccumulator
         private readonly List<float> _rttTimeSeries     = new();
         private readonly List<float> _dropsTimeSeries   = new();
         private readonly List<float> _bitrateTimeSeries = new();
+        private readonly List<float> _decodeTimeSeries  = new();
 
         private int  _targetFps;
         private long _totalFrames;
@@ -109,6 +116,8 @@ public void AddBatch(ClientBatch batch, HostMetricsSample host)
                     _dropSamples.Add(s.Drops);
                     _rttAvgSamples.Add(s.RttAvg);
                     _rttMaxSamples.Add(s.RttMax);
+                    _jitterSamples.Add(s.JitterAvg);
+                    _jitterMaxSamples.Add(s.JitterMax);
                     _decodeSamples.Add(s.DecodeMs);
                     _bitrateSamples.Add(s.BitrateAvgMbps);
 
@@ -119,6 +128,7 @@ public void AddBatch(ClientBatch batch, HostMetricsSample host)
                     _rttTimeSeries.Add(s.RttAvg);
                     _dropsTimeSeries.Add(s.Drops);
                     _bitrateTimeSeries.Add(s.BitrateAvgMbps);
+                    _decodeTimeSeries.Add(s.DecodeMs);
                 }
 
                 // Host: un campione per batch (snapshot al momento della ricezione)
@@ -130,7 +140,7 @@ public void AddBatch(ClientBatch batch, HostMetricsSample host)
             }
         }
 
-        public (SessionQualityStats Stats, List<float> FpsSeries, List<float> RttSeries, List<float> DropsSeries, List<float> BitrateSeries) Finalize()
+        public (SessionQualityStats Stats, List<float> RttSeries, List<float> DropsSeries, List<float> BitrateSeries, List<float> DecodeSeries) Finalize()
         {
             lock (_lock)
             {
@@ -139,15 +149,17 @@ public void AddBatch(ClientBatch batch, HostMetricsSample host)
                 var stats = new SessionQualityStats
                 {
                     SampleCount     = count,
-                    FpsAvg          = count > 0 ? _fpsAvgSamples.Average()         : 0f,
-                    FpsMin          = count > 0 ? _fpsMinSamples.Min()              : 0,
+                    FpsAvg          = count > 0 ? _fpsAvgSamples.Average()          : 0f,
+                    FpsMin          = count > 0 ? _fpsMinSamples.Min()               : 0,
                     DropRatePct     = _totalFrames > 0
                                          ? (float)_totalDrops / _totalFrames * 100f
                                          : 0f,
-                    RttAvgMs        = count > 0 ? _rttAvgSamples.Average()         : 0f,
-                    RttMaxMs        = count > 0 ? _rttMaxSamples.Max()              : 0f,
-                    DecodeAvgMs     = count > 0 ? _decodeSamples.Average()          : 0f,
-                    BitrateAvgMbps  = count > 0 ? _bitrateSamples.Average()         : 0f,
+                    RttAvgMs        = count > 0 ? _rttAvgSamples.Average()          : 0f,
+                    RttMaxMs        = count > 0 ? _rttMaxSamples.Max()               : 0f,
+                    JitterAvgMs     = count > 0 ? _jitterSamples.Average()           : 0f,
+                    JitterMaxMs     = count > 0 ? _jitterMaxSamples.Max()            : 0f,
+                    DecodeAvgMs     = count > 0 ? _decodeSamples.Average()           : 0f,
+                    BitrateAvgMbps  = count > 0 ? _bitrateSamples.Average()          : 0f,
 
                     HostGpuAvg      = _gpuSamples.Count     > 0 ? (int)_gpuSamples.Average()     : -1,
                     HostGpuPeak     = _gpuSamples.Count     > 0 ? _gpuSamples.Max()               : -1,
@@ -161,10 +173,10 @@ public void AddBatch(ClientBatch batch, HostMetricsSample host)
                 };
 
                 return (stats,
-                    new List<float>(_fpsTimeSeries),
                     new List<float>(_rttTimeSeries),
                     new List<float>(_dropsTimeSeries),
-                    new List<float>(_bitrateTimeSeries));
+                    new List<float>(_bitrateTimeSeries),
+                    new List<float>(_decodeTimeSeries));
             }
         }
 
@@ -177,6 +189,8 @@ public void Reset()
                 _dropSamples.Clear();
                 _rttAvgSamples.Clear();
                 _rttMaxSamples.Clear();
+                _jitterSamples.Clear();
+                _jitterMaxSamples.Clear();
                 _decodeSamples.Clear();
                 _bitrateSamples.Clear();
                 _gpuSamples.Clear();
@@ -188,6 +202,7 @@ public void Reset()
                 _rttTimeSeries.Clear();
                 _dropsTimeSeries.Clear();
                 _bitrateTimeSeries.Clear();
+                _decodeTimeSeries.Clear();
                 _targetFps   = 0;
                 _totalFrames = 0;
                 _totalDrops  = 0;