glouel/ AerialCompanion
About the developer
141 Stars 
4 Forks 
81 Commits 
5 Opened issues 
Description
A companion app for the Aerial screen saver for macOS that takes care of install and auto-updates.
Services available
Aerial Companion
The official companion app for the Aerial screen saver for macOS. It takes care of install, automatic updates and more.
This utility will install the Aerial screensaver and keep you up to date!
Previously called AerialUpdater
Installation
- Download the latest release
- Unzip and copy
AerialUpdater.app
to/Applications
-
Once copied, double click to launch
Aerial.app
in your Applications Folder Aerial will be installed if this is your first time, or prompt you to update to the latest version!
Uninstall
- To uninstall the Aerial Companion App simply delete
Aerial.app
from your Applications folder. - To uninstall the Aerial screen saver, please follow the directions here
I thought Aerial had auto-updates with Sparkle?
Aerial used to automatically update (since version 1.5.0) using the Sparkle framework.
With the introduction of macOS 10.15 (Catalina), things changed for screen savers and Aerial was no longer able to update itself because of the new security restrictions introduced with sandboxing. A temporary workaround was put in place in version 1.8.0 where you could get notified of a new version but not automatically install.
While this worked most of the time, for some users, the update check caused the
ScreenSaverEngineto lose the keyboard/mouse focus, and pressing a key would no longer let you exit the screen saver (pressing
cmd-alt-shift-esccould be used as a workaround). This issue seem to trigger a lot more often in macOS 11 (Big Sur). Due to this, Sparkle was removed from Aerial starting in version 2.0.0 and native support was added using Aerial Companion.
How does it work?
During your first launch you will be able to set up Aerial Companion to keep you up to date the way that you want. Choose whether it checks for an update hourly, daily, weekly, or only when you want to update manually. Run the companion app in the foreground from your menubar, or in the background without any effort from you. Stay up to date with either stable releases or beta updates.
I meant, how does it work technically?
In this repository, I store a manifest file that contains the version number of the latest release, and also the sha256 of the releases. This is generated after Aerial gets notarized for distribution and before I upload a new version on Aerial's releases page.
Periodically, Aerial Companion checks the manifest to see if a new version was released. When you decide to perform an update, the following happens - Aerial Companion uses the version number from the manifest to infer the download link from Aerial's repository (the download links are always of the same format, so version
1.9.2will be available at
https://github.com/JohnCoates/Aerial/releases/download/v1.9.2/Aerial.saver.zip) - The zip file is downloaded to
~/Library/Application Support/AerialUpdater/- The sha256 of the file is computed, and compared to the one from the manifest - The zip is unzipped in place, looking for
Aerial.saver-
Aerial.saveris verified (using macOS codesigning) to be using the correct Bundle ID (com.JohnCoates.Aerial) -
Aerial.saveris verified (using macOS codesigning) to be signed/notarized with my Developer Apple ID.
If and only if everything checks out, then
Aerial.savergets copied to
~/Library/Screen Savers/.
Do I have to use this? Is there an alternative?
You don't, and sure!
- As pointed out in Aerial's installation instructions, you can also use
homebrew
to install and/or update Aerial automatically. - You will always be able to manually download and install Aerial from its Github repository.
I don't want yet ANOTHER icon on my status bar!
Do not fear! After installing Aerial Companion you can do the following:
If you want to update in the background and hide the status icon: 1. Change your
Check Everysettings to Hourly, Daily, or Weekly 2. Set your
Update Modeto
Automatic3. Open the menu one last time and select
Launch > In the background (no menu)4. This will then quit Aerial Companion and you are all set!
If you want to update manually 1. Simply quit Aerial Companion by clicking
Quitat the bottom of the menu 2. When you want to check for an update, launch
Aerial.appfrom your
/Applicationsfolder and click
Check Nowfrom the menubar icon. 3. Once installed, quit Aerial Companion again by clicking
Quitat the bottom of the menu
Known Issues
- This tool only installs/updates Aerial if you install it for your user only, and not for all users. Installing a screen saver for all users requires an administrator password at install, and at each subsequent update, defeating the purpose of an auto-updater. It's recommended to check if you have an
Aerial.saver
file in/Library/Screen Savers/
. If you do, please remove it as you'll get two versions of Aerial alongside each other.
- When updating a screen saver, you must first close System Preferences. If you don't, you will need to quit and restart System Preferences after installing to reload the new version as the old one will remain in memory.
Why should I trust you? Who are you?
I'm Guillaume Louel, the developer of Aerial since version 1.4.
I have more questions!
Great! We love questions! Please feel free to send us bug reports, feature requests, and ask questions through any of the following methods:
- Report bugs or post feature requests on GitHub
- Join our Community Discord server for technical support, feature requests, and a fun time!