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
- https://github.com/scriptingosx/desktoppr
- GitHub: scriptingosx/desktoppr
- Brew formula source: Casks/d/desktoppr.rb
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\u0026nbsp;\u0026nbsp;\u0026nbsp;\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
}