.\" Title: fluxbox-style .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Date: 05/26/2009 .\" Manual: Fluxbox Manual .\" Source: fluxbox-style.txt 1.1.2 .\" Language: English .\" .TH "FLUXBOX\-STYLE" "5" "05/26/2009" "fluxbox\-style\&.txt 1\&.1\&.2" "Fluxbox Manual" .\" ----------------------------------------------------------------- .\" * (re)Define some macros .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" toupper - uppercase a string (locale-aware) .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de toupper .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ \\$* .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" SH-xref - format a cross-reference to an SH section .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de SH-xref .ie n \{\ .\} .toupper \\$* .el \{\ \\$* .\} .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" SH - level-one heading that works better for non-TTY output .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de1 SH .\" put an extra blank line of space above the head in non-TTY output .if t \{\ .sp 1 .\} .sp \\n[PD]u .nr an-level 1 .set-an-margin .nr an-prevailing-indent \\n[IN] .fi .in \\n[an-margin]u .ti 0 .HTML-TAG ".NH \\n[an-level]" .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 \." make the size of the head bigger .ps +3 .ft B .ne (2v + 1u) .ie n \{\ .\" if n (TTY output), use uppercase .toupper \\$* .\} .el \{\ .nr an-break-flag 0 .\" if not n (not TTY), use normal case (not uppercase) \\$1 .in \\n[an-margin]u .ti 0 .\" if not n (not TTY), put a border/line under subheading .sp -.6 \l'\n(.lu' .\} .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" SS - level-two heading that works better for non-TTY output .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de1 SS .sp \\n[PD]u .nr an-level 1 .set-an-margin .nr an-prevailing-indent \\n[IN] .fi .in \\n[IN]u .ti \\n[SN]u .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .ps \\n[PS-SS]u \." make the size of the head bigger .ps +2 .ft B .ne (2v + 1u) .if \\n[.$] \&\\$* .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" BB/BE - put background/screen (filled box) around block of text .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de BB .if t \{\ .sp -.5 .br .in +2n .ll -2n .gcolor red .di BX .\} .. .de EB .if t \{\ .if "\\$2"adjust-for-leading-newline" \{\ .sp -1 .\} .br .di .in .ll .gcolor .nr BW \\n(.lu-\\n(.i .nr BH \\n(dn+.5v .ne \\n(BHu+.5v .ie "\\$2"adjust-for-leading-newline" \{\ \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] .\} .el \{\ \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] .\} .in 0 .sp -.5v .nf .BX .in .sp .5v .fi .\} .. .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" BM/EM - put colored marker in margin next to block of text .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .de BM .if t \{\ .br .ll -2n .gcolor red .di BX .\} .. .de EM .if t \{\ .br .di .ll .gcolor .nr BH \\n(dn .ne \\n(BHu \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] .in 0 .nf .BX .in .fi .\} .. .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "Name" fluxbox-style \- A comprehensive look at styles/themes for fluxbox(1)\&. .SH "Synopsis" .sp This document describes various options available for fluxbox styles\&. .SH "DESCRIPTION" .sp What is a Style? .sp Styles, sometimes referred to as Themes, are a graphical overlay for the fluxbox(1) window manager\&. If you wanted to get to know fluxbox, the styles would be the \fIlook\fR of the \fIlook and feel\fR\&. .sp Styles are simple ASCII text files that tell fluxbox(1) how to generate the appearance of different components of the window manager\&. The default installation of fluxbox(1) is shipped with many classic examples that show a great deal of what one could do\&. To use one of the standard styles navigate to the \fISystem Styles\fR menu under your main fluxbox(1) menu\&. .sp fluxbox(1) uses its own graphics class to render its images on the fly\&. By using styles you can determine, at a great level of configurability, what your desktop will look like\&. Since fluxbox(1) was derived from blackbox many often wonder if old themes will work on the latest releases of fluxbox(1)\&. Well they basically do, but you will have to tune them since the fluxbox(1) code has changed quite a bit since the initial grab\&. .SH "STRUCTURE" .sp A style is made up of a few major components which then have their own sub\-directives\&. The major components are as follows: .sp The \fIwindow\&.*\fR directives control the appearance of the window frames, window\&.tab\&.* controls the appearance of the window tabs, \fImenu\&.*\fR controls the appearance of the popup menu that you see when you right click on the desktop\&. \fItoolbar\&.*\fR is the bar you will see at the top or bottom of your screen\&. Finally the \fIslit\&.*\fR has options you can use to customize the appearance of the slit\&. However if you don\'t set the slit directives specifically, the slit\'s appearance is controlled by the toolbar directives instead\&. .sp To understand how the style mechanism works, it is nice to know a little about how X11 resources work\&. X11 resources consist of a key and a value\&. The key is constructed of several smaller keys (sometimes referred to as children), delimited by a period (\&.)\&. Keys may also contain an asterisk (*) to serve as a wildcard, which means that one line of text will match several keys\&. This is useful for styles that are based on one or two colors\&. .sp A more complete reference to this can be found in X(7), section \fIRESOURCES\fR\&. .SH "LOCATION" .sp There are many places to store your styles, the most common is in your \fI~/\&.fluxbox/styles\fR directory\&. The initial installation will place the default styles in \fI@pkgdatadir@/styles\fR providing a basic usable configuration\&. .sp When creating your own style, create a directory (normally the name of your style) in \fI~/\&.fluxbox/styles/\fR (If the \fIstyles\fR directory doesn\'t exist, create that also)\&. While there isn\'t an official structure, it is common to create a directory named after your style and place your pixmaps directory (if required) in there along with a file called theme\&.cfg (may also be named style\&.cfg)\&. This file is where you will construct your style using the components covered later in this manual page\&. An example of steps taken when beginning a style project of your own may look like: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray $ cd $ mkdir \-p ~/\&.fluxbox/styles/YourStyle/pixmaps $ cd ~/\&.fluxbox/styles/YourStyle $ nano theme\&.cfg .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp Output of a packaged style should look like the following: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray $ cd $ tar \-tjvf YourStyle\&.tar\&.bz2 \&.fluxbox/styles/YourStyle/theme\&.cfg \&.fluxbox/styles/YourStyle/pixmaps \&.fluxbox/styles/YourStyle/pixmaps/stick\&.xpm \&.\&.\&. .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp Of course, all of these are just preferences, fluxbox(1) allows for the customization of many things, including how you handle your styles\&. Just remember, however, that if you plan to distribute your style you may find some community bickering if you don\'t follow practices\&. :) .SH "CREATING YOUR STYLE" .sp As discussed above, fluxbox(1) allows you to configure its four main components: the toolbar, menus, slit and window decorations\&. Remember that you can customize the slit with its own directives, otherwise the slit will take the appearance of the toolbar\&. .sp Here are some quick examples to illustrate basic syntax: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray toolbar\&.clock\&.color: green .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp This sets the color resource of the toolbar clock to \fIgreen\fR\&. Another example: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray menu*color: rgb:3/4/5 .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp This sets the color resource of the menu and all of its \fIchildren\fR to `rgb:3/4/5\'\&. (For a description of color names, see X(1)\&.) So this one also applies to \fImenu\&.title\&.color\fR and \fImenu\&.frame\&.color\fR\&. And with .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray *font: \-b&h\-lucida\-medium\-r\-normal\-*\-*\-140\-* .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp you set the font resource for all keys to this font name all at once (For information about the fonts installed on your system, you can use a program like xfontsel(1), gtkfontsel, or xlsfonts(1)\&.) .sp In the last example you will notice the wildcard (*) before font\&. In a Fluxbox style you can set a value with a wildcard\&. The example means that every font in the style will be what is specified\&. You can do this with any component/value\&. For example if you wanted all of the text to be one color you would do: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray *textColor: rgb:3/4/5 .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp This means that you can setup a very simple style with very few properties\&. See the EXAMPLES below for an example of this in practice\&. fluxbox(1) also allows you to override wildcards in your style\&. Lets take our example above and add an override for the toolbar\&.clock\&.textColor component: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray *textColor: rgb:3/4/5 toolbar\&.clock\&.textColor: rgb:255/0/0 .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp With that all of the text will be \fIrgb:3/4/5\fR except the toolbar clock text which will be \fIrgb:255/0/0\fR\&. .sp Now what makes fluxbox(1) so spectacular is its ability to render textures on the fly\&. A texture is a fillpattern that you see on some styles\&. Texture descriptions are specified directly to the key that they should apply to, e\&.g\&.: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray toolbar\&.clock: Raised Gradient Diagonal Bevel1 toolbar\&.clock\&.color: rgb:8/6/4 toolbar\&.clock\&.colorTo: rgb:4/3/2 .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp Don\'t worry, we will explain what these mean\&. A texture description consists of up to five fields, which are as follows: .PP \fBFlat | Raised | Sunken\fR. gives the component either a flat, raised or sunken appearance\&. .PP \fBGradient | Solid\fR. tells fluxbox(1) to draw either a solid color or a gradient texture\&. .PP \fBHorizontal | Vertical | Diagonal | Crossdiagonal | Pipecross | Elliptic | Rectangle | Pyramid\fR. Select one of these texture types\&. They only work when \fBGradient\fR is specified\&. .PP \fBInterlaced\fR. tells fluxbox(1) to interlace the texture (darken every other line)\&. This option is most commonly used with gradiented textures, but it also works in solid textures\&. .PP \fBBevel1 | Bevel2\fR. tells fluxbox(1) which type of bevel to use\&. Bevel1 is the default bevel\&. The shading is placed on the edge of the image\&. Bevel2 is an alternative\&. The shading is placed one pixel in from the edge of the image\&. .sp Instead of a texture description, also the option \fBParentRelative\fR is available, which makes the component appear as a part of its parent, e\&.g\&. totally transparent\&. .sp Or for even more possibilities Pixmap\&. If pixmap texture is specified (it might not be necessary on every occasion) the pixmap file is specified in a separate pixmap resource\&. .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray toolbar\&.clock: pixmap toolbar\&.clock\&.pixmap: clock_background\&.xpm .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp This feature might need some investigation, reports say that sometimes the resources color and colorTo must be set and then they may not be set\&. .sp All gradiented textures are composed of two color values: the \fIcolor\fR and \fIcolorTo\fR resources\&. When \fBInterlaced\fR is used in \fBSolid\fR mode, the \fIcolorTo\fR resource is used to find the interlacing color\&. .SH "A WORD ABOUT FONTS" .sp We should comment about fonts before we move on to the complete component list\&. fluxbox(1) supports different options for text\&. These options currently include bold, halo and shadow\&. To set these do this: fontname\-size:options for any of the font components in the style file\&. For example: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray menu\&.title\&.font: sans\-8:bold,shadow .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp The latest versions of fluxbox(1) (> 0\&.9\&.8) also support different values for these text options\&. The possibilities are as follows: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray \-\-\-\-\-\-\-\- Shadow color=<colorname> offsetx=<integer> offsety=<integer> Halo color=<colorname> \-\-\-\-\-\-\-\- .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp For the case of completeness, here are some real world examples: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray *\&.font: Verdana\-10:bold,shadow:offsetx=2;offsety=4;color=green *\&.font: Verdana\-10:halo:color=blue .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp Of course this could all be placed on one line\&. Also note that for the offset options, negative integers are allowed\&. .SS "FONT PROBLEMS" .sp If you have problems installing fonts or getting them to work, you should read the docs page at xfree\&.org\&. Here is a link to one of these: \m[blue]\fBhttp://xfree\&.org/4\&.3\&.0/fonts2\&.html#3\fR\m[] .SH "FULL COMPONENT LIST" .sp Here is the exhaustive component list for fluxbox(1) styles\&. Each one is listed with their type of value required\&. Comments in a style file are preceded with an exclamation point (!) which we also use here so that these can be pasted into a new theme\&.cfg to be customized appropiately\&. Please note that in order to keep styles consistent it is often the practice of stylists to provide all of the theme\-items in their style file even if they are not used\&. This allows the user the ease of changing different components\&. .SH "WINDOW OPTIONS" .sp Many, many things you can do with window design in fluxbox(1), below are your options\&. Have fun\&. .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- window\&.bevelWidth: <integer> window\&.borderColor: <color> window\&.borderWidth: <integer> window\&.button\&.focus: <texture type> window\&.button\&.focus\&.color: <color> window\&.button\&.focus\&.colorTo: <color> window\&.button\&.focus\&.picColor: <color> window\&.button\&.focus\&.pixmap: <filename> window\&.button\&.pressed: <texture type> window\&.button\&.pressed\&.color: <color> window\&.button\&.pressed\&.colorTo: <color> window\&.button\&.pressed\&.pixmap: <filename> window\&.button\&.unfocus: <texture type> window\&.button\&.unfocus\&.color: <color> window\&.button\&.unfocus\&.colorTo: <color> window\&.button\&.unfocus\&.picColor: <color> window\&.button\&.unfocus\&.pixmap: <filename> window\&.close\&.pixmap: <filename> window\&.close\&.pressed\&.pixmap: <filename> window\&.close\&.unfocus\&.pixmap: <filename> window\&.font: <font> window\&.frame\&.focusColor: <color> window\&.frame\&.unfocusColor: <color> window\&.grip\&.focus: <texture type> window\&.grip\&.focus\&.color: <color> window\&.grip\&.focus\&.colorTo: <color> window\&.grip\&.focus\&.pixmap: <filename> window\&.grip\&.unfocus: <texture type> window\&.grip\&.unfocus\&.color: <color> window\&.grip\&.unfocus\&.colorTo: <color> window\&.grip\&.unfocus\&.pixmap: <filename> window\&.handle\&.focus: <texture type> window\&.handle\&.focus\&.color: <color> window\&.handle\&.focus\&.colorTo: <color> window\&.handle\&.focus\&.pixmap: <filename> window\&.handle\&.unfocus: <texture type> window\&.handle\&.unfocus\&.color: <color> window\&.handle\&.unfocus\&.colorTo: <color> window\&.handle\&.unfocus\&.pixmap: <filename> window\&.handleWidth: <integer> window\&.iconify\&.pixmap: <filename> window\&.iconify\&.pressed\&.pixmap: <filename> window\&.iconify\&.unfocus\&.pixmap: <filename> window\&.justify: <{Left|Right|Center}> window\&.label\&.active: <texture type> window\&.label\&.active\&.textColor: <color> window\&.label\&.focus: <texture type> window\&.label\&.focus\&.color: <color> window\&.label\&.focus\&.colorTo: <color> window\&.label\&.focus\&.pixmap: <filename> window\&.label\&.unfocus: <texture type> window\&.label\&.unfocus\&.color: <color> window\&.label\&.unfocus\&.colorTo: <color> window\&.label\&.unfocus\&.pixmap: <filename> window\&.label\&.focus\&.textColor: <color> window\&.label\&.unfocus\&.textColor: <color> window\&.maximize\&.pixmap: <filename> window\&.maximize\&.pressed\&.pixmap: <filename> window\&.maximize\&.unfocus\&.pixmap: <filename> window\&.roundCorners: <{Top|Bottom}{Left|Right}> window\&.shade\&.pixmap: <filename> window\&.shade\&.pressed\&.pixmap: <filename> window\&.shade\&.unfocus\&.pixmap: <filename> window\&.stick\&.pixmap: <filename> window\&.stick\&.pressed\&.pixmap: <filename> window\&.stick\&.unfocus\&.pixmap: <filename> window\&.stuck\&.pixmap: <filename> window\&.stuck\&.unfocus\&.pixmap: <filename> window\&.title\&.focus: <texture type> window\&.title\&.focus\&.color: <color> window\&.title\&.focus\&.colorTo: <color> window\&.title\&.focus\&.pixmap: <filename> window\&.title\&.height: <integer> window\&.title\&.unfocus: <texture type> window\&.title\&.unfocus\&.color: <color> window\&.title\&.unfocus\&.colorTo: <color> window\&.title\&.unfocus\&.pixmap: <filename> \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .SH "MENU OPTIONS" .sp Everything you need to make your menu look pretty\&. .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- menu\&.bevelWidth: <integer> menu\&.borderColor: <color> menu\&.borderWidth: <integer> menu\&.bullet: <{empty|square|triangle|diamond}> menu\&.bullet\&.position: <{left|right}> menu\&.frame: <texture type> menu\&.frame\&.color: <color> menu\&.frame\&.colorTo: <color> menu\&.frame\&.disableColor: <color> menu\&.frame\&.font: <font> menu\&.frame\&.justify: <{Left|Right|Center}> menu\&.frame\&.pixmap: <filename> menu\&.frame\&.textColor: <color> menu\&.hilite: <texture type> menu\&.hilite\&.color: <color> menu\&.hilite\&.colorTo: <color> menu\&.hilite\&.pixmap: <filename> menu\&.hilite\&.textColor: <color> menu\&.itemHeight: <integer> menu\&.title: <texture type> menu\&.title\&.color: <color> menu\&.title\&.colorTo: <color> menu\&.title\&.font: <font> menu\&.title\&.pixmap: <filename> menu\&.title\&.textColor: <color> menu\&.title\&.justify: <{Left|Right|Center}> menu\&.titleHeight: <integer> menu\&.roundCorners: <{Top|Bottom}{Left|Right}> menu\&.selected\&.pixmap: <filename> menu\&.submenu\&.pixmap: <filename> menu\&.unselected\&.pixmap: <filename> \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .SH "BACKGROUND" .sp Every style must specify the background option\&. If you don\'t want your style to change the user\'s background, then use `background: none\'\&. The options `centered\', `aspect\', `tiled\', and `fullscreen\' require the `background\&.pixmap\' resource to contain a valid file name\&. The `random\' option requires `background\&.pixmap\' to contain a valid directory name\&. For these options, \fBfluxbox(1)\fR will call \fBfbsetbg(1)\fR to set the background\&. The options `gradient\', `solid\', and `mod\' all require `background\&.color\' to be set\&. `gradient\' and `mod\' both require `background\&.colorTo\'\&. `mod\' requires `background\&.modX\' and `background\&.modY\' to be set as well\&. These options will be passed to \fBfbsetroot(1)\fR to set the background\&. The special option `unset\' is for use in user overlay files only\&. It specifies that fbsetbg should never be run (by default, even when `none\' is set in the overlay, fluxbox will try to run \(lqfbsetbg \-z\(rq to restore the last wallpaper)\&. .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray background: centered|aspect|tiled|fullscreen|random|solid|gradient <texture>|mod|none|unset background\&.pixmap: <file or directory> background\&.color: <color> background\&.colorTo: <color> background\&.modX: <integer> background\&.modY: <integer> .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .SH "SLIT" .sp Here are all of the options for the slit\&. .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- slit: <texture type> slit\&.bevelWidth: <integer> slit\&.borderColor: <color> slit\&.borderWidth: <integer> slit\&.color: <color> slit\&.colorTo: <color> slit\&.pixmap: <filename> \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .SH "TOOLBAR OPTIONS" .sp Below you will find all of the configuration possibilities for the toolbar\&. The list is pretty extensive and offers you many options to make your toolbar look just the way you want it\&. .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- toolbar: <texture type> toolbar\&.bevelWidth: <integer (0\-255)> toolbar\&.borderColor: <color> toolbar\&.borderWidth: <integer> toolbar\&.button\&.scale: <integer> toolbar\&.color: <color> toolbar\&.colorTo: <color> toolbar\&.clock: <texture type> toolbar\&.clock\&.borderColor: <color> toolbar\&.clock\&.borderWidth: <integer> toolbar\&.clock\&.font: <font> toolbar\&.clock\&.justify: <{Left|Right|Center}> toolbar\&.clock\&.pixmap: <filename> toolbar\&.clock\&.color: <color> toolbar\&.clock\&.colorTo: <color> toolbar\&.clock\&.textColor: <color> toolbar\&.height: <integer> toolbar\&.iconbar\&.focused: <texture type> toolbar\&.iconbar\&.focused\&.color: <color> toolbar\&.iconbar\&.focused\&.colorTo:<color> toolbar\&.iconbar\&.focused\&.pixmap: <filename> toolbar\&.iconbar\&.unfocused: <texture type> toolbar\&.iconbar\&.unfocused\&.color: <color> toolbar\&.iconbar\&.unfocused\&.colorTo: <color> toolbar\&.iconbar\&.unfocused\&.pixmap: <filename> toolbar\&.iconbar\&.empty: <texture type> toolbar\&.iconbar\&.empty\&.color: <color> toolbar\&.iconbar\&.empty\&.colorTo: <color> toolbar\&.iconbar\&.empty\&.pixmap: <filename> toolbar\&.iconbar\&.focused\&.borderColor: <color> toolbar\&.iconbar\&.focused\&.borderWidth: <integer> toolbar\&.iconbar\&.unfocused\&.borderColor: <color> toolbar\&.iconbar\&.unfocused\&.borderWidth: <integer> toolbar\&.iconbar\&.borderColor: <color> toolbar\&.iconbar\&.borderWidth: <integer> toolbar\&.iconbar\&.focused\&.font: <font> toolbar\&.iconbar\&.focused\&.justify: <{Left|Right|Center}> toolbar\&.iconbar\&.focused\&.textColor: <color> toolbar\&.iconbar\&.unfocused\&.font: <font> toolbar\&.iconbar\&.unfocused\&.justify: <{Left|Right|Center}> toolbar\&.iconbar\&.unfocused\&.textColor: <color> toolbar\&.pixmap: <filename> toolbar\&.shaped: <boolean> toolbar\&.workspace\&.font: <font> toolbar\&.workspace\&.justify: <{Left|Right|Center}> toolbar\&.workspace\&.textColor: <color> toolbar\&.workspace: <texture type> toolbar\&.workspace\&.borderColor: <color> toolbar\&.workspace\&.borderWidth: <integer> toolbar\&.workspace\&.color: <color> toolbar\&.workspace\&.colorTo: <color> toolbar\&.workspace\&.pixmap: <filename> \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .SH "EXAMPLES" .sp This list may seem intimidating, but remember, when you create your own style you can easily set a majority of these keys with a single component\&. For an example of this: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- *color: slategrey *colorTo: darkslategrey *unfocus\&.color: darkslategrey *unfocus\&.colorTo: black *textColor: white *unfocus\&.textColor: lightgrey *font: lucidasans\-10 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp This sets nice defaults for many components\&. .SH "COLOR FORMATS" .sp These are the color formats for styles: .sp .if n \{\ .RS 4 .\} .fam C .ps -1 .nf .BB lightgray #000000 (Hexadecimal) rgb:<0\-255>/<0\-255>/<0\-255> .EB lightgray .fi .fam .ps +1 .if n \{\ .RE .\} .sp See /usr/share/X11/rgb\&.txt for an explaination\&. .SH "AUTHORS" .sp Blackbox was written and maintained by Brad Hughes <blackbox at alug\&.org> and Jeff Raven <jraven at psu\&.edu>\&. .sp fluxbox(1) is written and maintained by Henrik Kinnunen <fluxgen at fluxbox\&.org> with contributions and patches merged from many individuals around the world\&. .sp The Official fluxbox(1) website: \m[blue]\fBhttp://www\&.fluxbox\&.org\fR\m[] You can find a lot of styles here: \m[blue]\fBhttp://tenr\&.de/\fR\m[] .sp This manpage was composed from various resources including the official documentation, fluxbox(1) man page and numerous other resources by Curt "Asenchi" Micol\&. If you notice any errors or problems with this page, please contact him here: <asenchi at asenchi\&.com> and using the great contributions of <grubert at users\&.sourceforge\&.net>\&. Numerous other languages could be available if someone jumps in\&. .SH "SEE ALSO" .sp fluxbox(1) fbsetbg(1) fbsetroot(1)