feat: add file watcher for clipboard history updates

- Introduced a `_start_history_watcher` method in `DataManager` to
monitor changes in the history file and trigger updates.
- Added a callback `_on_history_updated` in `ClipboardHistoryController`
to handle history updates and refresh the UI.
- Updated `DataManager` to accept an `update_callback` parameter for
notifying changes.
- Added new constants (`COMPACT_MODE`, `ENTER_TO_PASTE`,
`PASTE_TOOL_CMD`, `X11_PASTE_TOOL_CMD`) in `constants.py` for additional
configuration options.

Author: d7omdev

.github/workflows/release.yml

@@ -5,6 +5,9 @@ on:
     tags:
       - "v*.*.*"
 
+permissions:
+  contents: write
+
 jobs:
   release:
     runs-on: ubuntu-latest

clipse_gui/app.py

@@ -60,7 +60,7 @@ def __init__(self, application_window: Gtk.ApplicationWindow):
         self._vadjustment_handler_id = None
 
         # --- Initialize Managers ---
-        self.data_manager = DataManager(HISTORY_FILE_PATH)
+        self.data_manager = DataManager(HISTORY_FILE_PATH, self._on_history_updated)
         self.image_handler = ImageHandler(IMAGE_CACHE_MAX_SIZE)
 
         # --- Build UI Content ---
@@ -153,15 +153,26 @@ def _apply_css(self):
         else:
             log.debug("CSS provider already exists.")
 
+    def _on_history_updated(self, loaded_items):
+        """Callback function called when the file is updated."""
+        self.items = loaded_items
+        self.update_filtered_items()
+        self._focus_first_item()
+
     def _load_initial_data(self):
         """Loads history in background thread."""
         loaded_items = self.data_manager.load_history()
+
         GLib.idle_add(self._finish_initial_load, loaded_items)
 
+        self.data_manager._start_history_watcher(self._on_history_updated)
+
     def _finish_initial_load(self, loaded_items):
         """Updates UI after initial data load."""
         self.items = loaded_items
+
         self.update_filtered_items()
+
         if not self.items:
             self.status_label.set_text("No history items found. Press ? for help.")
         else:

clipse_gui/constants.py

@@ -31,6 +31,12 @@
 SAVE_DEBOUNCE_MS = 500
 SEARCH_DEBOUNCE_MS = 250
 
+COMPACT_MODE = True
+ENTER_TO_PASTE = True
+PASTE_TOOL_CMD = "wl-paste --no-newline"
+X11_PASTE_TOOL_CMD = "xclip -o -selection clipboard"
+
+
 # --- CSS Styling ---
 APP_CSS = """
 .pinned-row {

clipse_gui/data_manager.py

@@ -15,9 +15,10 @@
 class DataManager:
     """Handles loading and saving clipboard history data."""
 
-    def __init__(self, file_path):
+    def __init__(self, file_path, update_callback=None):
         self.file_path = file_path
         self._save_lock = threading.Lock()  # Lock for saving operation
+        self.update_callback = update_callback
 
     def load_history(self):
         """Loads history from the JSON file."""
@@ -83,3 +84,31 @@ def _save_thread_target(self, items_to_save, callback_on_error):
                 log.error(f"Error saving history to {self.file_path}: {e}")
                 if callback_on_error:
                     GLib.idle_add(callback_on_error, f"Error saving: {e}")
+
+    def _start_history_watcher(self, callback, interval_ms=300):
+        """Starts a periodic file watcher to sync clipboard history."""
+        self._last_file_content = None
+
+        def check_for_changes():
+            try:
+                if not os.path.exists(self.file_path):
+                    return True
+
+                with open(self.file_path, "r", encoding="utf-8") as f:
+                    current_content = f.read()
+
+                if self._last_file_content is None:
+                    self._last_file_content = current_content
+                    return True
+
+                if current_content != self._last_file_content:
+                    self._last_file_content = current_content
+                    log.info("History file updated. Reloading...")
+                    loaded_items = self.load_history()
+                    GLib.idle_add(callback, loaded_items)
+            except Exception as e:
+                log.error(f"Error while watching history file: {e}")
+
+            return True
+
+        GLib.timeout_add(interval_ms, check_for_changes)