Automic VaultAutomic Vault

brew

Install wallpaper with Homebrew

Manage the desktop wallpaper. Version 2.3.4 via Homebrew; verified 2026-04-19.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install wallpaper

local Homebrew formula metadata

overview

Package summary

Manage the desktop wallpaper

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.

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 post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 4 platform targets.

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

CommandKindExposureNote
wallpapercliglobal executable

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-07-08
manager version2.3.4
manager updated2026-04-19
local dataok
upstreamcurrent
latest detectedv2.3.4

https://github.com/sindresorhus/macos-wallpaper

  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:wallpaper
Version2.3.4
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/wallpaper
Homepagehttps://github.com/sindresorhus/macos-wallpaper
Repositoryhttps://github.com/sindresorhus/macos-wallpaper
Upstream docshttps://github.com/sindresorhus/macos-wallpaper#readme
LicenseMIT
Source archivehttps://github.com/sindresorhus/macos-wallpaper/archive/refs/tags/v2.3.4.tar.gz
Last updated2026-04-19T19:39:05Z
Pulseupdated
Bottleavailable (on arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namewallpaper
Version Scheme0
Revision0
Head VersionHEAD
Requirements
  • macos
  • xcode
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Same workflow

  • gkrellmShares av.db curated category or tags: cli, desktop, system.
  • twmShares av.db curated category or tags: cli, desktop, system.
  • brightnessShares av.db curated category or tags: cli, macos, system, system-utility.
  • launchShares av.db curated category or tags: cli, macos, system, system-utility.
  • libnotifyShares av.db curated category or tags: cli, desktop, system.
  • m-cliShares av.db curated category or tags: cli, macos, system, system-utility.

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.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • package relationship graph
  • package version freshness
  • package-page enrichment