wallpapper

github.com/mczachurski/wallpapper Mac Apps Open-source projectOpen source

wallpapper creates dynamic wallpapers for macOS Mojave and later through a console application.

github.com/mczachurski/wallpapper
wallpapper homepage screenshot

About wallpapper

wallpapper is a console application that creates dynamic wallpapers for macOS Mojave and newer. Users place image files in one folder with a JSON file describing each image, then run the tool to generate a .heic file, with options for output filename, input description, metadata extraction, and image quality.

It supports solar-based wallpapers defined by altitude and azimuth and time-based wallpapers defined by timestamps, including flags for primary and light/dark static images. Installation is via Homebrew or manual build, which requires Xcode 10.2 and Swift 5.

Key features

  • Creates dynamic wallpapers for macOS Mojave and newer from images
  • Builds solar-based wallpapers using altitude and azimuth values
  • Builds time-based wallpapers using timestamps in JSON file
  • Extracts metadata from existing .heic files with -e option
  • Sets output filename and image quality via command options
  • Installs via Homebrew or manual Swift build process
Best for: Best for macOS users comfortable with the terminal who want to build dynamic wallpapers from their own images.
Good for
  • Open source repository with Homebrew and manual build instructions
  • Includes downloadable example dynamic wallpapers
  • Provides wallpapper-exif helper for working with solar coordinates
Watch out for
  • Works only on macOS Mojave and newer
  • Manual build requires Xcode 10.2 and Swift 5
  • Wallpaper definitions must be written manually as JSON files

wallpapper at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Platforms
macOS
Open source
Yes · Source code
Language
English
Last checked
Oct 6, 2026 · Online when checked
Listed
Oct 5, 2026

wallpapper alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Popular in Mac Apps

Well-known listings from the same topic.

All 140

wallpapper FAQ

How do I install wallpapper?
With Homebrew using brew tap mczachurski/wallpapper and brew install wallpapper, or by cloning the repository and building with Swift.
How do I create a dynamic wallpaper?
Put all pictures in one folder with a JSON file describing them, then run wallpapper with the -i input file and -o output file options.
How do I find altitude and azimuth for a solar wallpaper?
Use the wallpapper-exif application or enter the photo location and date in a solar calculator such as the NOAA or Omni Calculator pages listed in the documentation.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing