Open Wallpaper Engine icon Open Wallpaper Engine icon

Open Wallpaper Engine

Wallpaper Engine scene, video and web wallpapers, live on your Mac desktop, in the screen saver, and in an editor of their own.

macOS 14 or later · Free and open source (GPL-3.0)

The Snowy Plains scene wallpaper running on a Mac desktop: a snow-covered cabin at sunset with falling snow.

Wallpaper types

Plays the Wallpaper Engine format

Open Wallpaper Engine reads wallpapers in Wallpaper Engine's own format: the project.json, scene.json, packages, textures and shaders that Workshop items ship with. Three of the four wallpaper types run.

Scene

type: scene

  • Rendered natively with Metal, through each wallpaper's original shaders translated to Metal
  • Image, composition, fullscreen and solid layers; all 33 blend modes; effect masks
  • GPU particles, text and clock layers, keyframe and texture timelines
  • SceneScript, 3D models, scene lights, shadows and fog
  • HDR bloom, with EDR output on displays that can show it
  • Edited in the Wallpaper Editor, the only macOS app that edits Wallpaper Engine scenes

Video

type: video

  • MP4, MOV and M4V through AVFoundation
  • WebM (VP8/VP9) plays through WebKit, with placement, looping, volume, speed and per-display pause, and music sync
  • Playback rate, volume and placement (Fill, Fit, Center, Stretch, Zoom)
  • Optional music-synced zoom and tilt
  • HDR10 and HLG videos in HDR on displays that can show it

Web

type: web

  • HTML and WebGL wallpapers with local file access, so textures and assets load
  • User properties through wallpaperPropertyListener
  • Live audio through the audio listener
  • Now Playing through the media listeners
  • Folder properties, so slideshow wallpapers show your pictures
  • Devtools for authors: Safari's Web Inspector, or Chromium's DevTools on this Mac only

Not supported: application wallpapers. They are Windows programs and will not run.

Features

Built to render wallpapers the way their authors made them

The goal is to run every Wallpaper Engine wallpaper except applications, faithful to how Wallpaper Engine draws them, with fixes that work for all wallpapers instead of one.

Rendering

  • Metal on the GPU; Wallpaper Engine's GLSL is translated to Metal (GLSL → SPIR-V → MSL) by glslang and SPIRV-Cross built into the app
  • Translated shaders are cached on disk and compiled in the background
  • Workshop authors' own custom effects run through the same path, and so do the effects you write in the Wallpaper Editor's Shader Editor
  • Built-in effects need Wallpaper Engine on Steam: the app installs its assets from your own copy
  • Colour lookup tables, Wallpaper Engine's colour correction, bloom and HDR bloom
  • "Ultra (Display HDR)" outputs EDR on HDR-capable displays
  • Puppet Warp images with bone physics

Particles

  • Every particle system simulated on the GPU, in 3D, with 3D control points
  • Child systems, including ones triggered by their parent's particles
  • Emitter bursts, delays, periodic emission, and emitting from a layer's image
  • Collision (including with a model's bones), audio response, rotation about every axis
  • Turbulence, attractors, vortex and boid motion, ropes and trails

3D and lighting

  • 3D models with skinning, animation layers, morph targets and root motion
  • Perspective cameras with camera paths, fades and shake; 2D layers sit in depth
  • Scene lights with light cookies, shadows and planar reflections
  • Distance and height fog, and volumetric lights

SceneScript and Now Playing

  • A complete SceneScript runtime: modules, the scene, layer, effect and material object model, animation events, localStorage and cursor hit testing
  • Each wallpaper's scripts run on their own thread
  • Scripts can create layers, particle systems and sounds, drive bloom and fog, and pose puppets and models
  • Now Playing: scenes and web wallpapers receive the current track and playback state (macOS 15.4 or later)

Audio

  • System audio captured with a Core Audio process tap on macOS 14.2 or later (System Audio Recording permission), or with ScreenCaptureKit before that (Screen & System Audio Recording)
  • The audio spectrum is computed the way Wallpaper Engine computes it, in stereo
  • Audio-reactive layers, effects, particles and scripts
  • Sound layers play on the scene's clock, with spatial sound placed as in Wallpaper Engine

Every display

  • A different wallpaper on each display, or one on all of them
  • A wallpaper shown on several displays renders once and is presented on each
  • Pause per Display or Pause All, with playback rules checked for each display, including Wallpaper Engine's maximized-window rule
  • Rules for focused, maximized, fullscreen and audio-playing apps, a sleeping display and battery power
  • Per-display properties, with "Sync properties across displays"; playback continues across Spaces

Steam Workshop

  • Browse and search the Workshop inside the app with Wallpaper Engine's sorts: Top Rated, Most Popular (year, month, week or today), Most Recent, Most Up Votes and Most Subscriptions
  • Exact phrase search and Hide Anime, as in Wallpaper Engine
  • The Discover tab's lists, as in Wallpaper Engine: newly approved wallpapers, the most popular of the week, month and year, top rated, and by genre
  • Wallpaper Engine's filters: Show Only, resolution, content rating, type, and genres combined with AND or OR
  • Downloads go through your Steam account, which must own Wallpaper Engine; sign in once with the Steam mobile app's QR code or your password
  • Missing dependencies download automatically; unused ones are removed after a delete
  • Content rating defaults to Everyone

Library and playlists

  • Installed wallpapers filter by their Workshop tags, type, rating and resolution, sort as in Wallpaper Engine (Favorite and Last Updated included), and file into Wallpaper Engine's folders, which you can import
  • Import from folders or .zip packages, or by drag and drop; import your Wallpaper Engine favourites from Steam
  • Set as Wallpaper and Set as Screen Saver from the Installed, Discover and Workshop menus
  • Playlists change on a timer, at login, by time of day or by day of week, with Wallpaper Engine's 27 transitions, shuffle and repeat
  • Reset in Details returns a wallpaper's properties, and its scene edits, to the author's defaults
  • Safe restart skips a wallpaper that stalled or crashed the app and marks it in the library

Wallpaper Editor

  • Layers, effects with previews, a timeline, SceneScript, user properties, particle systems and Puppet Warp rigs, edited as a draft
  • Gizmos to move, turn and scale layers and 3D objects, and Wallpaper Engine's effect gizmos
  • FBX and OBJ model import, with Wallpaper Engine's Model Editor
  • Your own effects, written in the Shader Editor and translated to Metal as you apply them
  • Foreground Separation, Character Sheet Creation and Normal Map Generation, on your Mac
  • New Wallpaper… starts a scene from a picture or one of Wallpaper Engine's templates

Export

  • Live Photo lock screens for iPhone and iPad, from a scene or a video, with AirDrop or into Photos
  • Packages for Wallpaper Engine's Android app, sent to the device over Wi-Fi with a QR code
  • One wallpaper or a batch, without changing your desktop

Screen saver and lock screen

  • A fully live screen saver: each display's wallpaper is drawn as it runs, so clocks, scripts and audio-reactive parts move; nothing is recorded
  • Screen Saver Same as Wallpaper, or a wallpaper of your choice with your own layer and property choices
  • Web and WebM wallpapers through the Chromium engine
  • The lock screen shows a picture of each display's wallpaper

Performance settings

  • Quality presets (Low, Medium, High, Ultra), anti-aliasing and post-processing
  • Render Resolution: Your Display, 4K or Full (the wallpaper's own size, as in Wallpaper Engine), with optional Upscaling at 75, 67 or 50 %
  • Texture Resolution, Effect Detail, reflections, shadows and volumetrics
  • Frame rate limit and particle budget
  • A lower quality preset and frame rate cap on battery or in Low Power Mode, and Wallpaper Engine's Laptop on battery rule
  • Wallpapers pause while the screen is locked; caches clean up after themselves

A native Mac app

  • Liquid Glass on macOS 26: a native split view, toolbar and inspector with glass controls
  • Earlier macOS versions keep the familiar look
  • A menu bar icon with recent wallpapers, following the menu bar's appearance; the Dock icon and the menu bar icon can each be turned off
  • Hotkeys for actions, playlists, wallpapers and display profiles, and Wallpaper Engine's -control command line
  • Play in Window plays a wallpaper in a window of its own
  • Automatic updates, checked at openwallpaperengine.app and downloaded from GitHub Releases, which you can turn off in Settings › Updates

16 languages

  • German, French, Spanish, Brazilian Portuguese, Italian, Japanese, Korean, Simplified and Traditional Chinese, Russian, Polish, Turkish, Ukrainian, Arabic and Hindi, in addition to English
  • Chosen from the Language picker in Settings

Privacy

  • Your Steam password is never stored; the app keeps only Steam's sign-in token, in your Keychain
  • Everything the app saves stays on your Mac; no server, no data collection or analytics
  • Contacts Valve (Steam for the Workshop and assets) and, for app updates, openwallpaperengine.app (the update feed) and GitHub Releases (the downloads); optional plugins download from their own hosts only when you install them; web wallpapers may load their own online content
  • Update checks send no personal data and can be turned off in Settings › Updates

Screenshots

See it running

Captured from the app on macOS. Select a screenshot to enlarge it.

Requirements

Install

  • macOS 14 Sonoma or later, on a Mac with Metal
  • Liquid Glass interface on macOS 26
  • Now Playing needs macOS 15.4 or later
  • Scene wallpapers need Wallpaper Engine assets from your Steam copy (a Steam account that owns Wallpaper Engine); video and web wallpapers don't
  • Workshop downloads need a Steam account that owns Wallpaper Engine. Nothing else to install: the app talks to Steam itself
  • Audio-reactive wallpapers need the System Audio Recording permission (Screen & System Audio Recording before macOS 14.2), or the Microphone permission when you choose a recording device
  • HDR output needs a display that can show HDR, with Post-Processing set to Ultra (Display HDR)
  1. Download the DMG from the button above.
  2. Open it and drag Open Wallpaper Engine to Applications.
  3. Open the app. It's signed and notarized by Apple; macOS only asks once to confirm opening an app from the internet.
  4. Follow the setup assistant: sign in to Steam, and the Wallpaper Engine assets install automatically; it can also import your Wallpaper Engine favourites. You can also choose an existing Wallpaper Engine folder in Settings → Assets.
  5. Import wallpaper folders or .zip packages, or download from the Discover and Workshop tabs.

FAQ

Questions

Do I need Wallpaper Engine installed?

Scenes need Wallpaper Engine's built-in effects, materials, shaders, fonts and SceneScript runtime, which the app doesn't ship. Settings → Assets downloads them from your own Wallpaper Engine copy on Steam, keeps only those files and Wallpaper Engine's default wallpapers, and deletes the rest; or you can choose an existing Wallpaper Engine folder. Video and web wallpapers play without them. Shaders are translated by a compiler built into the app.

What does "Wallpaper Engine format" mean?

Wallpapers made for Wallpaper Engine are folders with a project.json and their content: a scene.json or scene.pkg with textures, materials and shaders for scenes, a video file, or an HTML page. Open Wallpaper Engine reads those files directly, so Workshop items and wallpapers you made yourself both work.

Where are wallpapers stored?

In ~/Documents/Open Wallpaper Engine by default. You can choose another folder in Settings and move the existing library there. Every Workshop download lands in that folder.

Do I need to own Wallpaper Engine?

For scene wallpapers and the Steam Workshop, yes: the built-in effects come from your own Wallpaper Engine copy, and Steam lets the app and Workshop items download only for an account that owns Wallpaper Engine. Video and web wallpapers you already have can be imported and played without Steam.

Which wallpapers do not work?

Application wallpapers are not supported. Scene support is broad but still growing; a wallpaper that stalls or crashes the app is skipped on the next launch and marked in the library.

Is my Steam login safe?

Your Steam password is never stored. The app keeps only the sign-in token Steam issues, in the macOS Keychain.

Can I edit or make wallpapers on a Mac?

Yes. The Wallpaper Editor (Edit Wallpaper under the library) edits scene wallpapers: layers, effects, particles, timelines, SceneScript, user properties, models and your own shaders. Add Wallpaper › New Wallpaper… starts one from a picture or from one of Wallpaper Engine's templates. You edit a draft, and the wallpaper's own files are never changed. New effects, Replace Shader and the templates read your Wallpaper Engine assets.

Does the screen saver need the app running?

The screen saver draws your wallpapers live through the app. When the app isn't running, the screen saver starts it in the background, with no window or Dock icon, through a background item listed in System Settings › General › Login Items. Install it in Settings › Plugins › Screen Saver.

How do I save battery?

In Settings › Performance, turn on "On battery: use a lower quality preset" to draw with a lower preset and an optional frame rate cap while the Mac is on battery or in Low Power Mode, or set Laptop on battery to Pause or Stop. Wallpapers also pause while the screen is locked.

Can scripts control the app?

Yes. The app takes Wallpaper Engine's -control commands (pause, play, open a wallpaper, playlists, profiles, properties and more), in Wallpaper Engine's spelling, so scripts written for it work with small changes. MCP clients can use the optional MCP Server plugin.

Why does the app ask for the Microphone?

Only if you choose a recording device in Settings › Optimizations › Audio, so audio-reactive wallpapers hear a microphone or a loopback device instead of the sound your Mac plays. The audio is analysed on your Mac and never recorded or sent.

What data does the app keep or send?

Everything Open Wallpaper Engine saves stays on your Mac: your settings, library, cache and your Steam login. Open Wallpaper Engine has no server and collects no data or analytics. It contacts Valve (Steam when you use the Workshop or install assets) and, for app updates, the update feed at openwallpaperengine.app and the downloads on GitHub Releases. Update checks send no personal data, and you can turn them off in Settings › Updates. Optional plugins download only when you install them: the Chromium web engine from the Chromium Embedded Framework's builds, and the depth model from Apple's Hugging Face repository. Send over Wi-Fi serves Android exports only to devices on your local network, and stops once 15 minutes pass without a request. Web wallpapers may load their own online content. Your Steam password and Steam Guard code go only to Steam and are never stored or logged; only Steam's sign-in token is kept, in your Keychain.

Credits

Who made it

Released by Deepratna Awale

Author and maintainer of this release: the Metal renderer, shader translation, SceneScript, audio, Workshop and the logo redesign. github.com/deepratna-awale

Based on Open Wallpaper Engine

The open-source Open Wallpaper Engine by MrWindDog and Haren Chen, licensed under GPL-3.0.

Logo

Original logo design by Klaus Zhu. Logo redesign by Deepratna Awale.

Contributors

1ris_W (Chinese translation) and everyone listed in AUTHORS.md.