Wallpapper is a console application for creating dynamic wallpapers for macOS Mojave and newer.
The tool solves the problem of generating macOS dynamic wallpapers, which change their appearance based on the time of day and system appearance settings. It works by taking a collection of images and a JSON configuration file that describes how those images should be displayed under different conditions. The application supports three kinds of dynamic wallpapers, including solar-based wallpapers that change according to the sun's position in the sky, defined by altitude and azimuth angles. It produces HEIC files that macOS recognizes as dynamic wallpapers.
Wallpapper suits developers and designers who want to create custom dynamic wallpapers without manually constructing the underlying HEIC container format. Users need to organize their images in a folder alongside a JSON file specifying properties like which image is primary, whether images apply to light or dark mode, and the solar coordinates that trigger each image. The tool is built in Swift and installable via Homebrew or manual compilation, making it accessible to those comfortable with command-line tools.
The project maintains active build automation through continuous integration workflows. Development is conducted in Swift with compatibility for the Swift Package Manager, allowing others to integrate or extend the tool programmatically.
