API documentation for awesome, a highly configurable X window manager (version master-gacc0123).
Welcome to the documentation for the awesome window manager. Below you find an overview of the individual parts which links to the full documentation.
If you are a new user, you may want to read 07-my-first-awesome.md to get started. In 05-awesomerc.md, the default configuration is explained.
If you already used awesome in the past, 89-NEWS.md and 17-porting-tips.md should be useful for you.
Libraries
| awesome | awesome core API |
| awful.client | This module documentation has been merged with the client class. |
| awful.completion | Completion module. |
| awful.ewmh | Implements EWMH requests handling. |
| awful.hotkeys_popup | Popup widget which shows current hotkeys and their descriptions. |
| awful.hotkeys_popup.keys | Additional hotkeys for awful.hotkeys_widget |
| awful.hotkeys_popup.keys.firefox | Firefox hotkeys for awful.hotkeys_widget |
| awful.hotkeys_popup.keys.qutebrowser | Qutebrowser hotkeys for awful.hotkeys_widget |
| awful.hotkeys_popup.keys.tmux | tmux hotkeys for awful.hotkeys_widget |
| awful.hotkeys_popup.keys.vim | VIM hotkeys for awful.hotkeys_widget |
| awful.hotkeys_popup.widget | Popup widget which shows current hotkeys and their descriptions. |
| awful.key | Create easily new key objects ignoring certain modifiers. |
| awful.keygrabber | Keygrabber Stack |
| awful.layout | Layout module for awful |
| awful.menu | A menu for awful |
| awful.mouse | This module documentation has been merged with the mouse class. |
| awful.placement | Algorithms used to place various drawables. |
| awful.prompt | Prompt module for awful. |
| awful.rules | Apply rules to clients at startup. |
| awful.screen | This module documentation has been merged with the screen class. |
| awful.spawn | Spawning of programs. |
| awful.tag | This module documentation has been merged with the tag class. |
| awful.titlebar | Titlebars for awful. |
| awful.util | Utility module for awful |
| awful.wibox | This module is deprecated and has been renamed awful.wibar |
| beautiful | Theme library. |
| beautiful.theme_assets | Generate vector assets using current colors. |
| beautiful.xresources | Library for getting xrdb data. |
| dbus | awesome D-Bus API |
| gears.color | |
| gears.debug | |
| gears.filesystem | Filesystem module for gears |
| gears.geometry | Helper functions used to compute geometries. |
| gears.math | Math module for gears |
| gears.object.properties | An helper module to map userdata index and newindex entries to lua classes. |
| gears.protected_call | |
| gears.shape | Module dedicated to gather common shape painters. |
| gears.string | String module for gears |
| gears.surface | |
| gears.table | Table module for gears |
| gears.wallpaper | |
| keygrabber | awesome keygrabber API |
| menubar | Menubar module, which aims to provide a freedesktop menu alternative |
| menubar.menu_gen | Menu generation module for menubar |
| menubar.utils | Utility module for menubar |
| mouse | awesome mouse API. |
| mousegrabber | awesome mousegrabber API |
| naughty | Notification library |
| naughty.dbus | DBUS/Notification support Notify |
| objects.button | Mouse buttons bindings |
| objects.client | client_t type |
| objects.drawable | drawable type |
| objects.drawin | Drawin type |
| objects.key | Key modifier |
| objects.screen | Is this screen still valid and may be used? |
| objects.tag | Tag type |
| objects.window | Windows type |
| root | awesome root window API |
| selection | awesome selection (clipboard) API |
| wibox.hierarchy | Management of widget hierarchies. |
Sample files
| rc.lua | The default rc.lua file. |
| theme.lua | The default theme file. |
Classes
| awful.button | Create easily new buttons objects ignoring certain modifiers. |
| awful.tooltip | Tooltip module for awesome objects. |
| awful.wibar | Wibox module for awful. |
| awful.widget.button | A simple button widget. |
| awful.widget.calendar_popup | A calendar popup wibox
Display a month or year calendar popup using |
| awful.widget.clienticon | Container showing the icon of a client. |
| awful.widget.common | |
| awful.widget.graph | This module has been moved to wibox.widget.graph |
| awful.widget.keyboardlayout | |
| awful.widget.launcher | |
| awful.widget.layoutbox | Layoutbox widget. |
| awful.widget.only_on_screen | A container that makes a widget display only on a specified screen. |
| awful.widget.progressbar | This module has been moved to wibox.widget.progressbar |
| awful.widget.prompt | The widget version of awful.prompt. |
| awful.widget.taglist | Taglist widget module for awful |
| awful.widget.tasklist | Tasklist widget module for awful. |
| awful.widget.textclock | This widget has moved to wibox.widget.textclock |
| awful.widget.watch | Watch widget. |
| button | awesome button API
Furthermore to the classes described here, one can also use signals as described in signals. |
| client | A process window. |
| drawable | awesome drawable API |
| gears.cache | |
| gears.matrix | An implementation of matrices for describing and working with affine transformations. |
| gears.object | The object oriented programming base class used by various Awesome widgets and components. |
| gears.timer | Timer objects and functions. |
| key | awesome key API
Furthermore to the classes described here, one can also use signals as described in signals. |
| menubar.icon_theme | Class module for icon lookup for menubar |
| menubar.index_theme | Class module for parsing an index.theme file |
| screen | awesome screen API
Screen objects can be added and removed over time. |
| signals | Handling of signals. |
| tag | awesome tag API
Furthermore to the classes described here, one can also use signals as described in signals. |
| wibox | |
| wibox.container.arcchart | A circular chart (arc chart). |
| wibox.container.background | A container capable of changing the background color, foreground color widget shape. |
| wibox.container.constraint | |
| wibox.container.margin | |
| wibox.container.mirror | |
| wibox.container.place | A container used to place smaller widgets into larger space. |
| wibox.container.radialprogressbar | A circular progressbar wrapper. |
| wibox.container.rotate | A container rotating the conained widget by 90 degrees. |
| wibox.container.scroll | This container scrolls its inner widget inside of the available space. |
| wibox.drawable | Handling of drawables. |
| wibox.layout.align | |
| wibox.layout.constraint | This class has been moved to wibox.container. |
| wibox.layout.fixed | |
| wibox.layout.flex | |
| wibox.layout.grid | A grid layout. |
| wibox.layout.manual | A layout with widgets added at specific positions. |
| wibox.layout.margin | This class has been moved to wibox.container.margin |
| wibox.layout.mirror | This class has been moved to wibox.container.mirror |
| wibox.layout.ratio | A layout filling all the available space. |
| wibox.layout.rotate | This class has been moved to wibox.container.rotate |
| wibox.layout.scroll | This class has been moved to wibox.container.scroll |
| wibox.layout.stack | A stacked layout. |
| wibox.widget | |
| wibox.widget.background | This class has been moved to wibox.container.background |
| wibox.widget.base | |
| wibox.widget.calendar | A calendar widget
This module defines two widgets: a month calendar and a year calendar The two widgets have a |
| wibox.widget.checkbox | A boolean display widget. |
| wibox.widget.graph | A graph widget. |
| wibox.widget.imagebox | |
| wibox.widget.piechart | Display percentage in a circle. |
| wibox.widget.progressbar | A progressbar widget. |
| wibox.widget.slider | An interactive mouse based slider widget. |
| wibox.widget.systray | |
| wibox.widget.textbox | |
| wibox.widget.textclock | Text clock widget. |
| xproperties | Handling of X properties. |