#!/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."