awful
The awful library is the core of AwesomeWM's window management functionality. It handles keybindings, mouse bindings, client rules, layouts, tags, and more.
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 |
awful.rules | Automatic client rules |
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 |
SomeWM Extensions
| Module | Description |
|---|---|
| awful.input | Runtime input device configuration (pointer, keyboard) |
Behavioral Notes
SomeWM's awful implementation is fully compatible with AwesomeWM. See Wayland vs X11 for platform-specific differences that may affect some operations.