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. Clicking an icon/popup item focuses or launches 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

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)
.popup-launcher	Popup container
.popup-launcher .popup-item	Window button in popup

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