Mirage

Native macOS · Wallpaper Engine-compatible runtime

Bring your macOS desktop to life

Scene, web, and video live wallpapers in one native experience. Browse and download Steam Workshop items, span multiple displays, and even install it as a screen saver.

Read the docs Download release

Open source · GPL-3.0 · Intel & Apple Silicon

One app for the whole live-wallpaper workflow

From getting and managing wallpapers to playback and system integration, Mirage ties every step together, natively.

Three wallpaper types

Scene, web, and video wallpapers each play in their own renderer process, isolated from one another.

Wallpaper library

Browse installed items with search, sorting, favorites, and filters by type, source, tag, and content rating.

Import & convert

Import any folder with a project.json, or convert mp4 / mov / m4v videos into local wallpaper packages.

Steam Workshop

Browse trending, newest, popular, and tagged items, detect presets, and let Mirage drive SteamCMD downloads.

Displays & menu bar

Assign wallpapers per display, control playback from the menu bar, and launch at login.

Screen saver

Install video, web, and scene wallpapers as a standalone screen saver that keeps your preset and properties.

Playback control

Adjust volume, speed, fill mode, and a wallpaper’s own custom properties live from the sidebar.

Battery-aware

When apps go fullscreen, audio plays, the display sleeps, or on battery, choose keep, mute, pause, or stop.

Multi-process rendering architecture

Renderers run as separate processes and receive line-delimited JSON over stdin, so a single renderer crash never takes down the main app.

App

Mirage

SwiftUI · AppKit

UI, library, Workshop, settings, process management, and system integration.

Scene

SceneWallpaper

C++20 · Vulkan · MoltenVK

Materials, particles, LUTs, text, and user properties.

Web

WebWallpaper

Objective-C++ · WKWebView

HTML wallpapers, JavaScript, media, and mouse events.

Video

VideoWallpaper

Objective-C++ · AVFoundation

Video looping, volume, speed, and fill mode.

3wallpaper types

4renderer processes

3interface languages

GPL-3.0fully open source

Ready to light up your desktop?

Build from source with the docs, or grab the latest release to get started.

Read the docs GitHub