====== awesome (Dynamic Window Manager) ======
[[http://awesome.naquadah.org/|awesome]] is a highly configurable, next generation framework [[slackware:window_manager|window manager]] for X. Primarly targeted at power users, developers and any people dealing with every day computing tasks and who want to have fine-grained control on theirs graphical environment. It is very fast and heavily extensible using the [[http://www.lua.org/|Lua]] programming language.\\
Licensed under the [[http://www.gnu.org/licenses/old-licenses/gpl-2.0.html|GNU GPLv2 license]].
===== Dependencies =====
Prior to installing awesome, you will need the following dependencies installed first:
* [[http://slackbuilds.org/development/libxdg-basedir/|libxdg-basedir]]\\
* [[http://slackbuilds.org/libraries/lgi/|lgi]]
* [[http://slackbuilds.org/development/lua/|lua]] is a dependency for lgi.
//note//: All of the above are available at [[http://slackbuilds.org|slackbuilds.org]]
===== Installation =====
If you have installed all of the above dependencies, you can now proceed with the build of awesome.\\
\\
Grab the slackbuild from [[http://slackbuilds.org/desktop/awesome/|here (slackbuilds.org)]].\\
Build it.\\
And then install the produced package.
=== Use awesome as your WM ===
You can select awesome as your Window Manager by running xwmconfig from a terminal.\\
- Open your terminal of choice.
- Run 'xwmconfig'
- Select xinitrc.awesome from the menu and hit enter.
This way when you start X, awesome will be picked up as your WM.
===== Configure awesome =====
By default, if there is no local config, awesome will read the default config from /etc/xdg/awesome/rc.lua and use it.\\
If you want to use your own configuration, you will need to do the following.
- Create a directory for awesome configuration file mkdir -p ~/.config/awesome/
- Copy the default awesome config cp /etc/xdg/awesome/rc.lua ~/.config/awesome/
Now you can go and change ~/.config/awesome/rc.lua to reflect you preferences.\\
\\
If you want, you can go and read [[http://awesome.naquadah.org/wiki/Awesome_3_configuration|this]] great wiki page, about what is possible to do with the configuration file.\\
\\
Some examples for own my customizations:
* modkey = Mod1 - (line 53) this changes the modkey to //Mod4/Mod1// (Windows/Alt key). By default it is Mod4
* terminal = terminator - (line 44) this changes the terminal to terminator (my favorite terminal). By default it is xterm
====== Links ======
* awesome home page: [[http://awesome.naquadah.org/|awesome.naquadah.org]]
* awesome wiki: [[http://awesome.naquadah.org/wiki/Main_Page| awesome.naquadah.org/wiki/Main_Page]]
* awesome FAQ: [[http://awesome.naquadah.org/wiki/FAQ|http://awesome.naquadah.org/wiki/FAQ]]
* Lua API documentation: [[http://awesome.naquadah.org/doc/api/]]
* Configuration: [[http://awesome.naquadah.org/wiki/Awesome_3_configuration|http://awesome.naquadah.org/wiki/Awesome_3_configuration]]
* More on Dynamic Window Managers (wikipedia): [[http://en.wikipedia.org/wiki/Dynamic_window_manager]]
====== Sources ======
* Originally written by [[wiki:user:sbolokanov | Симон Болоканов]]