# Aerial Screensaver for Linux (GNOME) Idle screensaver that plays Apple Aerial–style clips with **mpv**, on **every connected monitor**. Quiet defaults: AC-only, lid-aware, VAAPI decode, low CPU niceness. Works on AMD (Framework) and **Intel** laptops (e.g. **ThinkPad T480** / UHD 620). > Player + tooling are MIT. Apple’s video assets stay Apple’s — install them with the helpers or the optional LocalSend video pack. ## Requirements | Package | Why | |---|---| | GNOME (Wayland) | IdleMonitor + DisplayConfig | | `python3` + PyGObject | Daemon | | `mpv` | Playback | | `ffmpeg` | Optional encode | | `aria2c`, `curl`, `unzip` | Optional fetch / video zip | | `systemd --user` | Autostart | ### Fedora / CachyOS (ThinkPad T480) ```bash sudo dnf install mpv ffmpeg python3-gobject aria2 curl unzip \ intel-media-driver libva libva-utils ``` ### Debian / Ubuntu ```bash sudo apt install mpv ffmpeg python3-gi aria2 curl unzip \ intel-media-va-driver-non-free ``` Verify VAAPI: `vainfo` (should list Intel entrypoints). ## Install ```bash git clone https://git.kernelcode.com/aerial-screensaver-linux cd aerial-screensaver-linux ./install.sh # or: unzip aerial-screensaver-linux.zip && cd aerial-screensaver-linux && ./install.sh ``` ### Get the videos (pick one) **A. LocalSend video pack (best for T480)** — no multi-GB Apple download / long encode: ```bash ./install.sh --videos-zip ~/Downloads/aerial-videos-lite.zip # or later: install-aerial-videos --from-zip ~/Downloads/aerial-videos-lite.zip ``` **B. Download from Apple + encode on this machine** (slower on T480): ```bash ./install.sh --fetch-videos # or later: install-aerial-videos ``` **C. Your own files** — drop `.mp4` / `.mov` / `.mkv` in: ```text ~/Videos/Screensavers/Aerial ``` ## What gets installed | Path | Role | |---|---| | `~/.local/bin/aerial-screensaver` | Idle daemon | | `~/.local/bin/install-aerial-videos` | Install / fetch clips | | `~/.local/bin/fetch-aerial-recent` | Download Apple recent pack | | `~/.local/bin/encode-aerial-lite` | 1080p24 lite encoder | | `~/.config/systemd/user/aerial-screensaver.service` | Autostart | | `~/.config/aerial-screensaver/config` | Settings | | `~/Videos/Screensavers/Aerial` | Clip library | ## Config `~/.config/aerial-screensaver/config`: ```ini VIDEO_DIR=/home/YOU/Videos/Screensavers/Aerial IDLE_TIMEOUT_SECONDS=300 REQUIRE_AC=1 VAAPI_DEVICE=/dev/dri/renderD128 ``` On hybrid GPUs, leave `VAAPI_DEVICE` on the **iGPU** (Intel on T480, AMD display-class on Framework). `install.sh` auto-detects. **Clamshell / lid closed:** with `ALLOW_CLAMSHELL=1` (default), the screensaver still runs when the lid is closed **if an external display is active** (typical docked T480). In that mode it targets **only external monitors** (skips eDP), preferring the GNOME primary, using mpv `--fs-screen-name=` (Mutter screen indexes do not match mpv’s Wayland output order). Lid closed with no external display still skips/stops playback. ## Sharing (LocalSend) Send **two** files: | File | Size | Contents | |---|---|---| | `aerial-screensaver-linux.zip` | ~15KB | Code + installer | | `aerial-videos-lite.zip` | ~1GB | 12 ready-to-play 1080p clips | Recipient: ```bash unzip aerial-screensaver-linux.zip && cd aerial-screensaver-linux ./install.sh --videos-zip ~/Downloads/aerial-videos-lite.zip ``` ## Uninstall ```bash ./uninstall.sh ``` ## Tests ```bash python3 test_screensaver.py -v ``` ## License MIT for this software. Aerial footage remains Apple’s; we only provide download/install helpers and an optional private LocalSend pack of already-encoded lite clips.