mirror of
https://github.com/JakeStanger/ironbar.git
synced 2024-11-29 10:33:00 +03:00
3cf9be89fd
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.
103 lines
2.6 KiB
Markdown
103 lines
2.6 KiB
Markdown
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. |
|
|
|
|
<details>
|
|
<summary>JSON</summary>
|
|
|
|
```json
|
|
{
|
|
"start": [
|
|
{
|
|
"type": "launcher",
|
|
"favourites": [
|
|
"firefox",
|
|
"discord"
|
|
],
|
|
"show_names": false,
|
|
"show_icons": true,
|
|
"icon_theme": "Paper"
|
|
}
|
|
]
|
|
}
|
|
|
|
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>TOML</summary>
|
|
|
|
```toml
|
|
[[start]]
|
|
type = "launcher"
|
|
favorites = ["firefox", "discord"]
|
|
show_names = false
|
|
show_icons = true
|
|
icon_theme = "Paper"
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>YAML</summary>
|
|
|
|
```yaml
|
|
start:
|
|
- type: "launcher"
|
|
favorites:
|
|
- firefox
|
|
- discord
|
|
show_names: false
|
|
show_icons: true
|
|
icon_theme: "Paper"
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>Corn</summary>
|
|
|
|
```corn
|
|
{
|
|
start = [
|
|
{
|
|
type = "launcher"
|
|
favorites = ["firefox" "discord"]
|
|
show_names = false
|
|
show_icons = true
|
|
icon_theme = "Paper"
|
|
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
</details>
|
|
|
|
## 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 |
|