{"repo":"scriptingosx/desktoppr","free":true,"listed":false,"github":"https://github.com/scriptingosx/desktoppr","clone":"git clone https://github.com/scriptingosx/desktoppr.git","description":"Simple command line tool to set the desktop picture on macOS","language":"Swift","stars":382,"topics":["macos","desktop-picture","command-line-tool","command-line","terminal","swift","macadmin"],"license":"Apache-2.0","category":"cli-tools","readme_excerpt":"Here comes the desktoppr ! &nbsp; &nbsp; &nbsp; A simple command line tool which can read and set the desktop picture/wallpaper. Credit for the name to Neil Martin. Note: Apple used to call the macOS background image 'desktop picture' until macOS 13 Ventura, when they changed to be the same as in iOS: 'wallpaper'. This documentation might use either term. I have written a few blog posts that describe different use strategies for setting a desktop picture: - Using desktoppr in a managed environment - Building a LaunchD Installer pkg for desktoppr (and other tools) - Strategies to using desktoppr - Random Desktop Background with desktoppr Getting and setting the current desktop picture/wallpaper You can read the current desktop picture/wallpaper with: and set the desktop picture with When 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. When you have multiple displays, desktoppr will list all desktop pictures: When you pass a file desktoppr will set it as the desktop picture for all screens: You can also set the desktop for a specific screen: (index starts at zero) desktoppr can also control the image scaling and background color for the desktop picture. The scale and color settings will be set for all screens. Use the scale verb to control how the desktops are scaled. It can have the va","default_branch":null,"files":null,"tree":[],"storefront":"/r/scriptingosx","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/scriptingosx/desktoppr/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}