The Apple TV screensaver for your mac, now with optional wallpaper continuity. With optional overlays, time-of-day adaptation, and live camera feeds support. Now distributed as an App + App Extension.
For more details, check the website: aerialscreensaver.github.io
Starting with version 4, Aerial is now distributed as an App Extension, bundled inside the Aerial.app. This is using the same private API that Apple introduced in macOS 10.15 (yes, Catalina !) but still has not made public. The App Extension API allows to provide full compatibility with Sonoma and Tahoe, sidestepping the longstanding issues with the old outdated .saver API and it's terrible legacyScreenSaver.appex "compatibility layer".
If you want to make your own macOS App Extension screensaver, instead of messing with Aerial code (which has so much backward compatibility/legacy things), I vastly recommend you start with AppexSaverMinimal as a much easier to understand starting point ! It's a minimal working sample, with a clear documentation of what works, what changes from the old API, and what you should adapt if you already have a .saver project.
- macOS 15 (Sequoia) or later.
- Xcode 16 or later to build from source.
For earlier macOS Versions, check the old saver repository.
-
If you only want the
.saver, version 3.6.3 is the latest available. -
If you want to use the old desktop mode from Companion, version 1.5.3beta1 is the latest : you will need to disable the update checks as you will be prompted to upgrade to version 4 ! It will automatically download version 3.6.3 at first launch.
git clone https://github.com/AerialScreensaver/Aerial.git
cd Aerial
open Aerial.xcodeprojIn Xcode, pick the Aerial scheme and build (⌘B) or run (⌘R).
Note that ScreenSaver/Source/Models/API/APISecrets.swift ships with a blank OpenWeather key in the public source. The weather overlay won't display data unless you put your own key. Everything else in the app works without it.
Weather overlays are provided thanks to Openweather who has offerred free support for Aerial for many years now ! Many thanks to them !
Aerial relies on a few great open source projects, you should check them out :
- Sparkle for auto-updates
- KeyboardShortcuts by Sindre Sorhus for global shortcuts handling
- Github releases to discord by Seth Cohen for release notes in the community Discord
- Swift Argument parser by Apple (not used directly by Aerial, but PaperSaver does use it)
Many thanks to those maintainers and their contributors !
Contributions welcome, but please open an issue first for substantial changes so we can discuss the approach before you put time into it.
MIT — see LICENSE.
