[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-77792":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":13,"contributorsCount":9,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":15,"starSnapshotCount":15,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},77792,"Aerial","AerialScreensaver\u002FAerial","AerialScreensaver","Aerial app and screensaver for macOS",null,"https:\u002F\u002Fgithub.com\u002FAerialScreensaver\u002FAerial","Swift",395,14,4,0,15,18,38,45,73.33,false,"main",[24,25,26],"macos","screensaver","screen-saver","2026-06-12 04:01:22","# Aerial (formerly Aerial Companion)\n\n[![Total downloads](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002FAerialScreensaver\u002FAerial\u002Ftotal?style=flat-square&logo=apple&logoColor=white)](https:\u002F\u002Fgithub.com\u002FAerialScreensaver\u002FAerial\u002Freleases) [![Latest release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002FAerialScreensaver\u002FAerial?style=flat-square)](https:\u002F\u002Fgithub.com\u002FAerialScreensaver\u002FAerial\u002Freleases\u002Flatest)\n\n![Aerial screensaver showing weather, clock, and now-playing overlays atop a sunset video](screenshot.webp)\n\nThe Apple TV screensaver for your mac, now with optional wallpaper continuity. With optional overlays, time-of-day adaptation, and live camera feeds support. Now distributed as an App + App Extension.\n\nFor more details, check the website: [aerialscreensaver.github.io](https:\u002F\u002Faerialscreensaver.github.io)\n\n## App Extension\n\nStarting with version 4, Aerial is now distributed as an App Extension, bundled inside the Aerial.app. This is using the same private API that Apple introduced in macOS 10.15 (yes, Catalina !) but still has not made public. The App Extension API allows to provide full compatibility with Sonoma and Tahoe, sidestepping the longstanding issues with the old outdated `.saver` API and it's terrible `legacyScreenSaver.appex` \"compatibility layer\". \n\nIf you want to make your own macOS App Extension screensaver, instead of messing with Aerial code (which has so much backward compatibility\u002Flegacy things), I vastly recommend you start with  [AppexSaverMinimal](https:\u002F\u002Fgithub.com\u002FAerialScreensaver\u002FAppexSaverMinimal) as a much easier to understand starting point ! It's a minimal working sample, with a clear documentation of what works, what changes from the old API, and what you should adapt if you already have a `.saver` project. \n\n## Requirements\n\n- macOS 15 (Sequoia) or later.\n- Xcode 16 or later to build from source.\n\nFor earlier macOS Versions, check the [old saver repository](https:\u002F\u002Fgithub.com\u002FJohnCoates\u002FAerial). \n\n- If you only want the `.saver`, [version 3.6.3](https:\u002F\u002Fgithub.com\u002FJohnCoates\u002FAerial\u002Freleases\u002Ftag\u002Fv3.6.3) is the latest available.\n\n- If you want to use the old desktop mode from Companion, [version 1.5.3beta1](https:\u002F\u002Fgithub.com\u002FAerialScreensaver\u002FAerial\u002Freleases\u002Fdownload\u002Fv1.5.3beta1\u002FAerial.Companion.zip) is the latest : you *will need* to disable the update checks as you will be prompted to upgrade to version 4 ! It will automatically download version 3.6.3 at first launch. \n\n## Build from source\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FAerialScreensaver\u002FAerial.git\ncd Aerial\nopen Aerial.xcodeproj\n```\n\nIn Xcode, pick the **Aerial** scheme and build (`⌘B`) or run (`⌘R`).\n\nNote that `ScreenSaver\u002FSource\u002FModels\u002FAPI\u002FAPISecrets.swift` ships with a blank OpenWeather key in the public source. The weather overlay won't display data unless you put your own key. Everything else in the app works without it.\n\n## Thank you\n\nWeather overlays are provided thanks to [Openweather](https:\u002F\u002Fopenweathermap.org) who has offerred free support for Aerial for many years now ! Many thanks to them !\n\n\u003Ca href=\"https:\u002F\u002Fopenweathermap.org\">\u003Cimg src=\"ScreenSaver\u002FResources\u002Fopenweather_logo.png\" alt=\"OpenWeather\" width=\"200\">\u003C\u002Fa>\n\nAerial relies on a few great open source projects, you should check them out : \n- [Sparkle](https:\u002F\u002Fsparkle-project.org) for auto-updates\n- [KeyboardShortcuts](https:\u002F\u002Fgithub.com\u002Fsindresorhus\u002FKeyboardShortcuts) by Sindre Sorhus for global shortcuts handling\n- [Github releases to discord](https:\u002F\u002Fgithub.com\u002FSethCohen\u002Fgithub-releases-to-discord) by Seth Cohen for release notes in the community Discord\n- [Swift Argument parser](https:\u002F\u002Fgithub.com\u002Fapple\u002Fswift-argument-parser) by Apple (not used directly by Aerial, but [PaperSaver](https:\u002F\u002Fgithub.com\u002FAerialScreensaver\u002FPaperSaver) does use it)\n\nMany thanks to those maintainers and their contributors !\n\n## Contributing\n\nContributions welcome, but please open an issue first for substantial changes so we can discuss the approach before you put time into it.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","Aerial 是一款为 macOS 设计的应用程序和屏保，模仿了 Apple TV 的屏保效果。它支持可选的壁纸连续性、时间适应性以及实时摄像头流等功能，并且可以显示天气、时钟等信息叠加层。该项目采用 Swift 语言开发，利用了 macOS 10.15 引入但未公开的私有 API，确保与 Sonoma 和 Tahoe 等新版本系统的兼容性。Aerial 适用于希望在 Mac 上享受美观且功能丰富的屏保体验的用户，特别是那些喜欢个性化设置并追求高质量视觉效果的人士。此外，项目还提供了一个简化版的 App Extension 示例，方便开发者基于此创建自己的 macOS 屏保应用扩展。",2,"2026-06-11 03:56:00","trending"]