add support for loading from CLI

current syntax: flatpak run --file-forwarding be.alexandervanhee.gradia @@ "/path/to/file.png" @@

Author: AlexanderVanhee

data/be.alexandervanhee.gradia.desktop.in

@@ -1,5 +1,6 @@
 [Desktop Entry]
 Name=Gradia
+Comment=Make your images ready for the world
 Exec=gradia %f
 Icon=be.alexandervanhee.gradia
 Terminal=false
@@ -8,3 +9,4 @@ Categories=Graphics;
 Keywords=Image;Gradient;Background;Screenshot;Edit;
 StartupNotify=true
 DBusActivatable=true
+MimeType=image/png;image/jpeg;image/webp;

gradia/main.py

@@ -20,6 +20,7 @@
 import shutil
 
 from collections.abc import Sequence
+from typing import Optional
 
 from gi.repository import Adw, Gio
 
@@ -32,15 +33,30 @@ class GradiaApp(Adw.Application):
     def __init__(self, version: str):
         super().__init__(
             application_id="be.alexandervanhee.gradia",
-            flags=Gio.ApplicationFlags.HANDLES_COMMAND_LINE
+            flags=Gio.ApplicationFlags.HANDLES_COMMAND_LINE | Gio.ApplicationFlags.HANDLES_OPEN
         )
         self.temp_dir = tempfile.mkdtemp()
         self.version = version
         self.init_with_screenshot = False
+        self.file_to_open: Optional[str] = None
 
     def do_command_line(self, command_line: Gio.ApplicationCommandLine) -> int:
         args = command_line.get_arguments()[1:]
+
         self.init_with_screenshot = "--screenshot" in args
+
+        # Extract the first non-option argument
+        for arg in args:
+            if not arg.startswith("--"):
+                try:
+                    file = Gio.File.new_for_commandline_arg(arg)
+                    path = file.get_path()
+                    if path:
+                        self.file_to_open = path
+                        break
+                except Exception as e:
+                    print(f"Failed to parse file URI {arg}: {e}")
+
         self.activate()
         return 0
 
@@ -49,12 +65,18 @@ def do_activate(self):
             self.temp_dir,
             version=self.version,
             application=self,
-            init_with_screenshot=self.init_with_screenshot
+            init_with_screenshot=self.init_with_screenshot,
+            file_path=self.file_to_open
         )
+        print(self.file_to_open)
         self.ui.build_ui()
         self.ui.show()
 
     def do_open(self, files: Sequence[Gio.File], hint: str):
+        if files:
+            path = files[0].get_path()
+            if path:
+                self.file_to_open = path
         self.activate()
 
     def do_shutdown(self):
@@ -66,6 +88,7 @@ def do_shutdown(self):
         finally:
             Gio.Application.do_shutdown(self)
 
+
 def main(version: str):
     try:
         app = GradiaApp(version=version)

gradia/ui/image_loaders.py

@@ -48,7 +48,8 @@ def _is_supported_format(self, file_path: str) -> bool:
     def _set_image_and_update_ui(self, image_path: str, filename: str, location: str) -> None:
         """Common method to set image and update UI"""
         self.window.image_path = image_path
-        self.window.drawing_overlay.clear_drawing()
+        if hasattr(self.window, 'drawing_overlay') and self.window.drawing_overlay:
+            self.window.drawing_overlay.clear_drawing()
         self.window._update_sidebar_info(filename, location)
         self.window._start_processing()
 
@@ -234,6 +235,34 @@ def _handle_screenshot_uri(self, uri: str) -> None:
         finally:
             self.window._set_loading_state(False)
 
+class CommandlineLoader(BaseImageLoader):
+    """Handles loading images from command line arguments or programmatic file paths"""
+
+    def __init__(self, window: Gtk.ApplicationWindow, temp_dir: str) -> None:
+        super().__init__(window, temp_dir)
+
+    def load_from_file(self, file_path: str) -> None:
+        """Load image from a given file path"""
+        try:
+            if not file_path:
+                print("No file path provided")
+                return
+
+            if not os.path.isfile(file_path):
+                print(f"File does not exist: {file_path}")
+                return
+
+            if not self._is_supported_format(file_path):
+                print(f"Unsupported file format: {file_path}")
+                return
+
+            filename = os.path.basename(file_path)
+            directory = os.path.dirname(file_path)
+
+            self._set_image_and_update_ui(file_path, filename, directory)
+
+        except Exception as e:
+            print(f"Error loading file from command line: {e}")
 
 class ImportManager:
     def __init__(self, window: Gtk.ApplicationWindow, temp_dir: str) -> None:
@@ -244,6 +273,7 @@ def __init__(self, window: Gtk.ApplicationWindow, temp_dir: str) -> None:
         self.drag_drop_loader: DragDropImageLoader = DragDropImageLoader(window, temp_dir)
         self.clipboard_loader: ClipboardImageLoader = ClipboardImageLoader(window, temp_dir)
         self.screenshot_loader: ScreenshotImageLoader = ScreenshotImageLoader(window, temp_dir)
+        self.commandline_loader: CommandlineLoader = CommandlineLoader(window, temp_dir)
 
     def open_file_dialog(self) -> None:
         self.file_loader.open_file_dialog()
@@ -261,3 +291,6 @@ def load_from_clipboard(self) -> None:
 
     def take_screenshot(self) -> None:
         self.screenshot_loader.take_screenshot()
+
+    def load_from_file(self, file_path: str) -> None:
+        self.commandline_loader.load_from_file(file_path)

gradia/ui/window.py

@@ -46,7 +46,7 @@ class GradientWindow(Adw.ApplicationWindow):
     # Temp file names
     TEMP_PROCESSED_FILENAME: str = "processed.png"
 
-    def __init__(self, temp_dir: str, version: str, init_with_screenshot: bool = False, **kwargs) -> None:
+    def __init__(self, temp_dir: str, version: str, init_with_screenshot: bool = False, file_path: str = None, **kwargs) -> None:
         super().__init__(**kwargs)
 
         self.app: Adw.Application = kwargs['application']
@@ -94,6 +94,7 @@ def __init__(self, temp_dir: str, version: str, init_with_screenshot: bool = Fal
         self.create_action_with_param("pen-color", lambda action, param: self._set_pen_color_from_string(param.get_string()))
         self.create_action_with_param("fill-color", lambda action, param: self._set_fill_color_from_string(param.get_string()))
         self.create_action("del-selected", lambda *_: self.drawing_overlay.remove_selected_action(), ["<Primary>x", "Delete"])
+        self.file_path = file_path
 
         if init_with_screenshot:
             self.import_manager.take_screenshot()
@@ -132,6 +133,9 @@ def build_ui(self) -> None:
         self._setup_sidebar()
         self._setup_main_layout()
 
+        if self.file_path:
+            self.import_manager.load_from_file(self.file_path)
+
     def _setup_window(self) -> None:
         self.set_title("Gradia")
         self.set_default_size(self.DEFAULT_WINDOW_WIDTH, self.DEFAULT_WINDOW_HEIGHT)