.\" Original author: Hyriand <hyriand@thegraveyard.org> (2003)
.\" Updated by Martin Hradil (2019)
.\" License: GPL version 2
.TH HSETROOT 1 "2019-11-18" "1.0.5" "imlib2-based wallpaper changer"

.SH NAME
hsetroot \- imlib2-based wallpaper changer

.SH SYNOPSIS
.B hsetroot 
.RI [command1 [arg1..]] [command2 [arg1..]]...

.SH DESCRIPTION
.B 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.

.B hsetroot
is using XSetWindowBackgroundPixmap instead of XSetWindowBackground also for
solid colors. This makes it a good 
.B xsetroot
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.

.SH GENERIC OPTIONS
.TP
.B \-root
Treat multiple displays as one big screen (ignore xrandr outputs)
.TP
.B \-screens <int>
Set a screenmask to use

.SH GRADIENTS
.TP
.B \-add <color>
Add color to range using distance 1
.TP
.B \-addd <color> <distance>
Add color to range using custom distance
.TP
.B \-gradient <angle>
Render gradient using specified angle
.TP
.B \-clear
Clear the color range

.SH SOLID COLOR
.TP
.B \-solid <color>
Render a solid using the specified color

.SH IMAGE FILES
.TP
.B \-center <image>
Render an image centered on screen
.TP
.B \-cover <image>
Render an image centered on screen scaled to fill the screen fully
.TP
.B \-tile <image>
Render an image tiled
.TP
.B \-full <image>
Render an image maximum aspect
.TP
.B \-extend <image>
Render an image max aspect and fill borders
.TP
.B \-fill <image>
Render an image stretched

.SH IMAGE MANIPULATION:
.TP
.B \-tint <color>
Tint the current image
.TP
.B \-blur <radius>
Blur the current image
.TP
.B \-sharpen <radius>
Sharpen the current image
.TP
.B \-contrast <amount>
Adjust contrast of current image
.TP
.B \-brightness <amount>
Adjust brightness of current image
.TP
.B \-gamma <amount>
Adjust gamma level of current image
.TP
.B \-flipv
Flip the current image vertically
.TP
.B \-fliph
Flip the current image horizontally
.TP
.B \-flipd
Flip the current image diagonally

.SH MISC
.TP
.B \-alpha <amount>
Adjust alpha level for colors and images
.TP
.B \-write <filename>
Write current image to file

.SH SEE ALSO
.BR xsetroot (1)
.BR XSetWindowBackgroundPixmap (3)
.BR xcompmgr (1)

.SH AUTHOR
hsetroot was written by Hyriand <hyriand@thegraveyard.org> in 2003. 
Martin Hradil updated it in 2019.
.PP
This manual page was written by Stefan Hagen
<sh+ports@codevoid.de>, for the OpenBSD project (but may be used by others).