HOWTO awesome

From Gentoo Linux Wiki

Jump to: navigation, search
This article is part of the HOWTO series.
Installation Kernel & Hardware Networks Portage Software System X Server Gaming Non-x86 Emulators Misc

Desktop environments

Lightweight desktop environments

Window managers

Compositing window managers

Screenshots

edit


Contents

[edit] What is awesome?

awesome is a tiling window manager initialy based on a dwm code rewriting. It's extremely fast, small, dynamic and awesome.

Windows can be managed in several layouts: tiled, maximized and floating. Each layout can be applied on the fly, optimizing the environment for the application in use and the task performed.

Managing windows in tiled mode assures that no space will be wasted on your screen. No gaps, no overlap.


[edit] TODO

  • Full setup description
  • How to configurate
  • How to use

[edit] Setup

First unmask the awesome package:

echo "x11-wm/awesome" >> /etc/portage/package.keywords

Then emerge it:

emerge awesome


[edit] Configuration

For the first time we will take the default configuration and copy it to our home directory:

cd /usr/share/doc/awesome-2.0/
bunzip2 -k awesomerc.bz2 
cp awesomerc ~/.awesomerc

Now add awesome to your .xinitrc

[edit] Usage

Here are a few shortcuts set in the default config:


                             Commands of Awesome
                                                Client
                                                   Tag
                                                  Layout
                                                    Root
   Action              Key           Pointer         Code          
                                     Button
Terminal       Mod4            Return         spawn(exec xterm)     
                                           3 spawn(exec urxvt)     

Window

Focus
   +          Mod4            K              client_focusprev      
   -          Mod4            J              client_focusnext      
Maximize      Mod4            M              client_togglemax      
Float         Mod4 Ctrl       Space          client_togglefloating 
Raise                                1 
Move          Mod4                   1       client_movemouse      
Resize        Mod4                   3       client_resizemouse    
Kill          Mod4      Shift C              client_kill           

Tag

Set           Mod4      Shift #              client_tag(#)         
              Mod4                     1     client_tag            
Toggle        Mod4 Ctrl Shift #              client_toggletag(#)   
              Mod4                     3     client_toggletag      

View

Set           Mod4            #              tag_view(#)           
                                       1     tag_view              
Toggle        Mod4 Crtl       #              tag_toggleview(#)     
                                       3     tag_toggleview        
              Mod4            Right                                
+                                      4     tag_viewnext
                                           4 
              Mod4            Left                                 
-                                      5     tag_viewprev
                                           5 
Previous      Mod4            Esc                                  

Layout tag_viewprev_selected

              Mod4            Space                                                  
+                                        1                         tag_setlayout(+1)
                                         4 
              Mod4      Shift Space                                
-                                        3   tag_setlayout(-1)
                                         5 

Tile Layout

Master
   Set        Mod4 Ctrl       Return         client_zoom           
              Mod4                   2 
   Boundry
       Right  Mod4            L              tag_setmwfact(+0.05)  
       Left   Mod4            H              tag_setmwfact(-0.05)  
   Quantity
       +      Mod4      Shift H              tag_setnmaster(+1)    
       -      Mod4      Shift L              tag_setnmaster(-1)    
Rank
   +          Mod4      Shift K              client_swapprev       
   -          Mod4      Shift J              client_swapnext       
Columns
   +          Mod4 Ctrl       H              tag_setncol(+1)       
   -          Mod4 Ctrl       L              tag_setncol(-1)       

Screen

+             Mod4 Ctrl       J              screen_focusnext      
-             Mod4 Ctrl       K              screen_focusprev      

Awesome

Bar           Mod4            B              togglebar             
Configuration Mod4 Ctrl       R              reloadconfig          
Quit          Mod4      Shift Q              quit                  
    * Often
         * Mod4 = Windows or Logo key
         * Pointer Buttons
              * 1 = Left Mouse Button
              * 2 = Middle or Left & Right Mouse Button(s)
              * 3 = Right Mouse Button
              * 4 = Down Mouse Wheel
              * 5 = Up Mouse Wheel
    * "#" Refers to a Tag Number
    * Pointer Button Targets
         * Client = Applicaiton Window
         * Tag = Tag Displayed on the Awesome Toolbar
         * Layout = Layout Symbol Displayed on the Awesome Toolbar
         * Root = "Desktop"



[edit] See Also

Personal tools