wallpaper for Mac
macos-wallpaper Manage the desktop wallpaper on macOS
wallpaper — overview
macos-wallpaper Manage the desktop wallpaper on macOS
This is both a command-line app and a Swift package.
It correctly handles getting the active wallpaper even when the wallpaper is set to a directory.
CLI
Requires macOS 10.14.4 or later.
Install
Homebrew
Manually
Download the binary and put it in /usr/local/bin.
Usage
By default, it sets and gets the wallpaper for all screens. Use the --screen flag to change this. [!NOTE] macOS still offers a Tile option in System Settings, but it has no API. The undocumented NSWorkspace placement key silently ignores tile values, and the old desktoppicture.db method no longer works on macOS 26 and later. --scale therefore does not support tile. Set it manually in System Settings if you need it.
Set
Set solid color
Get
API
Building this requires the latest Xcode and macOS version. The package supports macOS 10.14.4 or later.
Install
Add the following to Package.swift:
Usage
See the source for more. [!NOTE] In sandboxed apps, the library gracefully handles database access restrictions and may return directory paths instead of specific image files when getting current wallpapers.
Dev
Run
Build
Related wallpaper - Get or set the desktop wallpaper cross-platform (Uses this binary) macos-trash - Move files and directories to the trash do-not-disturb - Control the macOS Do Not Disturb feature More…
Details
管理桌面壁纸
How to install wallpaper
- Open Terminal (press ⌘ + Space and type “Terminal”).
- If Homebrew is not installed yet, run the command below first.
- Run this command:
Latest 10 releases
Last updated 2026-04-19; current version v2.3.4, with the latest 10 releases listed.
| Version | Released | Type | Size | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v2.3.4 | 2026-04-19 | Stable | 1.5 MB | Download | — | — |
| v2.3.3 | 2025-10-02 | Stable | — | — | — | — |
| v2.3.2 | 2024-09-16 | Stable | 1.4 MB | — | — | — |
| v2.3.1 | 2022-01-23 | Stable | 1.4 MB | — | — | — |
| v2.3.0 | 2022-01-10 | Stable | 1.4 MB | — | — | — |
| v2.2.0 | 2021-09-16 | Stable | 704 KB | — | — | — |
| v2.1.0 | 2020-05-04 | Stable | 531 KB | — | — | — |
| v2.0.0 | 2018-09-28 | Stable | 3.5 MB | — | — | — |
| 1.3.0 | 2017-02-02 | Stable | 4 KB | — | — | — |
| 1.2.0 | 2016-07-24 | Stable | 3 KB | — | — | — |
Data from GitHub Releases; stable releases first, each group sorted newest first.
Prebuilt bottle platforms
Official Homebrew bottles cover:
- Apple silicon · latest macOS
- Apple silicon · macOS 26 Tahoe
- Apple silicon · macOS 15 Sequoia
- Apple silicon · macOS 14 Sonoma
- Intel · macOS 14 Sonoma
Compared with similar apps
Only public metadata is compared, with no subjective recommendation; see the compare pages for field-by-field comparisons.
| App | Version | License | Architecture | 30-day installs |
|---|---|---|---|---|
| wallpaper | v2.3.4 | MIT | CLI | 27 |
| gowall | v0.2.4 | MIT | CLI | 33 |
| gnome-papers | 51.1 | GPL-2.0-or-later | CLI | 37 |
| gossip | v0.14.0 | MIT | CLI | 16 |
Similar apps: Command-line Tools
gowall
Tool to convert a Wallpaper's color scheme / palettegnome-papers
gnome-papers is a document viewer for the GNOME desktop environment, primarily used to open and…gossip
I haven't had time to spend on NOSTR development for many months now.awww
awww is a command-line wallpaper tool designed for Wayland environments, specifically aimed at…go-hass-agent
A Home Assistant, native app integration for desktop/laptop devices.desktoppr
Here comes the desktoppr!Categories: Command-line Tools