Workshop Wallpaper Bridge is a macOS utility designed to enable the use of local Wallpaper Engine Workshop files on a Mac desktop. It operates by importing a user-provided, copied Wallpaper Engine Workshop folder into a private macOS library, specifically located at ~/Library/Application Support/WorkshopWallpaperBridge, and subsequently playing supported wallpapers as a desktop layer. The application is built for pre-existing local files, expressly stating it does not communicate with Steam, download Workshop items, bypass Steam authentication or DRM, emulate Steam protocols, upload or redistribute creator assets, or modify the original copied Workshop folder.

The core methodology involves the user copying the 431960 folder from their Windows Wallpaper Engine installation (typically $C:\Program Files (x86)\Steam\steamapps\workshop\content\431960$) to their Mac. Within the application's menu bar interface, the user navigates to Settings, browses to the copied 431960 folder, and initiates a "Scan." After scanning, supported items can be selected and imported into the Mac library. Playback is then initiated via "Play on Desktop." The application also supports directly adding user's own video files.

Supported content types and their handling mechanisms are as follows:

• .mp4, .mov, and .m4v video files are played directly.
• .webm, .mkv, and .avi video files are converted locally using ffmpeg (an optional dependency) before playback.
• index.html web wallpapers are rendered within a restricted local WebView.
• .jpg, .png, .gif, and .heic image files are displayed as static desktop layers.
• scene.pkg scene wallpapers are rendered, supporting packed 2D image layers and basic keyframed motion. This includes parsing packed .tex textures, LZ4 blocks, common DXT formats, and keyframed properties such as position, scale, rotation, and opacity. However, full compatibility is not claimed; particles, audio-reactive scripts, custom shaders, text layers, media integration, and video/GIF texture animation within scene.pkg files may be skipped or rendered differently from Wallpaper Engine. The application prioritizes scene.pkg data over low-resolution preview images like preview.jpg, thumbnail.jpg, or cover.png.

The utility includes functionality for a macOS screen saver. Enabling "Animate Screen Saver" installs and selects a bundled screen saver. Animated wallpapers in the screen saver include imported MP4, MOV, and M4V files, as well as local videos added by the user. Other formats (WebM, MKV, AVI before conversion, web wallpapers, and scene wallpapers) fall back to a still image. The application can also set a still desktop wallpaper, extracting a frame from video files for this purpose.

Building from source requires macOS 14+, Xcode command line tools, and a Swift 6 toolchain. ffmpeg is optional for .webm, .mkv, and .avi conversion. The source can be cloned from GitHub, and a local app bundle and DMG can be built using the Scripts/package-app.sh script. A command-line interface tool, wwbctl, is included for scanning, importing, conversion, and scene diagnostics, with commands such as wwbctl scan, wwbctl import, wwbctl import-video, wwbctl remove, wwbctl convert, wwbctl scene-info, wwbctl scene-render-info, and wwbctl doctor. Troubleshooting notes address common issues like wallpapers not appearing (checking playability, auto-pause settings, desktop view), blurry/cropped visuals (display modes, scene limitations), conversion failures (ffmpeg installation), and screen saver setup issues. The project explicitly states it is not affiliated with Valve, Steam, or Wallpaper Engine.