From 6f3426c481f03f5beeed9171b3280f0070798844 Mon Sep 17 00:00:00 2001 From: Christopher Warner Date: Tue, 13 Oct 2026 15:07:53 -0400 Subject: feat: package portable Aerial screensaver for sharing Add install/uninstall scripts, XDG config, portable VAAPI detection, fetch-aerial-recent helper, and a LocalSend-ready zip without Apple video assets. Co-authored-by: Cursor --- bin/fetch-aerial-recent | 112 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100755 bin/fetch-aerial-recent (limited to 'bin/fetch-aerial-recent') diff --git a/bin/fetch-aerial-recent b/bin/fetch-aerial-recent new file mode 100755 index 0000000..852bee8 --- /dev/null +++ b/bin/fetch-aerial-recent @@ -0,0 +1,112 @@ +#!/usr/bin/env bash +# Download the recent macOS Aerial pack (Tahoe / Sequoia / Sonoma / Cazadero) +# from Apple's public catalog, then optionally encode to lite 1080p24. +# +# Usage: +# fetch-aerial-recent # download masters only +# fetch-aerial-recent --encode # download + encode-aerial-lite +set -euo pipefail + +ENCODE=0 +for arg in "$@"; do + case "$arg" in + --encode) ENCODE=1 ;; + -h|--help) + echo "Usage: fetch-aerial-recent [--encode]" + exit 0 + ;; + esac +done + +MASTER_DIR="${AERIAL_MASTER_DIR:-$HOME/Videos/Screensavers/Aerial-masters}" +LITE_DIR="${DST_DIR:-$HOME/Videos/Screensavers/Aerial}" +CATALOG_DIR="${TMPDIR:-/tmp}/aerial-catalog-$$" +CONFIG_URL="https://configuration.apple.com/configurations/internetservices/aerials/resources-config-26-0.plist" +WANT_LABELS=( + "Tahoe Day" "Tahoe Morning" "Tahoe Evening" "Tahoe Night" + "Sequoia Sunrise" "Sequoia Morning" "Sequoia Night" + "Cazadero" + "Sonoma Evening" "Sonoma Clouds" "Sonoma from Above" "Sonoma River" +) + +need() { command -v "$1" >/dev/null 2>&1 || { echo "Missing dependency: $1" >&2; exit 1; }; } +need curl +need python3 +need aria2c +need tar + +mkdir -p "$MASTER_DIR" "$CATALOG_DIR" +trap 'rm -rf "$CATALOG_DIR"' EXIT + +echo "Resolving macOS Aerial catalog..." +RESOURCES_URL="$(curl -fsSL --max-time 30 "$CONFIG_URL" | python3 -c ' +import sys,re +text=sys.stdin.read() +m=re.search(r"resources-url\s*([^<]+)", text) +if not m: raise SystemExit("resources-url not found in plist") +print(m.group(1)) +')" + +echo "Catalog: $RESOURCES_URL" +curl -kfsSL --max-time 120 -o "$CATALOG_DIR/resources.tar" "$RESOURCES_URL" +tar -xf "$CATALOG_DIR/resources.tar" -C "$CATALOG_DIR" 2>/dev/null || true +ENTRIES_JSON="$(find "$CATALOG_DIR" -name entries.json -type f | head -n1)" +if [[ -z "$ENTRIES_JSON" ]]; then + echo "entries.json not found in catalog tar" >&2 + exit 1 +fi + +python3 - "$ENTRIES_JSON" "$CATALOG_DIR/urls.txt" <<'PY' +import json, os, sys +entries_path, urls_path = sys.argv[1], sys.argv[2] +want = { + "Tahoe Day", "Tahoe Morning", "Tahoe Evening", "Tahoe Night", + "Sequoia Sunrise", "Sequoia Morning", "Sequoia Night", + "Cazadero", + "Sonoma Evening", "Sonoma Clouds", "Sonoma from Above", "Sonoma River", +} +data = json.load(open(entries_path, encoding="utf-8")) +found = [] +with open(urls_path, "w", encoding="utf-8") as out: + for asset in data.get("assets", []): + label = asset.get("accessibilityLabel") or "" + if label not in want: + continue + url = asset.get("url-4K-SDR-240FPS") or asset.get("url-4K-SDR") + if not url: + continue + base = os.path.basename(url.split("?", 1)[0]) + out.write(f"{url}\n out={base}\n") + found.append((label, base)) +if len(found) != len(want): + missing = want - {l for l, _ in found} + print(f"warning: missing labels: {sorted(missing)}", file=sys.stderr) +print(f"Queued {len(found)} clips:") +for label, base in sorted(found): + print(f" {label}: {base}") +PY + +echo +echo "Downloading into $MASTER_DIR ..." +aria2c --check-certificate=false -c -x 4 -s 4 -j 3 \ + -i "$CATALOG_DIR/urls.txt" \ + -d "$MASTER_DIR" \ + --auto-file-renaming=false + +echo +echo "Masters ready: $(du -sh "$MASTER_DIR" | cut -f1)" + +if [[ "$ENCODE" -eq 1 ]]; then + SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" + ENCODER="$SCRIPT_DIR/encode-aerial-lite" + if [[ ! -x "$ENCODER" ]]; then + ENCODER="$(command -v encode-aerial-lite || true)" + fi + if [[ -z "$ENCODER" ]]; then + echo "encode-aerial-lite not found; masters left in $MASTER_DIR" >&2 + exit 1 + fi + DST_DIR="$LITE_DIR" "$ENCODER" "$MASTER_DIR" +fi + +echo "Done." -- cgit v1.2.3