Title: Fix 35 upstream bugs: volume flyout, mixer, media flyout, visualizer, taskbar widget, startup

.github/build-files/FluentFlyout_Installer.bat

@@ -10,6 +10,32 @@ ECHO   Please follow the prompts in the blue window.
 ECHO ===================================================
 ECHO.
 
+:: Prerequisite: the GitHub build is framework-dependent and needs the
+:: .NET Desktop Runtime 10 (x64). Without it the package installs fine but
+:: the app silently fails to start (no window, no Task Manager entry).
+SET "DotNetFxKey=HKLM\SOFTWARE\dotnet\Setup\InstalledVersions\x64\sharedfx\Microsoft.WindowsDesktop.App"
+reg query "%DotNetFxKey%" 2>NUL | findstr /R "10\." >NUL
+IF %ERRORLEVEL% NEQ 0 (
+    ECHO ---------------------------------------------------
+    ECHO   .NET 10 Desktop Runtime ^(x64^) was NOT detected.
+    ECHO   FluentFlyout will NOT start without it.
+    ECHO   Download it here:
+    ECHO   https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe
+    ECHO ---------------------------------------------------
+    ECHO.
+    SET /P OpenDotNet="Open the download page now? (Y/N): "
+    IF /I "%OpenDotNet%"=="Y" (
+        START "" "https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe"
+        ECHO.
+        ECHO Install the runtime, then run this installer again.
+        PAUSE
+        EXIT /B 1
+    ) ELSE (
+        ECHO Continuing without the runtime - the app may fail to start.
+        ECHO.
+    )
+)
+
 cd /d "%~dp0SystemFiles"
 
 :: Run the VS generated script

.github/build-files/README.txt

@@ -12,6 +12,13 @@ Since you've chosen to install via the GitHub method, there are two ways to inst
    this is the manual method. Follow the installation instructions below: 
    https://github.com/unchihugo/FluentFlyout?tab=readme-ov-file#using-msixbundle-installer
 
+PREREQUISITE (both methods):
+The GitHub build needs the .NET 10 Desktop Runtime (x64) installed, otherwise
+the package installs but the app silently fails to start (no window, not even
+in Task Manager). Get it here:
+https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe
+(The FluentFlyout_Installer.bat checks this for you automatically.)
+
 -----------------------------------------------------------------------------------------------------
 
 Note: GitHub releases provide the full feature set without restrictions. The only trade-off is

FluentFlyoutMSIX/FluentFlyoutMSIX.wapproj

@@ -83,7 +83,6 @@
     <AppxAutoIncrementPackageRevision>False</AppxAutoIncrementPackageRevision>
     <GenerateTestArtifacts>True</GenerateTestArtifacts>
     <AppxBundlePlatforms>x64</AppxBundlePlatforms>
-    <AppInstallerUri>C:\Users\hu8go\Desktop</AppInstallerUri>
     <HoursBetweenUpdateChecks>0</HoursBetweenUpdateChecks>
     <GenerateTemporaryStoreCertificate>True</GenerateTemporaryStoreCertificate>
     <PackageCertificateThumbprint>25D3EFB3B470444AB88088492FCDA18F99BAF513</PackageCertificateThumbprint>

FluentFlyoutMSIX/Package.appxmanifest

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
 
 <Package
   xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
@@ -20,8 +20,8 @@
   </Properties>
 
   <Dependencies>
-    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.0.0" MaxVersionTested="10.0.0.0" />
-    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.14393.0" MaxVersionTested="10.0.14393.0" />
+    <TargetDeviceFamily Name="Windows.Universal" MinVersion="10.0.19041.0" MaxVersionTested="10.0.26100.0" />
+    <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.19041.0" MaxVersionTested="10.0.26100.0" />
   </Dependencies>
 
   <Resources>

FluentFlyoutWPF/Classes/AudioDeviceMonitor.cs

@@ -16,6 +16,8 @@ public class AudioDeviceMonitor : IDisposable
     private AudioDeviceNotificationClient? _notificationClient;
 
     public event EventHandler<DefaultDeviceChangedEventArgs>? DefaultDeviceChanged;
+    public event EventHandler? DeviceTopologyChanged;
+    public event EventHandler? DevicePropertyChanged;
 
     public static AudioDeviceMonitor Instance
     {
@@ -44,6 +46,8 @@ private void Initialize()
             _deviceEnumerator = new MMDeviceEnumerator();
             _notificationClient = new AudioDeviceNotificationClient();
             _notificationClient.DefaultDeviceChanged += OnDefaultDeviceChanged;
+            _notificationClient.DeviceTopologyChanged += OnDeviceTopologyChanged;
+            _notificationClient.DevicePropertyChanged += OnDevicePropertyChanged;
             _deviceEnumerator.RegisterEndpointNotificationCallback(_notificationClient);
 
             Logger.Info("Audio device monitoring initialized");
@@ -64,6 +68,17 @@ private void OnDefaultDeviceChanged(object? sender, DefaultDeviceChangedEventArg
         DefaultDeviceChanged?.Invoke(this, e);
     }
 
+    private void OnDeviceTopologyChanged(object? sender, EventArgs e)
+    {
+        Logger.Info("Audio device topology changed");
+        DeviceTopologyChanged?.Invoke(this, e);
+    }
+
+    private void OnDevicePropertyChanged(object? sender, EventArgs e)
+    {
+        DevicePropertyChanged?.Invoke(this, e);
+    }
+
     public MMDevice? GetDefaultRenderDevice()
     {
         try
@@ -97,7 +112,12 @@ private void OnDefaultDeviceChanged(object? sender, DefaultDeviceChangedEventArg
 
     public void Dispose()
     {
-        _notificationClient?.DefaultDeviceChanged -= OnDefaultDeviceChanged;
+        if (_notificationClient != null)
+        {
+            _notificationClient.DefaultDeviceChanged -= OnDefaultDeviceChanged;
+            _notificationClient.DeviceTopologyChanged -= OnDeviceTopologyChanged;
+            _notificationClient.DevicePropertyChanged -= OnDevicePropertyChanged;
+        }
 
         if (_deviceEnumerator != null && _notificationClient != null)
         {
@@ -137,16 +157,18 @@ public void Dispose()
 public class AudioDeviceNotificationClient : IMMNotificationClient
 {
     public event EventHandler<DefaultDeviceChangedEventArgs>? DefaultDeviceChanged;
+    public event EventHandler? DeviceTopologyChanged;
+    public event EventHandler? DevicePropertyChanged;
 
     public void OnDefaultDeviceChanged(DataFlow flow, Role role, string defaultDeviceId)
     {
         DefaultDeviceChanged?.Invoke(this, new DefaultDeviceChangedEventArgs(flow, role, defaultDeviceId));
     }
 
-    public void OnDeviceStateChanged(string deviceId, DeviceState newState) { }
-    public void OnDeviceAdded(string pwstrDeviceId) { }
-    public void OnDeviceRemoved(string deviceId) { }
-    public void OnPropertyValueChanged(string pwstrDeviceId, PropertyKey key) { }
+    public void OnDeviceStateChanged(string deviceId, DeviceState newState) => DeviceTopologyChanged?.Invoke(this, EventArgs.Empty);
+    public void OnDeviceAdded(string pwstrDeviceId) => DeviceTopologyChanged?.Invoke(this, EventArgs.Empty);
+    public void OnDeviceRemoved(string deviceId) => DeviceTopologyChanged?.Invoke(this, EventArgs.Empty);
+    public void OnPropertyValueChanged(string pwstrDeviceId, PropertyKey key) => DevicePropertyChanged?.Invoke(this, EventArgs.Empty);
 }
 
 public class DefaultDeviceChangedEventArgs(DataFlow dataFlow, Role role, string deviceId) : EventArgs

FluentFlyoutWPF/Classes/NativeMethods.cs

@@ -69,6 +69,14 @@ public static partial class NativeMethods
     internal const int APPCOMMAND_MEDIA_PLAY_PAUSE = 14;
     internal const int FAPPCOMMAND_KEY = 0x0000;
 
+    // Process Access Rights
+    internal const uint PROCESS_QUERY_LIMITED_INFORMATION = 0x1000;
+
+    // AppBar (taskbar) messages and states
+    internal const uint ABM_GETSTATE = 0x00000004;
+    internal const uint ABM_GETTASKBARPOS = 0x00000005;
+    internal const int ABS_AUTOHIDE = 0x0000001;
+
     #endregion
 
     #region Enums
@@ -197,6 +205,17 @@ internal struct DISPLAY_DEVICE
         public string DeviceKey;
     }
 
+    [StructLayout(LayoutKind.Sequential)]
+    internal struct APPBARDATA
+    {
+        public int cbSize;
+        public IntPtr hWnd;
+        public uint uCallbackMessage;
+        public uint uEdge;
+        public RECT rc;
+        public int lParam;
+    }
+
     [StructLayout(LayoutKind.Sequential)]
     internal struct AccentPolicy
     {
@@ -386,5 +405,8 @@ internal struct WindowCompositionAttributeData
     [LibraryImport("shell32.dll")]
     internal static partial int SHQueryUserNotificationState(out QUERY_USER_NOTIFICATION_STATE pquns);
 
+    [DllImport("shell32.dll", CharSet = CharSet.Auto)]
+    internal static extern IntPtr SHAppBarMessage(uint dwMessage, ref APPBARDATA pData);
+
     #endregion
 }

FluentFlyoutWPF/Classes/Utils/MediaPlayerData.cs

@@ -14,6 +14,16 @@ public static class MediaPlayerData
 {
     private static readonly NLog.Logger Logger = NLog.LogManager.GetCurrentClassLogger();
 
+    [System.Runtime.InteropServices.DllImport("kernel32.dll", SetLastError = true)]
+    private static extern IntPtr OpenProcess(uint processAccess, bool bInheritHandle, uint processId);
+
+    [System.Runtime.InteropServices.DllImport("kernel32.dll", SetLastError = true, CharSet = System.Runtime.InteropServices.CharSet.Unicode)]
+    private static extern bool QueryFullProcessImageName(IntPtr hProcess, uint dwFlags, System.Text.StringBuilder lpExeName, ref int lpdwSize);
+
+    [System.Runtime.InteropServices.DllImport("kernel32.dll", SetLastError = true)]
+    [return: System.Runtime.InteropServices.MarshalAs(System.Runtime.InteropServices.UnmanagedType.Bool)]
+    private static extern bool CloseHandle(IntPtr hObject);
+
     private class CachedMediaPlayerInfo
     {
         public required string Title { get; set; }
@@ -92,7 +102,9 @@ public static (string, ImageSource?) GetAndCacheMediaPlayerData(string mediaPlay
                         // fall back to MainWindowTitle if the description is empty
                         string title = !string.IsNullOrWhiteSpace(mainModule.FileVersionInfo.FileDescription)
                                         ? mainModule.FileVersionInfo.FileDescription
-                                        : p.MainWindowTitle;
+                                        : !string.IsNullOrWhiteSpace(p.MainWindowTitle)
+                                            ? p.MainWindowTitle
+                                            : p.ProcessName;
 
                         return new { Title = title, Path = path, ProcessId = p.Id, IsExactMatch = isExactMatch };
                     }
@@ -256,6 +268,51 @@ private static bool IsBrowser(string processName) =>
         new[] { "chrome", "msedge" }
         .Contains(processName, StringComparer.OrdinalIgnoreCase);
 
+    /// <summary>
+    /// Resolves the executable path of a process, including elevated/admin
+    /// processes that deny <see cref="Process.MainModule"/> to a non-elevated
+    /// caller. <c>PROCESS_QUERY_LIMITED_INFORMATION</c> plus
+    /// <c>QueryFullProcessImageName</c> is granted for such processes, and file
+    /// metadata/icon reads work on the path without opening the process.
+    /// Returns null only when the process is gone or fully inaccessible.
+    /// </summary>
+    public static string? TryGetProcessPath(int processId)
+    {
+        IntPtr handle = IntPtr.Zero;
+        try
+        {
+            handle = OpenProcess(PROCESS_QUERY_LIMITED_INFORMATION, false, (uint)processId);
+            if (handle != IntPtr.Zero)
+            {
+                var builder = new System.Text.StringBuilder(1024);
+                int size = builder.Capacity;
+                if (QueryFullProcessImageName(handle, 0, builder, ref size) && size > 0)
+                    return builder.ToString(0, size);
+            }
+        }
+        catch
+        {
+            // fall through to the MainModule attempt below
+        }
+        finally
+        {
+            if (handle != IntPtr.Zero)
+            {
+                try { CloseHandle(handle); } catch { }
+            }
+        }
+
+        try
+        {
+            using var process = Process.GetProcessById(processId);
+            return process.MainModule?.FileName;
+        }
+        catch
+        {
+            return null;
+        }
+    }
+
     /// <summary>
     /// Extracts the associated icon for a given process ID. Returns null if the process is inaccessible.
     /// </summary>
@@ -274,8 +331,7 @@ private static bool IsBrowser(string processName) =>
                 }
             }
 
-            var process = Process.GetProcessById(processId);
-            var path = process.MainModule?.FileName;
+            var path = TryGetProcessPath(processId);
             if (path == null) return null;
 
             // store in cache for future lookups

FluentFlyoutWPF/Classes/Utils/MonitorUtil.cs

@@ -27,6 +27,16 @@ public struct MonitorInfo
     public static MonitorInfo GetSelectedMonitor(int index = 0)
     {
         var monitors = GetMonitors();
+
+        // Math.Clamp throws when min > max, which is exactly what happens with an
+        // empty monitor list: turning off a secondary display or switching the
+        // projection mode makes EnumDisplayMonitors briefly return nothing, and
+        // the resulting ArgumentException propagated out of every flyout
+        // placement and taskbar position tick, leaving the widget stuck and the
+        // taskbar unresponsive (#1085).
+        if (monitors.Count == 0)
+            return default;
+
         return monitors[Math.Clamp(index, 0, monitors.Count - 1)];
     }