{"id":15717690,"url":"https://github.com/waitsnake/animatedgif","last_synced_at":"2025-04-09T15:06:52.120Z","repository":{"id":74124033,"uuid":"45924963","full_name":"Waitsnake/AnimatedGif","owner":"Waitsnake","description":"A screensaver for Mac OSX / macOS that plays animated GIFs and APNGs","archived":false,"fork":false,"pushed_at":"2024-06-03T20:43:52.000Z","size":17714,"stargazers_count":213,"open_issues_count":10,"forks_count":31,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-09T15:06:45.234Z","etag":null,"topics":["animated-gifs","apng","gif","gif-animation","mac-osx","macos","metal","opengl","screensaver"],"latest_commit_sha":null,"homepage":"","language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Waitsnake.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-11-10T16:31:32.000Z","updated_at":"2025-03-06T18:40:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"86b379fa-1657-4898-b7fa-621fc79eed95","html_url":"https://github.com/Waitsnake/AnimatedGif","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Waitsnake%2FAnimatedGif","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Waitsnake%2FAnimatedGif/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Waitsnake%2FAnimatedGif/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Waitsnake%2FAnimatedGif/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Waitsnake","download_url":"https://codeload.github.com/Waitsnake/AnimatedGif/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248055284,"owners_count":21040157,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animated-gifs","apng","gif","gif-animation","mac-osx","macos","metal","opengl","screensaver"],"created_at":"2024-10-03T21:51:00.854Z","updated_at":"2025-04-09T15:06:52.102Z","avatar_url":"https://github.com/Waitsnake.png","language":"Objective-C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AnimatedGif\n\nAnimatedGif is an screensaver for Mac OSX / macOS that plays animated GIFs.\n\nIt 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.\n\nYou 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.\n\nSince 1.5.1 also animated PNG (Animated Portable Network Graphics (APNG)) are supported (starting with OSX 10.10).\n\u003cbr\u003e\n\n## Compatibility\n\n_Note: AnimatedGif is **not working** with **Catalina(10.15-10.15.7)** and early versions of **Big Sur(before 11.5.2)** since screensavers are to strong sandboxed in this versions of macOS(this means no GIF files can be selected or read from local disk and also background mode is broken), see issue \u003ca href=\"https://github.com/Waitsnake/AnimatedGif/issues/57\"\u003e#57\u003c/a\u003e and \u003ca href=\"https://github.com/Waitsnake/AnimatedGif/issues/63\"\u003e#63\u003c/a\u003e.\nLater OS versions of Big Sur starting with 10.5.2 make the Sandbox a bit more open and at least allow selection of local user files._\n\n\u003cbr\u003e\n\nSince release 1.5.0 AnimatedGif supports Metal(API) for rendering.\n\nWhen 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).\n\nUnfortunately 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.\n\nBecause Big Sur(11.5.2) still sandboxes screensaver the background mode is still not working and so this button will be automaticly disabled since release 1.5.4 when Big Sur(and Catalina) is detected. But background mode is still available on Mojave or earlier versions of OSX.\n\n\u003cbr\u003e\n\n## Version History\n\nThis project was originally (release 1.0) written with Xcode 6.2 and SDK for OSX 10.9 Mavericks. \n\nThe 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).\n\nThe 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.6).\n\nThe latest release 1.5.4 was compiled with Xcode 12.5.1 with SDK for macOS 11 Big Sur. It was tested successfully under High Sierra(10.13.6), Mojave(10.14.6) and Big Sur(11.5.2).\n\n## Setup - Mac\n\n1. Download and unzip the compiled release file from the releases tab: https://github.com/Waitsnake/AnimatedGif/releases/latest/\n2. Double click on the extracted \"AnimatedGif.saver\" file. macOS will ask if you like to install the screen saver\n3. Open ***System Preferences -\u003e Desktop and Screensaver***\n4. Select the AnimatedGif Screensaver\n5. Click \"Screen Saver Options\" below the screensaver preview\n6. Select your .gif file and adjust other settings to your liking\n\u003cp align=\"left\"\u003e\n\u003cimg src=\"readme_extra/screensaver.png?raw=true\" width=\"500\"/\u003e\n\u003c/p\u003e\n\u003cp align=\"left\"\u003e\n\u003cimg src=\"readme_extra/options.png?raw=true\" width=\"500\"/\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n## If there is an error message saying \"[AnimatedGif.saver] can't be opened because it is from an unidentified developer\" (Mojave) or  \"[AnimatedGif.saver] can't be opened because Apple cannot check it for malicious software.\" (Big Sur) \n\u003cbr\u003e\nMojave:\n\u003cimg src=\"readme_extra/can_not_open_1.png?raw=true\" width=\"500\"/\u003e\nBig Sur:\n\u003cimg src=\"readme_extra/big_sur_not_open_1.png?raw=true\" width=\"500\"/\u003e\n\n1. Open System Preferences\n2. Go to \"Security \u0026 Privacy\"\n3. Click \"Open Anyway\"\n\u003cbr\u003e\nMojave:\n\u003cimg src=\"readme_extra/can_not_open_2.png?raw=true\" width=\"500\"/\u003e\nBig Sur:\n\u003cimg src=\"readme_extra/big_sur_not_open_2.png?raw=true\" width=\"500\"/\u003e\n4. Click \"Open\"\n\u003cbr\u003e\nMojave:\n\u003cimg src=\"readme_extra/can_not_open_3.png?raw=true\" width=\"500\"/\u003e\nBig Sur:\n\u003cimg src=\"readme_extra/big_sur_not_open_3.png?raw=true\" width=\"500\"/\u003e\n5. Choose if you like to install screensaver for actual user onyl or all users\n\u003cbr\u003e\n6. Click \"Install\"\n\u003cbr\u003e\nMojave:\n\u003cimg src=\"readme_extra/can_not_open_4.png?raw=true\" width=\"500\"/\u003e\nBig Sur:\n\u003cimg src=\"readme_extra/big_sur_not_open_0.png?raw=true\" width=\"500\"/\u003e\n\nNote: On Big Sur steps 5. and 6. appear now even before step 1.\n\n## Uninstall AnimatedGif\n\n***Automatic Uninstall***\n\u003cbr\u003e\nIn 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.\n\n- \u003ca href=\"https://github.com/Waitsnake/AnimatedGif/raw/master/tools/Uninstall_AnimatedGif.app.zip\"\u003eUninstall_AnimatedGif.app.zip\u003c/a\u003e is an ZIP file containing an macOS application that uninstalls AnimatedGif (recommended way for unexperienced users)\n- \u003ca href=\"https://github.com/Waitsnake/AnimatedGif/raw/master/tools/Uninstall_AnimatedGif.scpt\"\u003eUninstall_AnimatedGif.scpt\u003c/a\u003e is an AppleScript that uninstalls AnimatedGif\n- \u003ca href=\"https://github.com/Waitsnake/AnimatedGif/raw/master/tools/Uninstall_AnimatedGif.sh\"\u003eUninstall_AnimatedGif.sh\u003c/a\u003e is an shell script that uninstalls AnimatedGif\n\u003cbr\u003e\n\n***Manually Uninstall***\n\u003cbr\u003e\n1. Open ***System Preferences -\u003e Desktop and Screensaver***\n2. Click \"Screen Saver Options\" and stop the background mode if it was enabled and close options.\n3. Right click the AnimatedGif Screensaver and select \"Delete AnimatedGif\"\n4. Click on \"Move to Trash\" to confirm\n\u003cp align=\"left\"\u003e\n\u003cimg src=\"readme_extra/delete1.png?raw=true\" width=\"500\"/\u003e\n\u003c/p\u003e\n\u003cp align=\"left\"\u003e\n\u003cimg src=\"readme_extra/delete2.png?raw=true\" width=\"500\"/\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n\nCopyright 2019 Marco Koehler\n(under the conditions of MIT License)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaitsnake%2Fanimatedgif","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaitsnake%2Fanimatedgif","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaitsnake%2Fanimatedgif/lists"}