[FEATURE] - Pinned Results

Flow.Launcher.Core/Plugin/PluginInstaller.cs

@@ -174,10 +174,16 @@ public static async Task UninstallPluginAndCheckRestartAsync(PluginMetadata oldP
 
         try
         {
-            if (!await PublicApi.Instance.UninstallPluginAsync(oldPlugin, removePluginSettings))
+            var isUninstalled = await PublicApi.Instance.UninstallPluginAsync(oldPlugin, removePluginSettings);
+            if (!isUninstalled)
             {
                 return;
             }
+
+            // Ensure PropertyChanged is raised even if the flag was already true,
+            // so pinned-results cleanup is triggered on every successful uninstall.
+            Settings.ShouldCleanPinnedResultsFromUninstalledPlugins = false;
+            Settings.ShouldCleanPinnedResultsFromUninstalledPlugins = true;
         }
         catch (Exception e)
         {

Flow.Launcher.Core/Plugin/PluginManager.cs

@@ -829,6 +829,11 @@ private static bool SameOrLesserPluginVersionExists(PluginMetadata metadata)
 
         #region Public Functions
 
+        public static bool PluginInitializedAndUnmodified(string id)
+        {
+            return GetAllInitializedPlugins(includeFailed: false).Any(p => p.Metadata.ID == id) && !PluginModified(id);
+        }
+
         public static bool PluginModified(string id)
         {
             return ModifiedPlugins.Contains(id);

Flow.Launcher.Core/Resource/Theme.cs

@@ -318,6 +318,30 @@ private ResourceDictionary GetResourceDictionary(string theme)
                     => Array.ForEach(setters, p => o.Setters.Add(p)));
             }
 
+            var baseHomeIconStyle = dict["BaseHomeIconFontStyle"] as Style;
+            var itemTitleStyle = (dict["ItemTitleStyle"] ?? dict["BaseItemTitleStyle"]) as Style;
+            var homeIconFontStyle = dict["HomeIconFontStyle"] as Style;
+
+            if (homeIconFontStyle == null && itemTitleStyle != null)
+            {
+                var styleToExtend = baseHomeIconStyle ?? itemTitleStyle;
+                var dynamicHomeStyle = new Style(typeof(TextBlock), styleToExtend);
+
+                var foregroundSetter = itemTitleStyle.Setters
+                    .OfType<Setter>()
+                    .FirstOrDefault(s => s.Property == TextBlock.ForegroundProperty);
+
+                if (foregroundSetter != null)
+                {
+                    dynamicHomeStyle.Setters.Add(new Setter(TextBlock.ForegroundProperty, foregroundSetter.Value));
+                }
+                else if (baseHomeIconStyle != null)
+                {
+                    dynamicHomeStyle.Setters.Add(new Setter(TextBlock.ForegroundProperty, new DynamicResourceExtension("ItemTitleStyle")));
+                }
+                dict["HomeIconFontStyle"] = dynamicHomeStyle;
+            }
+
             /* Ignore Theme Window Width and use setting */
             var windowStyle = dict["WindowStyle"] as Style;
             var width = _settings.WindowSize;

Flow.Launcher.Infrastructure/Constant.cs

@@ -35,6 +35,8 @@ public static class Constant
         public static readonly string ImageIcon = Path.Combine(ImagesDirectory, "image.png");
         public static readonly string HistoryIcon = Path.Combine(ImagesDirectory, "history.png");
         public static readonly string SettingsIcon = Path.Combine(ImagesDirectory, "settings.png");
+        public static readonly string ResultsIcon = Path.Combine(ImagesDirectory, "results.png");
+        public static readonly string SearchIcon = Path.Combine(ImagesDirectory, "search.png");
 
         public static string PythonPath;
         public static string NodePath;

Flow.Launcher.Infrastructure/UserSettings/Settings.cs

@@ -84,6 +84,7 @@ public bool ShowOpenResultHotkey
         public string OpenContextMenuHotkey { get; set; } = $"Ctrl+O";
         public string SettingWindowHotkey { get; set; } = $"Ctrl+I";
         public string OpenHistoryHotkey { get; set; } = $"Ctrl+H";
+        public string GridModeHotkey { get; set; } = $"{KeyConstant.Ctrl} + G";
         public string CycleHistoryUpHotkey { get; set; } = $"{KeyConstant.Alt} + Up";
         public string CycleHistoryDownHotkey { get; set; } = $"{KeyConstant.Alt} + Down";
         public string DialogJumpHotkey { get; set; } = $"{KeyConstant.Alt} + G";
@@ -125,6 +126,7 @@ public string Theme
         public double QueryBoxFontSize { get; set; } = 16;
         public double ResultItemFontSize { get; set; } = 16;
         public double ResultSubItemFontSize { get; set; } = 13;
+        public double HomeScreenFontSize { get; set; } = 12;
         public string QueryBoxFont { get; set; } = Win32Helper.GetSystemDefaultFont();
         public string QueryBoxFontStyle { get; set; }
         public string QueryBoxFontWeight { get; set; }
@@ -137,12 +139,52 @@ public string Theme
         public string ResultSubFontStyle { get; set; }
         public string ResultSubFontWeight { get; set; }
         public string ResultSubFontStretch { get; set; }
-        public bool UseGlyphIcons { get; set; } = true;
+
+        private bool _useGlyphIcons = true;
+        public bool UseGlyphIcons
+        {
+            get => _useGlyphIcons;
+            set
+            {
+                if (_useGlyphIcons != value)
+                {
+                    _useGlyphIcons = value;
+                    OnPropertyChanged();
+                }
+            }
+        }
+
         public bool UseAnimation { get; set; } = true;
         public bool UseSound { get; set; } = true;
         public double SoundVolume { get; set; } = 50;
-        public bool ShowBadges { get; set; } = false;
-        public bool ShowBadgesGlobalOnly { get; set; } = false;
+
+        private bool _showBadges = false;
+        public bool ShowBadges
+        {
+            get => _showBadges;
+            set
+            {
+                if (_showBadges != value)
+                {
+                    _showBadges = value;
+                    OnPropertyChanged();
+                }
+            }
+        }
+
+        private bool _showBadgesGlobalOnly = false;
+        public bool ShowBadgesGlobalOnly
+        {
+            get => _showBadgesGlobalOnly;
+            set
+            {
+                if (_showBadgesGlobalOnly != value)
+                {
+                    _showBadgesGlobalOnly = value;
+                    OnPropertyChanged();
+                }
+            }
+        }
 
         private string _settingWindowFont { get; set; } = Win32Helper.GetSystemDefaultFont(false);
         public string SettingWindowFont
@@ -389,6 +431,59 @@ public DoublePinyinSchemas DoublePinyinSchema
             }
         }
 
+        private bool _enablePinnedResults = false;
+        public bool EnablePinnedResults
+        {
+            get => _enablePinnedResults;
+            set
+            {
+                if (_enablePinnedResults != value)
+                {
+                    _enablePinnedResults = value;
+                    OnPropertyChanged();
+                }
+            }
+        }
+
+        private bool _shouldCleanPinnedResultsFromUninstalledPlugins = false;
+        /// <summary>
+        /// Flag that indicates whether to automatically clean pinned results that belong to uninstalled plugins.
+        /// When it is true, it means some plugins are uninstalled.
+        /// And we need to clean results of any pinned results associated with plugins that have been uninstalled.
+        /// </summary>
+        /// <remarks>
+        /// It does not need to be included in the settings since after restarting,
+        /// the results of uninstalled plugins cannot be constructed.
+        /// </remarks>
+        [JsonIgnore]
+        public bool ShouldCleanPinnedResultsFromUninstalledPlugins
+        {
+            get => _shouldCleanPinnedResultsFromUninstalledPlugins;
+            set
+            {
+                if (_shouldCleanPinnedResultsFromUninstalledPlugins != value)
+                {
+                    _shouldCleanPinnedResultsFromUninstalledPlugins = value;
+                    OnPropertyChanged();
+                }
+            }
+        }
+
+        private PinnedLayoutOptions _pinnedResultsLayout = PinnedLayoutOptions.List;
+        [JsonConverter(typeof(JsonStringEnumConverter))]
+        public PinnedLayoutOptions PinnedResultsLayout
+        {
+            get => _pinnedResultsLayout;
+            set
+            {
+                if (_pinnedResultsLayout != value)
+                {
+                    _pinnedResultsLayout = value;
+                    OnPropertyChanged();
+                }
+            }
+        }
+
         public bool AlwaysPreview { get; set; } = false;
 
         public bool AlwaysStartEn { get; set; } = false;
@@ -568,6 +663,8 @@ public List<RegisteredHotkeyData> RegisteredHotkeys
                     list.Add(new(SettingWindowHotkey, "SettingWindowHotkey", () => SettingWindowHotkey = ""));
                 if (!string.IsNullOrEmpty(OpenHistoryHotkey))
                     list.Add(new(OpenHistoryHotkey, "OpenHistoryHotkey", () => OpenHistoryHotkey = ""));
+                if (!string.IsNullOrEmpty(GridModeHotkey))
+                    list.Add(new(GridModeHotkey, "GridModeHotkey", () => GridModeHotkey = ""));
                 if (!string.IsNullOrEmpty(OpenContextMenuHotkey))
                     list.Add(new(OpenContextMenuHotkey, "OpenContextMenuHotkey", () => OpenContextMenuHotkey = ""));
                 if (!string.IsNullOrEmpty(SelectNextPageHotkey))
@@ -722,4 +819,10 @@ public enum HistoryStyle
         [EnumLocalizeKey(nameof(Localize.executedHistory))]
         LastOpened
     }
+
+    public enum PinnedLayoutOptions
+    {
+        List,
+        Grid
+    }
 }

Flow.Launcher/App.xaml.cs

@@ -259,8 +259,10 @@ await API.StopwatchLogInfoAsync(ClassName, "Startup cost", async () =>
 
                     await PluginManager.InitializePluginsAsync(_mainVM);
 
-                    // Refresh the history results after plugins are initialized so that we can parse the absolute icon paths
+                    // Refresh the history results & pinned results after plugins are initialized
+                    // so that we can parse the absolute icon paths
                     _mainVM.RefreshLastOpenedHistoryResults();
+                    _mainVM.RefreshPinnedResults();
 
                     // Refresh home page after plugins are initialized because users may open main window during plugin initialization
                     // And home page is created without full plugin list

Flow.Launcher/Helper/ResultHelper.cs

@@ -3,17 +3,16 @@
 using System.Threading.Tasks;
 using Flow.Launcher.Core.Plugin;
 using Flow.Launcher.Plugin;
-using Flow.Launcher.Storage;
 
 namespace Flow.Launcher.Helper;
 
 #nullable enable
 
 public static class ResultHelper
 {
-    public static async Task<Result?> PopulateResultsAsync(LastOpenedHistoryResult item)
+    public static async Task<Result?> PopulateResultsAsync<T>(T item, string query) where T : Result
     {
-        return await PopulateResultsAsync(item.PluginID, item.Query, item.Title, item.SubTitle, item.RecordKey);
+        return await PopulateResultsAsync(item.PluginID, query, item.Title, item.SubTitle, item.RecordKey);
     }
 
     public static async Task<Result?> PopulateResultsAsync(string pluginId, string trimmedQuery, string title, string subTitle, string recordKey)

Flow.Launcher/Languages/en.xaml

@@ -187,6 +187,17 @@
     <system:String x:Key="autoUpdatePlugins">Auto update plugins</system:String>
     <system:String x:Key="autoUpdatePluginsToolTip">Automatically check plugin updates and notify if there are any updates available</system:String>
 
+    <system:String x:Key="pinnedResults">Pinned Results</system:String>
+    <system:String x:Key="showPinnedResultsOnHomePage">Show pinned results on home page</system:String>
+    <system:String x:Key="pinnedResultsLayout">Pinned Results Layout</system:String>
+    <system:String x:Key="pinToFlow">Pin to Flow</system:String>
+    <system:String x:Key="unpinFromFlow">Unpin from Flow</system:String>
+    <system:String x:Key="pinResult">Pin Result</system:String>
+    <system:String x:Key="pinQuery">Pin Query</system:String>
+    <system:String x:Key="PinnedLayoutList">List</system:String>
+    <system:String x:Key="PinnedLayoutGrid">Grid</system:String>
+    <system:String x:Key="lastPinnedAt">Added to pinned: {0}</system:String>
+    <system:String x:Key="pinnedResultsEmpty">No pinned results yet</system:String>
     <!--  Setting Plugin  -->
     <system:String x:Key="searchplugin">Search Plugin</system:String>
     <system:String x:Key="searchpluginToolTip">Ctrl+F to search plugins</system:String>
@@ -304,6 +315,7 @@
     <system:String x:Key="queryBoxFont">Query Box Font</system:String>
     <system:String x:Key="resultItemFont">Result Title Font</system:String>
     <system:String x:Key="resultSubItemFont">Result Subtitle Font</system:String>
+    <system:String x:Key="homeScreenFontSize">Home Font Size</system:String>
     <system:String x:Key="resetCustomize">Reset</system:String>
     <system:String x:Key="resetCustomizeToolTip">Reset to the recommended font and size settings.</system:String>
     <system:String x:Key="ImportThemeSize">Import Theme Size</system:String>

Flow.Launcher/MainWindow.xaml

@@ -207,6 +207,10 @@
             Key="{Binding CycleHistoryUpHotkey, Converter={StaticResource StringToKeyBindingConverter}, ConverterParameter='key'}"
             Command="{Binding ReverseHistoryCommand}"
             Modifiers="{Binding CycleHistoryUpHotkey, Converter={StaticResource StringToKeyBindingConverter}, ConverterParameter='modifiers'}" />
+        <KeyBinding
+            Key="{Binding Settings.GridModeHotkey, Converter={StaticResource StringToKeyBindingConverter}, ConverterParameter='key'}"
+            Command="{Binding ToggleGridModeCommand}"
+            Modifiers="{Binding Settings.GridModeHotkey, Converter={StaticResource StringToKeyBindingConverter}, ConverterParameter='modifiers'}" />
         <KeyBinding
             Key="{Binding CycleHistoryDownHotkey, Converter={StaticResource StringToKeyBindingConverter}, ConverterParameter='key'}"
             Command="{Binding ForwardHistoryCommand}"
@@ -356,33 +360,26 @@
                     <ContentControl.Style>
                         <Style TargetType="ContentControl">
                             <Setter Property="Visibility" Value="Visible" />
+
                             <Style.Triggers>
                                 <MultiDataTrigger>
                                     <MultiDataTrigger.Conditions>
-                                        <Condition Binding="{Binding ElementName=ResultListBox, Path=Items.Count}" Value="0" />
-                                        <Condition Binding="{Binding ElementName=ResultContextMenu, Path=Visibility}" Value="Collapsed" />
-                                        <Condition Binding="{Binding ElementName=History, Path=Visibility}" Value="Collapsed" />
+                                        <Condition Binding="{Binding ActualHeight, ElementName=PinnedResultGrid}" Value="0" />
+
+                                        <Condition Binding="{Binding HasItems, ElementName=ResultListBox}" Value="False" />
+
+                                        <Condition Binding="{Binding Visibility, ElementName=History}" Value="Collapsed" />
+
+                                        <Condition Binding="{Binding Visibility, ElementName=ResultContextMenu}" Value="Collapsed" />
                                     </MultiDataTrigger.Conditions>
-                                    <MultiDataTrigger.Setters>
-                                        <Setter Property="Visibility" Value="Collapsed" />
-                                        <Setter Property="Margin" Value="0" />
-                                        <Setter Property="Height" Value="0" />
-                                    </MultiDataTrigger.Setters>
+
+                                    <Setter Property="Visibility" Value="Collapsed" />
+                                    <Setter Property="Height" Value="0" />
                                 </MultiDataTrigger>
                             </Style.Triggers>
-                            <!--<Style.Triggers>
-                                <DataTrigger Binding="{Binding ElementName=ResultListBox, Path=Visibility}" Value="Visible">
-                                    <Setter Property="Visibility" Value="Visible" />
-                                </DataTrigger>
-                                <DataTrigger Binding="{Binding ElementName=ResultContextMenu, Path=Visibility}" Value="Visible">
-                                    <Setter Property="Visibility" Value="Visible" />
-                                </DataTrigger>
-                                <DataTrigger Binding="{Binding ElementName=History, Path=Visibility}" Value="Visible">
-                                    <Setter Property="Visibility" Value="Visible" />
-                                </DataTrigger>
-                            </Style.Triggers>-->
                         </Style>
                     </ContentControl.Style>
+
                     <Rectangle
                         Name="MiddleSeparator"
                         Width="Auto"
@@ -411,11 +408,16 @@
                         x:Name="ResultArea"
                         Grid.Column="0"
                         Grid.ColumnSpan="{Binding ResultAreaColumn}">
+
+                        <!--  Pinned Results Grid  -->
+                        <flowlauncher:PinnedResultGrid x:Name="PinnedResultGrid" />
+
                         <ContentControl>
                             <flowlauncher:ResultListBox
                                 x:Name="ResultListBox"
                                 DataContext="{Binding Results}"
                                 LeftClickResultCommand="{Binding LeftClickResultCommand}"
+                                MouseSelectCommand="{Binding MouseSelectCommand}"
                                 RightClickResultCommand="{Binding RightClickResultCommand}" />
                         </ContentControl>
                         <ContentControl>