1AWESOMERC(5) AWESOMERC(5)
2
3
4
6 awesomerc - Configuration file for the awesome window manager
7
9 awesome looks for a configuration file in this order:
10
11 • $XDG_CONFIG_HOME/awesome/rc.lua
12
13 • $HOME/.config/awesome/rc.lua
14
15 • $XDG_CONFIG_DIRS/awesome/rc.lua
16
18 The rc.lua file contains configuration information for awesome. It can
19 be used to configure the behavior and look of awesome in a variety of
20 ways. It can be assimilated as a Lua program/script run at startup by
21 awesome. Therefore, it should use the awesome Lua API described in the
22 API section. This file is read at startup.
23
25 Documentation for the Lua API can be found in the luadoc directory.
26
28 The color format in awesome is either a standard X color name (blue,
29 darkblue, lightred, etc) or a hexadecimal formatted color (#rrggbb or
30 #rrggbbaa). By using the hexadecimal format, you can also specify an
31 alpha channel: that means that #00ff00 will draw pure green, but
32 #00ff00aa will set the alpha channel to ‘aa’ and will blend the green
33 with the color under it.
34
36 You can use Pango markup in a text string. This allows formatting the
37 text rendered inside widgets. Pango markup documentation can be found
38 in the Pango documentation at
39 http://library.gnome.org/devel/pango/stable/PangoMarkupFormat.html.
40
41 A Pango markup example: <span weight="bold"
42 foreground="#336699">...</span>.
43
45 awesome(1) awesome-client(1)
46
48 Written by Julien Danjou julien@danjou.info.
49
51 https://awesomewm.org
52
53
54
55 2021-07-21 AWESOMERC(5)