XMTOOLBOX(1) General Commands Manual XMTOOLBOX(1)


xmtoolbox - application launcher


xmtoolbox [-rcfile <file>]


XmToolbox displays a user defined, multi-level menu of application groups and applications. It also interfaces with the xmsm(1) session manager to provide screen locking and session commands.


-rcfile <full path>
Specify a configuration file to use. See CONFIGURATION for details.
-title String
Specify toolbox window title. Default is user's login name and the host name.


XmToolbox reads its menu configuration from text files. If not specified on command line with the -rcfile option, its location defaults to .toolboxrc in user's home directory and toolboxrc in any of system configuration directories e.g. /etc/X11, /usr/lib/X11.
The syntax of a configuration file is as follows:
# Comment
Menu Title { Command Title: Command Line SEPARATOR ...
Submenu Title { ... } }
Prefix any title string character with & to specify a mnemonic. Literal & and : characters may be specified by prefixing them with the \ escape character. Comments # and scope {} delimiters may only be placed at the beginning of an empty line.
Literal whitespace characters in the command line may be specified either by prefixing each one with the \ escape character, of by placing them into parentheses.


title String
Defaults to <user>@<host>.
dateTimeDisplay Boolean
Display date and time. Default is True.
dateTimeFormat String
Date and time format string. See strftime(3). Defaults to %D %l:%M %p.
rcFile String
Full path to the configuration file. See CONFIGURATION for details.


XmToolbox responds to SIGUSR1 signal by reparsing the menu configuration file.


xmsm(1) xmwm(1)


Toolbox was written and is maintained by alx@fastestcode.org