1AWESOME(1)                                                          AWESOME(1)
2
3
4

NAME

6       awesome - awesome window manager
7

SYNOPSIS

9       awesome [-v | --version] [-h | --help] [-c | --config FILE] [-k |
10       --check] [--search DIRECTORY] [-a | --no-argb] [-r | *--replace]
11

DESCRIPTION

13       awesome is a window manager for X. It manages windows in different
14       layouts, like floating or tiled. Any layout can be applied dynamically,
15       optimizing the environment for the application in use and the task
16       currently being performed.
17
18       In a tiled layout, windows are managed in a master and stacking area.
19       The master area contains the windows which currently need the most
20       attention, whereas the stacking area contains all other windows. In a
21       floating layout windows can be resized and moved freely. Dialog windows
22       are always managed as floating, regardless of the layout currently
23       applied. The spiral and dwindle layouts are special cases of the tiled
24       layout where the stacking area is arranged in a spiral for the former
25       or as a rectangular fractal for the later.
26
27       Windows are grouped by tags in awesome. Each window can be tagged with
28       one or more tags. Selecting certain tags displays all windows with
29       these tags.
30
31       awesome can contain small wiboxes which can display anything you want:
32       all available tags, the current layout, the title of the visible
33       windows, text, etc.
34

OPTIONS

36       -v, --version
37           Print version information to standard output, then exit.
38
39       -h, --help
40           Print help information, then exit.
41
42       -c, --config FILE
43           Use an alternate configuration file instead of
44           $XDG_CONFIG_HOME/awesome/rc.lua.
45
46       -k, --check
47           Check configuration file syntax.
48
49       --search
50           Add a directory to the library search path.
51
52       -a, --no-argb
53           Don’t use ARGB visuals.
54
55       -r, --replace
56           Replace an existing window manager.
57

DEFAULT MOUSE BINDINGS

59   Navigation
60       Button1 on tag name
61           View tag.
62
63       Button4, Button5 on tag name
64           Switch to previous or next tag.
65
66       Button4, Button5 on root window
67           Switch to previous or next tag.
68
69       Button1, Button3, Button4, Button5 on layout symbol
70           Switch to previous or next layout.
71
72   Layout modification
73       Mod4 + Button1 on tag name
74           Tag current client with this tag only.
75
76       Mod4 + Button3 on tag name
77           Toggle this tag for client.
78
79       Button3 on tag name
80           Add this tag to current view.
81
82       Mod4 + Button1 on client window
83           Move window.
84
85       Mod4 + Button3 on client window
86           Resize window.
87

DEFAULT KEY BINDINGS

89   Help
90       Mod4 + s
91           Show currently assigned key bindings.
92
93   Window manager control
94       Mod4 + Control + r
95           Restart awesome.
96
97       Mod4 + Shift + q
98           Quit awesome.
99
100       Mod4 + r
101           Run prompt.
102
103       Mod4 + x
104           Run Lua code prompt.
105
106       Mod4 + Return
107           Spawn terminal emulator.
108
109       Mod4 + w
110           Open main menu.
111
112   Clients
113       Mod4 + m
114           Maximize client.
115
116       Mod4 + n
117           Minimize client.
118
119       Mod4 + Control + n
120           Restore client.
121
122       Mod4 + f
123           Set client fullscreen.
124
125       Mod4 + Shift + c
126           Kill focused client.
127
128       Mod4 + t
129           Set client on-top.
130
131   Navigation
132       Mod4 + j
133           Focus next client.
134
135       Mod4 + k
136           Focus previous client.
137
138       Mod4 + u
139           Focus first urgent client.
140
141       Mod4 + Left
142           View previous tag.
143
144       Mod4 + Right
145           View next tag.
146
147       Mod4 + 1-9
148           Switch to tag 1-9.
149
150       Mod4 + Control + j
151           Focus next screen.
152
153       Mod4 + Control + k
154           Focus previous screen.
155
156       Mod4 + Escape
157           Focus previously selected tag set.
158
159   Layout modification
160       Mod4 + Shift + j
161           Switch client with next client.
162
163       Mod4 + Shift + k
164           Switch client with previous client.
165
166       Mod4 + o
167           Send client to next screen.
168
169       Mod4 + h
170           Decrease master width factor by 5%.
171
172       Mod4 + l
173           Increase master width factor by 5%.
174
175       Mod4 + Shift + h
176           Increase number of master windows by 1.
177
178       Mod4 + Shift + l
179           Decrease number of master windows by 1.
180
181       Mod4 + Control + h
182           Increase number of columns for non-master windows by 1.
183
184       Mod4 + Control + l
185           Decrease number of columns for non-master windows by 1.
186
187       Mod4 + space
188           Switch to next layout.
189
190       Mod4 + Shift + space
191           Switch to previous layout.
192
193       Mod4 + Control + space
194           Toggle client floating status.
195
196       Mod4 + Control + Return
197           Swap focused client with master.
198
199       Mod4 + Control + 1-9
200           Toggle tag view.
201
202       Mod4 + Shift + 1-9
203           Tag client with tag.
204
205       Mod4 + Shift + Control + 1-9
206           Toggle tag on client.
207

CUSTOMIZATION

209       awesome is customized by creating a custom
210       $XDG_CONFIG_HOME/awesome/rc.lua file.
211

SIGNALS

213       awesome can be restarted by sending it a SIGHUP.
214

SEE ALSO

216       awesomerc(5) awesome-client(1)
217

BUGS

219       Of course there’s no bug in awesome. But there may be unexpected
220       behaviors.
221

AUTHORS

223       Julien Danjou julien@danjou.info and others.
224

WWW

226       https://awesomewm.org
227
228
229
230                                  2022-01-19                        AWESOME(1)
Impressum