feat(screenshot): add visual notification for screenshot capture

- Add ShowNotification setting to enable/disable capture notifications
- Implement notification window with image thumbnail and capture type label
- Support Windows light/dark mode for notification styling
- Play Windows notification sound on capture
- Display notification at bottom-right with fade-in/out effects and auto-close timer
- Integrate notification calls after each screenshot capture method
- Enhance logging for notification display and errors
- Update build scripts and packaging to include modified plugin DLLs and resources

Author: NSTechBytes

.github/Dark_Toast.png

@@ -6,6 +6,8 @@
 using System.Linq;
 using System.Runtime.InteropServices;
 using System.Windows.Forms;
+using System.Media;
+using Microsoft.Win32;
 using Rainmeter;
 
 namespace PluginScreenshot
@@ -62,6 +64,7 @@ public class Settings
         public bool ShowCursor { get; private set; }
         public int JpegQuality { get; private set; }
         public Rectangle PredefinedRegion { get; private set; }
+        public bool ShowNotification { get; private set; }
 
         public Settings(API api)
         {
@@ -70,6 +73,7 @@ public Settings(API api)
             FinishAction = api.ReadString("ScreenshotFinishAction", "");
             ShowCursor = api.ReadInt("ShowCursor", 0) > 0;
             JpegQuality = api.ReadInt("JpgQuality", 70);
+            ShowNotification = api.ReadInt("ShowNotification", 0) > 0;
             int x = api.ReadInt("PredefX", 0);
             int y = api.ReadInt("PredefY", 0);
             int w = api.ReadInt("PredefWidth", 0);
@@ -179,6 +183,12 @@ public static void TakeFullScreen(Settings settings)
                 }
             });
 
+            if (settings.ShowNotification)
+            {
+                Logger.Log("TakeFullScreen: ShowNotification is enabled");
+                ShowNotificationWithImage(settings.SavePath, "Full Screen");
+            }
+
             ExecuteFinishAction(settings);
         }
 
@@ -200,6 +210,12 @@ public static void TakePredefined(Settings settings)
                 }
             });
 
+            if (settings.ShowNotification)
+            {
+                Logger.Log("TakePredefined: ShowNotification is enabled");
+                ShowNotificationWithImage(settings.SavePath, "Predefined Region");
+            }
+
             ExecuteFinishAction(settings);
         }
 
@@ -267,6 +283,12 @@ public static void TakeWindowScreenshot(Settings settings, string windowTitle)
                 }
             });
 
+            if (settings.ShowNotification)
+            {
+                Logger.Log("TakeWindowScreenshot: ShowNotification is enabled");
+                ShowNotificationWithImage(settings.SavePath, $"Window: {windowTitle}");
+            }
+
             ExecuteFinishAction(settings);
         }
 
@@ -303,6 +325,12 @@ public static void CompositeCapture(Rectangle rect, Settings settings)
 
                 SaveImageSafely(finalBmp, settings);
             }
+
+            if (settings.ShowNotification)
+            {
+                Logger.Log("CompositeCapture: ShowNotification is enabled");
+                ShowNotificationWithImage(settings.SavePath, "Custom Region");
+            }
         }
 
 
@@ -381,6 +409,54 @@ public static void ExecuteFinishAction(Settings settings)
                 Logger.Log("Error running finish action: " + ex.Message);
             }
         }
+
+        private static void ShowNotificationWithImage(string imagePath, string captureType)
+        {
+            try
+            {
+                if (!File.Exists(imagePath))
+                {
+                    Logger.Log($"ShowNotificationWithImage: Image file not found at '{imagePath}'");
+                    return;
+                }
+
+                Logger.Log($"ShowNotificationWithImage: Creating notification for '{captureType}'");
+
+                // Play Windows notification sound
+                try
+                {
+                    SystemSounds.Asterisk.Play();
+                    Logger.Log("Notification sound played");
+                }
+                catch (Exception ex)
+                {
+                    Logger.Log($"Failed to play notification sound: {ex.Message}");
+                }
+
+                // Create notification form on a separate thread
+                var notificationThread = new System.Threading.Thread(() =>
+                {
+                    try
+                    {
+                        Logger.Log("Notification thread started");
+                        Application.Run(new NotificationForm(imagePath, captureType));
+                    }
+                    catch (Exception ex)
+                    {
+                        Logger.Log($"Notification thread error: {ex.Message}");
+                    }
+                });
+                notificationThread.SetApartmentState(System.Threading.ApartmentState.STA);
+                notificationThread.IsBackground = true;
+                notificationThread.Start();
+
+                Logger.Log($"Notification thread started for '{captureType}' capture.");
+            }
+            catch (Exception ex)
+            {
+                Logger.Log($"Error showing notification: {ex.Message}");
+            }
+        }
     }
 
     public class CustomScreenshotForm : Form
@@ -470,6 +546,251 @@ private void OnPaint(object s, PaintEventArgs e)
         }
     }
 
+    public class NotificationForm : Form
+    {
+        private readonly Timer _autoCloseTimer;
+        private readonly Timer _fadeOutTimer;
+        private readonly string _imagePath;
+        private const int NotificationWidth = 380;
+        private const int NotificationHeight = 120;
+        private const int DisplayDuration = 4000; // 4 seconds
+        private const int FadeOutDuration = 500; // 0.5 seconds
+        private double _opacity = 1.0;
+        private readonly bool _isDarkMode;
+
+        public NotificationForm(string imagePath, string captureType)
+        {
+            _imagePath = imagePath;
+            _isDarkMode = IsWindowsDarkMode();
+
+            // Form settings
+            FormBorderStyle = FormBorderStyle.None;
+            StartPosition = FormStartPosition.Manual;
+            TopMost = true;
+            ShowInTaskbar = false;
+            Width = NotificationWidth;
+            Height = NotificationHeight;
+            BackColor = _isDarkMode ? Color.FromArgb(30, 30, 30) : Color.FromArgb(240, 240, 240);
+            Opacity = 0;
+
+            // Position at bottom-right of screen
+            var workingArea = Screen.PrimaryScreen.WorkingArea;
+            Location = new Point(
+                workingArea.Right - Width - 20,
+                workingArea.Bottom - Height - 20
+            );
+
+            // Create UI
+            CreateNotificationUI(captureType);
+
+            // Auto-close timer
+            _autoCloseTimer = new Timer { Interval = DisplayDuration };
+            _autoCloseTimer.Tick += (s, e) =>
+            {
+                _autoCloseTimer.Stop();
+                StartFadeOut();
+            };
+
+            // Fade-out timer
+            _fadeOutTimer = new Timer { Interval = 20 };
+            _fadeOutTimer.Tick += FadeOutTick;
+
+            // Click to close
+            Click += (s, e) => StartFadeOut();
+
+            // Show with fade-in effect
+            Load += (s, e) =>
+            {
+                FadeIn();
+                _autoCloseTimer.Start();
+            };
+        }
+
+        private bool IsWindowsDarkMode()
+        {
+            try
+            {
+                using (RegistryKey key = Registry.CurrentUser.OpenSubKey(@"Software\Microsoft\Windows\CurrentVersion\Themes\Personalize"))
+                {
+                    if (key != null)
+                    {
+                        object value = key.GetValue("AppsUseLightTheme");
+                        if (value != null)
+                        {
+                            return (int)value == 0; // 0 = Dark Mode, 1 = Light Mode
+                        }
+                    }
+                }
+            }
+            catch (Exception ex)
+            {
+                Logger.Log($"Failed to detect Windows theme: {ex.Message}");
+            }
+            return true; // Default to dark mode if detection fails
+        }
+
+        private void CreateNotificationUI(string captureType)
+        {
+            // Color scheme based on theme
+            Color panelBackColor = _isDarkMode ? Color.FromArgb(40, 40, 40) : Color.FromArgb(250, 250, 250);
+            Color textColor = _isDarkMode ? Color.White : Color.FromArgb(30, 30, 30);
+            Color subtitleColor = _isDarkMode ? Color.FromArgb(180, 180, 180) : Color.FromArgb(100, 100, 100);
+            Color closeButtonColor = _isDarkMode ? Color.FromArgb(150, 150, 150) : Color.FromArgb(100, 100, 100);
+            Color closeButtonHoverColor = _isDarkMode ? Color.White : Color.Black;
+            Color thumbnailBorderColor = _isDarkMode ? Color.FromArgb(60, 60, 60) : Color.FromArgb(200, 200, 200);
+
+            // Main panel
+            var panel = new Panel
+            {
+                Dock = DockStyle.Fill,
+                Padding = new Padding(10),
+                BackColor = panelBackColor
+            };
+
+            // Thumbnail image
+            var thumbnail = new PictureBox
+            {
+                Location = new Point(10, 10),
+                Size = new Size(100, 100),
+                SizeMode = PictureBoxSizeMode.Zoom,
+                BorderStyle = BorderStyle.FixedSingle,
+                BackColor = thumbnailBorderColor
+            };
+
+            try
+            {
+                using (var img = Image.FromFile(_imagePath))
+                {
+                    thumbnail.Image = new Bitmap(img, thumbnail.Size);
+                }
+            }
+            catch
+            {
+                thumbnail.BackColor = thumbnailBorderColor;
+            }
+
+            // Success icon/text
+            var successLabel = new Label
+            {
+                Text = "FinalShot",
+                Font = new Font("Segoe UI", 12, FontStyle.Bold),
+                ForeColor = Color.FromArgb(0, 200, 100),
+                Location = new Point(120, 10),
+                Size = new Size(200, 30),
+                TextAlign = ContentAlignment.MiddleLeft
+            };
+
+            // Title
+            var titleLabel = new Label
+            {
+                Text = "Screenshot Captured!",
+                Font = new Font("Segoe UI", 11, FontStyle.Bold),
+                ForeColor = textColor,
+                Location = new Point(120, 45),
+                Size = new Size(250, 25),
+                TextAlign = ContentAlignment.MiddleLeft
+            };
+
+            // Subtitle
+            var subtitleLabel = new Label
+            {
+                Text = captureType,
+                Font = new Font("Segoe UI", 9, FontStyle.Regular),
+                ForeColor = subtitleColor,
+                Location = new Point(120, 70),
+                Size = new Size(250, 20),
+                TextAlign = ContentAlignment.MiddleLeft
+            };
+
+            // Close button
+            var closeButton = new Label
+            {
+                Text = "✕",
+                Font = new Font("Segoe UI", 12, FontStyle.Bold),
+                ForeColor = closeButtonColor,
+                Location = new Point(NotificationWidth - 35, 5),
+                Size = new Size(25, 25),
+                TextAlign = ContentAlignment.MiddleCenter,
+                Cursor = Cursors.Hand
+            };
+            closeButton.Click += (s, e) => StartFadeOut();
+            closeButton.MouseEnter += (s, e) => closeButton.ForeColor = closeButtonHoverColor;
+            closeButton.MouseLeave += (s, e) => closeButton.ForeColor = closeButtonColor;
+
+            // Add all controls
+            panel.Controls.Add(thumbnail);
+            panel.Controls.Add(successLabel);
+            panel.Controls.Add(titleLabel);
+            panel.Controls.Add(subtitleLabel);
+            panel.Controls.Add(closeButton);
+            Controls.Add(panel);
+
+            // Make labels click-through to panel
+            foreach (Control ctrl in panel.Controls)
+            {
+                if (ctrl is Label && ctrl != closeButton)
+                {
+                    ctrl.Click += (s, e) => StartFadeOut();
+                }
+            }
+        }
+
+        private void FadeIn()
+        {
+            var fadeInTimer = new Timer { Interval = 10 };
+            double targetOpacity = 0.95;
+            double step = 0.05;
+
+            fadeInTimer.Tick += (s, e) =>
+            {
+                _opacity += step;
+                if (_opacity >= targetOpacity)
+                {
+                    _opacity = targetOpacity;
+                    Opacity = _opacity;
+                    fadeInTimer.Stop();
+                    fadeInTimer.Dispose();
+                }
+                else
+                {
+                    Opacity = _opacity;
+                }
+            };
+            fadeInTimer.Start();
+        }
+
+        private void StartFadeOut()
+        {
+            if (_fadeOutTimer.Enabled) return;
+            _autoCloseTimer.Stop();
+            _fadeOutTimer.Start();
+        }
+
+        private void FadeOutTick(object sender, EventArgs e)
+        {
+            _opacity -= 0.05;
+            if (_opacity <= 0)
+            {
+                _fadeOutTimer.Stop();
+                Close();
+            }
+            else
+            {
+                Opacity = _opacity;
+            }
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            if (disposing)
+            {
+                _autoCloseTimer?.Dispose();
+                _fadeOutTimer?.Dispose();
+            }
+            base.Dispose(disposing);
+        }
+    }
+
     public static class Plugin
     {
         [DllExport]