-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathw.1.html
432 lines (422 loc) · 43.2 KB
/
w.1.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
<!DOCTYPE html>
<html lang="en" dir="ltr" class="client-nojs">
<head>
<meta charset="UTF-8" />
<title>awesome</title>
<meta name="generator" content="MediaWiki 1.24.2" />
<link rel="alternate" type="application/x-wiki" title="Edit" href="/w/index.php?title=Main_Page&action=edit" />
<link rel="edit" title="Edit" href="/w/index.php?title=Main_Page&action=edit" />
<link rel="shortcut icon" href="/images/icons/aw_16.png" />
<link rel="search" type="application/opensearchdescription+xml" href="/w/opensearch_desc.php" title="awesome (en)" />
<link rel="EditURI" type="application/rsd+xml" href="https://awesomewm.org/w/api.php?action=rsd" />
<link rel="alternate" hreflang="x-default" href="/wiki/Main_Page" />
<link rel="copyright" href="https://creativecommons.org/licenses/by/3.0/" />
<link rel="alternate" type="application/atom+xml" title="awesome Atom feed" href="/w/index.php?title=Special:RecentChanges&feed=atom" />
<link rel="stylesheet" href="https://awesomewm.org/w/load.php?debug=false&lang=en&modules=mediawiki.legacy.commonPrint%2Cshared%7Cmediawiki.skinning.content.externallinks%7Cmediawiki.skinning.interface%7Cmediawiki.ui.button%7Cskins.monobook.styles&only=styles&skin=monobook&*" />
<!--[if IE 6]><link rel="stylesheet" href="/w/skins/MonoBook/IE60Fixes.css?303" media="screen" /><![endif]-->
<!--[if IE 7]><link rel="stylesheet" href="/w/skins/MonoBook/IE70Fixes.css?303" media="screen" /><![endif]--><meta name="ResourceLoaderDynamicStyles" content="" />
<link rel="stylesheet" href="https://awesomewm.org/w/load.php?debug=false&lang=en&modules=site&only=styles&skin=monobook&*" />
<style>a:lang(ar),a:lang(kk-arab),a:lang(mzn),a:lang(ps),a:lang(ur){text-decoration:none}
/* cache key: awesome:resourceloader:filter:minify-css:7:ad506c29508072131b881ff3f2f9d363 */</style>
<script src="https://awesomewm.org/w/load.php?debug=false&lang=en&modules=startup&only=scripts&skin=monobook&*"></script>
<script>if(window.mw){
mw.config.set({"wgCanonicalNamespace":"","wgCanonicalSpecialPageName":false,"wgNamespaceNumber":0,"wgPageName":"Main_Page","wgTitle":"Main Page","wgCurRevisionId":7469,"wgRevisionId":7469,"wgArticleId":1,"wgIsArticle":true,"wgIsRedirect":false,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":["Awesome"],"wgBreakFrames":false,"wgPageContentLanguage":"en","wgPageContentModel":"wikitext","wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""],"wgDefaultDateFormat":"dmy","wgMonthNames":["","January","February","March","April","May","June","July","August","September","October","November","December"],"wgMonthNamesShort":["","Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],"wgRelevantPageName":"Main_Page","wgIsProbablyEditable":true,"wgRestrictionEdit":[],"wgRestrictionMove":[],"wgIsMainPage":true});
}</script><script>if(window.mw){
mw.loader.implement("user.options",function($,jQuery){mw.user.options.set({"ccmeonemails":0,"cols":80,"date":"default","diffonly":0,"disablemail":0,"editfont":"default","editondblclick":0,"editsectiononrightclick":0,"enotifminoredits":0,"enotifrevealaddr":0,"enotifusertalkpages":1,"enotifwatchlistpages":1,"extendwatchlist":0,"fancysig":0,"forceeditsummary":0,"gender":"unknown","hideminor":0,"hidepatrolled":0,"imagesize":2,"math":1,"minordefault":0,"newpageshidepatrolled":0,"nickname":"","norollbackdiff":0,"numberheadings":0,"previewonfirst":0,"previewontop":1,"rcdays":7,"rclimit":50,"rows":25,"showhiddencats":0,"shownumberswatching":1,"showtoolbar":1,"skin":"monobook","stubthreshold":0,"thumbsize":5,"underline":2,"uselivepreview":0,"usenewrc":0,"watchcreations":1,"watchdefault":1,"watchdeletion":0,"watchlistdays":3,"watchlisthideanons":0,"watchlisthidebots":0,"watchlisthideliu":0,"watchlisthideminor":0,"watchlisthideown":0,"watchlisthidepatrolled":0,"watchmoves":0,"watchrollback":0,
"wllimit":250,"useeditwarning":1,"prefershttps":1,"language":"en","variant-gan":"gan","variant-iu":"iu","variant-kk":"kk","variant-ku":"ku","variant-shi":"shi","variant-sr":"sr","variant-tg":"tg","variant-uz":"uz","variant-zh":"zh","searchNs0":true,"searchNs1":false,"searchNs2":false,"searchNs3":false,"searchNs4":false,"searchNs5":false,"searchNs6":false,"searchNs7":false,"searchNs8":false,"searchNs9":false,"searchNs10":false,"searchNs11":false,"searchNs12":false,"searchNs13":false,"searchNs14":false,"searchNs15":false,"variant":"en"});},{},{});mw.loader.implement("user.tokens",function($,jQuery){mw.user.tokens.set({"editToken":"+\\","patrolToken":"+\\","watchToken":"+\\"});},{},{});
/* cache key: awesome:resourceloader:filter:minify-js:7:ab52f6eb1652fbc58fa39bdfdc3926f5 */
}</script>
<script>if(window.mw){
mw.loader.load(["mediawiki.page.startup","mediawiki.legacy.wikibits","mediawiki.legacy.ajax"]);
}</script>
</head>
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-Main_Page skin-monobook action-view">
<div id="globalWrapper">
<div id="column-content">
<div id="content" class="mw-body" role="main">
<a id="top"></a>
<div id="siteNotice"><div id="localNotice" lang="en" dir="ltr"><p><b>This wiki will shut down!</b>
</p><p>Please note that this wiki will be made read-only and eventually be taken offline.
</p><p>A replacement is being discussed at <a rel="nofollow" class="external free" href="https://github.com/awesomeWM/awesome-www/issues/7">https://github.com/awesomeWM/awesome-www/issues/7</a>. We'd be happy to have more input for that discussion and volunteers who help us migrate the content of this wiki to its replacement.
</p></div></div>
<h1 id="firstHeading" class="firstHeading" lang="en"><span dir="auto">Main Page</span></h1>
<div id="bodyContent" class="mw-body-content">
<div id="siteSub">From awesome</div>
<div id="contentSub"></div>
<div id="jump-to-nav" class="mw-jump">Jump to: <a href="#column-one">navigation</a>, <a href="#searchInput">search</a></div>
<!-- start content -->
<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="LanguageLinks">
<table width="100%">
<tr valign="top" style="background: #EEF3E2">
<td style="width: 25px; padding-left: 0.5em;"><img alt="Languages" src="/w/images/thumb/Geographylogo.png/25px-Geographylogo.png" width="25" height="25" srcset="/w/images/thumb/Geographylogo.png/38px-Geographylogo.png 1.5x, /w/images/Geographylogo.png 2x" /></td>
<td style="width: 10px; white-space: nowrap; padding: 4px 1em 0 0.5em; border-right: 1px solid #aaaaaa;"><b>Languages:</b> </td><td style="padding: 1px 1em 0; background: #F6F9ED;">
<p><b><strong class="selflink">English</strong></b>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
 • <span lang="de"><a href="/wiki/Main_Page/de" title="Main Page/de">Deutsch</a></span>
<span></span>
<span></span>
 • <span lang="fa"><a href="/wiki/Main_Page/fa" title="Main Page/fa">فارسی</a></span>
<span></span>
 • <span lang="fr"><a href="/wiki/Main_Page/fr" title="Main Page/fr">français</a></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
 • <span lang="ko"><a href="/wiki/Main_Page/ko" title="Main Page/ko">한국어</a></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
 • <span lang="ru"><a href="/wiki/Main_Page/ru" title="Main Page/ru">русский</a></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
<span></span>
 • <span lang="zh"><a href="/wiki/Main_Page/zh" title="Main Page/zh">中文</a></span>
<span></span>
<span></span>
<span></span>
</p>
</td></tr></table></div>
<p><br />
</p>
<table align="right">
<tr>
<td> <div id="toc" class="toc"><div id="toctitle"><h2>Contents</h2></div>
<ul>
<li class="toclevel-1 tocsection-1"><a href="#Documentation"><span class="tocnumber">1</span> <span class="toctext">Documentation</span></a>
<ul>
<li class="toclevel-2 tocsection-2"><a href="#Installation_.26_Basics_For_Users"><span class="tocnumber">1.1</span> <span class="toctext">Installation & Basics For Users</span></a></li>
<li class="toclevel-2 tocsection-3"><a href="#Development_Basics"><span class="tocnumber">1.2</span> <span class="toctext">Development Basics</span></a></li>
</ul>
</li>
<li class="toclevel-1 tocsection-4"><a href="#Customization"><span class="tocnumber">2</span> <span class="toctext">Customization</span></a>
<ul>
<li class="toclevel-2 tocsection-5"><a href="#Statusbars_and_widgets"><span class="tocnumber">2.1</span> <span class="toctext">Statusbars and widgets</span></a></li>
<li class="toclevel-2 tocsection-6"><a href="#Theming_awesome"><span class="tocnumber">2.2</span> <span class="toctext">Theming awesome</span></a></li>
<li class="toclevel-2 tocsection-7"><a href="#User_configuration_files"><span class="tocnumber">2.3</span> <span class="toctext">User configuration files</span></a></li>
<li class="toclevel-2 tocsection-8"><a href="#Other_tips"><span class="tocnumber">2.4</span> <span class="toctext">Other tips</span></a></li>
</ul>
</li>
<li class="toclevel-1 tocsection-9"><a href="#Lua_extensions"><span class="tocnumber">3</span> <span class="toctext">Lua extensions</span></a></li>
<li class="toclevel-1 tocsection-10"><a href="#More"><span class="tocnumber">4</span> <span class="toctext">More</span></a></li>
</ul>
</div>
</td></tr></table>
<div class="floatleft"><a href="/wiki/File:Aw_64.png" class="image" title="awesome"><img alt="awesome" src="/w/images/Aw_64.png" width="64" height="64" /></a></div>
<div style="margin-left: 70px;">
<p>The goal of this wiki is to provide a community-made documentation and especially help new users with the configuration of awesome. We cover developer information too, including information about how-to build awesome (several related distributions), how-to debug, and so on.
</p><p><b>Note:</b> Due to spammers, you must create an account in order to edit pages. While having to create an account to edit is annoying, so is spam.
</p><p>Feel free to register as a user and contribute to our documentation effort.
</p><p>Current <a href="/wiki/Releases" title="Releases">awesome releases</a>:
</p>
<ul><li> Stable: <a rel="nofollow" class="external text" href="http://awesome.naquadah.org/download/">awesome 3.5.9 <i>(Mighty Ravendark)</i></a>.</li>
<li> Development: Development versions of awesome can be downloaded via Git or as tarballs from <a rel="nofollow" class="external text" href="https://github.com/awesomeWM/awesome">Github</a>.</li>
<li> Screenshots: <a href="/wiki/Screenshots" title="Screenshots">Screenshots</a></li></ul>
</div>
<h2><span class="mw-headline" id="Documentation">Documentation</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=1" title="Edit section: Documentation">edit</a><span class="mw-editsection-bracket">]</span></span></h2>
<div class="floatleft"><a href="/wiki/File:Stock_book_blue.png" class="image" title="Documentation"><img alt="Documentation" src="/w/images/Stock_book_blue.png" width="64" height="64" /></a></div>
<div style="margin-left: 70px;">
<p>Configuration and control of awesome have changed between major versions and may continue to evolve in future ones. Some of the following documents may try to describe all the existing versions. Please fix them if a missing version needs special explanations. Other documents may be bound to only one version of awesome. Please fix them if version indication is missing.
</p>
<h3><span class="mw-headline" id="Installation_.26_Basics_For_Users">Installation & Basics For Users</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=2" title="Edit section: Installation & Basics For Users">edit</a><span class="mw-editsection-bracket">]</span></span></h3>
<ul><li> <a href="/wiki/Awesome_3.x" title="Awesome 3.x">Awesome 3.x</a> - Manpage and keyboard shortcuts.</li>
<li> <a rel="nofollow" class="external text" href="http://www.cheatography.com/fievel/cheat-sheets/awesome-window-manager-3-x/">Awesome 3.x shortcuts cheat sheet</a></li>
<li> <a rel="nofollow" class="external text" href="http://awesomewm.github.io/apidoc/documentation/90-FAQ.md.html">FAQ</a> - Check here first if you're having problems!</li>
<li> <a rel="nofollow" class="external text" href="http://awesomewm.github.io/apidoc/documentation/01-readme.md.html">Building awesome</a> - Instructions for building / installing awesome.</li>
<li> <a href="/wiki/Awesome_3_configuration" title="Awesome 3 configuration">awesome 3 configuration</a> - Get help understanding awesome 3 configuration and API basics.</li>
<li> <a href="/wiki/Awesome_3.0_to_3.1" title="Awesome 3.0 to 3.1">awesome 3.0 to 3.1</a> config options that changed between the releases</li>
<li> <a href="/wiki/Awesome_3.3_to_3.4" title="Awesome 3.3 to 3.4">awesome 3.3 to 3.4</a> configuration changes to the 3.4 version</li>
<li> <a href="/wiki/Awesome_3.4_to_3.5" title="Awesome 3.4 to 3.5">awesome 3.4 to 3.5</a> configuration changes to the 3.5 version</li>
<li> <a href="/wiki/Quickly_Setting_up_Awesome_with_Gnome" title="Quickly Setting up Awesome with Gnome">Quickly Setting up Awesome with Gnome</a> - How to make awesome be used in your gnome session with a couple of commands.</li>
<li> <a href="/wiki/KDE_and_awesome" title="KDE and awesome">KDE and awesome</a></li>
<li> <a href="/wiki/My_first_awesome" title="My first awesome">My first awesome</a> Tutorial for new users and beginners</li></ul>
<h3><span class="mw-headline" id="Development_Basics">Development Basics</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=3" title="Edit section: Development Basics">edit</a><span class="mw-editsection-bracket">]</span></span></h3>
<ul><li> <a href="/wiki/Using_Xephyr" title="Using Xephyr">Using Xephyr</a></li>
<li> <a href="/wiki/Debugging" title="Debugging">Debugging</a></li>
<li> <a href="/wiki/Signals" title="Signals">Signals</a></li>
<li> <a href="/wiki/Keycodes" title="Keycodes">keycodes</a></li>
<li> <a href="/wiki/Development_Environment_with_Xephyr_and_GNU_Make" title="Development Environment with Xephyr and GNU Make">Development Environment with Xephyr and GNU Make</a></li></ul>
<p>You might also want to join our IRC channel <a rel="nofollow" class="external text" href="irc://irc.oftc.net/awesome"><b>#awesome</b></a> on <a rel="nofollow" class="external text" href="http://www.oftc.net">OFTC</a>.
</p>
</div>
<h2><span class="mw-headline" id="Customization">Customization</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=4" title="Edit section: Customization">edit</a><span class="mw-editsection-bracket">]</span></span></h2>
<div class="floatleft"><a href="/wiki/File:Toolbox.png" class="image" title="Statusbars"><img alt="Statusbars" src="/w/images/Toolbox.png" width="64" height="64" /></a></div>
<div style="margin-left: 70px;">
<h3><span class="mw-headline" id="Statusbars_and_widgets">Statusbars and widgets</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=5" title="Edit section: Statusbars and widgets">edit</a><span class="mw-editsection-bracket">]</span></span></h3>
<ul><li> <a href="/wiki/Widgets_in_awesome" title="Widgets in awesome">Widgets in awesome</a> - A brief guide on the implementation of widgets within awesome.</li>
<li> <a href="/wiki/Vicious" title="Vicious">Vicious</a> - How to use the vicious widget library to add dynamic widgets.</li>
<li> <a href="/wiki/Obvious" title="Obvious">Obvious</a> - How to use the Obvious repo (Widgets with community support).</li>
<li> <a href="/wiki/User_Contributed_Widgets" title="User Contributed Widgets">User Contributed Widgets</a></li>
<li> <a href="/wiki/Using_Cairo_within_Awesome" title="Using Cairo within Awesome">Using Cairo within Awesome</a></li>
<li> <a href="/wiki/Titlebar_and_Statusbar_height" title="Titlebar and Statusbar height">Titlebar and Statusbar height</a> - Small how-to that helps you customize statusbar and titlebar height.</li>
<li> <a href="/wiki/Bashets" title="Bashets">Bashets</a> - Small Lua library to empower you to use your existing shellscripts as content providers for widgets.</li>
<li> <a href="/wiki/Launcher_auto-hiding" title="Launcher auto-hiding">Launcher auto-hiding</a> - Hide a launcher when the application is running.</li>
<li> <a href="/wiki/Lain" title="Lain">Lain</a> - Complements to improve configurability and usability.</li></ul>
<h3><span class="mw-headline" id="Theming_awesome">Theming awesome</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=6" title="Edit section: Theming awesome">edit</a><span class="mw-editsection-bracket">]</span></span></h3>
<ul><li> <a href="/wiki/Beautiful" title="Beautiful">Theming with Beautiful</a> - How to theme your awesome-3 with the beautiful library.</li>
<li> <a href="/wiki/Beautiful_themes" title="Beautiful themes">User Contributed Themes</a> - Several awesome themes for use with beautiful.</li>
<li> <a href="/wiki/Customizing_Fonts" title="Customizing Fonts">Customizing Fonts</a> - How to add new fonts to your system.</li>
<li> <a href="/wiki/Nice_Icons" title="Nice Icons">Nice Icons</a> - Where to find nice icons to use in your widgets.</li>
<li> <a href="/w/index.php?title=Picturesque&action=edit&redlink=1" class="new" title="Picturesque (page does not exist)">Picturesque</a> - Automatically fetch and change wallpapers.</li>
<li> <a href="/wiki/Variety" title="Variety">Variety</a> - Another automatic wallpaper changer.</li></ul>
<h3><span class="mw-headline" id="User_configuration_files">User configuration files</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=7" title="Edit section: User configuration files">edit</a><span class="mw-editsection-bracket">]</span></span></h3>
<ul><li> <a rel="nofollow" class="external text" href="https://github.com/copycat-killer/awesome-copycats">awesome-copycats</a></li>
<li> Examples of <a href="/wiki/User_Configuration_Files" title="User Configuration Files">other users' configuration files</a>.</li></ul>
<h3><span class="mw-headline" id="Other_tips">Other tips</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=8" title="Edit section: Other tips">edit</a><span class="mw-editsection-bracket">]</span></span></h3>
<ul><li> <a href="/wiki/Autostart" title="Autostart">Autostart</a> - Small function providing autostart functionality for awesome.</li>
<li> <a href="/wiki/Autostop" title="Autostop">Autostop</a> - Simple method to execute a program on quitting awesome.</li>
<li> <a href="/wiki/Understanding_Rules" title="Understanding Rules">Understanding Rules</a> - Describes Awesome's awful.rules facility for applying modifications to selected windows.</li>
<li> <a href="/wiki/NASA_IOTD_Wallpaper" title="NASA IOTD Wallpaper">NASA IOTD_Wallpaper</a> - Use NASA's "Image of the day" as wallpaper using feh</li>
<li> <a href="/wiki/Run_or_raise" title="Run or raise">Run or raise</a> - Run a client, or pop to it if it is already running.</li>
<li> <a href="/wiki/Global_Keybindings" title="Global Keybindings">Global Keybindings</a> - Create global keybindings in awesome.</li>
<li> <a href="/wiki/Document_keybindings" title="Document keybindings">Document keybindings</a> - Add documentation to each keybinding and display an "help" panel</li>
<li> <a href="/wiki/Keybindings_and_numeric_pad" title="Keybindings and numeric pad">Keybindings and numeric pad</a> - Use the numeric pad to go to tags and show menus associated to each tag</li>
<li> <a href="/wiki/Gradient" title="Gradient">Gradient</a> - Visual feedback on numerical data (e.g. processor usage).</li>
<li> <a href="/wiki/Problems_with_Java" title="Problems with Java">Problems with Java</a> - What to do if your java apps look grey.</li>
<li> <a href="/wiki/Symbolic_tag_names" title="Symbolic tag names">Symbolic tag names</a> - How to make your tags have that mysterious symbolic look.</li>
<li> <a href="/wiki/XRandR_Screen_Table" title="XRandR Screen Table">XRandR Screen Table</a> - If you don't like using numbers for screens.</li>
<li> <a href="/wiki/Move_Mouse" title="Move Mouse">Move Mouse</a> - Move the mouse from the centre of the screen for mouseless working.</li>
<li> <a href="/wiki/Dbus,_naughty_and_logs" title="Dbus, naughty and logs">Dbus, naughty and logs</a> - Display colorized notifications of your logs.</li>
<li> <a href="/wiki/Naughty_log_watcher" title="Naughty log watcher">Naughty log watcher</a> - Native implementation (no shell scripts/dbus required).</li>
<li> <a href="/wiki/Using_Xephyr" title="Using Xephyr">Using Xephyr</a> - How to run nested X sessions - good for testing new builds of awesome or different config files.</li>
<li> <a href="/wiki/Using_Multiple_Screens" title="Using Multiple Screens">Using Multiple Screens</a> - How to setup X with multiple screens/monitors for use with awesome.</li>
<li> <a href="/wiki/Using_redshift_with_awesome" title="Using redshift with awesome">Using redshift with awesome</a> - Redshift integration with awesome</li>
<li> <a href="/wiki/FullScreens" title="FullScreens">Fullscreens on Multiple Screens</a> - How to span a client on multiple screens/monitors with a key</li>
<li> <a href="/wiki/Nm-applet" title="Nm-applet">nm-applet</a> - How to setup nm-applet to start automatically in awesome.</li>
<li> <a href="/wiki/Mcabber_notifications" title="Mcabber notifications">Mcabber notifications</a> - Cool notifications for mcabber via naughty.</li>
<li> <a href="/wiki/Drop-down_terminal" title="Drop-down terminal">Drop-down terminal</a> - Toggle a video game-like console on the top of your screen like Yakuake/Tilda.</li>
<li> <a href="/wiki/Scratchpad_manager" title="Scratchpad manager">Scratchpad manager</a> - Basic scratchpad manager for the awesome window manager.</li>
<li> <a href="/wiki/WMII-like_tag_management" title="WMII-like tag management">WMII-like tag management</a> - Mimic WMII's way of tag managment.</li>
<li> <a href="/wiki/Video_wallpaper" title="Video wallpaper">Video wallpaper</a> - Play a video for your wallpaper using mplayer.</li>
<li> <a href="/wiki/Transparency" title="Transparency">Transparency</a> - Transparent windows using xcompmgr.</li>
<li> <a href="/wiki/Minitray" title="Minitray">Minitray</a> - Toggable system tray.</li>
<li> <a href="/wiki/Coverart_display" title="Coverart display">Coverart display</a> - Display Cover Art for current mpd song.</li>
<li> <a href="/wiki/Urxvt_tips" title="Urxvt tips">Urxvt tips</a> - Tips for using rxvt-unicode with awesome.</li>
<li> <a href="/wiki/Irssi_tips" title="Irssi tips">Irssi tips</a> - Tips for using Irssi with awesome.</li>
<li> <a href="/wiki/IM_tips" title="IM tips">IM tips</a> - Tips for using instant messaging clients with awesome.</li>
<li> <a href="/wiki/Remove_icons" title="Remove icons">Remove icons</a> - How to remove icons from the tasklist and show only current client.</li>
<li> <a href="/wiki/Custom_Prompts" title="Custom Prompts">Custom Prompts</a> - Customized prompts you can use with awful's prompt.</li>
<li> <a href="/wiki/Using_dmenu" title="Using dmenu">Using dmenu</a> - Altering the color scheme, integrating with beautiful, and Run or Raise.</li>
<li> <a href="/wiki/Run_commands_in_background" title="Run commands in background">Run commands in background</a> - Run shell-commands in background (without hanging awesome!) and returns it's output. </li>
<li> <a href="/wiki/How_to_add_awesome_to_gdm3" title="How to add awesome to gdm3">How to add awesome to gdm3</a> - This document explains to how add awesome WM to list of WMs gdm list</li>
<li> <a href="/wiki/How_to_take_ScreenShot_with_PrntScr_key" title="How to take ScreenShot with PrntScr key">How to take ScreenShot with PrntScr key</a> This coumentation explains you how to define PrntScr to take screenshot </li>
<li> <a href="/wiki/ShutdownDialog" title="ShutdownDialog">Shutdown dialog</a> - A simple dialog to shutdown/reboot/suspend/lock screen.</li>
<li> <a href="/wiki/Tree_File_Menu" title="Tree File Menu">Tree File Menu</a> - Python script to generate a tree file menu.</li>
<li> <a href="/wiki/Cycling_Random_Wallpaper_Or_Xscreensaver" title="Cycling Random Wallpaper Or Xscreensaver">Cycling Random Wallpaper Or Xscreensaver</a> - Cycle you background to a random picture or Xscreensaver after a random delay</li>
<li> <a href="/wiki/Blinking_text" title="Blinking text">Blinking text</a> - Blinking the text on textbox widget</li>
<li> <a href="/wiki/RPN_Calculator" title="RPN Calculator">RPN Calculator</a> - RPN calculator</li>
<li> <a href="/wiki/Modal_Keybindings" title="Modal Keybindings">Modal Keybindings</a></li>
<li> <a href="/wiki/Shared_tags" title="Shared tags">Shared tags</a> share tagset for multiple screens</li>
<li> <a href="/wiki/Move_Window_to_Workspace_Left/Right" title="Move Window to Workspace Left/Right">Move Window to Workspace Left/Right</a> - A function for moving a window one workspace to the left or right.</li>
<li> <a href="/wiki/Move_Client_to_Monitor_Left/Right" title="Move Client to Monitor Left/Right">Move Client to Monitor Left/Right</a> - How to move client to a specific direction when using more than two monitors.</li>
<li> <a href="/wiki/Move_Client_to_a_specific_Monitor" title="Move Client to a specific Monitor">Move Client to a specific Monitor</a> - How to move a client to a specific monitor.</li>
<li> <a href="/wiki/Move_Focus_to_a_specific_Monitor" title="Move Focus to a specific Monitor">Move Focus to a specific Monitor</a> - How to move the curser/focus to a specific monitor.</li>
<li> <a href="/wiki/Better_Font_Rendering" title="Better Font Rendering">Better Font Rendering</a></li>
<li> <a href="/wiki/Disable_startup-notification_globally" title="Disable startup-notification globally">Disable startup-notification globally</a> - If you are annoyed by the stopwatch/busy mouse cursor.</li>
<li> <a href="/wiki/Keeping_multitags_persistent" title="Keeping multitags persistent">Keeping multitags persistent</a> - If you want to able to quickly jump back to a multitag configuration</li>
<li> <a href="/wiki/Conky_bar" title="Conky bar">Conky bar</a> - A statusbar-like Conky configuration which is not overlapped by windows</li>
<li> <a href="/wiki/Conky_HUD" title="Conky HUD">Conky HUD</a> - An overlay-like heads-up-display configuration for Conky</li>
<li> <a href="/wiki/Workaround_plugins_that_steal_the_keyboard_focus" title="Workaround plugins that steal the keyboard focus">Workaround plugins that steal the keyboard focus</a> - This has been a known bug in Firefox for over 10 years.</li>
<li> <a href="/wiki/MPD_information_with_mpdcron" title="MPD information with mpdcron">MPD information with mpdcron</a></li>
<li> <a href="/wiki/Autostart_with_consolekit" title="Autostart with consolekit">Autostart with consolekit</a> - Using awesome menu to restart/shutdown/hibernate/suspend your computer</li>
<li> <a href="/wiki/Vmware" title="Vmware">Vmware</a> - Awesome and vmware tools</li>
<li> <a href="/wiki/Libreoffice_Multi-monitor" title="Libreoffice Multi-monitor">Libreoffice Multi-monitor</a> - Configure Libreoffice to work correctly with multiple monitors</li>
<li> <a href="/wiki/Systray_Hide/Show" title="Systray Hide/Show">Systray Hide/Show</a> - How to add a keybinding that toggles the systray's visibility</li>
<li> <a href="/wiki/SpeakerWidget" title="SpeakerWidget">SpeakerWidget</a> - A speaker widget with fancy icons.</li>
<li> <a href="/wiki/HelpPopup" title="HelpPopup">HelpPopup</a> - identifies the application and shows a hint for him</li>
<li> <a href="/wiki/TranslateIt" title="TranslateIt">Translation selected text</a> - translate text from X-buffer, using Google.Translate.</li>
<li> <a href="/wiki/RemoveExtraSpace" title="RemoveExtraSpace"> Remove extra space</a> - remove/tuning space between tags, if you using icons.</li>
<li> <a href="/wiki/Disable_DPMS" title="Disable DPMS">Disable DPMS</a> - disable energy saving mode for fullscreen applications</li>
<li> <a href="/wiki/Move_all_clients_to_another_tag" title="Move all clients to another tag">Move all clients to another tag </a> Move all the clients on this tag to another tag.</li></ul>
</div>
<h2><span class="mw-headline" id="Lua_extensions">Lua extensions</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=9" title="Edit section: Lua extensions">edit</a><span class="mw-editsection-bracket">]</span></span></h2>
<div class="floatleft"><a href="/wiki/File:Lua.jpg" class="image" title="Lua extensions"><img alt="Lua extensions" src="/w/images/Lua.jpg" width="64" height="64" /></a></div>
<div style="margin-left: 70px;">
<p>Lua is a fast, light-weight, embeddable scripting language. Lua combines simple procedural syntax with powerful data description constructs based on associative arrays and extensible semantics. Lua is dynamically typed, runs by interpreting bytecode for a register-based virtual machine, and has automatic memory management with incremental garbage collection, making it ideal for configuration, scripting, and rapid prototyping.
</p><p>Common uses of Lua are:
</p>
<ul><li> A configuration language for applications.</li>
<li> A standalone scripting language.</li>
<li> An embedded language in applications to modify runtime behaviour.</li></ul>
<p>To get introduced into Lua, please read <a href="/wiki/The_briefest_introduction_to_Lua" title="The briefest introduction to Lua"> the briefest introduction to Lua</a>. For deeper knowledge please read this <a rel="nofollow" class="external text" href="http://lua-users.org/wiki/LuaTutorial">tutorial</a> for the newcomers to the language. As a suggestion, please consider to get this <a rel="nofollow" class="external text" href="http://lua-users.org/wiki/LuaShortReference">Lua Short Reference</a>. The Awesome framework is built with Lua as the extension language. Some of all extensions can be seen below:
</p>
<ul><li> <a rel="nofollow" class="external text" href="http://awesome.naquadah.org/doc/api/">awful</a> - the standard awesome Lua library.</li>
<li> <a href="/wiki/Awful.menu" title="Awful.menu">awful.menu</a> - a popup menu library.</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/Elv13/radical">Radical</a> - A powerful and extensible menu system</li>
<li> <a href="/wiki/Beautiful" title="Beautiful">Beautiful</a> - a theming library.</li>
<li> <a href="/wiki/Obvious" title="Obvious">Obvious</a> - a new implementation of a widget library made since Wicked.</li>
<li> <a href="/wiki/Vicious" title="Vicious">Vicious</a> - a modular widget library derived from Wicked.</li>
<li> <a href="/wiki/Space_Invaders" title="Space Invaders">Space Invaders</a> - allows you to play Space Invaders with Awesome</li>
<li> <a href="/wiki/Naughty" title="Naughty">Naughty</a> - a popup notification library</li>
<li> <a href="/wiki/Shifty" title="Shifty">Shifty</a> - dynamic tagging library with advanced client matching and sane configuration</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/Elv13/tyrannical">Tyrannical</a> - A declarative tag and client configuration system for awful dynamic tags (Shifty spiritual successor)</li>
<li> <a href="/wiki/Eminent" title="Eminent">Eminent</a> - effortless wmii-style dynamic tagging library that does not require any rc.lua changes</li>
<li> <a href="/wiki/Rodentbane" title="Rodentbane">Rodentbane</a> - a library for rapid control of the mouse cursor using just the keyboard</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/Elv13/collision">Collision</a> - A powerful keyboard based navigation and resizing module with visual feedback indicators</li>
<li> <a href="/wiki/Flaw" title="Flaw">Flaw</a> - an object oriented library to manage widgets.</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/Elv13/retrograde">Retrograde</a> - A layout system identical the one from Awesome 3.2-3.4 for Awesome 3.5+</li>
<li> <a href="/wiki/Couth" title="Couth">couth</a> - yet another extension library -- includes visual popup notifications for alsa and mpd volume.</li>
<li> <a href="/wiki/Keychains" title="Keychains">keychains</a> - use of keychains in awesome</li>
<li> <a href="/wiki/Hints" title="Hints">hints</a> - window hints to focus windows</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/copycat-killer/vain-again">Vain</a> - An alternative layout system</li>
<li> <a href="/wiki/Blingbling" title="Blingbling">BlingBling</a> - A beautiful Cairo based widget set</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/copycat-killer/lain">Lain</a> - A widget library</li>
<li> <a rel="nofollow" class="external text" href="https://raw.github.com/gvalkov/dotfiles-awesome/master/ezconfig.lua">ezconfig</a> - Emacs-style keybindings for Awesome (eg. <code>'M-S-a'</code> vs <code>awful.key({modkey, 'Shift'}, 'a'</code>)</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/svexican/cheeky">cheeky</a> - A simple type-ahead window switcher (uses native clients menu)</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/svexican/dreary">dreary</a> - Temporary/overwritable client keybinds</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/sirkha/keyjoy">keyjoy</a> - Change your mouse and keyboard properties on a per-client basis using rules.</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/Elv13/repetitive">Repetitive</a> - Record and execute macros. Pin tags, clients and macros to F-keys at runtime</li>
<li> <a href="/wiki/Revelation" title="Revelation">Revelation</a> - Implementing <a rel="nofollow" class="external text" href="http://en.wikipedia.org/wiki/Exposé_(Mac_OS_X)">Mac OS X Exposé</a> in awesome.</li>
<li> <a rel="nofollow" class="external text" href="https://github.com/guotsuan/treetile">Treetile</a> - Treetile is binary tree-based and dynamical tiling layout for Awesome 3.5 and latter. you can split the screen in the way similarly to tmux or i3wm. </li></ul>
</div>
<h2><span class="mw-headline" id="More">More</span><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Main_Page&action=edit&section=10" title="Edit section: More">edit</a><span class="mw-editsection-bracket">]</span></span></h2>
<div class="floatleft"><a href="/wiki/File:Stock_help_blue.png" class="image" title="More"><img alt="More" src="/w/images/Stock_help_blue.png" width="64" height="64" /></a></div>
<div style="margin-left: 70px;">
<p>Most people these days are used to having a more complete desktop. This section includes links to various apps that are lightweight and useful from within awesome to fill the gaps between just a window manager and a full-blown desktop environment like KDE or GNOME.
</p>
<ul><li> <a href="/wiki/Customizing_GTK_Apps" title="Customizing GTK Apps">Customizing GTK Apps</a> - How to use themes without gnome-settings-daemon.</li>
<li> <a href="/wiki/Terminals" title="Terminals">Terminals</a> - Replacements for desktop environment terminals.</li>
<li> <a href="/wiki/File_Managers" title="File Managers">File Managers</a> - Lightweight stand-alone File Managers.</li>
<li> <a href="/wiki/Automounting" title="Automounting">Automounting</a> - A replacement for "gnome-volume-manager", "thunar-volman", etc.</li>
<li> <a href="/wiki/Xscreensaver" title="Xscreensaver">Xscreensaver</a> - Locking the screen; replacement for gnome-screensaver, etc.</li>
<li> <a href="/wiki/Calendars" title="Calendars">Calendars</a> - calendars and agenda solutions (text, graphical, interactive, ...)</li>
<li> <a href="/wiki/PowerManagement" title="PowerManagement">PowerManagement</a> - A replacement for gnome-power-manager or kpowersave</li></ul>
</div>
<!--
NewPP limit report
CPU time usage: 0.204 seconds
Real time usage: 0.319 seconds
Preprocessor visited node count: 806/1000000
Preprocessor generated node count: 1384/1000000
Post‐expand include size: 4603/2097152 bytes
Template argument size: 150/2097152 bytes
Highest expansion depth: 6/40
Expensive parser function count: 49/100
-->
<!-- Saved in parser cache with key awesome:pcache:idhash:1-0!*!0!!en!5!* and timestamp 20160515055817 and revision id 7469
-->
</div><div class="printfooter">
Retrieved from "<a dir="ltr" href="https://awesomewm.org/w/index.php?title=Main_Page&oldid=7469">https://awesomewm.org/w/index.php?title=Main_Page&oldid=7469</a>"</div>
<div id='catlinks' class='catlinks'><div id="mw-normal-catlinks" class="mw-normal-catlinks"><a href="/wiki/Special:Categories" title="Special:Categories">Category</a>: <ul><li><a href="/wiki/Category:Awesome" title="Category:Awesome">Awesome</a></li></ul></div></div> <!-- end content -->
<div class="visualClear"></div>
</div>
</div>
</div>
<div id="column-one">
<h2>Navigation menu</h2>
<div id="p-cactions" class="portlet" role="navigation">
<h3>Views</h3>
<div class="pBody">
<ul>
<li id="ca-nstab-main" class="selected"><a href="/wiki/Main_Page" title="View the content page [c]" accesskey="c">Page</a></li>
<li id="ca-talk"><a href="/wiki/Talk:Main_Page" title="Discussion about the content page [t]" accesskey="t">Discussion</a></li>
<li id="ca-edit"><a href="/w/index.php?title=Main_Page&action=edit" title="You can edit this page. Please use the preview button before saving [e]" accesskey="e">Edit</a></li>
<li id="ca-history"><a href="/w/index.php?title=Main_Page&action=history" rel="archives" title="Past revisions of this page [h]" accesskey="h">History</a></li>
</ul>
</div>
</div>
<div class="portlet" id="p-personal" role="navigation">
<h3>Personal tools</h3>
<div class="pBody">
<ul>
<li id="pt-anonuserpage"><a href="/wiki/User:95.90.224.24" class="new" title="The user page for the IP address you are editing as [.]" accesskey=".">95.90.224.24</a></li>
<li id="pt-anontalk"><a href="/wiki/User_talk:95.90.224.24" class="new" title="Discussion about edits from this IP address [n]" accesskey="n">Talk for this IP address</a></li>
<li id="pt-login"><a href="/w/index.php?title=Special:UserLogin&returnto=Main+Page" title="You are encouraged to log in; however, it is not mandatory [o]" accesskey="o">Log in</a></li>
</ul>
</div>
</div>
<div class="portlet" id="p-logo" role="banner">
<a href="/wiki/Main_Page" style="background-image: url(/images/icons/aw_64.png);" title="Visit the main page"></a>
</div>
<div class="generated-sidebar portlet" id="p-navigation" role="navigation">
<h3>Navigation</h3>
<div class='pBody'>
<ul>
<li id="n-mainpage-description"><a href="/wiki/Main_Page" title="Visit the main page [z]" accesskey="z">Main page</a></li>
<li id="n-Homepage"><a href="http://awesome.naquadah.org" rel="nofollow">Homepage</a></li>
<li id="n-recentchanges"><a href="/wiki/Special:RecentChanges" title="A list of recent changes in the wiki [r]" accesskey="r">Recent changes</a></li>
<li id="n-randompage"><a href="/wiki/Special:Random" title="Load a random page [x]" accesskey="x">Random page</a></li>
<li id="n-help"><a href="https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents" title="The place to find out">Help</a></li>
</ul>
</div>
</div>
<div id="p-search" class="portlet" role="search">
<h3><label for="searchInput">Search</label></h3>
<div id="searchBody" class="pBody">
<form action="/w/index.php" id="searchform">
<input type='hidden' name="title" value="Special:Search"/>
<input type="search" name="search" placeholder="Search" title="Search awesome [f]" accesskey="f" id="searchInput" />
<input type="submit" name="go" value="Go" title="Go to a page with this exact name if exists" id="searchGoButton" class="searchButton" /> 
<input type="submit" name="fulltext" value="Search" title="Search the pages for this text" id="mw-searchButton" class="searchButton" />
</form>
</div>
</div>
<div class="portlet" id="p-tb" role="navigation">
<h3>Tools</h3>
<div class="pBody">
<ul>
<li id="t-whatlinkshere"><a href="/wiki/Special:WhatLinksHere/Main_Page" title="A list of all wiki pages that link here [j]" accesskey="j">What links here</a></li>
<li id="t-recentchangeslinked"><a href="/wiki/Special:RecentChangesLinked/Main_Page" title="Recent changes in pages linked from this page [k]" accesskey="k">Related changes</a></li>
<li id="t-specialpages"><a href="/wiki/Special:SpecialPages" title="A list of all special pages [q]" accesskey="q">Special pages</a></li>
<li id="t-print"><a href="/w/index.php?title=Main_Page&printable=yes" rel="alternate" title="Printable version of this page [p]" accesskey="p">Printable version</a></li>
<li id="t-permalink"><a href="/w/index.php?title=Main_Page&oldid=7469" title="Permanent link to this revision of the page">Permanent link</a></li>
<li id="t-info"><a href="/w/index.php?title=Main_Page&action=info">Page information</a></li>
</ul>
</div>
</div>
</div><!-- end of the left (by default at least) column -->
<div class="visualClear"></div>
<div id="footer" role="contentinfo">
<div id="f-copyrightico">
<a href="https://creativecommons.org/licenses/by/3.0/"><img src="https://i.creativecommons.org/l/by/3.0/88x31.png" alt="Attribution 3.0 Unported" width="88" height="31" /></a>
</div>
<div id="f-poweredbyico">
<a href="//www.mediawiki.org/"><img src="/w/resources/assets/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" width="88" height="31" /></a>
</div>
<ul id="f-list">
<li id="lastmod"> This page was last modified on 9 May 2016, at 06:46.</li>
<li id="viewcount">This page has been accessed 1,391,540 times.</li>
<li id="copyright">Content is available under <a class="external" rel="nofollow" href="https://creativecommons.org/licenses/by/3.0/">Attribution 3.0 Unported</a> unless otherwise noted.</li>
<li id="privacy"><a href="/wiki/awesome:Privacy_policy" title="awesome:Privacy policy">Privacy policy</a></li>
<li id="about"><a href="/wiki/awesome:About" title="awesome:About">About awesome</a></li>
<li id="disclaimer"><a href="/wiki/awesome:General_disclaimer" title="awesome:General disclaimer">Disclaimers</a></li>
</ul>
</div>
</div>
<script>/*<![CDATA[*/window.jQuery && jQuery.ready();/*]]>*/</script><script>if(window.mw){
mw.loader.state({"site":"loading","user":"ready","user.groups":"ready"});
}</script>
<script>if(window.mw){
mw.loader.load(["mediawiki.toc","mediawiki.action.view.postEdit","mediawiki.user","mediawiki.hidpi","mediawiki.page.ready","mediawiki.searchSuggest"],null,true);
}</script>
<script>if(window.mw){
document.write("\u003Cscript src=\"https://awesomewm.org/w/load.php?debug=false\u0026amp;lang=en\u0026amp;modules=site\u0026amp;only=scripts\u0026amp;skin=monobook\u0026amp;*\"\u003E\u003C/script\u003E");
}</script>
<script>if(window.mw){
mw.config.set({"wgBackendResponseTime":98});
}</script></body></html>