mirror of
https://github.com/ParrotXray/mac-wallpaperengine.git
synced 2026-08-23 15:30:28 +09:00
* feat: add auto-update check against GitHub Releases * fix: Pause/Resume menu item not updating after click * fix: resolve UUID collision for UpdateService.swift in project file
Open Wallpaper Engine
A macOS app that displays wallpapers from the Steam Workshop.
Not affiliated with the commercial Wallpaper Engine on Steam.
Supported Wallpaper Types
| Type | Status |
|---|---|
| Video (.mp4, .webm) | ✅ |
| Web (HTML/WebGL) | ✅ |
| Scene (static) | ✅ |
| Scene (particles) | ⚠️ Partial |
| Scene (DXT textures) | ⚠️ Preview only |
| Application | ❌ |
Build from Source
Requirements: macOS 13.0+, Xcode 14.4+
git clone https://github.com/parrotxray/mac-wallpaperengine
cd mac-wallpaperengine
open "Open Wallpaper Engine.xcodeproj"
In Xcode, set signing to your own certificate or "Sign to Run Locally", then press Cmd + R.
Usage
Import Wallpapers
- Folder: File > Import from Folder
- Zip: File > Import or drag-and-drop a
.zipfile - Manual: Copy wallpaper folders into
~/Documents/Open Wallpaper Engine/
Steam Workshop
- Install steamcmd:
brew install steamcmd - Open the Workshop tab and log in with your Steam account (must own Wallpaper Engine)
- Enter a Steam Web API key when prompted
- Search and download wallpapers directly
Credits
- MrWindDog — Upstream fork maintainer
- Haren Chen — Original app creator
- 1ris_W — Chinese i18n
- Klaus Zhu — App icon
- Chen Chia Yang — Scene rendering, Workshop integration, multi-display support
Licensed under GPL-3.0.
Languages
Swift
99.8%
Objective-C
0.2%