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
        /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) 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) 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.

   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
        /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-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 3.6.0                       2024-06-16                  ICEWM-TOOLBAR(5)