Skip to main content
Version: 2.1

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:

Key Modules​

ModulePurpose
awful.keyDefine keyboard shortcuts
awful.buttonDefine mouse bindings
ruled.clientClient rules. Replaces the removed awful.rules module
awful.layoutTiling layouts
awful.tagTag (workspace) management
awful.clientClient (window) operations
awful.screenScreen management
awful.spawnLaunch applications
awful.promptInput prompts
awful.menuContext menus
awful.screenshotScreenshot capture and interactive snipping

SomeWM Extensions​

ModuleDescription
awful.inputRuntime input device configuration (pointer, keyboard)
CarouselHorizontal 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.