Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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-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 which 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
	/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 2.5.0			  2021-06-26		      ICEWM-TOOLBAR(5)

NAME | SYNOPSIS | DESCRIPTION | FORMAT | EXAMPLES | FILES | SEE ALSO | AUTHOR | LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=icewm-toolbar&sektion=5&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help