FreeBSD Manual Pages
ICEWM-TOOLBAR(5) Standards, Environments and Macros ICEWM-TOOLBAR(5)
NAME
icewm-toolbar - icewm toolbar configuration file
SYNOPSIS
$ICEWM_PRIVCFG/toolbar
$XDG_CONFIG_HOME/icewm/toolbar
$HOME/.icewm/toolbar
/usr/local/etc/icewm/toolbar
/usr/local/share/icewm/toolbar
DESCRIPTION
The toolbar file is responsible for configuring quick launch application
icons that are placed on the icewm(1) panel. It contains names of quick to
launch applications with icons for the task bar. Each non-empty non-com-
ment 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 fol-
lows 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) 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,
progThe 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 (""").
iconThe icon to display on the toolbar button. May be specified as a sin-
gle 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) are permitted here as
well.
EXAMPLES
Following is an example that places a number of toolbar buttons on the
icewm(1) 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/local/etc/icewm/toolbar
/usr/local/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-programs(5), icewm-menu(5), icewm-menu-fdo(1).
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.
icewm 4.0.0 2026-01-01 ICEWM-TOOLBAR(5)
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=icewm-toolbar&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>