Merge branch 'dev' into beta

Author: Belphemur

Directory.Packages.props

@@ -9,7 +9,7 @@
     <PackageVersion Include="FluentAssertions" Version="8.3.0" />
     <PackageVersion Include="JetBrains.Annotations" Version="2024.3.0" />
     <PackageVersion Include="Job.Scheduler" Version="3.1.8" />
-    <PackageVersion Include="Markdig" Version="0.41.2" />
+    <PackageVersion Include="Markdig" Version="0.41.3" />
     <PackageVersion Include="MessagePack" Version="3.1.4" />
     <PackageVersion Include="Microsoft.CSharp" Version="4.7.0" />
     <PackageVersion Include="Microsoft.Extensions.Caching.Memory" Version="9.0.6" />

README.de.md

@@ -43,6 +43,16 @@ Wählen Sie zuerst, wie im vorigen Abschnitt beschrieben, Ihre gewünschten Ger
 
   Wenn ein Mikrofon stummgeschaltet wird, erscheint ein dauerhaftes Banner auf Ihrem Bildschirm, um Sie daran zu erinnern, dass Ihr Mikrofon stummgeschaltet ist. Das Banner bleibt sichtbar, bis Sie die Stummschaltung des Mikrofons aufheben oder auf das Banner klicken, um es direkt zu aktivieren.
 
+## 🖱️ Taskleisten-Symbol Aktionen
+
+Das Taskleisten-Symbol unterstützt konfigurierbare Doppelklick-Aktionen. Sie können wählen, was beim Doppelklick auf das SoundSwitch-Symbol passiert:
+
+- **🔊 Gerät wechseln** (Standard): Wechselt durch Ihre konfigurierten Wiedergabegeräte
+- **📋 Profil wechseln**: Wechselt durch Ihre konfigurierten Audio-Profile
+- **⚙️ Einstellungen öffnen**: Öffnet das SoundSwitch-Einstellungsfenster
+
+Dieses Verhalten kann in den SoundSwitch-Einstellungen angepasst werden, um Ihrem bevorzugten Arbeitsablauf zu entsprechen.
+
 ## 💻 Kommandozeile (CLI)
 
 SoundSwitch verfügt über eine leistungsfähige Kommandozeilen-Schnittstelle, mit der Sie die Anwendung über die Befehlszeile steuern können:
@@ -71,14 +81,38 @@ SoundSwitch bietet vier verschiedenen Arten der Benachrichtigung, wenn ein Gerä
 
 ## Profile
 
-Mithilfe von Profilen ist es möglich zu einem bestimmten Gerät zu wechseln, wenn eine Bedingung eintritt. Profile können für die folgenden Zwecke definiert werden:
+Mithilfe von Profilen können Sie automatisch zu bestimmten Audiogeräten wechseln, wenn bestimmte Bedingungen erfüllt sind. Profile unterstützen mehrere Auslösertypen und erweiterte Geräteverwaltung:
+
+### 🎯 Profil-Auslöser
+
+- **⌨️ Hotkey-Auslöser**: Geräte mit benutzerdefinierten Tastenkombinationen wechseln. Mehrere Profile können dieselbe Tastenkombination verwenden und automatisch durchwechseln.
+
+- **💫 Anwendungs-Auslöser**: Automatischer Gerätewechsel, wenn bestimmte Anwendungen den Fokus erhalten. Zum Beispiel Spotify auf Lautsprecher leiten, während Spiele das Headset verwenden.
+
+- **🪟 Fenster-Auslöser**: Gerätewechsel basierend auf Fenstertiteln. Nützlich für Anwendungen, die ihre Fensternamen dynamisch ändern.
+
+- **🎮 Steam Big Picture**: Spezielles Profil, das automatisch aktiviert wird, wenn der Steam Big Picture-Modus gestartet wird.
+
+- **📱 UWP-App-Auslöser**: Unterstützung für Universal Windows Platform-Anwendungen mit automatischem Gerätewechsel.
+
+- **🚀 Startup-Auslöser**: Profile, die automatisch aktiviert werden, wenn SoundSwitch startet.
+
+- **🔄 Geräte-Geändert-Auslöser**: Erzwungene Profile, die bestimmte Gerätekonfigurationen beibehalten, auch wenn Windows versucht, sie zu ändern.
+
+- **📋 Tray-Menü-Auslöser**: Profile, die direkt über das Kontextmenü der Taskleiste zugänglich sind.
+
+### 🎚️ Erweiterte Profil-Funktionen
 
-- ### 💫 Anwendungsprofil
+- **Multi-Geräte-Unterstützung**: Separate Geräte für Wiedergabe, Kommunikation, Aufnahme und Aufnahme-Kommunikation konfigurieren
+- **Intelligente Gerätewiederherstllung**: Automatische Wiederherstellung vorheriger Audioeinstellungen, wenn ein Profil deaktiviert wird
+- **Vordergrund-App-Wechsel**: Option, nur die Audio-Einstellungen der fokussierten Anwendung zu wechseln anstatt systemweit
+- **Standard-Geräte-Kontrolle**: Wählen Sie, ob Windows-Standardgeräte geändert oder nur anwendungsspezifisches Routing verwendet werden soll
+- **Benachrichtigungskontrolle**: Benachrichtigungen bei Profilaktivierung aktivieren/deaktivieren
+- **Gerätevalidierung**: Automatische Überprüfung der Geräteverfügbarkeit mit Fallback-Behandlung
 
-  Wenn eine Anwendung fokussiert wird, werden die Soundeinstellungen auf der Grundlage des Profils geändert. Erstelle zum Beispiel ein Profil für Spotify, damit nur Musik über den Lautsprecher wiedergegeben wird, während das Lieblingsspiel über das Headset läuft.
+### 🔄 Hotkey-Durchschaltung
 
-- ### ⌨️ Hotkeyprofil
-  Wenn eine bestimmte Tastenkombination gedrückt wird, werden die Soundeinstellungen auf der Grundlage des Profils geändert. Definiere zum Beispiel eine spezielle Kombination, um als Wiedergabegerät den Fernseher zu verwenden.
+Wenn mehrere Profile dieselbe Tastenkombination verwenden, wechselt SoundSwitch automatisch zwischen ihnen durch. Wenn das Schnellmenü aktiviert ist, erscheint ein visueller Selektor, mit dem Sie das spezifische zu aktivierende Profil auswählen können.
 
 ## Erweiterte Funktionen
 

README.md

@@ -3,7 +3,9 @@
 [![.NET](https://github.com/Belphemur/SoundSwitch/actions/workflows/dotnet.yml/badge.svg)](https://github.com/Belphemur/SoundSwitch/actions/workflows/dotnet.yml)[![Last Release](https://img.shields.io/github/release/Belphemur/SoundSwitch.svg)](https://soundswitch.aaflalo.me) [![Downloads for last Release](https://img.shields.io/github/downloads/Belphemur/SoundSwitch/total.svg)](https://soundswitch.aaflalo.me/) [![Translate](https://hosted.weblate.org/widgets/soundswitch/-/svg-badge.svg)](https://hosted.weblate.org/projects/soundswitch/) [![Donate](https://img.shields.io/badge/Donate-paypal%2Fcc-blue.svg)](https://soundswitch.aaflalo.me) [![Help](https://img.shields.io/badge/Discord-Community%20&%20Help-green?style=flat-square&logo=discord)](https://discord.gg/gUCw3Ue)
 
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+
 [![All Contributors](https://img.shields.io/badge/all_contributors-13-orange.svg?style=flat-square)](#contributors-)
+
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 **SoundSwitch** offers you the opportunity to switch your playback and recording devices using simple **hotkeys**.
@@ -47,7 +49,17 @@ First set up your devices you want to cycle through, using _right click_ on the
 
   When a microphone is muted, a persistent banner will appear on your screen to remind you that your microphone is muted. The banner will remain visible until you unmute the microphone or click on the banner to unmute it directly.
 
-## 💻 Command Line Interface
+## 🖱️ System Tray Icon Actions
+
+The system tray icon supports configurable double-click actions. You can choose what happens when you double-click the SoundSwitch icon:
+
+- **🔊 Switch Device** (default): Cycles through your configured playback devices
+- **📋 Switch Profile**: Cycles through your configured audio profiles
+- **⚙️ Open Settings**: Opens the SoundSwitch settings window
+
+This behavior can be customized in the SoundSwitch settings to match your preferred workflow.
+
+## Command Line Interface
 
 SoundSwitch includes a powerful CLI that allows you to control the application through command line:
 
@@ -75,14 +87,38 @@ SoundSwitch provides four types of notification when a device is changed:
 
 ## Profiles
 
-Using profiles, it is possible to switch to a specific device when a condition occurs. Profiles can be defined for the following purposes:
+Using profiles, you can automatically switch to specific audio devices when certain conditions are met. Profiles support multiple trigger types and advanced device management:
+
+### 🎯 Profile Triggers
+
+- **⌨️ Hotkey Triggers**: Switch devices using custom key combinations. Multiple profiles can share the same hotkey and cycle through them automatically.
+
+- **💫 Application Triggers**: Automatically switch devices when specific applications gain focus. For example, route Spotify to speakers while games use your headset.
+
+- **🪟 Window Triggers**: Switch devices based on window titles. Useful for applications that change their window names dynamically.
+
+- **🎮 Steam Big Picture**: Special profile that activates automatically when Steam Big Picture mode is launched.
+
+- **📱 UWP App Triggers**: Support for Universal Windows Platform applications with automatic device switching.
+
+- **🚀 Startup Triggers**: Profiles that activate automatically when SoundSwitch starts.
+
+- **🔄 Device Changed Triggers**: Force profiles that maintain specific device configurations even when Windows tries to change them.
+
+- **📋 Tray Menu Triggers**: Profiles accessible directly from the system tray context menu.
+
+### 🎚️ Advanced Profile Features
 
-- ### 💫 Application profile
+- **Multi-Device Support**: Configure separate devices for playback, communication, recording, and recording communication
+- **Smart Device Restoration**: Automatically restore previous audio settings when a profile deactivates
+- **Foreground App Switching**: Option to switch only the focused application's audio instead of system-wide
+- **Default Device Control**: Choose whether to change Windows default devices or only application-specific routing
+- **Notification Control**: Enable/disable notifications when profiles activate
+- **Device Validation**: Automatic checking for device availability with fallback handling
 
-  When a application is focused, the sound settings are switched based on the profile. For example create a profile for Spotify to only play music on your speaker, while your favorite game is using your headset.
+### 🔄 Hotkey Cycling
 
-- ### ⌨️ Hot key profile
-  When a hot key combination is pressed, the sound settings are switched based on the profile. For example you define a special combination to switch your playback device to your television.
+When multiple profiles share the same hotkey, SoundSwitch automatically cycles through them. If Quick Menu is enabled, a visual selector appears allowing you to choose the specific profile to activate.
 
 ## Advanced
 

SoundSwitch/Framework/TrayIcon/IconDoubleClick/Action/IIconDoubleClick.cs

@@ -16,4 +16,16 @@
 
 namespace SoundSwitch.Framework.TrayIcon.IconDoubleClick.Action;
 
-public interface IIconDoubleClick : IEnumImpl<IconDoubleClickEnum>;
+/// <summary>
+/// Defines the contract for system tray icon double-click action implementations.
+/// Each implementation represents a specific action that can be performed when the user double-clicks the SoundSwitch system tray icon.
+/// </summary>
+public interface IIconDoubleClick : IEnumImpl<IconDoubleClickEnum>
+{
+    /// <summary>
+    /// Executes the double-click action.
+    /// This method is called when the user double-clicks the system tray icon and this action is configured.
+    /// </summary>
+    /// <param name="trayIcon">The TrayIcon instance that can be used to access UI functionality</param>
+    void Execute(UI.Component.TrayIcon trayIcon);
+}

SoundSwitch/Framework/TrayIcon/IconDoubleClick/Action/IconDoubleClickOpenSettings.cs

@@ -16,8 +16,29 @@
 
 namespace SoundSwitch.Framework.TrayIcon.IconDoubleClick.Action;
 
+/// <summary>
+/// Implementation for the "Open Settings" double-click action.
+/// When the user double-clicks the system tray icon, this action opens the SoundSwitch settings window.
+/// This provides quick access to application configuration and customization options.
+/// </summary>
 internal class IconDoubleClickOpenSettings : IIconDoubleClick
 {
+    /// <summary>
+    /// Gets the enum type that this implementation corresponds to.
+    /// </summary>
     public IconDoubleClickEnum TypeEnum => IconDoubleClickEnum.OpenSettings;
+
+    /// <summary>
+    /// Gets the localized label for this action as displayed in the user interface.
+    /// </summary>
     public string Label => SettingsStrings.openSettings;
+
+    /// <summary>
+    /// Executes the open settings action by showing the settings window.
+    /// </summary>
+    /// <param name="trayIcon">The TrayIcon instance used to show the settings window</param>
+    public void Execute(UI.Component.TrayIcon trayIcon)
+    {
+        trayIcon.ShowSettings();
+    }
 }

SoundSwitch/Framework/TrayIcon/IconDoubleClick/Action/IconDoubleClickSwitchDevice.cs

@@ -12,12 +12,35 @@
  * GNU General Public License for more details.
  ********************************************************************/
 
+using NAudio.CoreAudioApi;
 using SoundSwitch.Localization;
+using SoundSwitch.Model;
 
 namespace SoundSwitch.Framework.TrayIcon.IconDoubleClick.Action;
 
-internal class IconDoubleClickSwitchDevice: IIconDoubleClick
+/// <summary>
+/// Implementation for the "Switch Device" double-click action.
+/// When the user double-clicks the system tray icon, this action cycles through the configured playback devices.
+/// This is the default behavior and provides the traditional SoundSwitch functionality of device switching.
+/// </summary>
+internal class IconDoubleClickSwitchDevice : IIconDoubleClick
 {
+    /// <summary>
+    /// Gets the enum type that this implementation corresponds to.
+    /// </summary>
     public IconDoubleClickEnum TypeEnum => IconDoubleClickEnum.SwitchDevice;
+
+    /// <summary>
+    /// Gets the localized label for this action as displayed in the user interface.
+    /// </summary>
     public string Label => SettingsStrings.switchDevice;
+
+    /// <summary>
+    /// Executes the switch device action by cycling through configured playback devices.
+    /// </summary>
+    /// <param name="trayIcon">The TrayIcon instance (not used for this action)</param>
+    public void Execute(UI.Component.TrayIcon trayIcon)
+    {
+        AppModel.Instance.CycleActiveDevice(DataFlow.Render);
+    }
 }

SoundSwitch/Framework/TrayIcon/IconDoubleClick/Action/IconDoubleClickSwitchProfile.cs

@@ -1,10 +1,55 @@
 
-using SoundSwitch.Localization;
+using System.Linq;
+using Serilog;
+using SoundSwitch.Framework.Profile.Trigger;
+using SoundSwitch.Localization;
+using SoundSwitch.Model;
 
 namespace SoundSwitch.Framework.TrayIcon.IconDoubleClick.Action;
 
-internal class IconDoubleClickSwitchProfile: IIconDoubleClick
+/// <summary>
+/// Implementation for the "Switch Profile" double-click action.
+/// When the user double-clicks the system tray icon, this action cycles through the configured audio profiles.
+/// This allows users to quickly switch between different audio device configurations and setups.
+/// </summary>
+internal class IconDoubleClickSwitchProfile : IIconDoubleClick
 {
+    private Profile.Profile _activeTrayProfile;
+
+    /// <summary>
+    /// Gets the enum type that this implementation corresponds to.
+    /// </summary>
     public IconDoubleClickEnum TypeEnum => IconDoubleClickEnum.SwitchProfile;
+
+    /// <summary>
+    /// Gets the localized label for this action as displayed in the user interface.
+    /// </summary>
     public string Label => SettingsStrings.switchProfile;
+
+    /// <summary>
+    /// Executes the switch profile action by cycling through profiles with tray menu triggers.
+    /// </summary>
+    /// <param name="trayIcon">The TrayIcon instance (not used for this action)</param>
+    public void Execute(UI.Component.TrayIcon trayIcon)
+    {
+        // Check if there are any profiles with tray menu triggers
+        var profiles = AppModel.Instance.ProfileManager.Profiles
+            .Where(profile => profile.Triggers.Any(trigger => trigger.Type == TriggerFactory.Enum.TrayMenu))
+            .ToList();
+
+        if (!profiles.Any())
+        {
+            Log.Warning("No profiles available for tray icon double click");
+            return;
+        }
+
+        var nextProfile = _activeTrayProfile != null && profiles.Contains(_activeTrayProfile)
+            ? profiles[(profiles.IndexOf(_activeTrayProfile) + 1) % profiles.Count]
+            : profiles.First();
+
+        _activeTrayProfile = nextProfile;
+
+        Log.Information("Switching to profile {profile}", nextProfile.Name);
+        AppModel.Instance.ProfileManager.SwitchAudio(nextProfile);
+    }
 }

SoundSwitch/Framework/TrayIcon/IconDoubleClick/IconDoubleClickEnum.cs

@@ -14,9 +14,27 @@
 
 namespace SoundSwitch.Framework.TrayIcon.IconDoubleClick;
 
+/// <summary>
+/// Defines the available actions that can be performed when double-clicking the SoundSwitch system tray icon.
+/// These actions are configurable by the user in the application settings.
+/// </summary>
 public enum IconDoubleClickEnum
 {
+    /// <summary>
+    /// Cycles through the configured playback devices.
+    /// This is the default behavior and matches the traditional SoundSwitch functionality.
+    /// </summary>
     SwitchDevice = 0,
+
+    /// <summary>
+    /// Opens the SoundSwitch settings window.
+    /// Provides quick access to application configuration.
+    /// </summary>
     OpenSettings = 1,
+
+    /// <summary>
+    /// Cycles through the configured audio profiles.
+    /// Allows users to quickly switch between different audio device configurations.
+    /// </summary>
     SwitchProfile = 2,
 }

SoundSwitch/Framework/TrayIcon/IconDoubleClick/IconDoubleClickFactory.cs

@@ -17,13 +17,33 @@
 
 namespace SoundSwitch.Framework.TrayIcon.IconDoubleClick;
 
+/// <summary>
+/// Factory class for creating and managing system tray icon double-click action implementations.
+/// Provides access to all available double-click actions that users can configure for the SoundSwitch system tray icon.
+/// </summary>
 public class IconDoubleClickFactory() : AbstractFactory<IconDoubleClickEnum, IIconDoubleClick>(DoubleClick)
 {
+    /// <summary>
+    /// Collection of all available double-click action implementations.
+    /// Each implementation corresponds to a specific action users can perform by double-clicking the system tray icon.
+    /// </summary>
     private static readonly IEnumImplList<IconDoubleClickEnum, IIconDoubleClick> DoubleClick = new EnumImplList
         <IconDoubleClickEnum, IIconDoubleClick>
         {
             new IconDoubleClickSwitchDevice(),
             new IconDoubleClickSwitchProfile(),
             new IconDoubleClickOpenSettings()
         };
+
+    /// <summary>
+    /// Executes the specified double-click action.
+    /// This method eliminates the need for switch statements in the calling code.
+    /// </summary>
+    /// <param name="actionType">The type of action to execute</param>
+    /// <param name="trayIcon">The TrayIcon instance to pass to the action</param>
+    public void ExecuteAction(IconDoubleClickEnum actionType, UI.Component.TrayIcon trayIcon)
+    {
+        var action = Get(actionType);
+        action.Execute(trayIcon);
+    }
 }