====== 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 | Симон Болоканов]]