tchigher / animatedgif

A screensaver for Mac OSX / macOS that plays animated GIFs and APNGs

AnimatedGif

AnimatedGif is an screensaver for Mac OSX / macOS that plays animated GIFs.

It also has a background mode to let you run the gif as a desktop background (or wallpaper). The background mode can be enabled under "Screen Saver Options" in macOS.

You can either open only one single GIF file or you can choose a directory that contains more than one GIF file. In case of a selected directory the option panel of screensaver will let you choose a time between 1 and 30 minutes after which the GIF file is randomly changed.

Since 1.5.1 also animated PNG (Animated Portable Network Graphics (APNG)) are supported (starting with OSX 10.10).

Compatibility

This project was originally (release 1.0) written with Xcode 6.2 and SDK for OSX 10.9 Mavericks.

The release 1.4.0 was compiled with Xcode 10.1 with SDK for OSX 10.14 Mojave. It was tested successfully under Mavericks(10.9.5), El Capitan(10.11.6), High Sierra(10.13.6) and Mojave(10.14.5).

The latest release 1.5.3 was compiled with Xcode 10.2.1 with SDK for OSX 10.14 Mojave. It was tested successfully under Mavericks(10.9.5), High Sierra(10.13.6) and Mojave(10.14.5).

Note: AnimatedGif is not working with Catalina(10.15) since screensavers are now sandboxed (this means no GIF files can be selected or read from local disk and also background mode is broken), see issue #57.

Since release 1.5.0 AnimatedGif supports Metal(API) for rendering.

When started AnimatedGif tries to initialise Metal as first choice for rendering. Only if this initialisation fails (on MacOSX versions older than El Capitan (10.11) or not supported Macs(usually Macs older as Mid 2012; except Mac Pro models from Mid 2010 with supported graphics card)) it tries to initialise OpenGL for rendering(as it was default between release 1.0 till 1.4.0).

Unfortunately the screensaver clock is not working together with background mode and will be disabled if background mode is enabled. But the clock works fine in normal screensaver mode.

Setup - Mac

1. Download and unzip the compiled release file from the releases tab: https://github.com/Waitsnake/AnimatedGif/releases/latest/
2. Double click on the extracted "AnimatedGif.saver" file. macOS will ask if you like to install the screen saver
3. Open System Preferences -> Desktop and Screensaver
4. Select the AnimatedGif Screensaver
5. Click "Screen Saver Options" below the screensaver preview
6. Select your .gif file and adjust other settings to your liking

If there is an error message saying "[AnimatedGif.saver] can't be opened because it is from an unidentified developer"

1. Open System Preferences
2. Go to "Security & Privacy"
3. Click "Open Anyway"

4. Click "Open"

5. Choose if you like to install screensaver for actual user onyl or all users
6. Click "Install"

Uninstall AnimatedGif

Automatic Uninstall
In the linked tools here are 3 different ways to uninstall AnimatedGif. Each tool do the same and what way you choose depending only on your personal preferences.

• Uninstall_AnimatedGif.app.zip is an ZIP file containing an macOS application that uninstalls AnimatedGif (recommended way for unexperienced users)
• Uninstall_AnimatedGif.scpt is an AppleScript that uninstalls AnimatedGif
• Uninstall_AnimatedGif.sh is an shell script that uninstalls AnimatedGif

Manually Uninstall

1. Open System Preferences -> Desktop and Screensaver
2. Click "Screen Saver Options" and stop the background mode if it was enabled and close options.
3. Right click the AnimatedGif Screensaver and select "Delete AnimatedGif"
4. Click on "Move to Trash" to confirm

Copyright 2019 Marco Koehler (under the conditions of MIT License)