Mural app icon
Help

Everything,
explained

Everything you need to get started and make the most of Mural.

Overview

Mural is a next-generation dynamic wallpaper app for Mac. It lets you set any video or image as your desktop wallpaper, then layer real-time color effects, live widgets, animated text, and atmospheric audio on top — all designed from a single creative workspace called the Lab.

Video wallpapers, Lab effects, Themes, and all creative tools work right out of the box, with no additional setup.

Requirements

Getting Started

1. Install Mural

Download and install Mural from the Mac App Store.

2. Set Your First Wallpaper

From the Home tab, click Import to load any video or image from your Mac — or drag a file straight onto the window. It becomes your live desktop wallpaper right away.

You can also browse the built-in Themes library — hand-crafted cinematic wallpapers each paired with a matching atmosphere soundtrack — and apply them with a single click.

Themes

The Themes library contains curated cinematic wallpapers, each crafted with a matching atmosphere soundtrack. Hover over the center card to preview it with sound, then click Apply to set it.

Freeze, Loop & History

After importing a video, the Home tab gives you precise editorial control.

Freeze Frame

Scrub the filmstrip to find any perfect still frame and lock onto it. Use the left/right arrow keys for single-frame stepping.

A-B Loop

Set an in-point and out-point to loop a specific segment of the video with frame-accurate precision.

History

Every wallpaper state you've applied is automatically saved as a history entry — complete with the exact Lab effects, Freeze frame position, or Loop range active at that moment. Each entry stores a thumbnail for quick recognition. Tap any entry to restore it exactly as it was. History is preserved across restarts.

Lab — Grading

Professional color control over any wallpaper.

All adjustments are previewed live in the Lab window. Click Apply to push changes to your desktop.

Lab — Widgets

Add live elements directly on top of your wallpaper.

Clocks

Choose from three styles — Digital, Flip, and Analog — each with multiple sub-variants. Every color element is fully customizable. Toggle 12/24-hour format. Freely drag, resize, and rotate any clock on the canvas.

Weather & Atmosphere

Overlay real-time particle effects: Rain, Snow, Lightning, or Fog. Enable Nature Mode for an automatic weather cycle that shifts throughout the day without manual input. Each weather effect is linked to the Ambience audio system — its corresponding environmental SFX plays automatically and can be mixed independently alongside your music track.

Companion

A 3D companion character whose species, colors, personality, and outfit are one of a kind and tied to your Mac for life. No other Mac has the same one. It carries an umbrella in rain and reacts to lightning strikes.

M-CORE

A system monitor capsule showing live CPU and RAM usage directly on your desktop.

Custom Media

Import your own images, GIFs, or video clips as floating overlay widgets — with the Import button, or by dragging them straight into the Lab preview, where they land right where you drop them. The same file can be added more than once, and each item has its own opacity: drag the percentage in the list, or click it for a slider. Transparent backgrounds are fully supported — PNG images with alpha channels and videos with transparency composite directly over the wallpaper, making it easy to blend custom elements with the underlying scene. Multiple custom media widgets can be on screen simultaneously. Each video widget has its own independent volume fader.

Motion presets: Give any custom media object a life of its own — Float, Breathe, Sway, Spin, Spin CCW, Bounce, or Strobe — each available at three speeds. Motion is rendered identically everywhere it appears: the Lab preview, the home preview, your desktop, and the dynamic lock screen.

All widgets support free positioning, scaling, rotation, and a nine-position grid for quick snapping to common screen locations. As you drag, objects snap to the center lines with guides; hold ⌘ for fine, unsnapped moves. Front-to-back order is set in Layers — see Lab — Layers below.

Lab — Mantra

A typographic overlay engine that places animated text directly on your desktop.

Six animated 3D engines

Each engine has its own motion parameters (speed, distortion, repeat) and full RGB color control.

Serendipity

Words, met by chance. Serendipity brings a fresh line to your desktop on the interval you set, written in your language — or switch to English Style anytime.

Custom Text

Write your own words across multiple independent lines. Each line keeps its own typography, background, and shadow, along with a kinetic motion of its own — Float, Prism, Holo, Focus, Pulse, Glitch, or Neon — and can be freely positioned on the canvas. The list runs front to back, with new text added at the top — drag lines to reorder them, and set each line's opacity right in the list.

Lab — Ambience

Layer atmospheric audio over any wallpaper, from curated soundscapes to your own music library.

Built-in Presets

A library of curated ambient soundscapes — ready to apply in one tap directly from the Lab.

Custom Playlist

Import your own audio files and build a personal playlist inside the Lab. Arrange tracks in any order, then choose from four playback modes: sequential, list loop, single track loop, or shuffle. Full playback controls include play/pause, skip, and seek.

Weather Audio Linkage

The Ambience system is linked to the Widget weather layer. When a weather effect (Rain, Snow, Lightning, Fog) is active, its environmental SFX plays alongside your music — each running through a separate audio channel so they can be mixed independently without interfering with each other.

Lab — Layers (For Mural 4.0.0 and later)

One order for everything on your wallpaper.

Open Layers in the Lab preview to see everything as a single stack, front to back: Custom Media, Your Mantras, Serendipity, Kinetic Styles, Desktop Clock, Companion, M-CORE and Atmosphere. Drag any row up or down to decide what covers what.

Groups

Custom Media and Your Mantras each form a group. Drag a group to move everything in it, or drag a single item out to place it anywhere in the stack — and back in again. Dropping another layer inside a group splits it at that point.

On the Canvas

Right-click an object, or use the arrows on its edit frame, to bring it forward or send it backward one step. It swaps with the nearest layer it overlaps.

Colors

Each part has its own color in the panel, and anything not in use is shown in gray.

The order you set is the order you get — in the Lab preview, the home preview, your desktop, still wallpapers and the dynamic lock screen.

Personalization

A few more ways to make Mural feel like yours, outside the Lab.

Audio Console

All audio in Mural is routed through a four-track mixing console, accessible in Settings.

Each track has an independent volume fader. A global Master bus controls the overall output level. Individual video widgets also carry their own per-widget volume control within the Widgets panel.

Menu Bar Color

Tint your menu bar to match your style, available in Settings. By default, Mural adapts the color automatically. Turn on manual mode to pick from nine preset colors or the full color wheel — Mural remembers the last color you picked.

Solid Color Wallpapers

Set a flat color as your wallpaper instead of a video or image. Choose from 20 preset colors across four palettes — Neutrals, Cool, Purple, and Warm — or pick any color with the built-in color wheel and save it to your own My Colors library for later. Turn on Shuffle to automatically rotate through a palette in order or at random, on an interval you set.

Apply & Dynamic Lock Screen Sync

Apply

Pushes all current Lab settings — Grading, Widgets, Mantra, Ambience — from the preview window to your live desktop. What you see in the Lab preview is exactly what will appear.

Undo & Reset

Reset restores the current page to what you last applied. Right after you apply, the button turns into Undo, which takes your desktop back to the previous version — apply again to compare the two. ⌘Z and ⇧⌘Z undo and redo any change in the Lab, step by step.

Dynamic Lock Screen (For Mural 3.1.0 and later)

In the Dynamic Lock Screen tab, choose what your lock screen shows:

Using an earlier version of Mural? Update it from the Mac App Store first.

Mural EngineMural Engine Setup (Optional · for Mural 3.1.0 and later)

To sync your dynamic wallpaper to the lock screen, install Mural Engine once. Mural opens it automatically whenever it's needed.

  1. Download Mural Engine from muralflow.com/mural-engine
  2. Move the app to your Applications folder
  3. Open Mural Engine once. The first time it opens, macOS asks you to confirm — Mural Engine is checked by Apple, so click Open.
  4. In Mural, open the Dynamic Lock Screen tab and turn on Sync Dynamic Wallpaper to Lock Screen.
  5. On macOS 14 and 15, complete the authorization when prompted.

FAQ

I click to buy, but the purchase window shows no Touch ID or password, so I can't complete the purchase.

macOS hides Touch ID and the password field when another app's window covers the purchase window — even a window you can't see. Quit apps that keep windows floating over your screen, or stop screen sharing or recording, then try again.

What macOS version does Mural require?

macOS 14.0 Sonoma or later.

Does Mural support Intel Macs?

Yes. Mural runs natively on both Apple Silicon (M series) and Intel Macs.

Does Mural support external displays?

Yes. Mural supports your primary display plus one external display.

Which macOS versions support automatic lock screen sync?

macOS 14, 15, 26 and 27.

Will my wallpaper reset after restarting my Mac?

No. Mural remembers your wallpaper and all its effects.

Does Mural affect battery life?

Turn on Battery Saver in Settings to pause your wallpaper on battery power.

How do I enable Mural to launch automatically on login?

Turn on Launch at Login in Settings.

How do I update Mural Engine?

If Mural Engine is running, quit it from its menu bar icon, then download the latest version from muralflow.com/mural-engine. Open the disk image and drag Mural Engine.app into your Applications folder — when macOS asks, choose Replace, not Keep Both, so only one copy stays on your Mac. Then open Mural Engine once.

How do I uninstall?

Turn off Sync Dynamic Wallpaper to Lock Screen, quit Mural, then delete Mural and Mural Engine from your Applications folder.