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.