Launcher

Note

This module requires a wlroots-based compositor. It will not work without the wlr-foreign-toplevel-management protocol.

Windows-style taskbar that displays running windows, grouped by program. Hovering over a program with multiple windows open shows a popup with each window. Left clicking an icon/popup item focuses the program if it has any open instances or otherwise launches a new instance of the program. Middle clicking an icon always launches a new instance of the program. Optionally displays a launchable set of favourites.

Configuration

Type: launcher

	Type	Default	Description
favorites	string[]	[]	List of app IDs (or classes) to always show at the start of the launcher.
show_names	boolean	false	Whether to show app names on the button label. Names will still show on tooltips when set to false.
show_icons	boolean	true	Whether to show app icons on the button.
icon_size	integer	32	Size to render icon at (image icons only).
reversed	boolean	false	Whether to reverse the order of favorites/items
minimize_focused	boolean	true	Whether to minimize a focused window when its icon is clicked. Only minimizes single windows.
truncate.mode	'start' or 'middle' or 'end' or off	end	Location of the ellipses and where to truncate text from. Applies to application names when show_names is enabled.
truncate.length	integer	null	Fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.
truncate.max_length	integer	null	Maximum number of characters before truncating. Leave blank to let GTK automatically handle.
truncate_popup.mode	'start' or 'middle' or 'end' or off	middle	Location of the ellipses and where to truncate text from. Applies to window names within a group popup.
truncate_popup.length	integer	null	Fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.
truncate_popup.max_length	integer	25	Maximum number of characters before truncating. Leave blank to let GTK automatically handle.
page_size	integer	1000	Number of items to show on a page. When the number of items is reached, controls appear which can be used to move forward/back through the list of items.
icons.page_back	string or image	󰅁	Icon to show for page back button.
icons.page_forward	string or image	󰅂	Icon to show for page forward button.

JSON

{
  "start": [
    {
      "type": "launcher",
      "favourites": [
        "firefox",
        "discord"
      ],
      "show_names": false,
      "show_icons": true,
      "reversed": false
    }
  ]
}

TOML

[[start]]
type = "launcher"
favorites = ["firefox", "discord"]
show_names = false
show_icons = true
reversed = false

YAML

start:
  - type: "launcher"
    favorites:
      - firefox
      - discord
    show_names: false
    show_icons: true
    reversed: false

Corn

{
  start = [
    {
      type = "launcher"
      favorites = [ "firefox" "discord" ]
      show_names = false
      show_icons = true
      reversed = false
    }
  ]
}

Styling

Selector	Description
.launcher	Launcher widget box
.launcher .item	App button
.launcher .item.open	App button (open app)
.launcher .item.focused	App button (focused app)
.launcher .item.urgent	App button (urgent app)
.launcher .pagination	Pagination controls box
.launcher .pagination .btn-back	Pagination back button
.launcher .pagination .btn-forward	Pagination forward button
.popup-launcher	Popup container
.popup-launcher .popup-item	Window button in popup

For more information on styling, please see the styling guide.