Workshop Wallpaper Bridge는 macOS 사용자가 로컬에 저장된 Wallpaper Engine Workshop 파일을 바탕화면 배경으로 사용할 수 있도록 설계된 유틸리티입니다. 이 앱은 사용자가 이미 보유한 파일을 기반으로 작동하며, Steam과의 통신, Workshop 아이템 다운로드, 또는 원본 Workshop 폴더의 수정은 일절 수행하지 않습니다.

이 도구의 핵심 방법론은 다음과 같습니다. 사용자는 Windows 환경에서 복사한 Wallpaper Engine Workshop 폴더(예: $C:\Program Files (x86)\Steam\steamapps\workshop\content\431960$)를 macOS로 옮긴 후, Workshop Wallpaper Bridge의 설정에서 해당 폴더를 지정하고 스캔합니다. 스캔 과정을 통해 앱은 지원되는 콘텐츠를 식별하며, 사용자가 선택한 항목은 macOS의 개인 라이브러리 경로인 ~/Library/Application Support/WorkshopWallpaperBridge로 복사됩니다. 이렇게 가져온 파일은 macOS의 desktop layer에 렌더링되어 월페이퍼로 표시됩니다.

지원되는 Project type 및 처리 방식은 다음과 같습니다.

• .mp4, .mov, .m4v 형식의 비디오는 직접 재생됩니다.
• .webm, .mkv, .avi 형식의 비디오는 로컬에 설치된 ffmpeg를 사용하여 지원되는 비디오 형식(예: .mp4)으로 변환된 후 재생됩니다.
• index.html 파일을 포함하는 web wallpaper는 제한된 local WebView 환경 내에서 렌더링됩니다.
• .jpg, .png, .gif, .heic 형식의 이미지는 static desktop layer scene으로 표시됩니다.
• scene.pkg 형식의 scene wallpaper는 패킹된 2D 이미지 레이어와 기본적인 keyframed motion을 렌더링합니다. 이는 LZ4 블록, 일반적인 DXT 형식, 그리고 .tex 텍스처를 포함한 이미지 레이어를 지원하며, 위치, 스케일, 회전, 불투명도에 대한 keyframed animation을 처리합니다. 그러나 particles, audio-reactive scripts, custom shaders, text layers, media integration, 비디오/GIF texture animation과 같은 복잡한 요소는 지원되지 않거나 다르게 보일 수 있습니다. 앱은 preview.jpg, thumbnail.jpg, cover.png와 같은 Workshop preview 파일 대신 scene.pkg 데이터를 우선적으로 사용하여 고품질 렌더링을 시도합니다.

이 앱은 메뉴 바 유틸리티로 작동하며, 바탕화면 재생 모드로 Fit, Fill, Stretch를 제공하여 월페이퍼의 화면 표시 방식을 조절할 수 있습니다. 기본적으로 'Auto-pause behind apps' 기능이 활성화되어 앱이 활성화되면 월페이퍼 재생이 일시 중지됩니다.
추가 기능으로는 Mac 라이브러리에 가져온 월페이퍼로 macOS Screen Saver를 설정하는 Animate Screen Saver 기능과, 비디오 파일에서 프레임을 추출하여 정지 이미지 바탕화면으로 설정하는 Set Still Wallpaper 기능이 있습니다. Screen Saver의 경우, .mp4, .mov, .m4v 비디오는 애니메이션으로 재생되지만, web wallpaper나 scene wallpaper는 정지 이미지로 대체됩니다.

소스 코드 빌드를 위해서는 macOS 14 이상, Xcode command line tools, Swift 6 toolchain이 필요하며, ffmpeg는 .webm, .mkv, .avi 변환을 위해 선택적으로 설치할 수 있습니다. wwbctl이라는 command line interface(CLI) 도구가 포함되어 있어 스캔, 가져오기, 변환, scene diagnostics 등의 작업을 터미널에서 수행할 수 있습니다.

Workshop Wallpaper Bridge는 오직 로컬 파일에만 국한되며, Steam Workshop 아이템을 다운로드하거나, Steam 인증을 우회하거나, DRM을 우회하거나, Steam protocols을 에뮬레이션하지 않습니다. 또한 scene.pkg에 대한 완전한 런타임 호환성을 주장하지 않으며, 크리에이터 자산을 업로드, 공유 또는 재배포하지 않고, 원본 복사된 Workshop 폴더를 수정하지 않습니다. Valve, Steam, Wallpaper Engine과는 어떠한 제휴 관계도 없습니다. 라이선스는 MIT입니다.