开源项目phosphene在GitHub上获得670+星标,它是一个专为macOS Tahoe设计的视频壁纸引擎。与传统的动态壁纸方案不同,phosphene直接接入macOS原生壁纸选择器,让你的自定义视频与Apple内置的Aerials并列显示在系统设置中。
核心特性
1. 原生系统集成
phosphene基于Apple的私有WallpaperExtensionKit框架构建——这正是Apple自家Aerials使用的同一个框架。这意味着:
- 视频壁纸显示在系统设置 → 壁纸中,与Apple内置壁纸并列
- 播放进程独立于应用,即使退出app壁纸也会继续
- 与系统级锁屏、空闲、睡眠生命周期完全集成
2. 自定义视频支持
导入MP4、MOV或任何AVFoundation可读的视频文件,它们就会出现在系统壁纸选择器中。
3. 无缝循环播放
通过偏移PTS/DTS实现帧精确循环,没有刷新、没有卡顿。
4. 多显示器+per-Space
每个显示器可以设置不同的壁纸,每个Space(桌面空间)也可以独立配置,由macOS持久化保存。
5. 电源感知播放
内置渐进式PlaybackPolicy,根据以下状态自动调整:
- 热状态(温度过高时降低负载)
- 电池电量
- 电源状态(电池/交流电)
- 游戏模式
- 演示模式(活跃/锁定/空闲)
6. 被遮挡时暂停
当所有显示器都被窗口完全覆盖时,自动暂停渲染,节省资源。
7. 自适应变体
可以预渲染低分辨率/低帧率的视频变体,渲染器在每个循环边界自动切换到当前策略允许的最经济变体。
8. 菜单栏控制
通过菜单栏预览当前壁纸、切换暂停、切换显示器、配置行为、设置开机启动。
安装要求
- 系统:macOS Tahoe (26.0+)
- 硬件:Apple Silicon (arm64)
- 开发工具:Xcode 17+(用于从源码构建)
从源码构建
git clone https://github.com/kageroumado/phosphene.git
cd phosphene
open Phosphene.xcodeproj
# 在Xcode中选择Phosphene scheme,点击Run
# 需要设置开发团队进行代码签名
注意事项
phosphene使用的是Apple的私有框架,通过dlopen加载并使用Mirror运行时内省来与XPC类型通信。这意味着:
- Apple可能在任何主要OS版本中更改这个框架
- 目前追踪的是macOS 26 (Tahoe)
- 不保证在未来的macOS版本中继续工作
适用场景
- 个性化桌面:把喜欢的视频片段设为壁纸
- 展示用途:在产品发布会或演示中使用品牌视频壁纸
- 创意工作:设计师和创意工作者的桌面美化
- Apple TV风格:把Apple TV的Aerials体验扩展到自定义视频
项目链接
https://github.com/kageroumado/phosphene
















GitHub – TauricResearch/TradingAgents

暂无评论内容