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.3, October 23, 2018, see changes here)
- Unzip the downloaded file.
- Open Aerial.saver and confirm installation.
If Aerial.saver could not be opened, place Aerial.saver in ~/Library/Screen Savers
Important: Please note that if you are upgrading from a previous version, we strongly recommend 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
To upgrade Aerial, run brew cask upgrade
in Terminal.
- 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 screensaver in System Preferences and select
Delete "Aerial"
. - Or delete the file(s) directly. macOS can store screen savers in two locations.
/Library/Screen Savers
and/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 Cask, then the following command in a Terminal window should remove the Brew Cask 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. The last thing, you may want to delete the preferences plist
. The file is /Users/YOURUSERNAME/Library/Preferences/ByHost/com.JohnCoates.Aerial.{UUID}.plist
. It's highly recommended to remove that file if you purge the Cache folder.
- Every Aerial video: From the very first Aerials in San Francisco to the new space videos shot from the ISS! Now with better titles too so you can find your favorite videos faster.
- 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 Macs), 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. New in 1.4.1, we even have extra descriptions on the "original" videos (London, New York, San Francisco...)
- 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.
- Clock: We even have a properly styled clock if that's your thing!
- 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 resources, keep the tar and extracted files) - Download and rename
https://sylvan.apple.com/Aerials/2x/entries.json
totvos11.json
(tvOS11 resources, also in 4K) - Download and rename
http://a1.phobos.apple.com/us/r1000/000/Features/atv/AutumnResources/videos/entries.json
totvos10.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 AVFoundation framework to play the videos as your screensaver. When available, AVFoundation will use hardware decoding (from your CPU or your graphics card) to minimize the resources 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 options (Intel QuickSync and AMD UVD), QuickSync will always be preferred (Even if you "force" the discrete GPU use with an external monitor).
These are our recommendations 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 recommended 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
.
- Not seeing extended descriptions: Make sure you have version 1.4.2 or above.
- 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.app
andSystem Preferences.app
are 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 preferred 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.ImageConversionService
responsible for this CPU load. This is the iCloud Photos process, you can find more about what it does here and how to pause it. - Can't use Aerial as a login screensaver : As far as we know, using 3rd party screensavers before login is no longer possible on modern versions of macOS. More about this here.