awesome

• Index

Contents

• Static module functions
• Theme variables
• Deprecated functions
• Tables
• Fields

Popups and bars

• awful.hotkeys_popup.widget
• awful.menu
• awful.popup
• awful.titlebar
• awful.tooltip
• awful.wibar
• awful.widget.calendar_popup
• menubar
• naughty.layout.box
• naughty.layout.legacy
• wibox

Core components

• awesome
• awful.keygrabber
• client and awful.client
• drawable
• gears.timer
• mousegrabber
• naughty.action
• naughty.notification
• root
• screen and awful.screen
• tag and awful.tag

Input handling

• awful.button
• awful.key
• awful.keyboard
• mouse

Declarative rules

• ruled.client

Widgets

• awful.widget.button
• awful.widget.clienticon
• awful.widget.keyboardlayout
• awful.widget.launcher
• awful.widget.layoutbox
• awful.widget.layoutlist
• awful.widget.prompt
• awful.widget.taglist
• awful.widget.tasklist
• awful.widget.watch
• naughty.list.actions
• naughty.list.notifications
• naughty.widget.icon
• naughty.widget.message
• naughty.widget.title
• wibox.widget.calendar
• wibox.widget.checkbox
• wibox.widget.graph
• wibox.widget.imagebox
• wibox.widget.piechart
• wibox.widget.progressbar
• wibox.widget.separator
• wibox.widget.slider
• wibox.widget.systray
• wibox.widget.textbox
• wibox.widget.textclock

Widget containers

• awful.widget.only_on_screen
• naughty.widget.background
• wibox.container.arcchart
• wibox.container.background
• wibox.container.constraint
• wibox.container.margin
• wibox.container.mirror
• wibox.container.place
• wibox.container.radialprogressbar
• wibox.container.rotate
• wibox.container.scroll

Widget layouts

• wibox.layout.align
• wibox.layout.fixed
• wibox.layout.flex
• wibox.layout.grid
• wibox.layout.manual
• wibox.layout.ratio
• wibox.layout.stack

Utility libraries

• gears.debug
• gears.filesystem
• gears.geometry
• gears.math
• gears.object
• gears.protected_call
• gears.sort
• gears.string
• gears.table
• gears.wallpaper

Theme related libraries

• beautiful
• gears.color
• gears.shape

Libraries

• awful.completion
• awful.hotkeys_popup
• awful.layout
• awful.permissions
• awful.placement
• awful.prompt
• awful.rules
• awful.spawn
• awful.util
• dbus
• gears.matcher
• gears.surface
• menubar.menu_gen
• menubar.utils
• naughty
• selection
• wibox.widget

Sample files

• rc.lua
• theme.lua

Classes

• awful.widget.common
• gears.cache
• gears.matrix
• menubar.icon_theme
• menubar.index_theme
• signals
• wibox.drawable
• wibox.hierarchy
• wibox.widget.base
• xproperties

Documentation

• Authors
• Readme
• Contributing
• The AwesomeWM widget system
• Creating new widget
• Default configuration file documentation
• Change Awesome appearance
• My first Awesome
• Startup options
• Using Cairo and LGI
• Tips for upgrading your configuration
• NEWS
• FAQ

Module: menubar

Menubar module, which aims to provide a freedesktop menu alternative.

List of menubar keybindings:

Keybinding	Description
LeftC-j	select an item on the left
RightC-k	select an item on the right
Backspace	exit the current category if we are in any
Escape	exit the current directory or exit menubar
Home	select the first item
End	select the last
Return	execute the entry
C-Return	execute the command with awful.spawn
C-M-Return	execute the command in a terminal

Info:

• Copyright: 2011-2012 Alexander Yakushev
• Author: Alexander Yakushev <[email protected]>

Static module functions

menubar.refresh ([scr])	Refresh menubar’s cache by reloading .desktop files.
menubar.show ([scr])	Show the menubar on the given screen.
menubar.hide ()	Hide the menubar.

Theme variables

beautiful.menubar_fg_normal	color	Menubar normal text color.
beautiful.menubar_bg_normal	color	Menubar normal background color.
beautiful.menubar_border_width	number	Menubar border width.
beautiful.menubar_border_color	color	Menubar border color.
beautiful.menubar_fg_normal	color	Menubar selected item text color.
beautiful.menubar_bg_normal	color	Menubar selected item background color.

Deprecated functions

menubar.get [deprecated]

Get a menubar wibox.

Tables

geometry	Specifies the geometry of the menubar.
prompt_args	Allows user to specify custom parameters for prompt.run function (like colors).

Fields

menubar.cache_entries	boolean	When true the .desktop files will be reparsed only when the extension is initialized.
menubar.show_categories	boolean	When true the categories will be shown alongside application entries.
menubar.right_margin	number	Width of blank space left in the right side.
menubar.right_label	string	Label used for “Next page”, default “▶▶”.
menubar.left_label	string	Label used for “Previous page”, default “◀◀”.

Static module functions

menubar.refresh ([scr])

Refresh menubar’s cache by reloading .desktop files.

Parameters:

• scr screen Screen. (optional)

menubar.show ([scr])

Show the menubar on the given screen.

Parameters:

• scr Screen. (optional)

menubar.hide ()

Hide the menubar.

Theme variables

beautiful.menubar_fg_normal (color)

Menubar normal text color.

beautiful.menubar_bg_normal (color)

Menubar normal background color.

beautiful.menubar_border_width (number)

Menubar border width.

beautiful.menubar_border_color (color)

Menubar border color.

beautiful.menubar_fg_normal (color)

Menubar selected item text color.

beautiful.menubar_bg_normal (color)

Menubar selected item background color.

Deprecated functions

menubar.get [deprecated]

Get a menubar wibox.

Parameters:

• scr screen Screen. (optional)

Returns:

menubar wibox.

Tables

geometry

Specifies the geometry of the menubar. This is a table with the keys x, y, width and height. Missing values are replaced via the screen’s geometry. However, missing height is replaced by the font size.

prompt_args

Allows user to specify custom parameters for prompt.run function (like colors).

See also:

awful.prompt

Fields

menubar.cache_entries (boolean)

When true the .desktop files will be reparsed only when the extension is initialized. Use this if menubar takes much time to open.

menubar.show_categories (boolean)

When true the categories will be shown alongside application entries.

menubar.right_margin (number)

Width of blank space left in the right side.

menubar.right_label (string)

Label used for “Next page”, default “▶▶”.

menubar.left_label (string)

Label used for “Previous page”, default “◀◀”.