1ICEWM-TOOLBAR(5)      Standards, Environments and Macros      ICEWM-TOOLBAR(5)
2
3
4
5   NAME
6        icewm-toolbar - icewm toolbar configuration file
7
8   SYNOPSIS
9        $ICEWM_PRIVCFG/toolbar
10        $XDG_CONFIG_HOME/icewm/toolbar
11        $HOME/.icewm/toolbar
12        /etc/icewm/toolbar
13        /usr/share/icewm/toolbar
14
15   DESCRIPTION
16       The toolbar file is responsible for configuring quick launch
17       application icons that are placed on the icewm(1) panel.  It contains
18       names of quick to launch applications with icons for the task bar.
19       Each non-empty non-comment line starts with the keyword prog.  After
20       one or more spaces follows a name, which is displayed in a tool tip
21       whenever the mouse cursor hovers over the toolbar icon.  This name may
22       be a double quoted string.  Then follows the bare name of the icon to
23       use without extensions.  This icon will be shown in the toolbar.  The
24       last component is a shell command line which will be executed whenever
25       the user presses the icon in the toolbar.  For example, the following
26       line in toolbar will create a button with tool tip "Mozilla Firefox"
27       with the firefox icon which launches firefox(1) when clicked:
28
29           prog  "Mozilla Firefox"  firefox  /usr/bin/firefox --private-window
30
31   FORMAT
32       The format of the file contains one of the following line syntax:
33
34           prog "title" icon program options
35
36       Where,
37
38       prog
39           The literal string prog.
40
41       "title"
42           The title of the toolbar item, which will appear as a tool-tip for
43           the program button, enclosed in double quotes (""").
44
45       icon
46           The icon to display on the toolbar button.  May be specified as a
47           single dash ("-") when no icon is provided.  When no icon is
48           provided, the title text will be displayed on the button in place
49           of the icon.
50
51       program
52           The executable program (full path or executable name) to run when
53           the button is pressed.
54
55       options
56           Options and arguments that are passed to program.
57
58       Lines beginning with a hash ("#") are comment lines.  Comment lines and
59       blank lines are ignored.
60
61   EXAMPLES
62       Following is an example that places a number of toolbar buttons on the
63       icewm(1) panel:
64
65           prog "File Manager" file-manager.png pcmanfm
66           prog "Web Browser" web-browser.png /usr/lib/firefox/firefox
67           prog "Terminal" terminal.png roxterm
68           prog "Graphical Editor" text-editor.png gvim -f
69           prog "Calculator" accessories-calculator.png calculator
70           prog "Run Command" gtk-execute.png xde-run
71           prog "Network" gtk-network.png pcmanfm ~/Network
72           prog "Logout" system-log-out.png xde-logout
73
74   FILES
75       Locations for the toolbar file are as follows:
76
77        $ICEWM_PRIVCFG/toolbar
78        $XDG_CONFIG_HOME/icewm/toolbar
79        $HOME/.icewm/toolbar
80        /etc/icewm/toolbar
81        /usr/share/icewm/toolbar
82
83       The locations are searched in the order listed; the first file found is
84       read and the remainder ignored.
85
86   SEE ALSO
87       icewm(1), icewm-programs(5), icewm-menu(5), icewm-menu-fdo(1).
88
89   AUTHOR
90       Brian Bidulock <mailto:bidulock@openss7.org>.
91
92   LICENSE
93       IceWM is licensed under the GNU Library General Public License.  See
94       the COPYING file in the distribution.
95
96
97
98icewm 3.3.1                       2023-01-24                  ICEWM-TOOLBAR(5)
Impressum