EWCTL(1) Manual Page

  • Home
  • Back

  • EWCTL(1) General Commands Manual EWCTL(1)

    ewctlset display wallpaper

    ewctl [-d name] [file]

    ewctl -c | -h

    The ewctl utility is a frontend to the ewd(1) wallpaper daemon. It allows you to set and unset wallpapers on one or all displays. When invoked, the ewctl utility will set the wallpaper to image specified by file, which must be a JPEG XL image. If file is ‘-’ or unspecified, the standard input is read instead.

    To use other image formats you must first convert them from their original format to JPEG XL. This can be done with tools such as convert(1) or magick(1) from the ImageMagick(1) suite. ewctl also doesn’t concern itself with image scaling, as a result it is highly suggested that if you have a wallpaper at a larger resolution than your display, that you first scale it down using external tools to reduce memory usage.

    The options are as follows:

    , --clear
    Inform the daemon to stop rendering any wallpapers. This option can be combined with -d to only clear specific displays.
    , --display=name
    Inform the daemon to only apply changes to the display specified by name.
    , --help
    Display help information by opening this manual page.

    The ewctl utility exits 0 on success, and >0 if an error occurs.

    Set foo.jxl as the wallpaper for all displays:

    $ ewctl foo.jxl

    Set foo.jxl as the wallpaper for the display eDP-1 and bar.jxl as the wallpaper for the display DP-1

    $ ewctl -d eDP-1 foo.jxl
    $ ewctl -d DP-1 bar.jxl

    Clear any existing wallpaper from the display eDP-1:

    $ ewctl -c -d eDP-1

    Convert a PNG image to JPEG XL and scale it down to 1080p before setting it as the wallpaper for DP-1:

    $ magick large.png -resize 1920x1080 JXL:- | ewctl -d DP-1

    Try out a new wallpaper from the internet:

    $ curl example.com/image.jpg | magick JPG:- JXL:- | ewctl

    convert(1), curl(1), ewd(1), ImageMagick(1), magick(1), ewd(7)

    Thomas Voss <[email protected]>

    December 15 2023 MangoOS