Built-in Extensions¶

CommandSet¶

class libqtile.extension.CommandSet(**config)[source]¶

Give list of commands to be executed in dmenu style.

ex. manage mocp deamon:

Key([mod], 'm', lazy.run_extension(extension.CommandSet(
    commands={
        'play/pause': '[ $(mocp -i | wc -l) -lt 2 ] && mocp -p || mocp -G',
        'next': 'mocp -f',
        'previous': 'mocp -r',
        'quit': 'mocp -x',
        'open': 'urxvt -e mocp',
        'shuffle': 'mocp -t shuffle',
        'repeat': 'mocp -t repeat',
        },
    pre_commands=['[ $(mocp -i | wc -l) -lt 1 ] && mocp -S'],
    **Theme.dmenu))),

key	default	description
`background`	`None`	defines the normal background color
`command`	`None`	the command to be launched (string or list with arguments)
`commands`	`None`	dictionary of commands where key is runable command
`dmenu_bottom`	`False`	dmenu appears at the bottom of the screen
`dmenu_command`	`'dmenu'`	the dmenu command to be launched
`dmenu_font`	`None`	override the default ‘font’ and ‘fontsize’ options for dmenu
`dmenu_height`	`None`	defines the height (only supported by some dmenu forks)
`dmenu_ignorecase`	`False`	dmenu matches menu items case insensitively
`dmenu_lines`	`None`	dmenu lists items vertically, with the given number of lines
`dmenu_prompt`	`None`	defines the prompt to be displayed to the left of the input field
`font`	`'sans'`	defines the font name to be used
`fontsize`	`None`	defines the font size to be used
`foreground`	`None`	defines the normal foreground color
`pre_commands`	`None`	list of commands to be executed before getting dmenu answer
`selected_background`	`None`	defines the selected background color
`selected_foreground`	`None`	defines the selected foreground color

Dmenu¶

class libqtile.extension.Dmenu(**config)[source]¶

Python wrapper for dmenu http://tools.suckless.org/dmenu/

key	default	description
`background`	`None`	defines the normal background color
`command`	`None`	the command to be launched (string or list with arguments)
`dmenu_bottom`	`False`	dmenu appears at the bottom of the screen
`dmenu_command`	`'dmenu'`	the dmenu command to be launched
`dmenu_font`	`None`	override the default ‘font’ and ‘fontsize’ options for dmenu
`dmenu_height`	`None`	defines the height (only supported by some dmenu forks)
`dmenu_ignorecase`	`False`	dmenu matches menu items case insensitively
`dmenu_lines`	`None`	dmenu lists items vertically, with the given number of lines
`dmenu_prompt`	`None`	defines the prompt to be displayed to the left of the input field
`font`	`'sans'`	defines the font name to be used
`fontsize`	`None`	defines the font size to be used
`foreground`	`None`	defines the normal foreground color
`selected_background`	`None`	defines the selected background color
`selected_foreground`	`None`	defines the selected foreground color

DmenuRun¶

class libqtile.extension.DmenuRun(**config)[source]¶

Special case to run applications.

config.py should have something like:

from libqtile import extension
keys = [
    Key(['mod4'], 'r', lazy.run_extension(extension.DmenuRun(
        dmenu_prompt=">",
        dmenu_font="Andika-8",
        background="#15181a",
        foreground="#00ff00",
        selected_background="#079822",
        selected_foreground="#fff",
        dmenu_height=24,  # Only supported by some dmenu forks
    ))),
]

key	default	description
`background`	`None`	defines the normal background color
`command`	`None`	the command to be launched (string or list with arguments)
`dmenu_bottom`	`False`	dmenu appears at the bottom of the screen
`dmenu_command`	`'dmenu_run'`	the dmenu command to be launched
`dmenu_font`	`None`	override the default ‘font’ and ‘fontsize’ options for dmenu
`dmenu_height`	`None`	defines the height (only supported by some dmenu forks)
`dmenu_ignorecase`	`False`	dmenu matches menu items case insensitively
`dmenu_lines`	`None`	dmenu lists items vertically, with the given number of lines
`dmenu_prompt`	`None`	defines the prompt to be displayed to the left of the input field
`font`	`'sans'`	defines the font name to be used
`fontsize`	`None`	defines the font size to be used
`foreground`	`None`	defines the normal foreground color
`selected_background`	`None`	defines the selected background color
`selected_foreground`	`None`	defines the selected foreground color

J4DmenuDesktop¶

class libqtile.extension.J4DmenuDesktop(**config)[source]¶

Python wrapper for j4-dmenu-desktop https://github.com/enkore/j4-dmenu-desktop

key	default	description
`background`	`None`	defines the normal background color
`command`	`None`	the command to be launched (string or list with arguments)
`dmenu_bottom`	`False`	dmenu appears at the bottom of the screen
`dmenu_command`	`'dmenu'`	the dmenu command to be launched
`dmenu_font`	`None`	override the default ‘font’ and ‘fontsize’ options for dmenu
`dmenu_height`	`None`	defines the height (only supported by some dmenu forks)
`dmenu_ignorecase`	`False`	dmenu matches menu items case insensitively
`dmenu_lines`	`None`	dmenu lists items vertically, with the given number of lines
`dmenu_prompt`	`None`	defines the prompt to be displayed to the left of the input field
`font`	`'sans'`	defines the font name to be used
`fontsize`	`None`	defines the font size to be used
`foreground`	`None`	defines the normal foreground color
`j4dmenu_command`	`'j4-dmenu-desktop'`	the dmenu command to be launched
`j4dmenu_display_binary`	`False`	display binary name after each entry
`j4dmenu_generic`	`True`	include the generic name of desktop entries
`j4dmenu_terminal`	`None`	terminal emulator used to start terminal apps
`j4dmenu_usage_log`	`None`	file used to sort items by usage frequency
`j4dmenu_use_xdg_de`	`False`	read $XDG_CURRENT_DESKTOP to determine the desktop environment
`selected_background`	`None`	defines the selected background color
`selected_foreground`	`None`	defines the selected foreground color

RunCommand¶

class libqtile.extension.RunCommand(**config)[source]¶

Run an arbitrary command.

Mostly useful as a superclass for more specific extensions that need to interact with the qtile object.

Also consider simply using lazy.spawn() or writing a client.

key	default	description
`background`	`None`	defines the normal background color
`command`	`None`	the command to be launched (string or list with arguments)
`font`	`'sans'`	defines the font name to be used
`fontsize`	`None`	defines the font size to be used
`foreground`	`None`	defines the normal foreground color
`selected_background`	`None`	defines the selected background color
`selected_foreground`	`None`	defines the selected foreground color

WindowList¶

class libqtile.extension.WindowList(**config)[source]¶

Give vertical list of all open windows in dmenu. Switch to selected.

key	default	description
`all_groups`	`True`	If True, list windows from all groups; otherwise only from the current group
`background`	`None`	defines the normal background color
`command`	`None`	the command to be launched (string or list with arguments)
`dmenu_bottom`	`False`	dmenu appears at the bottom of the screen
`dmenu_command`	`'dmenu'`	the dmenu command to be launched
`dmenu_font`	`None`	override the default ‘font’ and ‘fontsize’ options for dmenu
`dmenu_height`	`None`	defines the height (only supported by some dmenu forks)
`dmenu_ignorecase`	`False`	dmenu matches menu items case insensitively
`dmenu_lines`	`'80'`	Give lines vertically. Set to None get inline
`dmenu_prompt`	`None`	defines the prompt to be displayed to the left of the input field
`font`	`'sans'`	defines the font name to be used
`fontsize`	`None`	defines the font size to be used
`foreground`	`None`	defines the normal foreground color
`item_format`	`'{group}.{id}: {window}'`	the format for the menu items
`selected_background`	`None`	defines the selected background color
`selected_foreground`	`None`	defines the selected foreground color