WallpaperMachine README

The project's README from github.com/MMFoundation/WallpaperMachine. As one markdown file: README.md.

English · 简体中文

A Mac desktop cycling through six live wallpapers played by WallpaperMachine: Chisaki over rippling water, Lucy on the Moon, a Red Bull F1 car in the snow, Firefly at dusk, Ellen at a rainy bus stop and Into The Abyss, under the macOS menu bar and Dock.

Wallpaper Engine wallpapers, now on macOS.

A free, open-source Mac app that plays Wallpaper Engine scene, video and web wallpapers
on your desktop, straight from the Steam Workshop. For anyone who wanted Wallpaper Engine on a Mac.

Latest version Build and release status License: GPL-2.0 macOS 15 or later on Apple silicon GitHub stars

Download for Mac, free   Try the live demo in your browser

macOS 15 Sequoia or later · Apple silicon (M1 or later) · Release notes and checksums

Quick start ·  The app ·  Why trust it ·  FAQ ·  Build it ·  Guides ·  Documentation ·  Sponsor

WallpaperMachine’s window on the Installed tab: filters for collections, type, age rating and tags on the left, a grid of Steam Workshop wallpapers in the middle, and the selected wallpaper’s preview, compatibility check and options in the inspector on the right.

Filters on the left, your library in the middle, the selected wallpaper’s options on the right. Press play and it becomes your desktop.

If WallpaperMachine earns a place on your desktop, a ⭐ helps other Mac users discover it.

Quick start

  1. Download the free disk image for the latest version.
  2. Install: open it and drag WallpaperMachine to Applications.
  3. Open it. The download isn't notarized yet, so macOS holds the first launch: click Open Anyway in System Settings → Privacy & Security, once.

A first-run guide takes it from there, and the app updates itself from then on. The install guide walks through every step with pictures.

Rather build it yourself? It takes two commands: see Open source. Free to build.

The app

One window, four tabs: Discover, pixiv, Installed and Settings. The website runs that same interface on a demo library, so you can try it in your browser. Close the window and the app keeps running in the menu bar, where you can pause, resume or go to the previous or next wallpaper.

Feature What it does
Apply Scene, video or web: press play and it becomes your desktop. Choosing a wallpaper only selects it.
Preview Try an installed scene, video or web wallpaper in its own window, with the current options and separate playback controls, before changing the desktop.
Workshop The live Steam Workshop, no sign-in to browse, with collections, each author's wallpapers and your subscriptions. Downloads run in the app, several at once, with a Steam account that owns Wallpaper Engine. Updates to the wallpapers you have are found once a day and installed in one click.
pixiv pixiv's illustration rankings and tag search. Save any page of a work as a still wallpaper; sign in to pixiv for members-only works and, if your account allows them, R-18.
Settings Every option its artist made, saved when you apply your changes; named property presets keep several versions and can be exported or imported.
Music Turn on Audio response and wallpapers made for sound move with what your Mac plays. Turn on Media integration and ones with a music display show the song that's on.
Playlists Let each display rotate through all wallpapers, favorites, its own list or a local collection. Reorder a list, save named playback plans, or switch between a day and a night wallpaper. Failed applications are skipped temporarily.
Displays Every display gets its own wallpaper, or mirrors another, with its own scaling, frame rate and volume. Copy or swap wallpapers and save multi-display arrangements to restore their wallpaper choices from Settings or Shortcuts.
Battery On battery, keep running, drop to a render scale and frame rate you choose, or pause. One choice, off until you pick it. The rest of playback and quality is on Performance.
Energy Settings → Performance shows the power the app draws and, on a laptop, its share of a full charge per hour. Change a setting there and it compares before and after. Each installed wallpaper gets its own rating once it has been measured.
Native Light, dark and your accent colour, like the rest of macOS, in English, 简体中文, 繁體中文 or 日本語.
Import Bring the Wallpaper Engine folders you already have, or your own videos and pictures. Drop them on the Dock icon or use Import; the app copies them and leaves the originals alone.
Keep your setup Export settings and retained files, optionally the whole wallpaper library; preview conflicts before a recoverable restore at the next launch. Sign-ins and passwords stay on this Mac.
Picture placement Drag, position and zoom imported pictures and saved pixiv pages separately for each display, without changing the original image.
Out of sight, paused A covered display stops its own wallpaper, and sleep or lock pauses them all. Playback rules can also pause or mute them while another app plays sound, while an app you choose is running or in front, in Low Power Mode, when the Mac runs hot, or during a Focus. Your own pause stays yours.
Automation Weekday and time schedules, local sunrise/sunset calculations, light/dark appearance choices, experimental desktop Space choices, and temporary Focus wallpapers or playlists. Keyboard shortcuts, Shortcuts, Siri, Spotlight and links can control playback and apply wallpapers, saved playlists or property presets.
Lock screen Video and scene wallpapers can animate the lock screen too. Experimental and off by default.
Screen saver Use each display’s applied scene, video, web or still wallpaper as its screen saver. Independent of lock-screen animation; experimental on macOS 26+.

Why you can trust it

Rust core · Metal graphics

Layer What it does
Swift shell The AppKit app. Its control panel is HTML in WKWebView (WebUI/), and web wallpapers run in web views of their own.
Rust core The vendored renderer (upstream/renderer): displays, wallpaper windows, video decode and audio capture, bridged to Swift with uniffi.
C++ scene engine Open Wallpaper Engine, statically linked into the Rust core, draws scene wallpapers.
Metal, via MoltenVK Scenes render through Vulkan on Metal. A native Metal scene renderer and AVFoundation video are opt-in under Settings → Performance.
Lock screen A sandboxed ExtensionKit extension (Extension/).

How the pieces talk to each other: docs/architecture.md. Where each file lives: docs/repository-layout.md.

Good to know.

A few things before your change of scenery.

What is WallpaperMachine?

WallpaperMachine is a native macOS client for Wallpaper Engine wallpapers. It brings scene, video and web wallpapers to your desktop, with Steam Workshop browsing and downloads built in.

Can I use Wallpaper Engine on a Mac?

Wallpaper Engine itself is made for Windows. WallpaperMachine is an independent Mac app built to play its scene, video and web wallpapers, with Steam Workshop browsing built in; compatibility varies by wallpaper. It is not affiliated with Wallpaper Engine or Valve. More in Wallpaper Engine on a Mac.

Do I need to own Wallpaper Engine?

You can browse the Workshop without signing in. Workshop downloads require a Steam account that owns Wallpaper Engine, and scene wallpapers need shared resources from a purchased Wallpaper Engine installation. The bundled video wallpaper, Aurora Drift, plays without either. More in Workshop browsing and downloads.

Which Macs is it built for?

Macs with Apple silicon (M1 or later) running macOS 15 Sequoia or later. The animated lock screen needs macOS 26 Tahoe or later. Intel Macs aren't supported.

Will every wallpaper work?

WallpaperMachine supports scene, video and web rendering. Compatibility varies by wallpaper; support for these formats does not mean every Workshop item will render identically, and Application wallpapers don't run. If one looks wrong, Not working? Report on GitHub in its details opens a new GitHub issue with that wallpaper's information filled in, for you to check and send. To attach logs, export a diagnostics report from Settings → Storage → Troubleshooting. Home folder paths, your Mac user name and Steam account names are replaced first.

How do I get it?

Download the signed build free from the latest release, or build it from the source. The build is not notarized, so macOS holds its first launch until you click Open Anyway in System Settings → Privacy & Security. The install guide walks through it, from the download to the first-run guide. From then on the app checks for new versions itself and, where it can replace its own copy, offers Restart to Update.

Is WallpaperMachine really free?

Yes. The signed download is free, and the complete source is here if you would rather build it yourself. Becoming a Supporter adds a sponsor place on the website and in this README, plus priority support. It buys no license: the app is the same with or without it. What it includes and how to become one: SPONSORS.md.

Where do I ask a question or suggest a feature?

Questions go to Discussions, and ideas to a feature request. For a wallpaper that looks wrong, use Not working? Report on GitHub in its details. Security problems are reported privately: see SECURITY.md.

Open source. Free to build.

The complete source is here. It builds on a Mac with Apple silicon, Xcode 26 (macOS 15.6 or later), a full Xcode selected with xcode-select and the Homebrew packages listed under Prerequisites; the renderer and scene engine are vendored under upstream/, not pulled in as submodules.

python3 scripts/install_ffmpeg.py                  # the project's LGPL FFmpeg build
python3 scripts/build.py --configuration Release   # renderer, bindings, Xcode project, app

The app lands in build/Build/Products/Release/WallpaperMachine.app. python3 scripts/test.py runs the tests, and python3 scripts/package.py --configuration Release --install makes the bundle self-contained, wraps it in a disk image and copies it to ~/Applications. Scene wallpapers also need shared resources from a Wallpaper Engine you own.

Toolchain, packaging and troubleshooting: docs/build.md. Working on the code: CONTRIBUTING.md.

Documentation

Document Purpose
docs/README.md Index of every document, features included
docs/architecture.md Runtime structure and module boundaries
docs/repository-layout.md Directory map and where new code goes
CONTRIBUTING.md Contributor working agreement
CODE_OF_CONDUCT.md How we treat each other in issues, discussions and reviews
SECURITY.md How to report a vulnerability privately
docs/testing/README.md Test strategy, commands, evidence policy
docs/release.md Versioning, release notes and the CI release pipeline
CHANGELOG.md What changed in each published version
LICENSING.md License policy, Supporter model and distribution status
SPONSORS.md Supporter pricing, what it includes and other ways to help
AGENTS.md Rules for agents working in this repository

Thank you. To every Supporter.

Supporters who choose to be shown are listed here and on the sponsor wall. Supporter is a one-time purchase for a sponsor place and priority support; the app and its source stay free for everyone. If WallpaperMachine has earned a place on your desktop, become a Supporter.

WallpaperMachine Supporters: xwei12. 1 Supporter on the wall. 1 more supports privately.

License

The source is offered under the GNU General Public License, version 2 only (LICENSE). The vendored renderer is GPL-2.0-only and the app shell is derived from it; upstream code keeps its own copyright and license notices, recorded in upstream/provenance.json. Every recipient keeps every right the GPL grants, whether or not they are a Supporter.

No binary is cleared for distribution yet. Apache-2.0 components (MoltenVK, the Vulkan loader, SPIRV-Tools, parts of glslang and the vendored spirv_reflect) are in every build's link closure and are not compatible with GPLv2. LICENSING.md records the policy, the Supporter model, each component's license, the open blockers and what would resolve them. Workshop wallpapers belong to their creators, and scene resources come from a Wallpaper Engine you own; the app bundles neither.


WallpaperMachine app icon

A new view.
Now on your Mac.

Made for a more personal Mac.
An independent project. Not affiliated with Wallpaper Engine or Valve.
Wallpapers shown: 千咲 · 不散的春之花 and 流萤 · 仲夏萤火之约 by 夜莺Night, Cyberpunk: Edgerunner-Lucy by 凉粥, RedBull F1 2026 by a bad driver, 绝区零 · 艾莲乔 by BIGDEECK and Into The Abyss by Blloopy. All artwork rights remain with their owners.

WallpaperMachine (MMFoundation/WallpaperMachine)

Searching Database…

Что это?WallpaperMachine — бесплатное приложение для Mac с открытым кодом, которое воспроизводит на вашем рабочем столе сценовые, видео- и веб-обои Wallpaper Engine, скачанные прямо из Steam Workshop.
Здесь запускается сам Wallpaper Engine или это что-то другое?Это независимый нативный клиент для macOS, а не порт самого Wallpaper Engine: воспроизведение реализовано заново на собственном рендер-ядре на Rust и статически слинкованном сценовом движке Open Wallpaper Engine, с рендером через Vulkan-on-Metal посредством MoltenVK.
Нужно ли владеть Wallpaper Engine или иметь аккаунт Steam?Просматривать Workshop и смотреть встроенные видео-обои можно вообще без аккаунта, а вот для скачивания предметов Workshop и сценовых обоев нужен аккаунт Steam, которому принадлежит сам Wallpaper Engine.
Будут ли работать все обои из Workshop, и на любом ли Mac это запустится?Работает только на Mac с Apple silicon и macOS 15 или новее — Mac на Intel не поддерживаются; совместимость зависит от обоев, а предметы Workshop типа Application не запускаются вовсе.
Приложение отслеживает или куда-то отправляет мои данные?В сеть оно выходит только для того, что вы просите: Steam для Workshop, pixiv при его открытии и GitHub для проверки обновлений; аналитики и слежки нет, а данные входа и пароли остаются на вашем Mac.
Это правда бесплатно, и что говорит лицензия?Всё приложение, его Rust-рендерер и сценовый движок открыты под GPL-2.0 — без закрытого ядра и платных функций; разовая покупка Supporter добавляет лишь упоминание спонсора и приоритетную поддержку, а не другую версию приложения.
Что можно делать без Wallpaper Engine и входа в Steam?Можно просматривать весь Workshop, смотреть встроенные видео-обои Aurora Drift, ставить иллюстрации pixiv как статичные обои и импортировать собственные видео и картинки — всё это без аккаунта.
Поддерживаются ли несколько дисплеев независимо?Да — каждому дисплею можно назначить свои обои или зеркало другого, со своим масштабированием, частотой кадров и громкостью, а целые раскладки на несколько дисплеев можно сохранять и восстанавливать.
Могут ли обои реагировать на музыку или состояние системы?Аудиореакция заставляет совместимые обои двигаться под то, что играет ваш Mac, интеграция Media показывает текущий трек, а правила воспроизведения могут ставить авто-паузу, когда дисплей перекрыт, Mac спит, перегревается или включён режим Focus.
Как убедиться, что скачанная сборка подлинная?Каждый релиз собирается GitHub Actions из тегированного коммита и публикуется с контрольной суммой SHA-256 и подтверждением происхождения сборки, а встроенный обновлятор отказывается устанавливать любой образ диска с несовпадающей контрольной суммой.
Size
31.5 MB
Stars
1K
Age
1mo
Commits · 90 Days