7 awesomerc - Configuration file for the 'awesome window manager'
16 <item> [<argument>] { <option> = <value>, ... }
26 The awesomerc file contains configuration informations for *awesome*. It can
27 be used to configure the behaviour and look of awesome in a variety of ways.
29 It is read at startup.
34 In awesome, a lot of *functions* are available. These functions are called
35 uicb (User Interface Call Backs). Each function can be bound to a key shortcut
41 This function quits awesome.
42 *statusbar_toggle* statusbar-identifier::
43 Hide or show statusbar (with no argument, toggle all).
45 Execute an external program.
47 Replace awesome with another window manager (or itself; i.e. reload config).
48 *widget_tell* widget-identifier data::
49 Feed information to your widgets.
54 Closes the focused client.
55 *client_moveresize* x y width height::
56 Dynamically move and resize floating windows.
57 Coordinates can be relative or absolute. Relative values must begin with + or -.
58 E.g: to move a window 10 pixels up: "+0 \+10 +0 +0" To move a window
59 in the upper left corner and increase its width by 10px: "0 0 \+0 +10"
60 *client_settrans* float::
61 Set client transparency, number can be a relative or absolute floating number in percentage.
63 Swap window placement with the next displayed window.
65 Swap window placement with the previous displayed window.
69 Focus previous window.
71 Set window fullscreen. Calling this function another time will reset the window to its previous state.
72 *client_togglehorizontalmax*::
73 Set window's horizontal size to display width. Calling another time will reset the window to its previous state.
74 *client_toggleverticalmax*::
75 Set window's vertical size to display height. Calling another time will reset the window to its previous state.
76 *client_togglefloating*::
77 Set window floating or tiled.
79 Set window as master window.
80 *client_movetoscreen* relative or absolute integer::
81 Move focused window to the nth screen, or next (+1) or previous (-1). If no screen_number is set, move to the next screen.
82 *client_tag* tag number::
83 Tag focused window with this tag.
85 Add or remove tag to focused window.
87 Move client window with mouse.
88 *client_resizemouse*::
89 Resize client window with mouse.
93 *tag_setlayout* relative or absolute integer::
94 Set layout number; or just switch to the next layout for current tag.
95 *tag_toggleview* tag::
96 Add windows tagged with tag number to current display.
97 *tag_view* tag number::
98 View windows tagged with tag number.
100 Show windows tagged with next tag in list.
102 Show windows tagged with previous tag in list.
103 *tag_viewprev_selected*::
104 Switch back to the previously displayed set of tags.
105 *tag_setmwfact* relative or absolute float::
106 Set master width factor.
107 *tag_setncol* relative or absolute integer::
108 Set number of columns for non-master windows.
109 *tag_setnmaster* relative or absolute integer::
110 Set number of master windows.
112 Create a new tag with that name.
116 *focus_client_byname* string::
117 Give client focus by its name.
118 *focus_history* negative number::
119 Focus the client that had focused nth focus switch earlier.
123 *screen_focus* relative or absolute integer::
124 Select Screen and focus first window and move mouse.
128 Statusbars can be customized by modifying widgets names, order and options.
132 This widget shows the tag list.
137 Horizontal offset (auto-alignment if not set).
139 Vertical offset (auto-alignment if not set).
143 This widget shows a icon for the selected layout.
148 Horizontal offset (auto-alignment if not set).
150 Vertical offset (auto-alignment if not set).
154 This widget shows a icon for the focused window using NET_WM_ICON or icon file set in rule.
159 Horizontal offset (auto-alignment if not set).
161 Vertical offset (auto-alignment if not set).
165 This widget shows the title of the focused window.
178 Horizontal offset (auto-alignment if not set).
180 Vertical offset (auto-alignment if not set).
184 This widget shows a list of running windows.
195 Background color for focused window.
197 Foreground color for focused window.
201 Show applications icons.
203 Show all windows from all tags.
205 Horizontal offset (auto-alignment if not set).
207 Vertical offset (auto-alignment if not set).
211 This widget shows a text.
228 Horizontal offset (auto-alignment if not set).
230 Vertical offset (auto-alignment if not set).
234 This widget shows an icon.
241 Resize icon to fit into statusbar.
243 Horizontal offset (auto-alignment if not set).
245 Vertical offset (auto-alignment if not set).
249 This widget shows one or more progress-bars.
256 Set height (i.e. 0.9 = 90%)
258 Empty space on the left.
260 Draws a bar; Options: fg, bg, bordercolor.
268 Horizontal offset (auto-alignment if not set).
270 Vertical offset (auto-alignment if not set).
274 This widget shows a graph.
277 Re-scales when input > max (see below).
279 This value prints a full graph.
285 Set height (i.e. 0.9 = 90%)
287 Empty space on the left.
295 Horizontal offset (auto-alignment if not set).
297 Vertical offset (auto-alignment if not set).
302 Configuration options and possible values.
304 ..............................................
305 Note: when there is no whitespace, quotes are optional.
307 <boolean> -> "true" or "false"
308 <color> -> #ff9933 (hexadecimal color notation: #red green blue)
309 <float> -> 0.3, 0,8 (often values between 0 and 1 are useful)
310 <font> -> Xft font: mono-10, fixed-12, sans-8, ...
311 <identifier> -> foobar (choose a name/string)
312 <image> -> "/home/awesome/pics/icon.png" (path to image)
313 <integer> -> 1, 10, -3 (positive numbers are required mostly)
314 <key> -> a, 1, F10 (see /usr/include/X11/keysymdef.h w/o XK_ or 'xev')
315 <mod> -> "Mod1", "Mod4", "Control" (modifiers)
316 <regex> -> regular expression
317 <string> -> "foo bar"
318 <uicb-arg> -> prog, 3... (argument to a uicb function, where required)
319 <uicb-cmd> -> spawn, exec, client_tag... (see UICB FUNCTIONS above)
320 <{.., ...}> -> list of available options
322 [MULTI] means, you can use an item multiple times.
326 screen <integer> [MULTI]
330 allow_lower_floats = <boolean>
332 focus_move_pointer = <boolean>
334 new_become_master = <boolean>
335 new_get_focus = <boolean>
336 opacity_unfocused = <integer>
337 resize_hints = <boolean>
338 sloppy_focus = <boolean>
343 tag <identifier> [MULTI]
345 layout = <{dwindle,floating,max,
346 spiral,tile,tileleft}>
353 layout <{dwindle,floating,max,
354 spiral,tile,tileleft}> { image = <image> } [MULTI]
361 normal_border = <color>
364 focus_border = <color>
375 statusbar <identifier> [MULTI]
377 position = <{top,bottom,left,right}>
381 taglist <identifier> [MULTI]
383 x = <integer> y = <integer>
386 button = <integer> modkey = {<mod>, ...}
387 command = <uicb-cmd> arg = <uicb-arg>
390 layoutinfo <identifier>
392 x = <integer> y = <integer>
395 button = <integer> modkey = {<mod>, ...}
396 command = <uicb-cmd> arg = <uicb-arg>
399 netwmicon <identifier>
401 x = <integer> y = <integer>
404 button = <integer> modkey = {<mod>, ...}
405 command = <uicb-cmd> arg = <uicb-arg>
408 focustitle <identifier>
413 align = <{center,left,right}>
414 x = <integer> y = <integer>
417 button = <integer> modkey = {<mod>, ...}
418 command = <uicb-cmd> arg = <uicb-arg>
421 tasklist <identifier>
428 show_icons = <boolean>
430 align = <{center,left,right}>
431 x = <integer> y = <integer>
434 command = <uicb-cmd> arg = <uicb-arg>
435 button = <integer> modkey = {<mod>, ...}
438 textbox <identifier> [MULTI]
445 align = <{center,left,right}>
446 x = <integer> y = <integer>
449 button = <integer> modkey = {<mod>, ...}
450 command = <uicb-cmd> arg = <uicb-arg>
453 iconbox <identifier> [MULTI]
457 x = <integer> y = <integer>
460 button = <integer> modkey = {<mod>, ...}
461 command = <uicb-cmd> arg = <uicb-arg>
464 progressbar <identifier> [MULTI]
466 bar { fg = <color> bg = <color> bordercolor = <color> } [MULTI]
470 padding_left = <integer>
471 x = <integer> y = <integer>
474 button = <integer> modkey = {<mod>, ...}
475 command = <uicb-cmd> arg = <uicb-arg>
478 graph <identifier> [MULTI]
484 padding_left = <integer>
487 bordercolor = <color>
488 x = <integer> y = <integer>
491 button = <integer> modkey = {<mod>, ...}
492 command = <uicb-cmd> arg = <uicb-arg>
502 xproperty_name = <string>
503 xproperty_value = <regex>
504 float = <{auto,true,false}>
508 not_master = <boolean>
515 key = <key> modkey = {<mod>, ...}
516 command = <uicb-cmd> arg = <uicb-arg>
520 keylist = {<key>, ...}
521 modkey = {<mod>, ...}
523 arglist = {<uicb-arg>, ...}
530 button = <integer> modkey = {<mod>, ...}
531 command = <uicb-cmd> arg = <uicb-arg>
535 button = <integer> modkey = {<mod>, ...}
536 command = <uicb-cmd> arg = <uicb-arg>
539 ..............................................
544 Check awesome's wiki: http://awesome.naquadah.org/wiki/
549 awesome(1) awesome-client(1)
554 This man page was written by Julien Danjou <julien@danjou.info> and Marco Candrian <mac@calmar.ws>.
558 http://awesome.naquadah.org