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