Moonleaf logo moonleaf

macOS Wallpaper Playlists, Rotation & History (Free Guide)

Updated: November 13, 2026 • 6 min read • macOS 12+ (Intel & Apple Silicon) Free & Open Source

Quick Answer

How do you rotate curated wallpaper sets on a Mac without copying files into separate folders? Moonleaf lets you create named playlists that reference wallpapers in your library, pick In order or Random playback with per-list intervals (15 minutes, 1 hour, 3 hours, or Daily), assign playlists to individual desktops, and switch lists right from the macOS menu bar.

Plus built-in recall & storage clarity: Moonleaf tracks up to your last 1,000 successful wallpaper applies in Recent and Timeline views, and separates saved library files from external references and clearable download cache in Settings → Storage.

Disclosure: Moonleaf is our free, MIT-licensed macOS wallpaper manager.

Why Named Playlists Beat Single-Folder Rotation

macOS System Settings can rotate pictures inside a single folder, which forces you to duplicate images across folders if you want separate "Work", "Minimal", and "Night" sets—and gives you no menu bar switch or apply history.

In Moonleaf, your Library holds the source wallpapers (or external links to folders you already keep), while Playlists act as lightweight collections pointing to them:

Step 1: Create a Playlist & Multi-Select from Library

  1. Open Moonleaf and switch to the Playlists tab in the sidebar.
  2. Enter a Playlist name (for example, Focus or Ultrawide Landscapes) and click Create.
  3. Open the Library tab, search by filename (Search name or file) or filter by favorites/type, then click Select to pick multiple wallpapers at once and choose Add selected to add them to your playlist without interrupting what is currently on screen.

Back in Playlists, you can drag items to reorder them (or use the Up / Down buttons), inspect how many files in the list are available, and remove individual items anytime.

Step 2: Set Order, Interval & Desktop Target

Inside your selected playlist, configure how and where it rotates:

Want different playlists on different monitors or virtual Spaces? See our Per-Monitor & Space Wallpaper Guide.

Step 3: Switch Playlists & Shuffle from the Menu Bar

Once your playlists are ready, you don't need to keep the manager window open:

Step 4: Find Past Wallpapers in 1,000-Item Usage History

Ever seen a wallpaper rotate past and wished you knew its name? The History section in Overview records up to your latest 1,000 successful applies (both manual picks and automatic rotations, excluding startup restores):

Step 5: Inspect Details, Esc Preview, Copy Image & Storage

Two quality-of-life tools make managing a large wallpaper library straightforward:

Safe by design:

Clearing the download cache or memory thumbnails in Settings → Storage never deletes your saved library wallpapers or external folders.

Frequently Asked Questions

Do Moonleaf playlists copy my wallpaper files on disk?

No. Playlists store references to assets in your library rather than duplicating files. One wallpaper can belong to multiple playlists, and deleting a playlist or removing an item from a list keeps the original file untouched.

What rotation orders and intervals do Moonleaf playlists support?

Each playlist can play In order (reordered via drag-and-drop or Up/Down controls) or Random, and each playlist has its own rotation interval: 15 minutes, 1 hour, 3 hours, or Daily. You can also assign different playlists to different desktops.

Can I switch wallpaper playlists from the macOS menu bar?

Yes. Click the Moonleaf icon in the menu bar and open the Playlists submenu to switch the current desktop to any named playlist, or click Shuffle Now for an immediate change.

How many wallpaper changes does Usage History keep?

Moonleaf keeps up to your last 1,000 successful wallpaper applies in Recent (deduplicated) and Timeline (day-by-day) views. Clearing history deletes recorded usage entries only—your wallpapers, favorites, and playlists remain intact.

Does clearing cache in Moonleaf delete my saved wallpapers?

No. Settings → Storage separates Library files, External references, Download cache, and Memory thumbnails. Clearing the download cache or memory thumbnails never deletes wallpapers in your library or external folders.

Build Smarter Wallpaper Playlists on Mac

Download Moonleaf free under the MIT License. Native Swift & AppKit for macOS 12+ (Apple Silicon & Intel).

Download moonleaf.dmg
brew install shiquda/moonleaf/moonleaf