wmapplrc(1)

NAME
wmapplrc - configuration file for wmappl

DESCRIPTION
The format of a wmappl configuration file consists of a number of sections, 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 configuration options for wmappl. These options have the same names as the long command line options and are entirely optional. Command line arguments 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 relative 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 precedence 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)