1AWESOME(1) AWESOME(1)
2
6 awesome - awesome window manager
7
9 awesome [-v | --version] [-h | --help] [-c | --config FILE] [-k |
10 --check] [--search DIRECTORY] [-a | --no-argb] [-r | *--replace]
11
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 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 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 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
36 -v, --version
37 Print version information to standard output, then exit.
38 -h, --help
40 Print help information, then exit.
41 -c, --config FILE
43 Use an alternate configuration file instead of
44 $XDG_CONFIG_HOME/awesome/rc.lua.
45 -k, --check
47 Check configuration file syntax.
48 --search
50 Add a directory to the library search path.
51 -a, --no-argb
53 Don’t use ARGB visuals.
54 -r, --replace
56 Replace an existing window manager.
57
59 Navigation
60 Button1 on tag name
61 View tag.
62 Button4, Button5 on tag name
64 Switch to previous or next tag.
65 Button4, Button5 on root window
67 Switch to previous or next tag.
68 Button1, Button3, Button4, Button5 on layout symbol
70 Switch to previous or next layout.
71 Layout modification
73 Mod4 + Button1 on tag name
74 Tag current client with this tag only.
75 Mod4 + Button3 on tag name
77 Toggle this tag for client.
78 Button3 on tag name
80 Add this tag to current view.
81 Mod4 + Button1 on client window
83 Move window.
84 Mod4 + Button3 on client window
86 Resize window.
87
89 Help
90 Mod4 + s
91 Show currently assigned key bindings.
92 Window manager control
94 Mod4 + Control + r
95 Restart awesome.
96 Mod4 + Shift + q
98 Quit awesome.
99 Mod4 + r
101 Run prompt.
102 Mod4 + x
104 Run Lua code prompt.
105 Mod4 + Return
107 Spawn terminal emulator.
108 Mod4 + w
110 Open main menu.
111 Clients
113 Mod4 + m
114 Maximize client.
115 Mod4 + n
117 Minimize client.
118 Mod4 + Control + n
120 Restore client.
121 Mod4 + f
123 Set client fullscreen.
124 Mod4 + Shift + c
126 Kill focused client.
127 Mod4 + t
129 Set client on-top.
130 Navigation
132 Mod4 + j
133 Focus next client.
134 Mod4 + k
136 Focus previous client.
137 Mod4 + u
139 Focus first urgent client.
140 Mod4 + Left
142 View previous tag.
143 Mod4 + Right
145 View next tag.
146 Mod4 + 1-9
148 Switch to tag 1-9.
149 Mod4 + Control + j
151 Focus next screen.
152 Mod4 + Control + k
154 Focus previous screen.
155 Mod4 + Escape
157 Focus previously selected tag set.
158 Layout modification
160 Mod4 + Shift + j
161 Switch client with next client.
162 Mod4 + Shift + k
164 Switch client with previous client.
165 Mod4 + o
167 Send client to next screen.
168 Mod4 + h
170 Decrease master width factor by 5%.
171 Mod4 + l
173 Increase master width factor by 5%.
174 Mod4 + Shift + h
176 Increase number of master windows by 1.
177 Mod4 + Shift + l
179 Decrease number of master windows by 1.
180 Mod4 + Control + h
182 Increase number of columns for non-master windows by 1.
183 Mod4 + Control + l
185 Decrease number of columns for non-master windows by 1.
186 Mod4 + space
188 Switch to next layout.
189 Mod4 + Shift + space
191 Switch to previous layout.
192 Mod4 + Control + space
194 Toggle client floating status.
195 Mod4 + Control + Return
197 Swap focused client with master.
198 Mod4 + Control + 1-9
200 Toggle tag view.
201 Mod4 + Shift + 1-9
203 Tag client with tag.
204 Mod4 + Shift + Control + 1-9
206 Toggle tag on client.
207
209 awesome is customized by creating a custom
210 $XDG_CONFIG_HOME/awesome/rc.lua file.
211
213 awesome can be restarted by sending it a SIGHUP.
214
216 awesomerc(5) awesome-client(1)
217
219 Of course there’s no bug in awesome. But there may be unexpected
220 behaviors.
221
223 Julien Danjou julien@danjou.info and others.
224
226 https://awesomewm.org
227 2021-07-21 AWESOME(1)