From a3dd0791db06ad3e0af97b0362c684f9fbdf752f Mon Sep 17 00:00:00 2001
From: gramps <gramps@llamachile.shop>
Date: Mon, 17 Aug 2026 07:45:29 -0700
Subject: [PATCH] =?UTF-8?q?fix:=20creator=20feedback=20batch=20Branch=201?=
 =?UTF-8?q?=20=E2=80=94=20TRAX=20volume,=20tooltip,=20meter=20boost,=20sli?=
 =?UTF-8?q?der=20click,=20backdrop?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- TRAX: LocalGain now applies 0.2× factor so music is quieter relative to desktop audio slider
- TRAX tooltip: switched to ToolTipService with Placement=Top to fix z-order in Viewbox overlay
- Mic meter: MeterLevel multiplied by 1.2× before clamping for ~20% higher visual readout
- Volume sliders: click anywhere on track to jump thumb to that position before dragging
- Backdrop: Image Visibility now binds to BackdropVisible; compositor checks IsVisible before blit
- Renamed 'Backdrop' to 'Game Capture' in EnsureBackdrop + test assertions
---
 HANDOFF.md                                  | 10 ++++------
 MainWindow.xaml                             |  4 +++-
 MainWindow.xaml.cs                          | 13 +++++++++++++
 Services/Compositor/SceneCompositor.cs      |  2 +-
 TASKS.md                                    | 15 +++++++++++++++
 ViewModels/MainViewModel.cs                 | 13 ++++++++++---
 ytLive.Tests/LayoutStorePersistenceTests.cs |  2 +-
 7 files changed, 47 insertions(+), 12 deletions(-)

diff --git a/HANDOFF.md b/HANDOFF.md
index 6697972..25c7cdc 100644
--- a/HANDOFF.md
+++ b/HANDOFF.md
@@ -5,10 +5,10 @@
 > a problem. Conventions: [`schema.md`](schema.md). Rewrite this file at session
 > end, compaction, or any interruption.
 
-## Session state (last updated: 2026-08-16, renumbering finalised)
+## Session state (last updated: 2026-08-17, creator feedback batch Branch 1)
 
-- **Branch:** `main`, tracking `origin/main`. Working tree: the **TASK 9 reusable-stream slice** is
-  committed + pushed (details below). Local branches `social-bar`/`webcam-validation` untouched (no secrets).
+- **Branch:** `main`, tracking `origin/main`. Working tree: **TASK 14 Branch 1 (quick fixes)** — TRAX volume, tooltip, mic meter boost, click-to-position sliders, backdrop visibility + rename. Build **0 warnings**, **207 tests passing**. Ready to commit.
+- **TASK 14 — CREATOR FEEDBACK BATCH — IN PROGRESS.** Branch 1 shipped: TRAX volume 0.2× factor, TRAX tooltip z-order fix, mic meter +20% boost, click-to-position volume sliders, backdrop visibility binding + compositor guard, rename "Backdrop" → "Game Capture". Branch 2 pending: Elements panel, webcam border config, Countdown source (Starting/BRB), Web source.
 - **TASK 9 — REUSABLE STREAM + HEALTH BANNER — SHIPPED 2026-08-16 (items 1–3).**
   - **Items 1–2 (reusable stream):** `_rtmpUrlProvider` now yields a real RTMP URL.
     `YouTubeStreamService` gains `GetOrCreateReusableStreamAsync` (lists `liveStreams?mine=true`,
@@ -40,9 +40,7 @@
 - **TASK 13 added** — marcom/launch kit. Business details moved to `MARCOM.md`. Queued after all v1 features.
 - **Backlog updated** — removed v0.3 (stream scheduling, not needed for casual streamers). Multi-destination
   restreaming noted as "congrats, you're ready for OBS" moment.
-- **Resume point (next branch):** **TASK 9 item 4 — live chat** (`liveChat/messages` poll, right-panel
-  render, Super Chat + membership badges). Then item 5 (error handling), item 6 (visibility unlock),
-  item 7 (full broadcast form), then TASK 10 (billing + unlock + support).
+- **Resume point (next branch):** **TASK 14 Branch 2** — Elements panel beneath Sources (per-element config with live preview, ✕ revert / ✓ commit), webcam border config (color #RRGGBB + picker, thickness 0–10), Countdown source (Starting/BRB scenes, timer 1–60 min), Web source (all scenes, URI input). Then **TASK 9 item 4 — live chat**.
 - **TASK 12 — MASTER LIMITER — COMMITTED + PUSHED 2026-08-15.** Queued from the TRAX discussion: the
   live mix summed mic + loopback with no ceiling, so hot gains could pass 0 dBFS and clip the AAC
   encode. New pure `Services/Audio/MasterLimiter.cs` (−1 dBFS ceiling, instant attack per frame,
diff --git a/MainWindow.xaml b/MainWindow.xaml
index 0af4d8d..a9aa416 100644
--- a/MainWindow.xaml
+++ b/MainWindow.xaml
@@ -389,6 +389,7 @@
                                 <!-- Live desktop/game backdrop (bottom layer; the static
                                      background renders above it). -->
                                 <Image Source="{Binding BackdropImage}" Stretch="UniformToFill"
+                                       Visibility="{Binding BackdropVisible, Converter={StaticResource BoolToVis}}"
                                        IsHitTestVisible="False"/>
                                 <Image Source="{Binding ActiveBackgroundImage}" Stretch="UniformToFill"
                                        IsHitTestVisible="False"/>
@@ -779,7 +780,8 @@
                                      desktop audio controls. -->
                                 <Button Style="{StaticResource YtButtonSecondary}" Padding="8,2"
                                         FontSize="11" VerticalAlignment="Center" Margin="0,0,8,0"
-                                        ToolTip="{Binding TraxToolTip}"
+                                        ToolTipService.ToolTip="{Binding TraxToolTip}"
+                                        ToolTipService.Placement="Top"
                                         Click="TraxButton_Click"
                                         PreviewMouseRightButtonUp="TraxButton_PreviewMouseRightButtonUp">
                                     <StackPanel Orientation="Horizontal">
diff --git a/MainWindow.xaml.cs b/MainWindow.xaml.cs
index 624c4a3..d084ea7 100644
--- a/MainWindow.xaml.cs
+++ b/MainWindow.xaml.cs
@@ -83,6 +83,8 @@ public partial class MainWindow : Window
 
     private void VolumeSlider_PreviewMouseLeftButtonDown(object sender, MouseButtonEventArgs e)
     {
+        if (sender is Slider slider)
+            SetSliderValueFromClick(slider, e);
         if (sender is FrameworkElement { DataContext: MainViewModel vm })
             vm.SetVolumeAdjusting(true);
     }
@@ -101,6 +103,8 @@ public partial class MainWindow : Window
 
     private void GameVolumeSlider_PreviewMouseLeftButtonDown(object sender, MouseButtonEventArgs e)
     {
+        if (sender is Slider slider)
+            SetSliderValueFromClick(slider, e);
         if (sender is FrameworkElement { DataContext: MainViewModel vm })
             vm.SetGameVolumeAdjusting(true);
     }
@@ -117,6 +121,15 @@ public partial class MainWindow : Window
             vm.SetGameVolumeAdjusting(false);
     }
 
+    private static void SetSliderValueFromClick(Slider slider, MouseButtonEventArgs e)
+    {
+        var track = slider.Template.FindName("PART_Track", slider) as System.Windows.Controls.Primitives.Track;
+        if (track == null) return;
+        var pos = e.GetPosition(track);
+        var fraction = Math.Clamp(pos.X / track.RenderSize.Width, 0, 1);
+        slider.Value = slider.Minimum + fraction * (slider.Maximum - slider.Minimum);
+    }
+
     private void MicSpeaker_MouseLeftButtonUp(object sender, MouseButtonEventArgs e)
     {
         if (sender is FrameworkElement { DataContext: MainViewModel vm })
diff --git a/Services/Compositor/SceneCompositor.cs b/Services/Compositor/SceneCompositor.cs
index fa09ea0..0f0f7ac 100644
--- a/Services/Compositor/SceneCompositor.cs
+++ b/Services/Compositor/SceneCompositor.cs
@@ -46,7 +46,7 @@ public sealed class SceneCompositor
         var elements = scene.Elements;
 
         var backdrop = elements.OfType<Source>().FirstOrDefault(s => s.IsBackdrop);
-        var backdropFrame = backdrop != null ? frameFor(backdrop) : null;
+        var backdropFrame = backdrop != null && backdrop.IsVisible ? frameFor(backdrop) : null;
         if (backdropFrame != null)
             BlitContent(buffer, cropW, cropH, 0, 0, cropW, cropH, backdropFrame, 1f, false, false);
 
diff --git a/TASKS.md b/TASKS.md
index 9ecb35a..748a9fc 100644
--- a/TASKS.md
+++ b/TASKS.md
@@ -809,6 +809,21 @@ No changes to `MusicPlayer`, the 0.20 cap, the ducker, or the meter zones. Build
 
 ---
 
+## TASK 14 — Creator feedback batch: quick fixes (TRAX, meter, backdrop, sliders)
+
+**Goal:** address creator's immediate UX feedback from testing session.
+
+### Status: 🔶 In progress — Branch 1 (items 1–5) shipped
+
+1. ✅ TRAX volume — `LocalGain = GameAudioVolume * 0.2` so TRAX is 20% of the desktop audio slider (was 100%, now quieter)
+2. ✅ TRAX tooltip — replaced `ToolTip` binding with `ToolTipService.ToolTip` + `Placement="Top"` to fix z-order inside Viewbox overlay
+3. ✅ Mic meter boost — `MeterLevel` multiplied by 1.2× before clamping so the bar reads ~20% higher at same input level
+4. ✅ Click-to-position sliders — clicking anywhere on the mic/game volume slider track now jumps the thumb to that position before starting the drag
+5. ✅ Backdrop visibility — the dedicated `<Image>` now binds `Visibility` to `BackdropVisible` (ViewModel property); compositor checks `IsVisible` before blit
+6. ✅ Rename "Backdrop" → "Game Capture" in `EnsureBackdrop()` + test assertions
+
+---
+
 ## Backlog (future versions)
 
 1. v0.2 — Recording to local file (recordings carry the branding flash — see TASK 3 / `ai.md` Monetization)
diff --git a/ViewModels/MainViewModel.cs b/ViewModels/MainViewModel.cs
index bf652eb..0ba6afb 100644
--- a/ViewModels/MainViewModel.cs
+++ b/ViewModels/MainViewModel.cs
@@ -197,10 +197,15 @@ public class MainViewModel : ViewModelBase
         private set
         {
             if (SetProperty(ref _backdropImage, value))
+            {
                 OnPropertyChanged(nameof(ShowPreviewPlaceholder));
+                OnPropertyChanged(nameof(BackdropVisible));
+            }
         }
     }
 
+    public bool BackdropVisible => ActiveScene?.Elements.OfType<Source>().FirstOrDefault(s => s.IsBackdrop)?.IsVisible == true;
+
     public SceneElement? SelectedElement
     {
         get => _selectedElement;
@@ -337,7 +342,7 @@ public class MainViewModel : ViewModelBase
     /// level flashes on the bar) so the creator sees where they're setting it;
     /// otherwise the realtime live level scaled by volume (raising the volume
     /// moves ambient noise up the bar). Read-only meter.</summary>
-    private double MeterLevel => MicMuted ? 0 : _volumeAdjusting || _volumeFlash ? MicVolume : Math.Min(1, AudioLevelMeter.ToDisplay((float)AudioLevel) * MicVolume);
+    private double MeterLevel => MicMuted ? 0 : _volumeAdjusting || _volumeFlash ? MicVolume : Math.Min(1, AudioLevelMeter.ToDisplay((float)AudioLevel) * 1.2 * MicVolume);
 
     public double MeterFillWidth => MeterLevel * 288;
 
@@ -595,7 +600,7 @@ public class MainViewModel : ViewModelBase
     /// Called whenever the game volume/mute change and on TRAX load.</summary>
     private void UpdateTraxLocalGain()
     {
-        _musicPlayer.LocalGain = GameMuted ? 0f : (float)GameAudioVolume;
+        _musicPlayer.LocalGain = GameMuted ? 0f : (float)(GameAudioVolume * 0.2);
     }
 
     /// <summary>Live desktop/game input level (0..1), fed by the mixer's loopback
@@ -1405,7 +1410,7 @@ public class MainViewModel : ViewModelBase
 
         backdrop = new Source
         {
-            Name = "Backdrop",
+            Name = "Game Capture",
             Type = SourceType.DisplayCapture,
             IsBackdrop = true,
             IsEnabled = true,
@@ -1697,6 +1702,8 @@ public class MainViewModel : ViewModelBase
     {
         if (element == null) return;
         element.IsVisible = !element.IsVisible;
+        if (element is Source { IsBackdrop: true })
+            OnPropertyChanged(nameof(BackdropVisible));
     }
 
     private void AddSource(object? parameter)
diff --git a/ytLive.Tests/LayoutStorePersistenceTests.cs b/ytLive.Tests/LayoutStorePersistenceTests.cs
index e2af8c1..24e3fdf 100644
--- a/ytLive.Tests/LayoutStorePersistenceTests.cs
+++ b/ytLive.Tests/LayoutStorePersistenceTests.cs
@@ -90,7 +90,7 @@ public class LayoutStorePersistenceTests
             using var store = new LayoutStore(path);
             var backdrop = new Source
             {
-                Name = "Backdrop",
+                Name = "Game Capture",
                 Type = SourceType.DisplayCapture,
                 IsBackdrop = true,
                 IsEnabled = true,