Homepage: https://www.gnu.org/software/emacs
Author: Stefan Kangas
Change the desktop background
This library provides the command `wallpaper-set', which sets the desktop background. On GNU/Linux and other Unix-like systems, it uses an external command to set the desktop background. This should work seamlessly on both X and Wayland. Finding an external command to use is obviously a bit tricky to get right, as there is no lack of platforms, window managers, desktop environments and tools. However, it should be detected automatically in most cases. If it doesn't work in your environment, customize the user options `wallpaper-command' and `wallpaper-command-args'. On MS-Windows, it uses the `w32-set-wallpaper' function, and on Haiku the `haiku-set-wallpaper' function, neither of which relies on any external commands. The value of `wallpaper-command' and `wallpaper-command-args' are ignored on such systems. On macOS, the "osascript" command is used. You might need to disable the option "Change picture" in the "Desktop & Screensaver" preferences for this to work (this was seen with macOS 10.13). You might also have to tweak some permissions. Note: If you find that you need to use a command in your environment that was not automatically detected, we would love to hear about it! Please send an email to bug-gnu-emacs@gnu.org and tell us the command (and all options) that worked for you. You can also use `M-x report-emacs-bug'.