[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
howtos:window_managers:awesome [2015/01/01 14:45 (UTC)] – [awesome on Slackware] sbolokanovhowtos:window_managers:awesome [2015/04/14 21:48 (UTC)] (current) – Removed 4 U200B (zero wdth space) in http://awesome.naquadah.org/doc/api/​ didierspaier
Line 1: Line 1:
 <!-- Add your text below. We strongly advise to start with a Headline (see button bar above). --> <!-- Add your text below. We strongly advise to start with a Headline (see button bar above). -->
-==== awesome (Dynamic Window Manager) as a WM for Slackware ==== +====== awesome (Dynamic Window Manager) ====== 
-awesome is a highly configurable, next generation framework 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.\\+[[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]]. Licensed under the [[http://www.gnu.org/licenses/old-licenses/gpl-2.0.html|GNU GPLv2 license]].
-=== Dependencies ===+ 
 +===== Dependencies =====
 Prior to installing awesome, you will need the following dependencies installed first: Prior to installing awesome, you will need the following dependencies installed first:
   * [[http://slackbuilds.org/development/libxdg-basedir/|libxdg-basedir]]\\   * [[http://slackbuilds.org/development/libxdg-basedir/|libxdg-basedir]]\\
Line 10: Line 11:
 //note//: All of the above are available at [[http://slackbuilds.org|slackbuilds.org]] //note//: All of the above are available at [[http://slackbuilds.org|slackbuilds.org]]
  
-=== Installation ===+===== Installation =====
 If you have installed all of the above dependencies, you can now proceed with the build of awesome.\\ If you have installed all of the above dependencies, you can now proceed with the build of awesome.\\
 \\ \\
Line 16: Line 17:
 Build it.\\ Build it.\\
 And then install the produced package. And then install the produced package.
-==== Starting awesome ==== +=== Use awesome as your WM === 
-Exit X server and run //xwmconfig//. +You can select awesome as your Window Manager by running xwmconfig from a terminal.\\ 
-Choose awesome from the menu and run //startx// to start X server again.+  - 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 <code bash>mkdir -p ~/.config/awesome/</code>
 +  - Copy the default awesome config <code bash>cp /etc/xdg/awesome/rc.lua ~/.config/awesome/</code>
 +
 +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 ====== ====== Links ======
-  * Home page: [[http://awesome.naquadah.org/|awesome.naquadah.org]] +  * awesome home page: [[http://awesome.naquadah.org/|awesome.naquadah.org]] 
-  * wiki: [[http://awesome.naquadah.org/wiki/Main_Page| awesome.naquadah.org/wiki/Main_Page]] +  * awesome wiki: [[http://awesome.naquadah.org/wiki/Main_Page| awesome.naquadah.org/wiki/Main_Page]] 
-  * FAQ: [[http://awesome.naquadah.org/wiki/FAQ|http://awesome.naquadah.org/wiki/FAQ]]+  * 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]]   * 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 ====== ====== Sources ======
 <!-- If you are copying information from another source, then specify that source --> <!-- If you are copying information from another source, then specify that source -->

Trace:

howtos:window_managers:awesome ()