From 0baf87d979dc4b8319f398b582c4f61c07fdaa13 Mon Sep 17 00:00:00 2001
From: Ray Berezowski <6616212+rberezowski@users.noreply.github.com>
Date: Wed, 26 Aug 2026 22:43:58 -0400
Subject: [PATCH] Add launcher item notes

---
 MainWindow.xaml                | 31 ++++++++++++++++++++++---------
 MainWindow.xaml.cs             |  5 +++++
 Models/LauncherConfig.cs       |  2 ++
 README.md                      |  1 +
 Services/LauncherController.cs |  1 +
 TaskbarLauncher.csproj         |  4 ++--
 Views/LauncherPopup.xaml.cs    |  6 ++++++
 config.example.json            |  5 +++++
 docs/INSTALL.md                |  1 +
 9 files changed, 45 insertions(+), 11 deletions(-)

diff --git a/MainWindow.xaml b/MainWindow.xaml
index 217249f..9a6e765 100644
--- a/MainWindow.xaml
+++ b/MainWindow.xaml
@@ -183,6 +183,7 @@
                                 <RowDefinition Height="Auto"/>
                                 <RowDefinition Height="Auto"/>
                                 <RowDefinition Height="Auto"/>
+                                <RowDefinition Height="Auto"/>
                             </Grid.RowDefinitions>
 
                             <TextBlock Text="Title" VerticalAlignment="Center" Margin="0,0,8,8"/>
@@ -213,20 +214,32 @@
                                     Padding="8,4"
                                     Margin="0,0,0,8"/>
 
-                            <TextBlock Text="Icon Path" Grid.Row="5" VerticalAlignment="Center" Margin="0,0,8,0"/>
-                            <TextBox x:Name="IconPathBox" Grid.Row="5" Grid.Column="1" Margin="0,0,8,8"
+                            <TextBlock Text="Notes" Grid.Row="5" VerticalAlignment="Top" Margin="0,4,8,8"/>
+                            <TextBox x:Name="NotesBox"
+                                     Grid.Row="5"
+                                     Grid.Column="1"
+                                     Grid.ColumnSpan="2"
+                                     Margin="0,0,0,8"
+                                     AcceptsReturn="True"
+                                     MinHeight="54"
+                                     TextWrapping="Wrap"
+                                     VerticalScrollBarVisibility="Auto"
                                      TextChanged="PreviewField_Changed"/>
-                            <StackPanel Grid.Row="5" Grid.Column="2" Orientation="Horizontal" Margin="0,0,0,8">
+
+                            <TextBlock Text="Icon Path" Grid.Row="6" VerticalAlignment="Center" Margin="0,0,8,0"/>
+                            <TextBox x:Name="IconPathBox" Grid.Row="6" Grid.Column="1" Margin="0,0,8,8"
+                                     TextChanged="PreviewField_Changed"/>
+                            <StackPanel Grid.Row="6" Grid.Column="2" Orientation="Horizontal" Margin="0,0,0,8">
                                 <Button Content="Icon" Click="BrowseIcon_Click" Padding="8,4" Margin="0,0,6,0"/>
                                 <Button Content="Reset" Click="ResetIcon_Click" Padding="8,4"/>
                             </StackPanel>
 
-                            <TextBlock Text="Selected Item Display" Grid.Row="6" VerticalAlignment="Center" Margin="0,0,8,8"/>
-                            <ComboBox x:Name="ItemDisplayModeBox" Grid.Row="6" Grid.Column="1" Grid.ColumnSpan="2"
+                            <TextBlock Text="Selected Item Display" Grid.Row="7" VerticalAlignment="Center" Margin="0,0,8,8"/>
+                            <ComboBox x:Name="ItemDisplayModeBox" Grid.Row="7" Grid.Column="1" Grid.ColumnSpan="2"
                                       Margin="0,0,0,8" SelectionChanged="ItemDisplayModeBox_SelectionChanged"/>
 
-                            <TextBlock Text="Launch Options" Grid.Row="7" VerticalAlignment="Top" Margin="0,2,8,8"/>
-                            <StackPanel Grid.Row="7" Grid.Column="1" Grid.ColumnSpan="2" Margin="0,0,0,8">
+                            <TextBlock Text="Launch Options" Grid.Row="8" VerticalAlignment="Top" Margin="0,2,8,8"/>
+                            <StackPanel Grid.Row="8" Grid.Column="1" Grid.ColumnSpan="2" Margin="0,0,0,8">
                                 <CheckBox x:Name="RunAsAdminBox"
                                           Content="Run as administrator"
                                           Margin="0,0,0,6"
@@ -238,8 +251,8 @@
                                           Unchecked="LaunchOptionBox_Changed"/>
                             </StackPanel>
 
-                            <TextBlock Text="Preview" Grid.Row="8" VerticalAlignment="Top" Margin="0,4,8,0"/>
-                            <Border Grid.Row="8" Grid.Column="1" Grid.ColumnSpan="2"
+                            <TextBlock Text="Preview" Grid.Row="9" VerticalAlignment="Top" Margin="0,4,8,0"/>
+                            <Border Grid.Row="9" Grid.Column="1" Grid.ColumnSpan="2"
                                     BorderThickness="1"
                                     BorderBrush="{DynamicResource AppBorderBrush}"
                                     Background="{DynamicResource AppSurfaceBrush}"
diff --git a/MainWindow.xaml.cs b/MainWindow.xaml.cs
index 53cb54a..f4b60a1 100644
--- a/MainWindow.xaml.cs
+++ b/MainWindow.xaml.cs
@@ -614,6 +614,7 @@ public partial class MainWindow : Window
         TargetBox.Text = item.Target;
         ArgumentsBox.Text = item.Arguments ?? "";
         WorkingFolderBox.Text = item.WorkingFolder ?? "";
+        NotesBox.Text = item.Notes ?? "";
         IconPathBox.Text = item.IconPath ?? "";
         loadedAutoIconPath = GetAutomaticIconPath(item);
         ItemDisplayModeBox.SelectedItem = item.DisplayMode;
@@ -634,6 +635,7 @@ public partial class MainWindow : Window
         TargetBox.Text = "";
         ArgumentsBox.Text = "";
         WorkingFolderBox.Text = "";
+        NotesBox.Text = "";
         IconPathBox.Text = "";
         loadedAutoIconPath = null;
         ItemDisplayModeBox.SelectedItem = controller?.Config.DisplayMode;
@@ -660,6 +662,7 @@ public partial class MainWindow : Window
         selectedItem.WorkingFolder = LauncherController.CanUseLaunchOptions(selectedItem.Type) && !string.IsNullOrWhiteSpace(WorkingFolderBox.Text)
             ? WorkingFolderBox.Text.Trim()
             : null;
+        selectedItem.Notes = string.IsNullOrWhiteSpace(NotesBox.Text) ? null : NotesBox.Text.Trim();
         EnsureAutomaticIconPath();
         selectedItem.IconPath = string.IsNullOrWhiteSpace(IconPathBox.Text) ? null : IconPathBox.Text.Trim();
         if (ItemDisplayModeBox.SelectedItem is LauncherDisplayMode itemMode)
@@ -975,6 +978,7 @@ public partial class MainWindow : Window
             Target = item.Target,
             Arguments = item.Arguments,
             WorkingFolder = item.WorkingFolder,
+            Notes = item.Notes,
             IconPath = item.IconPath,
             IsFavorite = item.IsFavorite,
             IsDisabled = item.IsDisabled,
@@ -1935,6 +1939,7 @@ public partial class MainWindow : Window
                 !string.IsNullOrWhiteSpace(WorkingFolderBox.Text)
                     ? WorkingFolderBox.Text.Trim()
                     : null,
+            Notes = string.IsNullOrWhiteSpace(NotesBox.Text) ? null : NotesBox.Text.Trim(),
             IconPath = string.IsNullOrWhiteSpace(IconPathBox.Text) ? null : IconPathBox.Text.Trim(),
             IsFavorite = selectedItem.IsFavorite,
             IsDisabled = selectedItem.IsDisabled,
diff --git a/Models/LauncherConfig.cs b/Models/LauncherConfig.cs
index ca1ad8b..e018f99 100644
--- a/Models/LauncherConfig.cs
+++ b/Models/LauncherConfig.cs
@@ -25,6 +25,8 @@ public sealed class LauncherItem
 
     public string? WorkingFolder { get; set; }
 
+    public string? Notes { get; set; }
+
     public string? IconPath { get; set; }
 
     public bool IsFavorite { get; set; }
diff --git a/README.md b/README.md
index 44f9200..14ac1bd 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,7 @@ Download the compiled Windows release from:
 - Right-click app/file entries to open their containing folder
 - Optional run-as-administrator mode for app and file entries
 - Optional working folder and start-minimized launch options for app and file entries
+- Per-item notes, visible in launcher tooltips and searchable from the popup
 - Validate missing app, file, and folder targets from Settings
 - Export and import selected items or menu sections
 - Sort a selected menu or item level alphabetically
diff --git a/Services/LauncherController.cs b/Services/LauncherController.cs
index 8098229..1404957 100644
--- a/Services/LauncherController.cs
+++ b/Services/LauncherController.cs
@@ -181,6 +181,7 @@ public sealed class LauncherController : IDisposable
             Target = item.Target,
             Arguments = item.Arguments,
             WorkingFolder = item.WorkingFolder,
+            Notes = item.Notes,
             IconPath = item.IconPath,
             IsFavorite = false,
             IsDisabled = false,
diff --git a/TaskbarLauncher.csproj b/TaskbarLauncher.csproj
index c1d7172..760d625 100644
--- a/TaskbarLauncher.csproj
+++ b/TaskbarLauncher.csproj
@@ -12,8 +12,8 @@
     <Authors>Ray Berezowski</Authors>
     <ApplicationIcon>Assets\AppIcon.ico</ApplicationIcon>
     <Version>1.0.1</Version>
-    <AssemblyVersion>1.0.1.20</AssemblyVersion>
-    <FileVersion>1.0.1.20</FileVersion>
+    <AssemblyVersion>1.0.1.21</AssemblyVersion>
+    <FileVersion>1.0.1.21</FileVersion>
     <InformationalVersion>1.0.1</InformationalVersion>
   </PropertyGroup>
 
diff --git a/Views/LauncherPopup.xaml.cs b/Views/LauncherPopup.xaml.cs
index 705afa0..6c4863e 100644
--- a/Views/LauncherPopup.xaml.cs
+++ b/Views/LauncherPopup.xaml.cs
@@ -473,6 +473,11 @@ public partial class LauncherPopup : Window
             AddToolTipLine(panel, $"Working folder: {item.WorkingFolder}");
         }
 
+        if (!string.IsNullOrWhiteSpace(item.Notes))
+        {
+            AddToolTipLine(panel, $"Notes: {item.Notes}");
+        }
+
         if (item.IsFavorite)
         {
             AddToolTipLine(panel, "Pinned to top");
@@ -526,6 +531,7 @@ public partial class LauncherPopup : Window
         return item.Title.Contains(query, StringComparison.OrdinalIgnoreCase) ||
             item.Target.Contains(query, StringComparison.OrdinalIgnoreCase) ||
             (item.Arguments?.Contains(query, StringComparison.OrdinalIgnoreCase) ?? false) ||
+            (item.Notes?.Contains(query, StringComparison.OrdinalIgnoreCase) ?? false) ||
             parentPath.Contains(query, StringComparison.OrdinalIgnoreCase);
     }
 
diff --git a/config.example.json b/config.example.json
index 166fd97..1d5d1a9 100644
--- a/config.example.json
+++ b/config.example.json
@@ -10,6 +10,7 @@
       "Target": "",
       "Arguments": null,
       "WorkingFolder": null,
+      "Notes": null,
       "IconPath": null,
       "IsFavorite": false,
       "IsDisabled": false,
@@ -23,6 +24,7 @@
           "Target": "%USERPROFILE%\\Documents",
           "Arguments": null,
           "WorkingFolder": null,
+          "Notes": null,
           "IconPath": "%USERPROFILE%\\Documents",
           "IsFavorite": false,
           "IsDisabled": false,
@@ -37,6 +39,7 @@
           "Target": "%USERPROFILE%\\Downloads",
           "Arguments": null,
           "WorkingFolder": null,
+          "Notes": null,
           "IconPath": "%USERPROFILE%\\Downloads",
           "IsFavorite": false,
           "IsDisabled": false,
@@ -53,6 +56,7 @@
       "Target": "",
       "Arguments": null,
       "WorkingFolder": null,
+      "Notes": null,
       "IconPath": null,
       "IsFavorite": false,
       "IsDisabled": false,
@@ -66,6 +70,7 @@
           "Target": "notepad.exe",
           "Arguments": null,
           "WorkingFolder": null,
+          "Notes": "Simple starter app entry.",
           "IconPath": "notepad.exe",
           "IsFavorite": false,
           "IsDisabled": false,
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
index e4b45be..d773f33 100644
--- a/docs/INSTALL.md
+++ b/docs/INSTALL.md
@@ -49,6 +49,7 @@ From Settings you can:
 - Right-click an app or file item and choose **Open Containing Folder**
 - Enable **Run as administrator** for app and file items that need elevation
 - Set a working folder or start apps minimized for app and file items
+- Add notes to items for reminders, context, or search keywords
 - Use **Config... > Validate Targets** to check for missing app, file, and folder targets
 - Use **Config... > Export Selected Item** or **Import Item** to share one item or menu section
 - Right-click an item and choose **Sort This Menu** or **Sort This Level**