From 590f0f62c881935502d2fe5b85ed26979a518be6 Mon Sep 17 00:00:00 2001 From: Christopher Warner Date: Wed, 14 Oct 2026 14:18:02 -0400 Subject: feat: allow screensaver in clamshell with external display When the lid is closed but a non-eDP monitor is active (docked T480), keep idle playback running instead of treating a closed lid as a hard stop. Co-authored-by: Cursor --- aerial_screensaver.py | 81 ++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 68 insertions(+), 13 deletions(-) (limited to 'aerial_screensaver.py') diff --git a/aerial_screensaver.py b/aerial_screensaver.py index 12727c9..7b64cac 100755 --- a/aerial_screensaver.py +++ b/aerial_screensaver.py @@ -21,6 +21,8 @@ LID_STATE_CANDIDATES = ( "/proc/acpi/button/lid/LID0/state", "/proc/acpi/button/lid/LID/state", ) +# Built-in panel connectors (clamshell = lid closed + non-builtin still active). +BUILTIN_CONNECTOR_PREFIXES = ("eDP", "LVDS", "DSI") IPC_SOCKET_PREFIX = "/tmp/mpv_aerial_" LOG_PATH = Path.home() / "aerial_debug.log" @@ -35,13 +37,23 @@ def _load_config() -> dict[str, str]: key, value = line.split("=", 1) cfg[key.strip()] = value.strip().strip('"').strip("'") # Environment overrides config - for key in ("VIDEO_DIR", "IDLE_TIMEOUT_SECONDS", "VAAPI_DEVICE", "REQUIRE_AC"): + for key in ( + "VIDEO_DIR", + "IDLE_TIMEOUT_SECONDS", + "VAAPI_DEVICE", + "REQUIRE_AC", + "ALLOW_CLAMSHELL", + ): env = os.environ.get(f"AERIAL_{key}") if env: cfg[key] = env return cfg +def _connector_is_builtin(connector: str) -> bool: + return connector.startswith(BUILTIN_CONNECTOR_PREFIXES) + + def _pci_attrs_for_render(render: Path) -> tuple[str, str]: """Return (pci_class, vendor) hex strings for a render node.""" try: @@ -107,6 +119,12 @@ class AerialScreensaver: self.video_dir = Path(cfg.get("VIDEO_DIR", str(DEFAULT_VIDEO_DIR))).expanduser() self.idle_timeout_seconds = int(cfg.get("IDLE_TIMEOUT_SECONDS", DEFAULT_IDLE_SECONDS)) self.require_ac = cfg.get("REQUIRE_AC", "1").lower() not in ("0", "false", "no") + # Lid closed + external display (docked / clamshell) is allowed by default. + self.allow_clamshell = cfg.get("ALLOW_CLAMSHELL", "1").lower() not in ( + "0", + "false", + "no", + ) self.vaapi_device = find_vaapi_device(cfg.get("VAAPI_DEVICE") or None) self.processes: list[subprocess.Popen] = [] self.idle_monitor = None @@ -118,8 +136,9 @@ class AerialScreensaver: logging.info( "Initializing Aerial Screensaver " - "(mpv lite, AC=%s, lid-aware, multi-screen, vaapi=%s)...", + "(mpv lite, AC=%s, clamshell=%s, multi-screen, vaapi=%s)...", self.require_ac, + self.allow_clamshell, self.vaapi_device or "auto", ) self._connect_idle_monitor() @@ -186,8 +205,8 @@ class AerialScreensaver: logging.error("Error checking lid status: %s", e) return True - def get_screen_count(self) -> int: - """Return active GNOME logical monitor count (fallback: 1).""" + def _display_state(self) -> tuple[int, bool]: + """Return (logical_monitor_count, has_external_display).""" try: proxy = Gio.DBusProxy.new_for_bus_sync( Gio.BusType.SESSION, @@ -206,10 +225,37 @@ class AerialScreensaver: None, ) _serial, _monitors, logical_monitors, _props = reply.unpack() - return max(1, len(logical_monitors)) + has_external = False + for lm in logical_monitors: + # (x, y, scale, transform, primary, monitors, properties) + for mon in lm[5]: + connector = mon[0] + if not _connector_is_builtin(connector): + has_external = True + break + if has_external: + break + return len(logical_monitors), has_external except Exception as e: - logging.error("Error detecting screens, defaulting to 1: %s", e) - return 1 + logging.error("Error detecting displays: %s", e) + return 0, False + + def get_screen_count(self) -> int: + """Return active GNOME logical monitor count (fallback: 1).""" + count, _external = self._display_state() + return max(1, count) if count > 0 else 1 + + def has_external_display(self) -> bool: + _count, external = self._display_state() + return external + + def display_ok(self) -> bool: + """Lid open, or clamshell (lid closed + external display) when allowed.""" + if self.is_lid_open(): + return True + if self.allow_clamshell and self.has_external_display(): + return True + return False def on_dbus_signal(self, proxy, sender_name, signal_name, parameters) -> None: if signal_name != "WatchFired": @@ -217,14 +263,21 @@ class AerialScreensaver: watch_id = parameters.unpack()[0] if watch_id != self.watch_id: return - if self.is_on_ac() and self.is_lid_open(): - logging.info("Idle threshold reached, on AC and lid is OPEN. Starting mpv.") + on_ac = self.is_on_ac() + display_ok = self.display_ok() + if on_ac and display_ok: + lid = "open" if self.is_lid_open() else "closed (clamshell/external)" + logging.info( + "Idle threshold reached, on AC, display ok (lid %s). Starting mpv.", + lid, + ) self.start_screensaver() else: logging.info( - "Idle threshold reached but skip (AC: %s, Lid Open: %s)", - self.is_on_ac(), + "Idle threshold reached but skip (AC: %s, Lid Open: %s, External: %s)", + on_ac, self.is_lid_open(), + self.has_external_display(), ) def _collect_videos(self) -> list[str]: @@ -327,8 +380,10 @@ class AerialScreensaver: while self._any_running(): time.sleep(1) try: - if not self.is_lid_open(): - logging.info("Lid closed during playback. Stopping mpv.") + if not self.display_ok(): + logging.info( + "No usable display (lid closed without external). Stopping mpv." + ) self.stop_screensaver() break reply = self.idle_monitor.call_sync( -- cgit v1.2.3