awful
awful provides client and tag operations, layouts, input bindings, and application launching.
Upstream documentation: The awful library spans multiple sections in the AwesomeWM docs:
- input_handling - keybindings, mouse bindings
- libraries - spawn, layout, completion
- core_components - screen, client, tag
Key Modules
| Module | Purpose |
|---|---|
awful.key | Define keyboard shortcuts |
awful.button | Define mouse bindings |
ruled.client | Client rules. Replaces the removed awful.rules module |
| awful.layout | Tiling layouts |
awful.tag | Tag (workspace) management |
awful.client | Client (window) operations |
awful.screen | Screen management |
awful.spawn | Launch applications |
awful.prompt | Input prompts |
awful.menu | Context menus |
| awful.screenshot | Screenshot capture and interactive snipping |
SomeWM Extensions
| Module | Description |
|---|---|
| awful.accessibility | Pointer location with rings, magnification and shake activation |
| awful.input | Runtime input device configuration (pointer, keyboard) |
| Carousel | Horizontal and vertical scrollable tiling |
Behavioral Notes
Legacy aliases and functional helpers removed in 2.0 remain unavailable. Use the replacement list when porting older configs. See deviations for platform differences.