screenoverlay 0.4.1__tar.gz → 0.5.0__tar.gz

{screenoverlay-0.4.1 → screenoverlay-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: screenoverlay
-Version: 0.4.1
+Version: 0.5.0
 Summary: Cross-platform screen overlay with blur, black, white, and custom modes
 Home-page: https://github.com/pekay-ai/screenoverlay
 Author: Pekay
@@ -107,6 +107,10 @@ Overlay(mode='white').activate(duration=1)
 
 # Custom colored overlay
 Overlay(mode='custom', color_tint=(255, 100, 100), opacity=0.7).activate()
+
+# Multi-monitor control
+Overlay(mode='blur', all_screens=True).activate(duration=5)   # Blur all monitors (default)
+Overlay(mode='blur', all_screens=False).activate(duration=5)  # Blur only primary monitor
 ```
 
 Press `ESC` to dismiss the overlay early.
@@ -222,7 +226,8 @@ Overlay(
     mode='blur',              # 'blur', 'black', 'white', 'custom'
     blur_strength=3,          # 1-5 (only for mode='blur')
     opacity=0.85,             # 0.0-1.0
-    color_tint=(136, 136, 136)  # RGB tuple (0-255)
+    color_tint=(136, 136, 136),  # RGB tuple (0-255)
+    all_screens=True          # True = all monitors, False = primary only
 )
 ```
 
@@ -234,6 +239,7 @@ Overlay(
 | `blur_strength` | int | `3` | Blur intensity 1-5 (only for blur mode) |
 | `opacity` | float | `0.85` | Window opacity 0.0 (transparent) to 1.0 (opaque) |
 | `color_tint` | tuple | `(136, 136, 136)` | RGB color values (0-255) |
+| `all_screens` | bool | `True` | If `True`, blur all monitors. If `False`, blur only primary monitor |
 
 ### `activate()` Method
 

{screenoverlay-0.4.1 → screenoverlay-0.5.0}/README.md

@@ -63,6 +63,10 @@ Overlay(mode='white').activate(duration=1)
 
 # Custom colored overlay
 Overlay(mode='custom', color_tint=(255, 100, 100), opacity=0.7).activate()
+
+# Multi-monitor control
+Overlay(mode='blur', all_screens=True).activate(duration=5)   # Blur all monitors (default)
+Overlay(mode='blur', all_screens=False).activate(duration=5)  # Blur only primary monitor
 ```
 
 Press `ESC` to dismiss the overlay early.
@@ -178,7 +182,8 @@ Overlay(
     mode='blur',              # 'blur', 'black', 'white', 'custom'
     blur_strength=3,          # 1-5 (only for mode='blur')
     opacity=0.85,             # 0.0-1.0
-    color_tint=(136, 136, 136)  # RGB tuple (0-255)
+    color_tint=(136, 136, 136),  # RGB tuple (0-255)
+    all_screens=True          # True = all monitors, False = primary only
 )
 ```
 
@@ -190,6 +195,7 @@ Overlay(
 | `blur_strength` | int | `3` | Blur intensity 1-5 (only for blur mode) |
 | `opacity` | float | `0.85` | Window opacity 0.0 (transparent) to 1.0 (opaque) |
 | `color_tint` | tuple | `(136, 136, 136)` | RGB color values (0-255) |
+| `all_screens` | bool | `True` | If `True`, blur all monitors. If `False`, blur only primary monitor |
 
 ### `activate()` Method
 

{screenoverlay-0.4.1 → screenoverlay-0.5.0}/screenoverlay/__init__.py

@@ -5,7 +5,7 @@ Provides blur, black, white, and custom color overlays with minimal latency
 
 from .overlay import NativeBlurOverlay as Overlay
 
-__version__ = '0.4.0'
+__version__ = '0.5.0'
 __author__ = 'Pekay'
 __all__ = ['Overlay']
 

{screenoverlay-0.4.1 → screenoverlay-0.5.0}/screenoverlay/overlay.py

@@ -131,9 +131,27 @@ class NativeBlurOverlay:
             self._command_queue.put('show')
     
     def hide(self):
-        """Hide the overlay (instant, ~1ms)"""
+        """
+        Hide the overlay and restart for next use (100% reliable, prevents ghost windows)
+        
+        This method:
+        1. Hides the overlay instantly (user sees clear screen ~1ms)
+        2. Stops the overlay process completely (kills any ghost windows)
+        3. Starts a fresh overlay ready for next show() (happens in background ~300ms)
+        
+        This "restart on hide" approach guarantees zero ghost windows by giving
+        each detection cycle a fresh overlay process, at the cost of ~300ms 
+        startup time that happens during safe periods (when screen is clear).
+        """
         if self._command_queue is not None:
+            # Hide first (instant for user)
             self._command_queue.put('hide')
+            
+            # Stop the process completely to prevent ghost windows
+            self.stop()
+            
+            # Start fresh overlay for next show() (happens in background)
+            self.start()
     
     def stop(self):
         """Stop and cleanup the overlay completely"""
@@ -165,16 +183,22 @@ class NativeBlurOverlay:
                         cmd = command_queue.get_nowait()
                         if cmd == 'show':
                             for win in self.windows:
-                                win.deiconify()
-                                win.lift()
+                                try:
+                                    win.deiconify()
+                                    win.lift()
+                                except Exception as e:
+                                    print(f"Warning: Failed to show window: {e}")
                         elif cmd == 'hide':
                             for win in self.windows:
-                                win.withdraw()
+                                try:
+                                    win.withdraw()
+                                except Exception as e:
+                                    print(f"Warning: Failed to hide window: {e}")
                         elif cmd == 'stop':
                             self.root.quit()
                             return
-                except:
-                    pass
+                except Exception as e:
+                    print(f"Warning: Command queue error: {e}")
                 
                 # Check again in 10ms
                 self.root.after(10, check_commands)

{screenoverlay-0.4.1 → screenoverlay-0.5.0}/screenoverlay.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: screenoverlay
-Version: 0.4.1
+Version: 0.5.0
 Summary: Cross-platform screen overlay with blur, black, white, and custom modes
 Home-page: https://github.com/pekay-ai/screenoverlay
 Author: Pekay
@@ -107,6 +107,10 @@ Overlay(mode='white').activate(duration=1)
 
 # Custom colored overlay
 Overlay(mode='custom', color_tint=(255, 100, 100), opacity=0.7).activate()
+
+# Multi-monitor control
+Overlay(mode='blur', all_screens=True).activate(duration=5)   # Blur all monitors (default)
+Overlay(mode='blur', all_screens=False).activate(duration=5)  # Blur only primary monitor
 ```
 
 Press `ESC` to dismiss the overlay early.
@@ -222,7 +226,8 @@ Overlay(
     mode='blur',              # 'blur', 'black', 'white', 'custom'
     blur_strength=3,          # 1-5 (only for mode='blur')
     opacity=0.85,             # 0.0-1.0
-    color_tint=(136, 136, 136)  # RGB tuple (0-255)
+    color_tint=(136, 136, 136),  # RGB tuple (0-255)
+    all_screens=True          # True = all monitors, False = primary only
 )
 ```
 
@@ -234,6 +239,7 @@ Overlay(
 | `blur_strength` | int | `3` | Blur intensity 1-5 (only for blur mode) |
 | `opacity` | float | `0.85` | Window opacity 0.0 (transparent) to 1.0 (opaque) |
 | `color_tint` | tuple | `(136, 136, 136)` | RGB color values (0-255) |
+| `all_screens` | bool | `True` | If `True`, blur all monitors. If `False`, blur only primary monitor |
 
 ### `activate()` Method
 

{screenoverlay-0.4.1 → screenoverlay-0.5.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="screenoverlay",
-    version="0.4.1",
+    version="0.5.0",
     author="Pekay",
     author_email="ppnicky@gmail.com",
     description="Cross-platform screen overlay with blur, black, white, and custom modes",