---
title: "MacWall Documentation"
description: "Install, configure, and troubleshoot MacWall on macOS."
canonical: "https://macwall.app/docs"
---

# MacWall Documentation

Task-oriented guides for installing, configuring, and troubleshooting MacWall. For concepts see [/learn](https://macwall.app/learn); for news and comparisons see [/blog](https://macwall.app/blog).

## Getting started

- [Install MacWall](https://macwall.app/docs/install-macwall) — Download the MacWall DMG, install it, grant the one permission macOS asks for, and get a live wallpaper running in under two minutes.
- [Menu bar controls](https://macwall.app/docs/menu-bar-controls) — Pause, resume, stop, shuffle, and switch live wallpapers from the MacWall menu bar item without opening the full window.

## Wallpapers

- [Set a live wallpaper](https://macwall.app/docs/set-a-live-wallpaper) — Browse the MacWall catalog, preview a loop, and set it as your desktop live wallpaper — including per-display setups on multi-monitor Macs.
- [Import your own videos](https://macwall.app/docs/import-your-own-videos) — Drag any MP4, MOV, M4V, or GIF into MacWall to use it as a Mac live wallpaper, plus the encoding settings that keep playback smooth and efficient.
- [Live Lock Screen](https://macwall.app/docs/live-lock-screen-and-screen-saver) — Turn on MacWall's live Lock Screen and Screen Saver playback on macOS 26 (Tahoe) and later, and understand the macOS limits behind it.

## Pro & licensing

- [License and activation](https://macwall.app/docs/license-and-activation) — How MacWall Pro licensing works: one-time $7.99 purchase, instant key activation, up to 3 Macs, and how to move a license to a new machine.
- [Performance and battery](https://macwall.app/docs/performance-and-battery) — Every MacWall pause rule explained — battery, full screen, display sleep, high CPU — plus how to verify real CPU usage in Activity Monitor.

## Troubleshooting

- [Fix common issues](https://macwall.app/docs/troubleshooting) — Wallpaper not showing, playback stuck on one frame, downloads failing, black screen after a macOS update — with the fix for each.
- [Uninstall MacWall](https://macwall.app/docs/uninstall-macwall) — Remove MacWall and every cached wallpaper video from your Mac, restore your static desktop picture, and keep your license for later.

## Developers

- [Public API & feeds](https://macwall.app/docs/public-api) — Read-only MacWall endpoints for the wallpaper catalog and release metadata, plus the RSS, JSON Feed, llms.txt, and API catalog documents that describe this site.

---

Source: https://macwall.app/docs