HSETROOT(1)

NAME
hsetroot - imlib2-based wallpaper changer

SYNOPSIS
hsetroot [command1 [arg1 ...]] [command2 [arg2 ...]]

DESCRIPTION
hsetroot is a tool which allows you to compose wallpapers ("root pixmaps") for X. It has a lot of options like rendering gradients, solids and images and manipulate these in various ways. hsetroot also supports alpha-channels.

hsetroot uses XSetWindowBackgroundPixmap(3) instead of XSetWindowBackground(3) for solid colors. This makes it a good xsetroot(1) replacement when a compositor (compton, xcompmgr, ...) is in use.

Colors are in the #rgb, #rrggbb, #rrggbbaa, rgb:1/2/3 formats or a X color name.

GENERIC OPTIONS

-root
    Treat multiple displays as one big screen (ignore xrandr outputs)

-screens int
    Set a screenmask to use

GRADIENTS

-add color
    Add color to range using distance 1

-addd color distance
    Add color to range using custom distance

-gradient angle
    Render gradient using specified angle

-clear
    Clear the color range

SOLID COLOR

-solid color
    Render a solid using the specified color

IMAGE FILES

-center image
    Render an image centered on screen

-cover image
    Render an image centered on screen scaled to fill the screen fully

-tile image
    Render an image tiled

-full image
    Render an image maximum aspect

-extend image
    Render an image max aspect and fill borders

-fill image
    Render an image stretched

IMAGE MANIPULATION

-tint color
    Tint the current image

-blur radius
    Blur the current image

-sharpen radius
    Sharpen the current image

-contrast amount
    Adjust contrast of current image

-brightness amount
    Adjust brightness of current image

-gamma amount
    Adjust gamma level of current image

-flipv
    Flip the current image vertically

-fliph
    Flip the current image horizontally

-flipd
    Flip the current image diagonally

MISC

-alpha amount
    Adjust alpha level for colors and images

-write filename
    Write current image to file

SEE ALSO
xcompmgr(1), xsetroot(1), XSetWindowBackgroundPixmap(3)

AUTHORS
hsetroot was written by Hyriand <hyriand@thegraveyard.org> in 2003. Martin Hradil updated it in 2019.

This manual page was written by Stefan Hagen <sh+ports@codevoid.de> for the OpenBSD project (but may be used by others).