[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82842":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":9,"rankLanguage":9,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":15,"starSnapshotCount":15,"syncStatus":18,"lastSyncTime":28,"discoverSource":29},82842,"workshop-wallpaper-bridge","3x-haust\u002Fworkshop-wallpaper-bridge","3x-haust","Local-only macOS bridge for personally copied Wallpaper Engine Workshop wallpapers",null,"Swift",181,9,118,1,0,10,35,2,51.5,"MIT License",false,"main",true,[],"2026-06-12 04:01:39","# Workshop Wallpaper Bridge\n\n[![Swift](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSwift-6-orange.svg)](Package.swift)\n[![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-macOS%2014%2B-lightgrey.svg)](README.md)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue.svg)](LICENSE)\n\nUse local Wallpaper Engine Workshop files on macOS.\n\nWorkshop Wallpaper Bridge imports a copied Wallpaper Engine Workshop folder into a private Mac library and plays supported wallpapers on the desktop layer. It is built for files you already have locally. It does not talk to Steam, download Workshop items, or modify the copied Workshop folder.\n\n[Website](https:\u002F\u002F3x-haust.github.io\u002Fworkshop-wallpaper-bridge\u002F) · [한국어](README.ko.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [Releases](https:\u002F\u002Fgithub.com\u002F3x-haust\u002Fworkshop-wallpaper-bridge\u002Freleases)\n\n## Demo\n\n![Workshop Wallpaper Bridge demo](assets\u002Fworkshop-wallpaper-bridge-demo.gif)\n\n## Download\n\nDownload the latest `WorkshopWallpaperBridge-macOS-arm64.dmg` from [Releases](https:\u002F\u002Fgithub.com\u002F3x-haust\u002Fworkshop-wallpaper-bridge\u002Freleases).\n\n1. Open the DMG.\n2. Drag **Workshop Wallpaper Bridge.app** to **Applications**.\n3. Open the app. It runs as a menu bar utility, not a Dock app.\n\nmacOS may warn that the app is from an unidentified developer if the release is not notarized yet. You can still build from source with Swift.\n\n## Use It\n\nFor Wallpaper Engine projects:\n\n1. On Windows, locate the Workshop folder:\n\n   ```text\n   C:\\Program Files (x86)\\Steam\\steamapps\\workshop\\content\\431960\n   ```\n\n2. Copy the `431960` folder to your Mac.\n3. Open **Workshop Wallpaper Bridge Settings** from the menu bar icon.\n4. Click **Browse**, choose the copied `431960` folder, then click **Scan**.\n5. Select a supported item and click **Import Selected**.\n6. Click **Play on Desktop**.\n\nFor your own videos, click **Add Video File** instead of scanning a Workshop folder.\n\nDisplay modes:\n\n- **Fit** keeps the full wallpaper visible.\n- **Fill** covers the screen and may crop edges.\n- **Stretch** fills the screen exactly and may distort the image.\n\nPlayback notes:\n\n- **Auto-pause behind apps** is enabled by default.\n- Closing the settings window does not stop playback.\n- **Open at Login** restores the last played wallpaper after login.\n- **Remove** deletes the imported Mac-library copy only. It does not touch the original copied folder or video.\n\nImported files are stored in:\n\n```text\n~\u002FLibrary\u002FApplication Support\u002FWorkshopWallpaperBridge\n```\n\n## What Works\n\n| Project type | Support |\n| --- | --- |\n| `.mp4`, `.mov`, `.m4v` video | Plays directly |\n| `.webm`, `.mkv`, `.avi` video | Converts locally with `ffmpeg`, then plays |\n| `index.html` web wallpaper | Plays in a restricted local WebView |\n| `.jpg`, `.png`, `.gif`, `.heic` image | Displays as a static desktop layer |\n| `scene.pkg` scene wallpaper | Renders packed 2D image layers and basic keyframed motion |\n\nScene support is conservative. Basic image-layer scenes work, including packed `.tex` textures, LZ4 blocks, common DXT formats, and keyframed position, scale, rotation, and opacity. Particles, audio-reactive scripts, custom shaders, text layers, media integration, and video\u002FGIF texture animation may be skipped or look different from Wallpaper Engine.\n\nWorkshop preview files such as `preview.jpg`, `thumbnail.jpg`, and `cover.png` are treated as thumbnails. If a project contains `scene.pkg`, the app reads the packed scene data instead of stretching a low-resolution preview across the screen.\n\n## Screen Saver\n\nTurn on **Animate Screen Saver** to install and select the bundled macOS screen saver for the current Mac host.\n\nWhat animates in the screen saver:\n\n- MP4, MOV, and M4V wallpapers from the Mac library.\n- Local videos added with **Add Video File**.\n\nWhat uses a still fallback:\n\n- WebM, MKV, and AVI before conversion.\n- Web wallpapers.\n- Scene wallpapers.\n\nmacOS still controls when the screen saver starts. Configure the start time and password timing in System Settings > Lock Screen. Until macOS starts the selected screen saver, the normal static Lock Screen wallpaper is shown.\n\nThe app can also set a still desktop wallpaper with **Set Still Wallpaper**. For MP4, MOV, and M4V files, it extracts a frame from the video instead of using a small Workshop preview.\n\n## Build From Source\n\nRequirements:\n\n- macOS 14 or newer\n- Xcode command line tools\n- Swift 6 toolchain\n- Optional: `ffmpeg` for WebM, MKV, and AVI conversion\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002F3x-haust\u002Fworkshop-wallpaper-bridge.git\ncd workshop-wallpaper-bridge\nswift run WorkshopWallpaperBridge\n```\n\nBuild a local app bundle and DMG:\n\n```bash\nbash Scripts\u002Fpackage-app.sh\nopen \"dist\u002FWorkshop Wallpaper Bridge.app\"\n```\n\nThe script writes:\n\n```text\ndist\u002FWorkshopWallpaperBridge-macOS-arm64.dmg\n```\n\nInstall `ffmpeg`:\n\n```bash\nbrew install ffmpeg\n```\n\n## CLI\n\n`wwbctl` is included for scanning, importing, conversion, and scene diagnostics:\n\n```bash\nswift run wwbctl scan \"\u002Fpath\u002Fto\u002F431960\" --out index.json\nswift run wwbctl import \"\u002Fpath\u002Fto\u002F431960\"\nswift run wwbctl import-video \"\u002Fpath\u002Fto\u002Fvideo.mp4\"\nswift run wwbctl remove \"\u003Casset-id>\"\nswift run wwbctl convert input.webm --out output.mp4\nswift run wwbctl scene-info \"\u002Fpath\u002Fto\u002Fscene.pkg\"\nswift run wwbctl scene-render-info \"\u002Fpath\u002Fto\u002Fscene.pkg\"\nswift run wwbctl doctor\n```\n\nFor signed public releases, set `SIGN_IDENTITY`, `NOTARY_PROFILE`, and `REQUIRE_SIGNING=1` before running `Scripts\u002Fpackage-app.sh`.\n\n## Troubleshooting\n\nNothing appears on the desktop:\n\n- Check that the imported item is marked `playable`.\n- Press **Stop**, then **Play on Desktop** again.\n- Temporarily turn off **Auto-pause behind apps**.\n- Make sure you are viewing the desktop, not a full-screen app Space.\n\nThe wallpaper looks blurry or cropped:\n\n- Use **Fit** to keep the full image or video visible.\n- Use **Fill** to cover the screen and accept edge cropping.\n- For `scene.pkg` items, check whether the scene uses unsupported particles, scripts, shaders, or animated textures.\n\nWebM, MKV, or AVI conversion fails:\n\n```bash\nbrew install ffmpeg\n```\n\n**Workshop Wallpaper Bridge** does not appear in Screen Saver settings:\n\n- Open the packaged `.app`, not only `swift run`.\n- Turn on **Animate Screen Saver** once.\n- Check that `~\u002FLibrary\u002FScreen Savers\u002FWorkshop Wallpaper Bridge.saver` exists.\n- Quit and reopen System Settings if the list does not refresh.\n\nThe screen saver preview is black:\n\n- Install the latest release.\n- Toggle **Animate Screen Saver** off and on again.\n- Click **Screen Saver Settings** once so the app reinstalls and reselects the bundled saver.\n\n## Project Boundaries\n\nWorkshop Wallpaper Bridge is local-only.\n\n- It does not download Steam Workshop items.\n- It does not bypass Steam authentication.\n- It does not bypass DRM.\n- It does not emulate Steam protocols.\n- It does not claim full `scene.pkg` runtime compatibility.\n- It does not upload, share, or redistribute creator assets.\n- It does not modify the original copied Workshop folder.\n\nWorkshop Wallpaper Bridge is not affiliated with Valve, Steam, or Wallpaper Engine. Wallpaper Engine is a trademark of its respective owner.\n\n## License\n\nMIT\n","Workshop Wallpaper Bridge 是一个专为 macOS 设计的本地壁纸引擎工作坊文件桥接工具。它允许用户将从 Windows 系统中复制过来的 Wallpaper Engine 工作坊文件夹导入到 Mac 上，并在桌面上播放支持的动态壁纸，包括视频、HTML5 壁纸和静态图片等格式。该工具使用 Swift 语言开发，具有良好的本地集成能力，不依赖 Steam 或者网络下载任何内容。适用于已经拥有 Wallpaper Engine 文件且希望在 macOS 上继续享受这些动态壁纸的用户，特别适合那些经常在不同操作系统之间切换但又不想失去个性化桌面体验的人士。","2026-06-11 04:09:23","CREATED_QUERY"]