TL;DR
A developer has reverse-engineered Apple’s private WallpaperExtensionKit framework to create Phosphene, an app that enables custom video wallpapers on macOS Tahoe. This breakthrough shows how system features can be accessed via private APIs, but also highlights potential stability risks.
A developer has created Phosphene, an open-source application that enables users to set custom videos as macOS desktop and lock-screen wallpapers on macOS Tahoe by reverse-engineering Apple’s private WallpaperExtensionKit framework.
Phosphene is a menu bar app paired with a wallpaper extension that integrates directly with macOS’s native wallpaper system. It uses the private WallpaperExtensionKit framework, the same one Apple employs for its own Aerial wallpapers, allowing videos to be played seamlessly as wallpapers across multiple displays and spaces.
The app supports importing MP4, MOV, and other AVFoundation-readable video files, which then appear in the system wallpaper picker. It offers features like gapless looping, per-display selection, power-aware playback, and smooth lock-screen transitions. The extension loads at runtime via dlopen and communicates with the menu bar app through shared app groups and XPC calls, enabling real-time control and customization.
Since it relies on private APIs, Phosphene may be affected by future macOS updates. Its development required advanced techniques such as runtime introspection and mirror-based reflection to interact with non-public system frameworks. The project is open-source, licensed under MIT, and built specifically for Apple Silicon Macs running macOS 14 Tahoe or later.
Why It Matters
This development demonstrates how private system frameworks can be harnessed to extend macOS capabilities beyond official support, raising questions about stability and security. For users and developers, it offers a glimpse into potential customization options but also highlights the risks of relying on private APIs, which could change or break with system updates. It underscores both the ingenuity and the fragility of system-level modifications.
macOS video wallpaper app
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Background
Apple’s macOS has traditionally limited wallpaper customization to static images and Apple’s own dynamic options like Aerials. While third-party apps have attempted to add video wallpapers, they often relied on unofficial methods or were limited in scope. The introduction of WallpaperExtensionKit in macOS 14 Tahoe provides a new avenue for system-level wallpaper extensions, but Apple has not publicly documented this private API, making reverse-engineering necessary. Prior to this, no publicly available tool allowed seamless, system-integrated video wallpapers at this level of fidelity.
“Using WallpaperExtensionKit, we’ve been able to integrate custom videos directly into the system wallpaper picker, making them indistinguishable from Apple’s own Aerials.”
— Developer of Phosphene
“Relying on private frameworks can introduce stability and security risks, and such methods are generally discouraged for end-users.”
— Apple security analyst
Apple Silicon Mac desktop wallpaper
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
What Remains Unclear
It remains unclear how future macOS updates might affect Phosphene, as Apple could change or remove the private WallpaperExtensionKit framework. The stability of the app across system updates is uncertain, and there is no official support or guarantee.
Custom murals, Custom Sizes, Custom Patterns, Custom Wallpapers (Customized Size)
Number of pieces: 1
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
What’s Next
Developers and users will likely monitor macOS updates for compatibility issues. Apple could also choose to limit or disable such private API access in future releases. The project may evolve to adapt to system changes or inspire official support for custom video wallpapers in future macOS versions.
AVFoundation video files for Mac wallpapers
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Key Questions
Is Phosphene officially supported by Apple?
No, Phosphene relies on private APIs not documented or supported by Apple, making it unofficial and potentially unstable with system updates.
Can I use Phosphene on my Mac now?
Yes, if your Mac runs macOS 14 Tahoe or later on Apple Silicon, and you build or download the app, it should function. However, stability is not guaranteed.
Does using private frameworks pose security risks?
Yes, apps that depend on private APIs can introduce security and stability concerns, as these frameworks are not subject to Apple’s official review or support.
Will Apple support custom video wallpapers officially?
There has been no official indication from Apple that they plan to add native support for user videos as wallpapers in future macOS releases.
Source: Hacker News
