---
name: "icewm-toolbar"
section: "5"
platform: "linux"
package: "icewm"
version: "4.1.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/icewm-toolbar"
---

# icewm-toolbar(5)

### NAME

```
 icewm-toolbar - icewm toolbar configuration file
```

### SYNOPSIS

```
 $ICEWM_PRIVCFG/toolbar
 $XDG_CONFIG_HOME/icewm/toolbar
 $HOME/.icewm/toolbar
 /usr/etc/icewm/toolbar
 /usr/share/icewm/toolbar
```

### DESCRIPTION

The *toolbar* file is responsible for configuring quick launch application icons that are placed on the [**icewm**(1)](/icewm/1.md) panel.  It contains names of quick to launch applications with icons for the task bar.  Each non-empty non-comment line starts with the keyword **prog**. After one or more spaces follows a name, which is displayed in a tool tip whenever the mouse cursor hovers over the toolbar icon.  This name may be a double quoted string.  Then follows the bare name of the icon to use without extensions.  This icon will be shown in the toolbar.  The last component is a shell command line that will be executed whenever the user presses the icon in the toolbar.  For example, the following line in toolbar will create a button with tool tip `"Mozilla Firefox"` with the *firefox* icon which launches [**firefox**(1)](/firefox/1.md) when clicked:

```
    prog  "Mozilla Firefox"  firefox  /usr/bin/firefox --private-window
```

### FORMAT

The format of the file contains one of the following line syntax:

**prog** **"***title***"** *icon* *program* *options*

Where,

- **prog**

  The literal string **prog**.

- **"***title***"**

  The title of the toolbar item, which will appear as a tool-tip for the program button, enclosed in double quotes (`"""`).

- *icon*

  The icon to display on the toolbar button.  May be specified as a single dash (`"-"`) when no icon is provided.  When no icon is provided, the *title* text will be displayed on the button in place of the icon.

- *program*

  The executable program (full path or executable name) to run when the button is pressed.

- *options*

  Options and arguments that are passed to *program*.

Lines beginning with a hash (`"#"`) are comment lines.  Comment lines and blank lines are ignored.

Please note that all keywords from [**icewm-menu**(5)](/icewm-menu/5.md) are permitted here as well.

### EXAMPLES

Following is an example that places a number of toolbar buttons on the [**icewm**(1)](/icewm/1.md) panel:

```
    prog "File Manager" file-manager.png pcmanfm
    prog "Web Browser" web-browser.png /usr/lib/firefox/firefox
    prog "Terminal" terminal.png roxterm
    prog "Graphical Editor" text-editor.png gvim -f
    prog "Calculator" accessories-calculator.png calculator
    prog "Run Command" gtk-execute.png xde-run
    prog "Network" gtk-network.png pcmanfm ~/Network
    prog "Logout" system-log-out.png xde-logout
```

### FILES

Locations for the *toolbar* file are as follows:

```
 $ICEWM_PRIVCFG/toolbar
 $XDG_CONFIG_HOME/icewm/toolbar
 $HOME/.icewm/toolbar
 /usr/etc/icewm/toolbar
 /usr/share/icewm/toolbar
```

The locations are searched in the order listed; the first file found is read and the remainder ignored.

### SEE ALSO

[**icewm**(1)](/icewm/1.md), [**icewm-programs**(5)](/icewm-programs/5.md), [**icewm-menu**(5)](/icewm-menu/5.md), [**icewm-menu-fdo**(1)](/icewm-menu-fdo/1.md).

### AUTHOR

Brian Bidulock \<mailto:bidulock@openss7.org\>.

### LICENSE

**IceWM** is licensed under the GNU Library General Public License. See the *COPYING* file in the distribution.