Add pipewire-capture debug logging support (#205)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: bquenin

pyproject.toml

@@ -39,7 +39,7 @@ dependencies = [
     # Linux only - window capture (X11 fallback)
     "python-xlib>=0.33; sys_platform == 'linux'",
     # Linux only - window capture (Wayland via PipeWire portal)
-    "pipewire-capture>=0.2.5; sys_platform == 'linux'",
+    "pipewire-capture>=0.2.6; sys_platform == 'linux'",
     # GPU acceleration (CUDA 12) - Windows and Linux
     "nvidia-cublas-cu12; sys_platform == 'win32' or sys_platform == 'linux'",
     "nvidia-cudnn-cu12; sys_platform == 'win32' or sys_platform == 'linux'",

src/interpreter/capture/linux_wayland.py

@@ -12,7 +12,7 @@
 import numpy as np
 from numpy.typing import NDArray
 from pipewire_capture import CaptureStream as PwCaptureStream
-from pipewire_capture import PortalCapture, is_available
+from pipewire_capture import PortalCapture, init_logging, is_available
 
 from .. import log
 
@@ -28,6 +28,16 @@ def is_wayland_available() -> bool:
     return is_available()
 
 
+def configure_logging(debug: bool) -> None:
+    """Configure pipewire-capture logging level.
+
+    Args:
+        debug: If True, enable debug logging in pipewire-capture.
+    """
+    if debug:
+        init_logging("debug")
+
+
 def get_window_list() -> list[dict]:
     """Return empty list - Wayland uses portal picker instead of window enumeration."""
     return []

src/interpreter/gui/app.py

@@ -136,6 +136,13 @@ def run():
 
     # Configure logging
     log.configure(level="DEBUG" if args.debug else "INFO")
+
+    # Configure pipewire-capture logging on Wayland (must be after log.configure)
+    if platform.system() == "Linux" and os.environ.get("WAYLAND_DISPLAY"):
+        from ..capture.linux_wayland import configure_logging as configure_wayland_logging
+
+        configure_wayland_logging(args.debug)
+
     logger = log.get_logger()
     logger.info(f"interpreter v{__version__}")