🍺 BREW Explorer

← all casks

desktoppr

brew install --cask desktoppr v0.5,218

Command-line tool to set the desktop picture

122
30-day installs · #1259
305
90-day · #1383
765
365-day · #1691
373
★ GitHub stars · updated 7mo ago

GitHub topics

command-line command-line-tool desktop-picture macadmin macos swift terminal

Links

Raw metadata
{
  "alternatives": [],
  "artifacts": [
    {
      "uninstall": [
        {
          "pkgutil": "com.scriptingosx.desktoppr"
        }
      ]
    },
    {
      "pkg": [
        "desktoppr-0.5-218.pkg"
      ]
    }
  ],
  "auto_updates": null,
  "categories": [],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Command-line tool to set the desktop picture",
  "disable_reason": null,
  "disabled": 0,
  "display_name": "desktoppr",
  "enrichment_fetched_at": "2026-06-20T22:42:02+00:00",
  "first_seen": "2026-06-20T00:47:34+00:00",
  "full_token": "desktoppr",
  "github_default_branch": "main",
  "github_last_commit_at": "2026-01-22T06:53:27Z",
  "github_readme_excerpt": "# Here comes the `desktoppr`!\n\n![](https://img.shields.io/github/v/release/scriptingosx/desktoppr)\u0026nbsp;![](https://img.shields.io/github/downloads/scriptingosx/desktoppr/latest/total)\u0026nbsp;![](https://img.shields.io/badge/macOS-10.13%2B-success)\u0026nbsp;![](https://img.shields.io/github/license/scriptingosx/desktoppr)\n\nA simple command line tool which can read and set the desktop picture/wallpaper. Credit for the name to [Neil Martin](https://macadmins.slack.com/archives/C19MR7EM9/p1536586211000100).\n\nNote: Apple used to call the macOS background image \u0027desktop picture\u0027 until macOS 13 Ventura, when they changed to be the same as in iOS: \u0027wallpaper\u0027. This documentation might use either term.\n\nI have written a few blog posts that describe different use strategies for setting a desktop picture:\n\n- [Using desktoppr in a managed environment](https://scriptingosx.com/2024/01/using-desktoppr-in-a-managed-environment/)\n- [Building a LaunchD Installer pkg for desktoppr (and other tools)](https://scriptingosx.com/2024/07/building-a-launchd-installer-pkg-for-desktoppr-and-other-tools/)\n- [Strategies to using desktoppr](https://scriptingosx.com/2020/03/strategies-to-using-desktoppr/)\n- [Random Desktop Background with desktoppr](https://scriptingosx.com/2020/04/random-desktop-background-color-with-desktoppr/)\n\n## Getting and setting the current desktop picture/wallpaper\n\nYou can read the current desktop picture/wallpaper with:\n\n```\n$ desktoppr\n/Library/Desktop Pictures/Sierra.jpg\n```\n\nand set the desktop picture with\n\n```\n$ desktoppr \"/Library/Desktop Pictures/BoringBlueDesktop.png\"\n```\n\nWhen the path is a path to a folder, the system will rotate the wallpaper through all the image files in that folder. The default rotation time is 30 minutes and can be changed in the Wallpaper settings pane. `desktoppr` cannot change the frequency.\n\n```\n$ desktoppr \"/Library/Desktop Pictures/My Wallpapers/\"\n```\n\nWhen you have multiple displays, `desktoppr` will list all desktop pictures:\n\n```\n$ d",
  "github_repo": "scriptingosx/desktoppr",
  "github_stars": 373,
  "github_topics": [
    "command-line",
    "command-line-tool",
    "desktop-picture",
    "macadmin",
    "macos",
    "swift",
    "terminal"
  ],
  "homepage": "https://github.com/scriptingosx/desktoppr",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 122,
  "installs_365d": 765,
  "installs_90d": 305,
  "last_seen": "2026-06-20T00:47:34+00:00",
  "llm_generated_at": null,
  "llm_model": null,
  "names": [
    "desktoppr"
  ],
  "one_liner": null,
  "rank_30d": 1259,
  "rank_365d": 1691,
  "rank_90d": 1383,
  "raw_hash": "9d4600f1b0133f86",
  "ruby_source_path": "Casks/d/desktoppr.rb",
  "tap": "homebrew/cask",
  "token": "desktoppr",
  "version": "0.5,218",
  "why_use_this": null
}