File: wallpaper.el.html
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.
Defined variables (8)
wallpaper--default-setters | List of setters used for setting the wallpaper. |
wallpaper-command | Executable used by ‘wallpaper-set’ for setting the wallpaper. |
wallpaper-command-args | Command line arguments for ‘wallpaper-command’. |
wallpaper-debug | If non-nil, display debug messages. |
wallpaper-default-height | Default height used by ‘wallpaper-set’. |
wallpaper-default-width | Default width used by ‘wallpaper-set’. |
wallpaper-image-file-extensions | List of file extensions that ‘wallpaper-set’ will consider for completion. |
wallpaper-set-function | Function used by ‘wallpaper-set’ to set the wallpaper. |