feat(gui): add minimize-to-tray support with tray icon and settings toggle

Introduce system tray functionality, allowing the app window to minimize
to tray instead of quitting. Added `TrayManager` for tray icon
management (AppIndicator or StatusIcon), updated shutdown and quit logic
to support tray, and exposed a "Minimize to system tray" toggle in
settings. Config option `minimize_to_tray` added to enable/disable
feature.

Closes #9

Author: d7omdev

Makefile

@@ -94,7 +94,7 @@ install: nuitka
 	@mkdir -p "$(DESKTOP_DEST_DIR)"
 	@printf "%s\n" \
 		"[Desktop Entry]" \
-		"Version=0.3.1" \
+		"Version=0.3.2" \
 		"Type=Application" \
 		"Name=Clipse GUI" \
 		"GenericName=Clipboard Manager" \

clipse_gui/__init__.py

@@ -1 +1 @@
-__version__ = "0.3.1"
+__version__ = "0.3.2"

clipse_gui/app.py

@@ -7,6 +7,7 @@
     DEFAULT_WINDOW_WIDTH,
 )
 from .controller import ClipboardHistoryController
+from .tray_manager import TrayManager
 
 from gi.repository import Gtk, Gio, GLib  # noqa: E402
 
@@ -23,6 +24,7 @@ def __init__(self):
         )
         self.window = None
         self.controller = None
+        self.tray_manager = None
 
     def do_startup(self):
         """Called once when the application starts."""
@@ -56,6 +58,12 @@ def do_activate(self):
                 self.window.set_icon_name("edit-copy")
             except GLib.Error as e:
                 log.warning(f"Could not set window icon name: {e}")
+            
+            # Setup tray manager
+            self.tray_manager = TrayManager(self)
+            
+            # Connect window events for tray functionality
+            self.window.connect("delete-event", self._on_window_delete)
 
             try:
                 self.controller = ClipboardHistoryController(self.window)
@@ -99,4 +107,15 @@ def do_shutdown(self):
             if hasattr(self.controller, "_trigger_save"):
                 self.controller._trigger_save()
 
+        # Cleanup tray resources
+        if self.tray_manager:
+            self.tray_manager.cleanup()
+        
         Gtk.Application.do_shutdown(self)
+
+    def _on_window_delete(self, window, event):
+        """Handle window delete event - minimize to tray if enabled."""
+        if self.tray_manager and constants.MINIMIZE_TO_TRAY:
+            if self.tray_manager.minimize_to_tray():
+                return True  # Prevent window destruction
+        return False  # Allow normal window destruction

clipse_gui/constants.py

@@ -26,6 +26,7 @@
         "save_debounce_ms": "300",
         "search_debounce_ms": "250",
         "paste_simulation_delay_ms": "150",
+        "minimize_to_tray": "True",
     },
     "Commands": {
         "copy_tool_cmd": "wl-copy",
@@ -76,6 +77,7 @@
 PASTE_SIMULATION_DELAY_MS = config.getint(
     "General", "paste_simulation_delay_ms", fallback=150
 )
+MINIMIZE_TO_TRAY = config.getboolean("General", "minimize_to_tray", fallback=True)
 
 COPY_TOOL_CMD = config.get("Commands", "copy_tool_cmd", fallback="wl-copy")
 X11_COPY_TOOL_CMD = config.get(

clipse_gui/controller.py

@@ -990,28 +990,42 @@ def restart_application(self):
         """Restarts the application to apply settings changes."""
         import sys
         import os
+        import subprocess
+        import shutil
 
         log.info("Restarting application to apply settings changes...")
-
-        # Get the current application instance
         app = self.window.get_application()
         if app:
-            # Close the current application
             app.quit()
 
-        # Restart the application
         try:
-            # Get the original command line arguments
-            args = sys.argv[:]
-            log.debug(f"Restarting with args: {args}")
+            clipse_gui_path = shutil.which("clipse-gui")
+
+            if clipse_gui_path:
+                args = [clipse_gui_path] + sys.argv[1:]
+                log.debug(f"Restarting with system executable: {args}")
+                subprocess.Popen(args, cwd=os.getcwd())
+            elif getattr(sys, "frozen", False):
+                executable = sys.executable
+                args = [executable] + sys.argv[1:]
+                log.debug(f"Restarting with frozen executable: {args}")
+                subprocess.Popen(args, cwd=os.getcwd())
+            else:
+                original_cmd = sys.argv[0]
+                if os.path.isfile(original_cmd) and os.access(original_cmd, os.X_OK):
+                    args = [original_cmd] + sys.argv[1:]
+                    log.debug(f"Restarting with original command: {args}")
+                    subprocess.Popen(args, cwd=os.getcwd())
+                else:
+                    raise Exception(f"Cannot find executable: {original_cmd}")
 
-            # Use os.execv to replace the current process
-            os.execv(sys.executable, [sys.executable] + args)
         except Exception as e:
             log.error(f"Failed to restart application: {e}")
-            # Fallback: just quit the application
-            if app:
-                app.quit()
+
+        if app:
+            app.quit()
+        else:
+            sys.exit(0)
 
     def on_preview_key_press(self, preview_window, event):
         """Handles key presses within the preview window."""
@@ -1161,6 +1175,16 @@ def on_key_press(self, widget, event):
                 else:
                     app = self.window.get_application()
                     if app:
+                        # Try to minimize to tray if enabled, otherwise quit
+                        from . import constants
+
+                        if (
+                            hasattr(app, "tray_manager")
+                            and app.tray_manager
+                            and constants.MINIMIZE_TO_TRAY
+                        ):
+                            if app.tray_manager.minimize_to_tray():
+                                return True  # Successfully minimized to tray
                         app.quit()
                     else:
                         log.warning("Application instance is None. Cannot quit.")
@@ -1276,6 +1300,16 @@ def on_key_press(self, widget, event):
             else:
                 app = self.window.get_application()
                 if app:
+                    # Try to minimize to tray if enabled, otherwise quit
+                    from . import constants
+
+                    if (
+                        hasattr(app, "tray_manager")
+                        and app.tray_manager
+                        and constants.MINIMIZE_TO_TRAY
+                    ):
+                        if app.tray_manager.minimize_to_tray():
+                            return True  # Successfully minimized to tray
                     app.quit()
                 else:
                     log.warning("Application instance is None. Cannot quit.")