One more try before sleep.

QUICKSTART

@@ -1 +0,0 @@
-See http://wiki.gnome.org/Projects/Cthulhu

README.md

@@ -1,5 +1,10 @@
 # Cthulhu 
 
+## Note
+
+If you somehow stumbled across this while looking for a desktop screen reader for Linux, you most likely want [Orca](https://orca.gnome.org/) instead. Cthulhu is currently a supplemental screen reader that fills a nitch for some advanced users. E.g. some older QT based programs may work with Cthulhu, and if you use certain window managers like i3, Mozilla applications like Firefox and Thunderbird may work better.
+
+
 ## Introduction
 
 Cthulhu is a free, open source, flexible, and extensible screen reader
@@ -20,7 +25,7 @@ Cthulhu has the following dependencies:
 
 * Python 3         - Python platform
 * pygobject-3.0    - Python bindings for the GObject library
-* libpeas          - GObject based Plugin engine
+* pluggy          - Plugin and hook calling mechanisms for python
 * gtk+-3.0         - GTK+ toolkit
 * json-py          - a JSON (<https://json.org/>) reader and writer in Python
 * python-speechd   - Python bindings for Speech Dispatcher (optional)
@@ -30,7 +35,6 @@ Cthulhu has the following dependencies:
 * py-setproctitle  - Python library to set the process title (optional)
 * gstreamer-1.0    - GStreamer - Streaming media framework (optional)
 * socat            - Used for self-voicing functionality.
-* libpeas          - For the plugin system.
 
 You are strongly encouraged to also have the latest stable versions
 of AT-SPI2 and ATK.

src/cthulhu/cthulhu.py

@@ -47,11 +47,9 @@ class APIHelper:
         self.app = app
         self._gestureBindings = {}
         
-    def registerGestureByString(self, function, name, gestureString, 
+    def registerGestureByString(self, function, name, gestureString, inputEventType='default', normalizer='cthulhu', learnModeEnabled=True, contextName=None):
-                                inputEventType='default', normalizer='cthulhu',
-                                learnModeEnabled=True, contextName=None):
         """Register a gesture by string.
-        
+    
         Arguments:
         - function: the function to call when the gesture is performed
         - name: a human-readable name for this gesture
@@ -60,23 +58,23 @@ class APIHelper:
         - normalizer: the normalizer to use
         - learnModeEnabled: whether this should be available in learn mode
         - contextName: the context for this gesture (e.g., plugin name)
-        
+    
         Returns the binding ID or None if registration failed
         """
         if not gestureString.startswith("kb:"):
             return None
-            
+        
         # Extract the key portion from the gesture string
         key = gestureString.split(":", 1)[1]
-        
+    
         # Handle Cthulhu modifier specially
         if "cthulhu+" in key.lower():
             from . import keybindings
             key_parts = key.lower().split("+")
-            
+        
             # Determine appropriate modifier mask
             modifiers = keybindings.CTHULHU_MODIFIER_MASK
-            
+        
             # Extract the final key (without modifiers)
             final_key = key_parts[-1]
             
@@ -87,18 +85,23 @@ class APIHelper:
                 modifiers = keybindings.CTHULHU_CTRL_MODIFIER_MASK
             elif "alt" in key_parts:
                 modifiers = keybindings.CTHULHU_ALT_MODIFIER_MASK
-                
+            
             # Create a keybinding handler
             class GestureHandler:
                 def __init__(self, function, description):
                     self.function = function
                     self.description = description
-                
+            
                 def __call__(self, script, inputEvent):
-                    return self.function(script, inputEvent)
+                    try:
-            
+                        return function(script, inputEvent)
+                    except Exception as e:
+                        import logging
+                        logging.getLogger(__name__).error(f"Error in keybinding handler: {e}")
+                        return True
+        
             handler = GestureHandler(function, name)
-            
+        
             # Register the binding with the active script
             from . import cthulhu_state
             if cthulhu_state.activeScript:
@@ -108,20 +111,29 @@ class APIHelper:
                     keybindings.defaultModifierMask,
                     modifiers,
                     handler)
-                bindings.add(binding)
                 
+                # Add the binding to the active script
+                bindings.add(binding)
+            
                 # Store binding for later reference
                 if contextName not in self._gestureBindings:
                     self._gestureBindings[contextName] = []
                 self._gestureBindings[contextName].append(binding)
-                
+            
+                # Register key grab at the system level
+                grab_ids = cthulhu.addKeyGrab(binding)
+            
+                # For later removal
+                if grab_ids:
+                    binding._grab_ids = grab_ids
+            
                 return binding
-        
+    
         return None
         
     def unregisterShortcut(self, binding, contextName=None):
         """Unregister a previously registered shortcut.
-        
+    
         Arguments:
         - binding: the binding to unregister
         - contextName: the context for this gesture
@@ -131,11 +143,18 @@ class APIHelper:
         if cthulhu_state.activeScript:
             bindings = cthulhu_state.activeScript.getKeyBindings()
             bindings.remove(binding)
+        
+        # Remove key grab at system level
+        if hasattr(binding, '_grab_ids'):
+            for grab_id in binding._grab_ids:
+                self.app.removeKeyGrab(grab_id)
             
-        # Remove from our tracking
+        # Remove from tracking
         if contextName in self._gestureBindings:
             if binding in self._gestureBindings[contextName]:
                 self._gestureBindings[contextName].remove(binding)
+
+
 import gi
 import importlib
 import os

src/cthulhu/cthulhuVersion.py

@@ -23,5 +23,5 @@
 # Fork of Orca Screen Reader (GNOME)
 # Original source: https://gitlab.gnome.org/GNOME/orca
 
-version = "2025.04.04"
+version = "2025.04.14"
 codeName = "testing"

src/cthulhu/plugins/self_voice/plugin.py

@@ -1,9 +1,6 @@
 #!/usr/bin/env python3
 #
 # Copyright (c) 2024 Stormux
-# Copyright (c) 2010-2012 The Orca Team
-# Copyright (c) 2012 Igalia, S.L.
-# Copyright (c) 2005-2010 Sun Microsystems Inc.
 #
 # This library is free software; you can redistribute it and/or
 # modify it under the terms of the GNU Lesser General Public
@@ -20,8 +17,6 @@
 # Free Software Foundation, Inc., Franklin Street, Fifth Floor,
 # Boston MA  02110-1301 USA.
 #
-# Fork of Orca Screen Reader (GNOME)
-# Original source: https://gitlab.gnome.org/GNOME/orca
 
 """Self Voice plugin for Cthulhu screen reader."""