wmapplrc(1)wmapplrc(1)NAMEwmapplrc - 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
example: "[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 ALSOwmappl(1)
March 9, 2004 wmapplrc(1)
