LinuxCommandLibrary

plasma-apply-wallpaperimage

Set desktop wallpaper using an image file

TLDR

Apply a wallpaper

$ plasma-apply-wallpaperimage [/path/to/image]
copy

Apply a wallpaper with a fill mode
$ plasma-apply-wallpaperimage --fill-mode [stretch|preserveAspectFit|preserveAspectCrop|tile|tileVertically|tileHorizontally|pad] [/path/to/image]
copy

Display help
$ plasma-apply-wallpaperimage --help
copy

SYNOPSIS

plasma-apply-wallpaperimage [options]

PARAMETERS


    The path to the image file to be used as the wallpaper. This is a mandatory parameter.

--screen
    Apply wallpaper only to the specified screen. (Default: all screens)

--placement
    Wallpaper placement option (default: default) options are:
default,
centered,
scaled,
scaledandcropped,
tiled

--help
    Displays help information about the command.

DESCRIPTION

The `plasma-apply-wallpaperimage` command is a utility specifically designed for the KDE Plasma desktop environment. It allows users to programmatically set a wallpaper from the command line. This is particularly useful for scripting, automation, or applying wallpaper configurations across multiple systems or sessions. The command facilitates setting a single image as the wallpaper. It operates by interacting with the Plasma configuration system, modifying the settings responsible for the displayed wallpaper. The image path must be valid and accessible to the user executing the command. The command simplifies the process of changing wallpapers compared to manually navigating the system settings, especially when combined with other utilities for image manipulation or retrieval. Note: This command is specific to the KDE Plasma desktop environment, and will not function correctly under other desktop environments.

USAGE EXAMPLES

Setting a Wallpaper:
`plasma-apply-wallpaperimage /path/to/my/image.jpg`

Setting for a specific screen:
`plasma-apply-wallpaperimage --screen 1 /path/to/my/image.jpg`

Set and scale an Image:
`plasma-apply-wallpaperimage --placement scaled /path/to/my/image.jpg`

SEE ALSO

Copied to clipboard