3x-haust

3x-haust / workshop-wallpaper-bridge

Public

Local-only macOS bridge for personally copied Wallpaper Engine Workshop wallpapers

80
3
89% credibility
Found Jun 01, 2026 at 80 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

Workshop Wallpaper Bridge is a menu bar utility for macOS that lets people who already own Wallpaper Engine on Windows use their existing wallpaper collection on a Mac. After copying the Workshop folder from Windows, users point the app to it, and it automatically finds all supported wallpapers—videos, images, and web animations. The app plays these wallpapers on the desktop layer, with smart auto-pause when other apps cover the screen. It respects copyright by only working with files users already have legal access to, and it never downloads or redistributes anything.

How It Works

1
💾 You already use Wallpaper Engine on Windows

You've collected amazing animated wallpapers from the Steam Workshop over the years.

2
📦 You copy your Workshop folder to your Mac

You take the folder where Wallpaper Engine stores all your wallpapers and move it to your Mac.

3
🖥️ You open the app from your menu bar

The app lives quietly in your menu bar without cluttering your Dock, ready whenever you need it.

4
🔍 You point the app to your wallpapers and it finds them

You tell the app where your wallpapers are, and it automatically discovers all the videos, images, and web animations it can use.

5
✨ You pick a wallpaper and play it on your desktop

You choose from your imported collection and click Play. Your wallpaper comes to life on the desktop layer.

6
Your wallpaper adapts to how you work
⏸️
Auto-pauses when you're working

When another app covers your screen, your wallpaper gently pauses to save resources.

📺
Fits your screen perfectly

You can choose how your wallpaper fills your display—keeping it all visible, covering the whole screen, or stretching to fit.

🌟 Your Windows wallpapers now live on your Mac

Enjoy your animated desktop while the app runs quietly in the background, handling everything smoothly.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 80 to 80 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is workshop-wallpaper-bridge?

Workshop Wallpaper Bridge is a menu bar utility that brings Wallpaper Engine Workshop wallpapers to macOS without Steam. You copy your existing Workshop folder from Windows, point the app at it, and it scans for supported wallpapers, imports them to a local Mac library, and renders them on the desktop layer. It plays video, web, and image wallpapers directly, converting unsupported formats like WebM or MKV via ffmpeg if you have it installed. The app stays in the menu bar, pauses playback when other apps cover the desktop, and survives sleep/wake cycles.

Why is it gaining traction?

This solves a real pain point for Mac users who already bought Wallpaper Engine on Windows and want to keep using their library. The workflow is straightforward: copy the Workshop folder, scan it, import what you want, and play. The app is honest about what it cannot do, explicitly stating it does not download items, bypass DRM, or unpack proprietary scene packages. A CLI tool called wwbctl exposes scan, import, convert, and doctor commands for automation or testing.

Who should use this?

Mac users who already own Wallpaper Engine on Windows and have copied their Workshop folder locally. Developers comfortable with the command line will appreciate wwbctl for batch operations. Anyone who wants animated desktop wallpapers without running Steam or emulation software.

Verdict

For the right audience, this is a well-crafted tool that does exactly what it promises. The codebase is tested and uses modern Swift with SwiftUI for the UI. At 80 stars, credibility sits at 0.9%, reflecting the project is small and relatively new. Docs are clear enough to get started quickly. Try the prebuilt release if your Mac runs macOS 14 or later and you already have wallpapers copied locally.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.