[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 [2014/03/21 11:36 (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 ====== +====== awesome (Dynamic Window Manager====== 
-awesome is a highly configurable, next generation framework window manager for X. It is very fast, extensible and licensed under the GNU GPLv2 license.\\ +[[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.\\ 
-It is 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.+Licensed under the [[http://www.gnu.org/licenses/old-licenses/gpl-2.0.html|GNU GPLv2 license]].
  
-==== awesome on Slackware ==== +===== Dependencies ===== 
-Slackware does not come with awesome Window Manager. You will need to add it manually.+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]]
  
-== Dependencies == +===== Installation ===== 
-Install the following dependencies +If you have installed all of the above dependencies, you can now proceed with the build of awesome.\\ 
-  * libxdg-basedir - slackbuild available on [[http://slackbuilds.org/repository/14.1/development/libxdg-basedir/|SlackBuilds.org]] +\\ 
-  * lgi slackbuild available on [[http://slackbuilds.org/repository/14.1/libraries/lgi/|SlackBuilds.org]] +Grab the slackbuild from [[http://slackbuilds.org/desktop/awesome/|here (slackbuilds.org)]].\\ 
-//note//: [[http://slackbuilds.org/repository/14.1/development/lua/|lua]] is dependency for lgi+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.
  
-== Installation == +===== Configure awesome ===== 
-Download the slackbuild from [[http://slackbuilds.org/repository/14.1/desktop/awesome/|SlackBuilds.org]].\\ +By default, if there is no local config, awesome will read the default config from /etc/xdg/awesome/rc.lua and use it.\\ 
-Build and install the package. +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> 
-== Configuration == +  - Copy the default awesome config <code bash>cp /etc/xdg/awesome/rc.lua ~/.config/awesome/</code>
-awesome does not create configuration file automaticallyso you will need to do it manually.\\ +
-  - mkdir -p ~/.config/awesome/ +
-  - cp /etc/xdg/awesome/rc.lua ~/.config/awesome/ +
- +
-awesome is using LUA scripting language for configuration.\\ +
-In order to customize awesome to your liking, you will need to edit your config file accordingly.\\ +
-Some examples for customizations:\\ +
-  * modkey (modifier key - line 53) - popular values: //Mod4/Mod1// (Windows/Alt key), default: //Mod4// +
-  * terminal (default terminal - line 44) - default: xterm +
-For explanation on how to configure awesome check this wiki article: [[http://awesome.naquadah.org/wiki/Awesome_3_configuration|awesome.naquadah.org/wiki/Awesome_3_configuration]] +
- +
-==== Starting awesome ==== +
-Exit X server and run //xwmconfig//+
-Choose awesome from the menu and run //startx// to start X server again.+
  
 +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 -->
 howtos:window_managers:awesome ()