macOS
Homebrewverified · 100%
brew install wallpaperlocal Homebrew formula metadata
brew / rank 4713
Install wallpaper with Homebrew
Manage the desktop wallpaper. Version 2.3.4 via Homebrew; verified from local package data.
install
Additional install commands
overview
Package summary
Manage the desktop wallpaper
Project links
Commands and aliases
- wallpaper
history
Project history and usage
macOS Wallpaper is Sindre Sorhus's focused utility and Swift package for getting and setting the desktop wallpaper on macOS. It exists in the long-running niche of command-line desktop customization, where macOS behavior around multiple screens, Spaces, dynamic wallpapers, and interval-rotating folders has historically made simple scripts brittle.
Project history
The project was already releasing as the `wallpaper` command by 2016, when version 1.2.0 added support for desktop backgrounds configured to change on an interval. In 2018, version 2.0.0 was a notable transition: the project was rewritten in Swift, gained multiple-screen support, changed the CLI to explicit `get` and `set` subcommands, and became available as a Swift Package Manager API.
Subsequent releases track macOS platform changes rather than broad feature growth. Releases added Apple silicon support in 2022 and compatibility fixes for newer macOS versions, including macOS 26 fixes in 2025 and 2026.
How it is used
The command is used in scripts and small automation workflows that need a stable `wallpaper get` or `wallpaper set` interface instead of direct AppleScript, Dock database, or System Events snippets. The README notes that the package handles the active wallpaper correctly even when the system wallpaper is set to a directory.
Sources
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
wallpaper | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version2.3.4
manager updated
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:wallpaper |
|---|---|
| Version | 2.3.4 |
| Package manager | Homebrew |
| Homepage | https://github.com/sindresorhus/macos-wallpaper |
| Repository | https://github.com/sindresorhus/macos-wallpaper |
| Bottle | not recorded |
| Service | none declared |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated package history
- pkg.so package database
- pkgdb category and tag curation