2007-11-20 09:28:50 +01:00
# Description
2008-03-08 09:32:07 +01:00
*awesome* is a floating and tiling window manager initialy based on a [dwm](http://www.suckless.org/wiki/dwm) code rewriting.
2007-11-20 09:28:50 +01:00
It's extremely fast, small, dynamic and awesome.
2008-01-09 10:03:27 +01:00
Windows can be managed in several layouts: tiled, maximized, dwindle, spiral, floating…
2007-11-20 09:28:50 +01:00
Each layout can be applied on the fly, optimizing the environment for the application in use and the task performed.
2007-11-28 13:55:11 +01:00
Managing windows in tiled mode assures that no space will be wasted on your screen. No gaps, no overlap.
2008-01-09 10:03:27 +01:00
Other layouts can be used for different purpose.
2007-11-20 09:28:50 +01:00
2008-03-08 09:32:07 +01:00
If you do not want to use the tiling management, you can use the floating layout wich will let you organize your windows as you wish, like any other window manager.
2008-02-13 17:25:24 +01:00
# Concepts
2007-11-20 09:28:50 +01:00
## Tiled layout
With tiled layout, windows are managed in a master and a stacking area.
The master area contains the windows which currently need most attention, whereas the stacking area contains all other windows.
The master area can be splited in several rows and column, as you want.
2007-11-21 16:30:43 +01:00
## Maximized layout
2008-02-13 17:25:24 +01:00
Each window is resized to take full screen space.
2007-11-21 16:30:43 +01:00
2007-11-20 09:28:50 +01:00
## Floating layout
In floating layout, windows can be resized and moved freely, just like a usual window manager.
Dialog windows are always managed floating, regardless of the layout selected.
## Tags
Windows are grouped by tags. Each window can be tagged with one or multiple tags.
Selecting certain tags displays all windows with those tags. Each tag can have its own layout.
Tags can be compared to virtual desktops, but it's more powerful: you can quickly merge and show several tags at the same time,
and go back to only one tag after.
## Status bar
2008-02-13 17:25:24 +01:00
awesome contains a small status bar which can contain a lot of widget: display all available tags, current layout, tasklists, texts, icons, graphs, progress bars. Each widget can have its own configuration and mouse bindings.
2008-01-09 10:03:27 +01:00
2007-11-21 16:30:43 +01:00
*awesome* draws a small border around windows to indicate their focus state.
## Configuration
2007-11-20 09:28:50 +01:00
2008-02-13 17:25:24 +01:00
Every aspect of *awesome* is configurable via a configuration file: **awesomerc**.
2007-11-20 09:28:50 +01:00
# Features and non-features
In contrast to ion, larswm, wmii, or dwm, awesome is much, pick 2 from that list: smaller, faster, simpler or awesome.
* Very stable.
2008-02-13 17:25:24 +01:00
* No mouse needed: everything can be performed with keyboard.
* Multihead support (XRandR, Xinerama or Zaphod mode).
* EWMH support.
2007-11-20 09:28:50 +01:00
* Some real transparency support (using Composite extension and xcompmgr for now).
2008-01-09 10:03:27 +01:00
* No limit on its source size: *awesome* has features we want.
2007-11-20 09:28:50 +01:00
* Doesn't distinguish between layers: there is no floating or tiled layer. Whether or not the clients of currently selected tag(s) are in tiled layout, you can rearrange them on the fly. Popup and fixed-size windows are always floating, however.
2008-02-13 17:25:24 +01:00
* Each function for manipulating environment is bindable to keys shortcut, mouse buttons or executable remotely via a socket (*awesome-client*).
2008-02-09 10:05:43 +01:00
This gonna be LEGEN... wait for it... DARY!