How to use Wallhaven wallpapers on Mac

Wallhaven is a website, not a Mac app. The direct route is to download an image from wallhaven.cc in your browser and set it in System Settings → Wallpaper. Once you are collecting more than a few, it is quicker to search Wallhaven from a menu-bar picker so every download lands in your wallpaper folder ready to apply.

What Wallhaven is

Wallhaven is a community wallpaper site. Images are uploaded and tagged by its users, then found through tag search, three broad categories (General, Anime, People), resolution and aspect-ratio filters, and sorting by popularity or upload date. It also publishes an API, which is how desktop apps can search it.

Because uploads are user-submitted, copyright stays with whoever made the image. Downloading one for your own desktop is what the site is for; check the original source before you reuse an image anywhere else.

Set a Wallhaven wallpaper manually on macOS

No app required — this works on any Mac.

1. Search wallhaven.cc, and set the resolution filter to At least your display's native resolution so results are not upscaled.
2. Open the wallpaper's page and download the full-size file rather than saving the thumbnail.
3. Move it into one folder you keep for this — ~/Pictures/Wallpapers is a sensible default.
4. Open System Settings → Wallpaper and scroll to Your Photos, where the Add Photo button takes a single file or a whole folder. Right-clicking the file in Finder and choosing Set Desktop Picture does the same thing in one step.

On more than one display, macOS applies the change to the screen the System Settings window is currently on, so move the window before you pick. Per-display targeting is one of the things a dedicated app handles differently.

This is fine for a wallpaper or two a month. It gets tedious once you are downloading regularly: browser tab, Downloads folder, file move, System Settings, repeat.

Browse Wallhaven from the Mac menu bar

Wallset's Browse tab searches Wallhaven directly and downloads results into your local library. Wallhaven is the default source and needs no account and no API key — the same goes for the other two sources, Wikimedia Commons and Pixabay.

Browse is a Pro feature. Every install starts a 7-day Pro trial automatically, with no signup, so it is available from first launch; keeping it is a one-time $7.99 purchase. When a trial ends, local switching, the hotkey picker, and auto-rotation keep working for free.

The Wallset workflow, step by step

1. Press the global hotkey — ⌥Space by default — to open the picker from whatever you were doing.
2. Switch to Browse. Wallhaven is already selected in the toolbar's source picker.
3. Type a search, or start from a quick-search tag: Nature, Space, Minimalist, Dark, City, Abstract, Cars, Animals, Architecture, Retro, or Sci-Fi.
4. Narrow the results with the controls Wallhaven genuinely supports — the General, Anime, and People categories, a Top Rated sort, and a minimum resolution.
5. Choose Download & Apply. The file is saved into your wallpaper folder, named from the image's tags, applied to the desktop, and — with Pro — optionally added to a collection on the way in.

Wallset remembers which Wallhaven image a local file came from. Applying a result you already downloaded reuses the saved file instead of fetching it again, and the context menu can reveal that file in Finder or reopen its Wallhaven page when you want to credit the uploader.

Wallset requests Wallhaven's safe-for-work tier only. That is fixed, not a preference.

Search and filter tips

Filter by resolution before anything else

A wallpaper below your display's resolution will be stretched. Set the minimum to match the panel you are on — 5120×2880 for a 27-inch 5K display, 3456×2234 for a 16-inch MacBook Pro — and the weak results disappear before you have to judge them.

Search tags, not sentences

Wallhaven indexes tags contributed by uploaders, so short terms work better than descriptions. When you find something close to what you want, its tags are the fastest way to more of the same.

Know which controls live where

Wallset exposes the categories, Top Rated sort, and minimum-resolution filter. The website has more than that, including aspect-ratio filters and finer search syntax. Wallset deliberately shows only the filters a source can actually honor, so its controls change as you switch providers, and sources are searched one at a time rather than merged.

Keep the downloads organized

Wallhaven filenames are auto-generated on the way in, from the image's tags, which usually leaves you something searchable. Wallset's local search is a literal case-insensitive filename match — it does not infer subjects or read tags — so rename anything that arrived unhelpfully named. Renaming from the picker renames the real file.

• Press Space for a full-size preview before committing to a wallpaper.
• Press ⌘I to check pixel dimensions, file size, and date added.
• Deleting moves the file to the Trash after a confirmation, so it stays recoverable.
• Supported formats are JPG, JPEG, PNG, HEIC, WebP, and TIFF.

Organizing a Mac wallpaper folder and the wallpaper organizer features cover this in more depth.

Rotation and collections: free versus Pro

Once Wallhaven images are in your folder, they behave like any other local wallpaper. That is what makes the free half of the app useful even if you never buy Pro.

Auto-rotation swaps are always instant, on either tier. The crossfade and the Pro transition styles play only when you switch manually from the picker. There is more detail in the guide to changing wallpaper automatically and on the automatic wallpaper changer page.

Common questions

Is there an official Wallhaven app for Mac?

No. Wallhaven is a website with a public API. Mac apps that offer Wallhaven search, Wallset included, use that API — the site itself works fine in any browser.

Do I need a Wallhaven account or API key?

No. Wallhaven search and downloads work in Wallset with no account and nothing to paste into Settings — the same is true of its other two sources, Wikimedia Commons and Pixabay.

Are Wallhaven wallpapers free to use?

They are free to download and set as your own desktop background. Uploads are user-submitted and copyright stays with the original artist, so check an image's source before reusing it anywhere else.

Can Wallset show Wallhaven's adult content?

No. Wallset requests Wallhaven's safe-for-work tier only, and there is no setting that changes it.

Can Wallset rotate through Wallhaven wallpapers automatically?

It rotates through images already saved in your local folder or, with Pro, a collection — so download the Wallhaven wallpapers you want first. Wallset does not fetch new images from Wallhaven on a timer, and rotation swaps are instant with no transition.

Does Wallset support live or video wallpapers?

No. Wallset applies still images only: JPG, JPEG, PNG, HEIC, WebP, and TIFF. Its animated transitions play during a manual switch, not continuously behind the desktop.