Variable: wallpaper-command-args

wallpaper-command-args is a customizable variable defined in wallpaper.el.gz.

Value

nil

Documentation

Command line arguments for wallpaper-command.

A suitable command for your environment should be detected automatically, so there is usually no need to customize this. However, if you do need to change this, you might also want to customize wallpaper-command to match.

The value is a list of command list arguments to use, or a function that returns a list of command line arguments.

In each command line argument, these specifiers will be replaced:

  %f full file name
  %h height of the selected frame's display (as returned
         by display-pixel-height)
  %w the width of the selected frame's display (as returned
         by display-pixel-width).
  %F full file name URI-encoded
  %S current X screen (e.g. "0")
  %W current workspace (e.g., "0")
  %M name of the monitor (e.g., "0" or "LVDS")

If wallpaper-set is run from a TTY frame, instead prompt for a height and width to use for %h and %w.

The value of this variable is ignored on MS-Windows and Haiku systems, where a native API is used instead.

This variable was added, or its default value changed, in Emacs 29.1.

Probably introduced at or before Emacs version 29.1.

Source Code

;; Defined in /usr/src/emacs/lisp/image/wallpaper.el.gz
(defcustom wallpaper-command-args (wallpaper--find-command-args)
  "Command line arguments for `wallpaper-command'.
A suitable command for your environment should be detected
automatically, so there is usually no need to customize this.
However, if you do need to change this, you might also want to
customize `wallpaper-command' to match.

The value is a list of command list arguments to use, or a
function that returns a list of command line arguments.

In each command line argument, these specifiers will be replaced:

  %f   full file name
  %h   height of the selected frame's display (as returned
         by `display-pixel-height')
  %w   the width of the selected frame's display (as returned
         by `display-pixel-width').
  %F   full file name URI-encoded
  %S   current X screen (e.g. \"0\")
  %W   current workspace (e.g., \"0\")
  %M   name of the monitor (e.g., \"0\" or \"LVDS\")

If `wallpaper-set' is run from a TTY frame, instead prompt for a
height and width to use for %h and %w.

The value of this variable is ignored on MS-Windows and Haiku
systems, where a native API is used instead."
  :type '(choice (repeat string)
                 function)
  :group 'image
  :version "29.1")