TL;DR
A developer has reverse engineered Apple’s private WallpaperExtensionKit to create Phosphene, an open-source app that allows users to set personal videos as wallpapers on macOS Tahoe. It integrates deeply with system features, offering smooth playback and multi-display support.
A developer has released Phosphene, an open-source app that enables macOS users to set personal videos as desktop and lock-screen wallpapers by reverse engineering Apple’s private WallpaperExtensionKit framework. This development provides a new way to personalize macOS desktops beyond Apple’s built-in options, with system-level integration and advanced features.
Phosphene is a menu bar application combined with a wallpaper extension that plays user-imported videos as desktop and lock-screen wallpapers on macOS Tahoe (macOS 14). It integrates directly into the system’s native wallpaper picker, appearing alongside Apple’s default Aerials, and supports importing MP4, MOV, and other AVFoundation-readable files.
The app leverages Apple’s private WallpaperExtensionKit framework, which is also used by Apple’s Aerial wallpapers. It loads this framework dynamically at runtime using dlopen and Mirror-based reflection, allowing it to communicate with system components despite the private API status. This approach enables the app to run video playback out-of-process, survive app quits, and synchronize with system sleep and lock states.
Features include gapless, frame-accurate looping, multi-display support with per-space and per-display wallpapers, power-aware playback that reduces resource use based on thermal and battery states, and smooth lock-screen transitions that mimic Apple’s own wallpapers. Additionally, it detects occlusion to pause rendering when the desktop isn’t visible and can pre-render lower-resolution variants to optimize performance.
Users manage their video library via the menu bar, selecting videos that then appear in the system wallpaper picker. macOS handles the actual wallpaper assignment, while Phosphene’s extension provides the frames through a remote AVSampleBufferDisplayLayer. The app architecture separates the menu bar interface from the wallpaper extension, which runs within the system process, enabling seamless integration.
Why It Matters
This development matters because it unlocks a previously restricted customization feature for macOS users, allowing personal videos to serve as dynamic wallpapers. It demonstrates how developers can reverse engineer and utilize private frameworks to extend system functionality, potentially inspiring further customization tools. However, reliance on private APIs means future macOS updates could break compatibility, and this approach may have security or stability implications.
macOS video wallpaper app
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Background
macOS has long supported static wallpapers, with limited options for animated or video backgrounds. Apple’s own Aerial wallpapers are built-in, but third-party customization has been restricted. Previous efforts to modify wallpapers often involved unofficial hacks or less integrated solutions. The release of Phosphene marks a significant step in system-level customization, made possible by reverse engineering private frameworks, specifically WallpaperExtensionKit, which is used internally by Apple for its own high-quality wallpapers.
Since macOS 14 (Tahoe), Apple introduced new APIs and frameworks for wallpaper extensions, but these are private and undocumented. Phosphene leverages these APIs by dynamically loading the framework, enabling features like multi-display support, power-aware playback, and lock-screen transitions—capabilities that were previously inaccessible to third-party developers.
“Phosphene is built on top of Apple’s private WallpaperExtensionKit framework, allowing deep system integration for custom video wallpapers.”
— Developer (@kageroumado)
“Using reverse engineering techniques, the developer managed to tap into Apple’s private frameworks to enable video wallpapers on macOS Tahoe.”
— MacRumors
HelloWall 17.71"x 315" Black and White Wallpaper Removable Wallpaper Stick and Peel Vintage Video Cassette Tape Wall Paper Sticker Pull and Stick on Bedroom Accent Wall Contact Paper Renters Friendly
😊CLASSIC DESIGN: The black and white wallpaper will never go out of style, perfect for decorating walls and…
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 future-proof Phosphene is, as it depends on private APIs that Apple could change or deprecate in upcoming macOS updates. For more on system customization, see related developments in system modifications.
macOS lock screen video wallpaper
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
What’s Next
Next steps include monitoring macOS updates for compatibility issues, potential official responses from Apple regarding private API use, and community adoption or development of similar tools. You can also explore related projects like show HN: Daily vibe-coding video games.
dynamic macOS wallpaper software
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 is an unofficial, reverse-engineered tool that relies on private APIs not documented or supported by Apple.
Can I use Phosphene on versions of macOS earlier than Tahoe?
No, Phosphene requires macOS 14 (Tahoe) or later, as it depends on features introduced in that version.
Will Apple fix or block this functionality in future updates?
It is uncertain. Since Phosphene uses private frameworks, future macOS updates could break its functionality or lead to restrictions.
Is using Phosphene safe or secure?
Using tools that rely on private APIs carries potential security and stability risks. Users should proceed with caution.
Source: Hacker News
