phosphene:macOS Tahoe视频壁纸引擎,把任意视频设为桌面壁纸

开源项目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 – kageroumado/phosphene

© 版权声明
THE END
喜欢就支持一下吧
点赞14 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容