ironbar/docs/modules/Launcher.md
Jake Stanger 3cf9be89fd
feat: global icon theme setting
BREAKING CHANGE: This removes the `icon_theme` option from `launcher` and `focused`. You will need to set this at the top of your config instead.
2023-01-30 11:51:01 +00:00

2.6 KiB

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.

Screenshot showing several open applications, including a focused terminal.

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.
JSON
{
  "start": [
    {
      "type": "launcher",
      "favourites": [
        "firefox",
        "discord"
      ],
      "show_names": false,
      "show_icons": true,
      "icon_theme": "Paper"
    }
  ]
}


TOML
[[start]]
type = "launcher"
favorites = ["firefox", "discord"]
show_names = false
show_icons = true
icon_theme = "Paper"
YAML
start:
  - type: "launcher"
    favorites:
      - firefox
      - discord
    show_names: false
    show_icons: true
    icon_theme: "Paper"
Corn
{
  start = [
    {
      type = "launcher"
      favorites = ["firefox" "discord"]
      show_names = false
      show_icons = true
      icon_theme = "Paper"

    }
  ]
}

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