TL;DR
A hacker has created an app called Phosphene that leverages Apple’s private WallpaperExtensionKit to enable custom video wallpapers on macOS Tahoe. This demonstrates system-level access but relies on private APIs, which could change or break in future updates.
A developer has successfully built an application called Phosphene that uses Apple’s private WallpaperExtensionKit framework to display custom video wallpapers on macOS Tahoe, marking a significant technical achievement and raising questions about system security and future OS updates.
Phosphene is a menu bar app combined with a wallpaper extension that plays user-imported MP4, MOV, or AVFoundation-readable videos as desktop and lock-screen wallpapers on macOS 14 Tahoe. It integrates directly with the system’s native wallpaper picker, appearing alongside Apple’s built-in Aerials, and is built on top of Apple’s private WallpaperExtensionKit framework, which is also used by Apple’s Aerial wallpapers.
The app loads this private framework via dlopen and uses runtime introspection through Mirror reflection to communicate with system XPC types. This approach allows video playback to run out-of-process, survive app quits, and integrate with the system’s lock-screen, idle, and sleep lifecycle. Learn more about system-level customization and private APIs.
Developed for macOS 14 Tahoe on Apple Silicon, Phosphene requires Xcode 17+ and Swift 6, and it embeds its wallpaper extension into the app bundle, registering with the system at launch. The extension renders frames into a remote CAContext using AVSampleBufferDisplayLayer, bypassing limitations of AVPlayerLayer in remote contexts. It uses a combination of decode pipelines, PTS offsets, and preloaded variants to achieve glitch-free, frame-accurate looping.
Why It Matters
This development demonstrates that private system frameworks can be leveraged to extend system functionality beyond official APIs, enabling features like custom video wallpapers that were previously inaccessible. It highlights potential security and stability concerns, as reliance on private APIs can lead to system breakage if Apple changes these interfaces in future updates. For users and developers, it signals both technical possibility and the risks associated with private API use.
macOS video wallpaper app
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Background
Apple has historically maintained strict control over system customization features, with official support limited to static wallpapers and Apple’s own dynamic options like Aerials. The release of macOS 14 Tahoe introduced new system frameworks, including WallpaperExtensionKit, which allows third-party extensions to provide wallpapers. Explore related projects on system customization.
“By reverse-engineering WallpaperExtensionKit, we’ve unlocked the ability to run custom videos as wallpapers, directly integrating with macOS’s native system.”
— the developer of Phosphene
“Using private frameworks like WallpaperExtensionKit poses risks, as Apple can change or remove these at any OS update, potentially breaking such implementations.”
— Apple security expert (unnamed)
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 Remains Unclear
It is not yet clear how stable or sustainable this approach is across future macOS updates, as Apple could modify or revoke access to WallpaperExtensionKit. The long-term implications for system security and stability remain uncertain, and there is no indication that Apple endorses or supports this method.
MP4 MOV desktop wallpaper macOS
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
What’s Next
Further development may include refining the app’s stability, exploring additional private APIs, or attempting to create more advanced video effects. Apple could also introduce official support or block such private API usage in upcoming updates, which would impact the viability of similar projects. Monitoring macOS updates and Apple’s response will be crucial for developers interested in system-level customization.
macOS wallpaper extension
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, undocumented APIs and is not officially supported by Apple. Its use may break with future macOS updates.
Can I install Phosphene on my Mac now?
Yes, if your Mac runs macOS 14 Tahoe on Apple Silicon and you follow the developer’s installation instructions, but be aware of potential stability or security issues.
Will Apple change WallpaperExtensionKit in future updates?
It is possible. As a private framework, Apple can modify or remove WallpaperExtensionKit at any time, which could render Phosphene unusable.
Does using private APIs pose security risks?
Yes, reliance on private APIs can introduce security and stability risks, as they are not subject to official review or support.
Could Apple add official support for video wallpapers?
It is uncertain. Apple has not announced plans for official video wallpaper support, but this development might influence future features or policies.
Source: Hacker News
