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

FreeBSD Manual Pages

  
 
  

home | help
wmapplrc(1)		    General Commands Manual		   wmapplrc(1)

NAME
       wmapplrc	- configuration	file for wmappl

DESCRIPTION
       The  format of a	wmappl configuration file consists of a	number of sec-
       tions, defined by a section name	surrounded in square brakets, for  ex-
       ample:  "[section]".  Each  button  that	should appear in wmappl	should
       have its	own section. The lines following the section name specify  the
       icon  to	 use,  the command to launch when the button is	pressed	and an
       optional	tooltip	string to be displayed.

       An optional [wmappl] section may	be specified which specifies  configu-
       ration  options	for  wmappl.  These options have the same names	as the
       long command line options and are entirely optional. Command line argu-
       ments  will override any	specified in the configuration file. There are
       some options that have no cooresponding command line option.

       Anything	after a	pound sign ('#') is considered a comment and  will  be
       ignored.	 A  line  may  be  continued by	ending the line	in a backslash
       ('\'). Blank lines and any invalid key=value pairs are ignored.

BUTTON SECTION OPTIONS
       icon=<iconfile>
	      xpm icon for the button, accepts an absolute path	or a path rel-
	      ative to a directory in the iconpath

       command=<command>
	      command to execute when button is	pressed, it should end with an
	       to run it in the	background

       tooltip=<tooltip	string>
	      tooltip that should be displayed over the	button when the	 mouse
	      is hovered over it

WMAPPL SECTION OPTIONS
       iconpath=<path1>:[path2]:...:[pathN]
	      a	colon separated	path to	search for icons

       name=<windowname>
	      window name (specify different names to run multiple instances)

       tooltip_delay=<delay in milliseconds>
	      delay in milliseconds before appearance of tooltip

       window=
	      run in windowed mode if this option is specified

       debug= run in debug mode	if this	option is specified

       background_color=<color>
	      specifies	the background color of	wmappl

       background_icon=<iconfile>
	      xpm  icon	for the	background of wmappl, accepts an absolute path
	      or a path	relative to a directory	in the iconpath	(takes	prece-
	      dence over background_color option)

       tooltip_foreground=<color>
	      foreground (text)	color for tooltips

       tooltip_background=<color>
	      background color for tooltips

       tooltip_font=<X11 font string>
	      X11 font string for the font to use for tooltips

EXAMPLE
       The  following  example	defines	nine buttons, specifies	wmappl options
       and demonstrates	comments, line expansion and blank lines:

	   [wmappl]
	   iconpath=/usr/share/icons/wmappl:/usr/share/pixmaps/mini
	   name=Demo
	   window=
	   debug=
	   tooltip_delay=800		    # 800 milliseconds
	   tooltip_foreground=rgb:ff/ff/ff  # white tooltip text
	   tooltip_background=rgb:ff/00/00  # red tooltip background
	   tooltip_font=-*-bitstream vera serif-*-*-*-*-*-*-*-*-*-*-*-*	 # use
       vera serif font
	   background_color=rgb:73/7e/df    # light blue wmappl	background
	   background_icon=checker.xpm
	   # the checkered background will override the	light blue background

	   [info]
	   icon	= info.xpm
	   command = xmessage "Reports bugs to:	\
	   wmappl.sourceforge.net" &
	   tooltip = wmappl information

	   [man	wmappl]
	   icon	= wmappl.xpm
	   command = xterm -fg white -bg black -e man wmappl &
	   tooltip = open the wmappl man page

	   [wprefs]
	   icon	= gnustep.xpm
	   command = /usr/share/GNUstep/WPrefs.app/WPrefs &

	   [mozilla]
	   icon	= mozilla.xpm
	   command = mozilla &

	   [xterm]
	   icon	= glowx.xpm
	   command = xterm &

	   [ghostview]
	   icon	= ghost.xpm
	   command = gv	&

	   [xmms]
	   icon	= xmms.xpm
	   command = xmms &
	   tooltip = xmms gets a really	really really	\
		     really really really really really	\
		     really really really really really	\
		     long tooltip!

	   [ssh	to work]
	   icon	= ssh.xpm
	   command = xterm -fg green -bg black \
		     -e	ssh -l user shell.work.com &

REPORTING BUGS
       Report bugs at http://wmappl.sourceforge.net

WARRANTY
       This is free software with ABSOLUTELY NO	WARRANTY

AUTHOR
       Casey Harkins <charkins@pobox.com>

SEE ALSO
       wmappl(1)

				 March 9, 2004			   wmapplrc(1)

NAME | DESCRIPTION | BUTTON SECTION OPTIONS | WMAPPL SECTION OPTIONS | EXAMPLE | REPORTING BUGS | WARRANTY | AUTHOR | SEE ALSO

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

home | help