Lua Libraries
SomeWM implements AwesomeWM's Lua API. The official AwesomeWM API documentation is the primary reference for all standard libraries.
This section documents SomeWM-specific extensions and notes any behavioral differences from AwesomeWM.
Core Libraries
| Library | Purpose | Docs |
|---|---|---|
| awful | Window management, keybindings, layouts, client rules | AwesomeWM docs ¹ |
| beautiful | Theming and appearance | AwesomeWM docs |
| wibox | Widgets, containers, and the wibar | AwesomeWM docs |
| naughty | Notifications | AwesomeWM docs |
| gears | Utilities (timers, shapes, colors, filesystem) | AwesomeWM docs ¹ |
¹ awful and gears span multiple categories in the AwesomeWM docs (input_handling, libraries, core_components, etc.)
SomeWM Extensions
These APIs are unique to SomeWM and not available in AwesomeWM:
| API | Purpose |
|---|---|
| awful.input | Runtime input device configuration |
| somewm-client | IPC command-line tool |
Other References
| Reference | Description |
|---|---|
| Key Names | Modifier keys and key name reference |
| Signals | Event signals by object type |
| Default Keybindings | Built-in keyboard shortcuts |