I reverse engineered Apple's video wallpapers
This project delves deep into Apple's private WallpaperExtensionKit to enable custom video wallpapers on macOS, a long-sought feature for personalization. The open-source release, born from a commercial venture, highlights impressive reverse-engineering and a native-like integration. HN appreciates the technical mastery and the generous sharing of a polished, power-aware solution.
The Lowdown
Phosphene is a new open-source macOS application that allows users to set their own video files as desktop and lock-screen wallpapers. Born from a reverse-engineering effort into Apple's private WallpaperExtensionKit framework, it integrates seamlessly with macOS System Settings, offering a native-like experience for custom video backgrounds.
- Custom Video Integration: Users can import any AVFoundation-readable video file (MP4, MOV, etc.) into Phosphene's library, and these videos will appear directly in the macOS System Settings wallpaper picker.
- Native-like Playback: By leveraging Apple's private WallpaperExtensionKit, Phosphene ensures video playback runs out-of-process, survives app quits, and interacts correctly with the OS-level lock-screen, idle, and sleep states.
- Optimized Performance: The app features gapless looping, multi-display support, and intelligent PlaybackPolicy that dynamically adjusts video quality and pauses playback based on factors like thermal state, battery level, game mode, and whether the desktop is occluded by windows.
- Technical Ingenuity: The project employs advanced techniques like dlopen for runtime loading of private frameworks and Mirror-based introspection for XPC communication, acknowledging potential breakage with future macOS updates.
- Open-Source Release: Originally intended as a commercial product, Phosphene was open-sourced after its creator assessed the competitive landscape, making its sophisticated functionality freely available to the community.
Phosphene stands out as a technically impressive solution for a common user desire, showcasing how deep system understanding can unlock new levels of customization on macOS, even when venturing into private APIs.
The Gossip
Nostalgic Nods & Notable Nuances
Commenters shared enthusiasm for custom video wallpapers, drawing nostalgic connections to older OS features like Windows Vista's animated backgrounds and HTML wallpapers. Amidst this excitement, some users recounted frustrating experiences with Apple's own default video wallpapers, citing issues like excessive data consumption, which the author addressed by highlighting Phosphene's distinct implementation approach.
Fragile Framework Futures
A prevalent concern revolved around the inherent instability of relying on Apple's private frameworks. While admiring the project's deep integration, many cautioned that future macOS updates could easily break Phosphene's functionality. The author, however, expressed a pragmatic view, noting the framework's historical stability and Apple's likely focus elsewhere.
Praise for Phosphene's Prowess
The community overwhelmingly lauded the project's technical ingenuity and the elegant solution it offers for a frequently requested feature. Users celebrated the newfound ability to personalize their macOS desktops with custom videos, leading to discussions about potential content. The author also took the opportunity to showcase their broader portfolio of projects, emphasizing their development capabilities.