Skip to content

Commit

Permalink
Update Readme.md
Browse files Browse the repository at this point in the history
1.4.2
  • Loading branch information
glouel committed Oct 23, 2018
1 parent 35c61e0 commit c48e132
Showing 1 changed file with 5 additions and 8 deletions.
13 changes: 5 additions & 8 deletions Readme.md
Expand Up @@ -31,15 +31,15 @@ You can see a list of contributors [here](https://github.com/JohnCoates/Aerial/g
### Manual Installation
*Rather install from Terminal or have auto-updates? Look at the Brew Cask section below!*

1. [Click here to Download](https://github.com/JohnCoates/Aerial/releases/download/v1.4.1/Aerial.saver.zip) (Version 1.4.1, October 16, 2018, see [changes here](https://github.com/JohnCoates/Aerial/releases/tag/v1.4.1)) (1.4.2 beta 4, October 22, 2018, is also available [here](https://github.com/JohnCoates/Aerial/releases/download/v1.4.2beta4/Aerial.saver.zip), [click here](https://github.com/JohnCoates/Aerial/releases/tag/v1.4.2beta4) for more information on what's changed)
1. [Click here to Download](https://github.com/JohnCoates/Aerial/releases/download/v1.4.2/Aerial.saver.zip) (Version 1.4.2, October 23, 2018, see [changes here](https://github.com/JohnCoates/Aerial/releases/tag/v1.4.2))
2. Unzip the downloaded file.
3. 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. Also please note that clicking on the Preview button with 1.4.1 in System Preferences will show you a black screen. The screensaver will still work correctly. This bug is fixed in 1.4.2 beta (See above).
**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.

### Brew Cask Support - (Updated for Version 1.4.1)
### Brew Cask Support - (1.4.2 coming soon)

If you're looking to install Aerial across many systems, remotely, or simply from Terminal we recommend [Brew Cask](https://caskroom.github.io). Prefer this method if you're looking for auto-updates.

Expand Down Expand Up @@ -104,7 +104,7 @@ You can then download the videos you want from the JSON files. In the 4K JSONs,

## About HEVC and hardware decoding

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 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.
Aerial uses Apple's [AVFoundation framework](https://developer.apple.com/documentation/avfoundation) 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).

Expand All @@ -118,10 +118,7 @@ You can easily check for yourself what to expect by opening a video in Quicktime

## Troubleshooting

- Not seeing extended descriptions: If you manually removed your cache folder, you may no longer see the extra descriptions on video (eg, you only see "Space" on Space videos and City names for every single video). If that's the case, it's likely you have deleted the `TVIdleScreenStrings.bundle` from your cache directory. To restore it, three solutions :
1) Update to 1.4.2 beta (see above), it will magically fix itself
1) Close System Preferences, delete `/Users/YOURUSERNAME/Library/Preferences/ByHost/com.JohnCoates.Aerial.{UUID}.plist`, and go back to System Preferences and open Aerial again. It should redownload the missing file.
2) Download manually `https://sylvan.apple.com/Aerials/resources.tar` and put that file in the Aerial cache folder (you can open that folder from the Cache panel, by clicking the `Show in Finder` button. You will need to extract the tar. Make sure that the extracted files are at the root of the cache folder, and not in a resources subfolder (some unarchiving tools will do that by default). If so, just move the content of the resources folder to the parent directory.
- 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` and `System 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](http://www.openradar.me/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 a `com.apple.photos.ImageConversionService` responsible for this CPU load. This is the iCloud Photos process, you can find more about [what it does here](https://support.apple.com/en-gu/HT204264) and how to pause it.
Expand Down

0 comments on commit c48e132

Please sign in to comment.