Frequently Asked Questions - SAP/backgrounds GitHub Wiki

Backgrounds supports command line use.

--listBackgrounds Print the names of all available backgrounds.

/Applications/Backgrounds.app/Contents/MacOS/Backgrounds --listBackgrounds 

It will return a list of available predefined backgrounds like this:

--setBackground <name> Set the Desktop to the predefined background with the given name. The predefined backgrounds may be found in the Predefined.plist inside the Resources folder of the Backgrounds app or may be deployed via configuration profile.

/Applications/Backgrounds.app/Contents/MacOS/Backgrounds --setBackground <name> 

For example:

/Applications/Backgrounds.app/Contents/MacOS/Backgrounds --setBackground "From light gray to dark gray"

Would set the background with name From light gray to dark gray.

--allScreens Set the Desktop picture as background for all attached screens, instead of just for the main screen.

You use the --allScreens argument to set it for all attached screens. So if we stick to the previous example,to the the background with name From light gray to dark gray for all screens. Use:

For assistance, please run the following command to display all available options:

/Applications/Backgrounds.app/Contents/MacOS/Backgrounds --help

The issue is, that macOS does not remember for which screen you set a desktop picture. As soon as you add or remove a display, the desktop picture moves to another screen. So if you have screens with different aspect ratio, you notice borders on top/bottom or left/right of the picture. This has nothing to do with our app but is an issue introduced in macOS 13. In our case review with Apple we have been told that this will not be fixed anymore in macOS 13 but a fix is scheduled for the next major macOS version.

Note:

• We agreed that we can mention this issue on our GitHub page but without our feedback id.
• We also agreed that we can encourage people to open feedback for this with Apple.