summaryrefslogtreecommitdiff
path: root/aerial_screensaver.py
diff options
context:
space:
mode:
authorChristopher Warner <cwarner@kernelcode.com>2026-10-14 14:18:02 -0400
committerChristopher Warner <cwarner@kernelcode.com>2026-10-14 14:18:02 -0400
commit590f0f62c881935502d2fe5b85ed26979a518be6 (patch)
tree8d594f2aa414f9df338c98bfbcea436fc41ead2a /aerial_screensaver.py
parent01c81994fa51ba8946e58ac4bf0b739ed816f7d3 (diff)
downloadaerial-screensaver-linux-590f0f62c881935502d2fe5b85ed26979a518be6.tar.gz
aerial-screensaver-linux-590f0f62c881935502d2fe5b85ed26979a518be6.tar.bz2
aerial-screensaver-linux-590f0f62c881935502d2fe5b85ed26979a518be6.tar.xz
aerial-screensaver-linux-590f0f62c881935502d2fe5b85ed26979a518be6.zip
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 <cursoragent@cursor.com>
Diffstat (limited to 'aerial_screensaver.py')
-rwxr-xr-xaerial_screensaver.py81
1 files changed, 68 insertions, 13 deletions
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(