Aerial is a Mac screen saver based on the new Apple TV screen saver that displays the aerial movies Apple shot over New York, San Francisco, Hawaii, China, etc. Starting with version 1.4, this also includes the new ISS videos available in tvOS 12!
Aerial is completely open source, so feel free to contribute to its development.
Windows user? Try cDima/Aerial
Linux user? Try graysky2/xscreensaver-aerial
Version 1.4 is also maintained by :
You can see a list of contributors here.
Rather install from terminal or have auto-updates? Look at the Brew Cask section below!
- Click here to Download (Version 1.4)
- Unzip the downloaded file.
- Open Aerial.saver and confirm installation.
If Aerial.saver could not be opened, place Aerial.saver in ~/Library/Screen Savers
Please note that if you are upgrading from a previous version, we strongly recommand you close System Preferences after the installation and reopen it, as Swift screensavers aren't loaded correctly otherwise when updated.
If you're looking to install Aerial across many systems, remotely, or simply from terminal we recommend Brew Cask. Prefer this method if you're looking for auto-updates.
Simply issue the following terminal command: brew cask install aerial
- Open
System Preferences->Desktop & Screen Saver->Screen Saver - Choose Aerial and click on Screen Saver Options to select your settings.
There are three options to uninstall Aerial from your Mac.
- Right-click on the Aerial screen saver in System Preferences and select
Delete "Aerial". - Or delete the file(s) directly. macOS can store screen savers in two locations.
/Library/Screen Saversand/Users/YOURUSERNAME/Library/Screen Savers. Check both locations for a file called "Aerial.saver" and delete any copies you find. - If you installed Aerial using brew, then the following command in a Terminal window should remove the brew installed version.
brew cask uninstall aerial
You may also want to delete the folder /Users/YOURUSERNAME/Library/Caches/Aerial. This is where Aerial stores the cached copies of the aerial videos.
- Every Aerial video: From the very first Aerials in San Francisco to the new space videos shot from the ISS!
- 4K HEVC: With the launch of Apple TV 4K, many videos are now available in this format. Aerial will show you the best format available based on your preferences.
- Different videos based on time: Want to see night videos at night? You can either specify your sunset or sunrise time manually, or, if your Mac is compatible with Night Shift (see here for a list of compatible Mac), get those automatically (you do not need to enable Night Shift).
- Feeling Dark?: Aerial is now compatible with Dark Mode in macOS 10.14 Mojave, and can play night videos when Dark Mode is enabled.
- Descriptions: Wondering where an Aerial view was shot? Aerial can now tell you as they play.
- Full offline mode:: Behind a firewall? Just copy the cache folder from another Mac and you are all set. You can also disable all streaming.
- Better cache management: You can now cache your favorite videos individually, no need to grab them all. Or just stream them as you go, they'll get cached automatically too.
- And many bug fixes!
Aerial is written in Swift, which requires OS X Mavericks (10.9) or above.
- Found a bug? Open an issue. Try to be as specific as possible.
- Have a feature request? Open an issue. Tell us why this feature would be useful, and why you and others would want it.
We appreciate all pull requests.
If you want to use Aerial on a Mac behind a firewall or with no network access, the easiest way starting with version 1.4 is to copy the content of the cache folder from another Mac where Aerial is already installed.
If that's not an option, you can manually recreate a cache folder by downloading files manually.
- Download and untar
https://sylvan.apple.com/Aerials/resources.tar(tvOS12 ressources, keep the tar and extracted files) - Download and rename
https://sylvan.apple.com/Aerials/2x/entries.jsontotvos11.json(tvOS11 ressources, also in 4K) - Download and rename
http://a1.phobos.apple.com/us/r1000/000/Features/atv/AutumnResources/videos/entries.jsontotvos10.json(the original Aerials, in 1080p H.264 only)
You can then download the videos you want from the JSON files. In the 4K JSONs, you are looking for the url-1080-H264 (1080p H.264, most compatible format), url-1080-SDR (1080p HEVC, better quality, requires a recent Mac for hardware decoding) or url-4K-SDR (4K HEVC).
Aerial uses Apple's AV Framework to play the videos as your screensaver. When available, AV Framework will use hardware decoding (from your CPU or your graphic card) to minimize the ressources needed for video playback. You can find guidelines in the help button next to the Preferred video format setting. By default, Aerial uses 1080p H.264 videos which is the most compatible format. Please note that all HEVC videos are encoded with the Main10 profile, which may not be hardware accelerated by your machine, while some other HEVC videos (encoded in Main profile) will be.
While we wish to provide everyone with the best setting for their machine, the GVA framework from Apple doesn't let us distinguish HEVC Main10 profile acceleration from general HEVC acceleration. Early feedback we gathered also seems to point that on machines with multiple decoding option (Intel QuickSync and AMD UVD), QuickSync will always be prefered (even if you "force" the discrete GPU use with an external monitor).
These are our recommandations so far:
- Macs older than 2011 may lack H.264 acceleration.
- Macs with an Intel CPU (with iGPU) from the Sandy Bridge (2011) generation to Broadwell (early 2015) should have H.264 hardware acceleration available.
- Late 2015 and 2016 Macs (Skylake and Kaby Lake) may only have partially accelerated HEVC decoding. We recommand you stick to 1080p H.264 on laptops. You may consider the HEVC format on desktops but understand that decoding may be CPU intensive and spin up your fans.
- Macs 2017 and up should have full HEVC acceleration.
You can easily check for yourself what to expect by opening a video in Quicktime (use the Show in Finder option in the Cache tab to find the cached videos). In activity monitor, the AV Framework GVA process is called VTDecoderXPCService.
- Black screen: If you are behind a firewall (like Little Snitch or Hands Off!) try creating exceptions for Aerial to allow it access to Apple's servers. Be sure the applications
ScreenSaverEngine.appandSystem Preferences.appare not being blocked access to *.phobos.apple.com, *.phobos.apple.com.edgesuite.net and sylvan.apple.com. If that isn't an option, please look at the Offline mode section. - "You cannot use the Aerial screen saver with this version of macOS." error: Select Aerial, close System Preferences with Aerial still selected, re-open System Preferences and Aerial should now work. This is a known bug with Swift screensavers in macOS/OS X reported to Apple as rdar://25569037.
- High CPU usage/fan spinning all of a sudden: If you correctly configured the Prefered video format according to your Mac and still experience high CPU usage/fan spinning all of a sudden, please look for the cause with
Activity Monitor, you may see acom.apple.photos.ImageConversionServiceresponsible for this CPU load. This is thes iCloud Photos process, you can find more about what it does here and how to pause it.