explaingit

bigsaltyfishes/wallpaper-engine-for-macos

★ 12RustAudience · developerComplexity · 4/5ActiveLicenseSetup · hard

TLDR

Open-source macOS port of Wallpaper Engine for Apple Silicon, with FFmpeg/VideoToolbox decoding, vDSP audio FFT, and partial SceneScript support. Needs a Steam copy of Wallpaper Engine for assets.

Mindmap

mindmap
  root((wallpaper-engine-for-macos))
    Inputs
      Wallpaper Engine assets
      SceneScript files
      Audio signal
    Outputs
      Animated desktop wallpaper
      Audio reactive scenes
      Multi monitor mirror
    Use Cases
      Animated Mac wallpapers
      Audio reactive backgrounds
      Workshop content on Mac
    Tech Stack
      Rust
      Swift
      Objective C
      FFmpeg
      Metal

Things people build with this

USE CASE 1

Run animated and audio-reactive wallpapers on an Apple Silicon Mac

USE CASE 2

Reuse Wallpaper Engine workshop content bought on Steam on macOS

USE CASE 3

Mirror one wallpaper across multiple monitors with custom scaling

USE CASE 4

Study how to bridge Rust, Swift, and Metal for a desktop graphics app

Tech stack

RustSwiftC++Objective-C++FFmpegMetalNix

Getting it running

Difficulty · hard Time to first run · 1h+

Needs a paid Steam copy of Wallpaper Engine, steamcmd with the Windows platform override, Apple Silicon, macOS 26, and manual approval of an unsigned app.

GPL-2.0 license, you can use and modify the code but any distributed derivative must also be GPL-2.0 with source available.

In plain English

This project is an open-source version of Wallpaper Engine that runs on macOS. Wallpaper Engine is a popular paid program on Windows that lets people use videos, animations, and reactive scenes as their desktop background. The author has put together a Mac equivalent using a mix of C++, Objective-C++, Rust, and Swift, building on top of a modified copy of another project called open-wallpaper-engine and adding several extra features. The README is clear that this is a personal learning project, not a polished product. Updates happen when the author has time, and not every wallpaper from the original Windows program will run correctly. The app only works on Macs with Apple Silicon chips, and the author recommends macOS 26 because that is the version they build against. The extra work on top of the upstream renderer includes audio FFT analysis accelerated by Apple's vDSP framework, which powers the audio-reactive wallpapers; an audio and video pipeline built with FFmpeg and Apple's VideoToolbox for hardware-accelerated decoding and video textures; a partial script engine that understands some of the SceneScript files used in workshop content; a rewritten shader processor inspired by linux-wallpaperengine; and support for user-defined properties and custom display scaling. To use it you still need a real copy of Wallpaper Engine, because the Mac program reads its assets. The README walks through buying it via Steam, installing the steamcmd command-line tool with Homebrew or by direct download, then logging in and running app_update 431960 with the platform forced to Windows so that Steam will install the Windows files on your Mac. After that you grab the Mac app from the GitHub Releases page, drag it to the Applications folder, and approve it in System Settings because it is unsigned. The wallpaper picker, audio response toggle, multi-monitor mirror mode, and four different scaling algorithms are explained in short sections. The project is built with the Nix build system, with Xcode 26 or newer required for some Swift libraries. It is released under the GPL-2.0 licence, and the README credits the upstream open-wallpaper-engine, linux-wallpaperengine, and an earlier wallpaper-engine-mac project for the renderer, shader code, and icon.

Copy-paste prompts

Prompt 1
Walk me through installing steamcmd with Homebrew and running app_update 431960 to fetch the Windows Wallpaper Engine assets needed by wallpaper-engine-for-macos.
Prompt 2
Explain how the audio FFT pipeline in wallpaper-engine-for-macos uses Apple vDSP to drive audio-reactive shaders.
Prompt 3
Show me how to build wallpaper-engine-for-macos from source with Nix and Xcode 26 on Apple Silicon.
Prompt 4
Help me approve the unsigned wallpaper-engine-for-macos app in macOS System Settings and pick a workshop wallpaper from the picker.
Prompt 5
Compare the four display scaling algorithms in wallpaper-engine-for-macos and recommend one for a 5K display.
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.