From Things and Stuff Wiki
(Redirected from Awesome)
Jump to navigation Jump to search


  • awesome - a highly configurable, next generation framework window manager for X. It is very fast, extensible and licensed under the GNU GPLv2 license.It is primarily targeted at power users, developers and any people dealing with every day computing tasks and who want to have fine-grained control on their graphical environment.

To debug rc.lua changes:

Xephyr :1 -ac -br -noreset -screen 1152x720 &
DISPLAY=:1.0 awesome -c ~/.config/awesome/


  • - a tool to create a menu of installed applications for the awesome window manager. It searches for and parses .desktop files to find the name, execution command, and icon of installed applications. These are then grouped into categories, sorted, and written to a lua script ($HOME/.config/awesome/appmenu.lua) that can be used in your awesome WM configuration script.


  • -a library for Awesome window manager that aims to simplify the creation of key and button bindings. It is based on code from the old Awesome wiki.


Freedesktop menu


awful.key({ modkey, "Shift"   }, "y", awful.placement.centered),




  • - Divides the workarea into 3 frames, which are like emacs windows. Each frame may be associated with a client window to show in the frame. Functions are provided to switch between frames and to pull windows unassociated windows into the current frame.This is similar (though less flexible than) the layout used by stumpwm or emacs' windows and buffers.



  • -If you use netctl or another network manager which doesn't provide any good tray icon or if you want something more native than nm-applet, this is for you.







Text format

You can use Pango markup in a text string. This allows formatting the text rendered inside widgets. Pango markup documentation can be found in the Pango documentation at

A Pango markup example: .


  • :carrot: - Carrot awesomeWM personalization application

  • - This module add some visual indicators for common window management operations. It is now easier to know the impact of a given command as a visual queue will be printed on the screen. Collision has 3 modes: Focus: Move the focus from client to client; Move: Move a client; Resize: Change a client dimensions; Tag: Move to the previous/next tag

  • -Auto-hide the awesome-wibox/taskbarIf you ever wanted to squeeze out that last bit of screen real estate in awesome and only show the wibox when needed (i.e when pressing the ModKey), this is for you.Since awesome doesn't allow easy access to the states of the Super/Mod-Key itself in rc.lua, one cannot simply show the wibox while the ModKey is pressed and hide it again on release. This little python daemon will sit in the background and do just that.

  • -a simple per-window keyboard layout switcher for Awesome WM.It uses awesome XKB functions, so awesome 4 is required. Layouts stored in X property awpwkb_layout and they are persistent between awesome restarts.


  • Scratchpad - An easy way to create multiple scratchpads.

Themes and configs

The color format in awesome is either a standard X color name (blue, darkblue, lightred, etc) or a hexadecimal formatted color (#rrggbb or #rrggbbaa). By using the hexadecimal format, you can also specify an alpha channel: that means that #00ff00 will draw pure green, but #00ff00aa will set the alpha channel to ‘aa’ and will blend the green with the color under it.

If xdg/awesome default config loads instead of .config/awesome, this is due to error in the rc.lua.

  • - the most powerful and highly configurable, next generation framework window manager for X, Although it takes time and effort to configure it, but I'm very satisfied with the result.