t* My OpenBSD ports URI git clone git://git.codevoid.de/mystuff.git DIR Log DIR Files DIR Refs --- thsetroot.1 (2752B) --- 1 .\" Original author: Hyriand <hyriand@thegraveyard.org> (2003) 2 .\" Updated by Martin Hradil (2019) 3 .\" License: GPL version 2 4 .Dd August 13, 2020 5 .Dt HSETROOT 1 6 .Os 7 .Sh NAME 8 .Nm hsetroot 9 .Nd wallpaper changer that works with compositors 10 .Sh SYNOPSIS 11 .Nm 12 .Op Ar command1 Op Ar arg1 ... 13 .Op Ar command2 Op Ar arg2 ... 14 .Sh DESCRIPTION 15 .Nm 16 is a tool which allows you to compose wallpapers ("root pixmaps") for X. 17 It has a lot of options like rendering gradients, solids and images and 18 manipulate these in various ways. 19 .Nm 20 also supports alpha-channels. 21 .Pp 22 .Nm 23 uses 24 .Xr XSetWindowBackgroundPixmap 3 25 instead of 26 .Xr XSetWindowBackground 3 27 for solid colors. 28 This makes it a good 29 .Xr xsetroot 1 30 replacement when a compositor (compton, xcompmgr, ...) is in use. 31 .Pp 32 Colors are in the #rgb, #rrggbb, #rrggbbaa, rgb:1/2/3 formats or a X color name. 33 .Sh GENERIC OPTIONS 34 .Bl -tag -width Ds 35 .It Fl root 36 Treat multiple displays as one big screen (ignore xrandr outputs) 37 .It Fl screens Ar int 38 Set a screenmask to use 39 .El 40 .Sh GRADIENTS 41 .Bl -tag -width Ds 42 .It Fl add Ar color 43 Add color to range using distance 1 44 .It Fl addd Ar color Ar distance 45 Add color to range using custom distance 46 .It Fl gradient Ar angle 47 Render gradient using specified angle 48 .It Fl clear 49 Clear the color range 50 .El 51 .Sh SOLID COLOR 52 .Bl -tag -width Ds 53 .It Fl solid Ar color 54 Render a solid using the specified color 55 .El 56 .Sh IMAGE FILES 57 .Bl -tag -width Ds 58 .It Fl center Ar image 59 Render an image centered on screen 60 .It Fl cover Ar image 61 Render an image centered on screen scaled to fill the screen fully 62 .It Fl tile Ar image 63 Render an image tiled 64 .It Fl full Ar image 65 Render an image maximum aspect 66 .It Fl extend Ar image 67 Render an image max aspect and fill borders 68 .It Fl fill Ar image 69 Render an image stretched 70 .El 71 .Sh IMAGE MANIPULATION 72 .Bl -tag -width Ds 73 .It Fl tint Ar color 74 Tint the current image 75 .It Fl blur Ar radius 76 Blur the current image 77 .It Fl sharpen Ar radius 78 Sharpen the current image 79 .It Fl contrast Ar amount 80 Adjust contrast of current image 81 .It Fl brightness Ar amount 82 Adjust brightness of current image 83 .It Fl gamma Ar amount 84 Adjust gamma level of current image 85 .It Fl flipv 86 Flip the current image vertically 87 .It Fl fliph 88 Flip the current image horizontally 89 .It Fl flipd 90 Flip the current image diagonally 91 .El 92 .Sh MISC 93 .Bl -tag -width Ds 94 .It Fl alpha Ar amount 95 Adjust alpha level for colors and images 96 .It Fl write Ar filename 97 Write current image to file 98 .El 99 .Sh SEE ALSO 100 .Xr xcompmgr 1 , 101 .Xr xsetroot 1 , 102 .Xr XSetWindowBackgroundPixmap 3 103 .Sh AUTHORS 104 .Nm 105 was written by 106 .An Hyriand Aq Mt hyriand@thegraveyard.org 107 in 2003. 108 Martin Hradil updated it in 2019. 109 .Pp 110 This manual page was written by 111 .An Stefan Hagen Aq Mt sh+ports[at]codevoid[dot]de 112 for the 113 .Ox 114 project (but may be used by others).