TL;DR
A developer has reverse engineered Apple’s private WallpaperExtensionKit framework to create an app that enables custom video wallpapers on macOS Tahoe. The app integrates with system features and uses private APIs, which could change in future OS releases. This development highlights potential security and stability concerns. Spotify and its hosting platforms are adopting Apple’s tech for video podcasts.
A developer has built an open-source application that allows users to set custom videos as wallpapers on macOS Tahoe by reverse engineering Apple’s private WallpaperExtensionKit framework. This breakthrough enables desktop and lock-screen video wallpapers beyond Apple’s native Aerials, raising questions about system security and future OS stability.
The app, named Phosphene, integrates directly with macOS’s native wallpaper system by utilizing Apple’s private WallpaperExtensionKit framework, which Apple uses for its own Aerial wallpapers. It loads this framework via dlopen and uses runtime reflection to communicate with its XPC types, a method that could break if Apple updates the framework in future OS releases. Phosphene supports importing MP4 and MOV files, offers seamless loop playback, and allows per-display and per-Space customization, all while respecting power and thermal policies to prevent system overheating or battery drain.
The app operates as a menu bar utility managing a video library, with a separate extension embedded into the system that renders the videos into the desktop wallpaper. It handles multiple displays, supports gapless and frame-accurate looping, and adapts playback quality based on system conditions. The extension runs in a sandboxed environment, communicating with the main app via XPC, and directly renders frames into a remote CAContext using AVSampleBufferDisplayLayer, bypassing the limitations of AVPlayerLayer inside remote contexts.
The developer emphasizes that the app relies on private APIs and frameworks, which Apple could change or disable in future OS updates, potentially breaking the functionality. The project is open-source under MIT license, and the developer notes that the app’s architecture is tightly coupled with macOS 14 (Tahoe) and Apple Silicon hardware, requiring Xcode 17+ for development and testing.
Why It Matters
This development is significant because it demonstrates that system-level customization of macOS wallpapers is possible through reverse engineering private frameworks, potentially opening doors for further customization or security concerns. It also raises questions about Apple’s control over system features and the stability of such modifications, especially since private APIs are involved. For users, it signals the possibility of more personalized desktop experiences, but also highlights risks related to OS updates and system integrity.
As an affiliate, we earn on qualifying purchases.
Background
Apple has traditionally limited wallpaper customization to its built-in options like Aerials, with third-party apps unable to modify system wallpapers directly due to sandboxing and private API restrictions. The reverse engineering of WallpaperExtensionKit by the developer marks a notable exception, leveraging undocumented APIs to extend system capabilities. Show HN: Daily vibe-coding video games, day 33: Tower Defense. Prior to this, similar efforts have been limited or involved unofficial modifications, but Phosphene’s approach operates within the system’s native wallpaper framework, making it more integrated and potentially more stable—at least until Apple updates or disables the private frameworks involved.
“By reverse engineering WallpaperExtensionKit, I was able to create a system that plays user videos as wallpapers, integrated seamlessly with macOS Tahoe.”
— the developer (@kageroumado)
“Using private frameworks like WallpaperExtensionKit in this manner can introduce stability and security risks, especially if Apple changes those APIs in future releases.”
— Apple security expert (unnamed)
What Remains Unclear
It remains unclear how long the app will remain functional, as future macOS updates could break its reliance on private APIs. Show HN: Daily vibe-coding video games, day 33: Tower Defense. Apple has not commented on the project or its approach, and there is no indication whether Apple might take measures to restrict such modifications in upcoming releases.
What’s Next
The developer plans to maintain and update the project for future macOS versions, but users should be cautious about relying on it for critical workflows. Apple may respond by tightening API restrictions or implementing safeguards that prevent such modifications, potentially rendering the app non-functional. Further community developments or official support for custom video wallpapers could emerge depending on user interest and technical feasibility.
Key Questions
Is using this app safe for my system?
Since the app relies on private frameworks and reverse engineering, it may pose risks related to system stability and security. Users should proceed with caution and be aware that future OS updates could disable or break the functionality.
Will Apple support custom video wallpapers officially?
Currently, there is no indication that Apple plans to support this feature officially. The app operates by bypassing standard APIs, which Apple may restrict in future updates.
Can I use this on older versions of macOS?
No, the app requires macOS 14 (Tahoe) and Apple Silicon hardware, leveraging new system APIs introduced in this version.
What happens if Apple updates the WallpaperExtensionKit framework?
If Apple modifies or removes the private framework, the app’s core functionality could break, requiring updates or potentially becoming unusable.
Is this legal or against Apple’s terms of service?
Using private APIs and reverse engineering may violate Apple’s terms of service and could lead to system instability or other issues. Users should be aware of these risks.
Source: Hacker News
