matchbox(1)

NAME
matchbox - A X11 Window Manger for handheld devices.

SYNOPSIS
matchbox -help
matchbox [options...]

DESCRIPTION
Matchbox is a X11 window manager designed for computers with little screen real estate, limited input devices and low cpu/storage resources. Touchscreen PDA's fit well into this category.

OPTIONS

-display
    Specify the XServer for matchbox to connect to. Defaults to $DISPLAY environmental variable.

-theme
    Specify the theme file to use. Defaults to default_theme_rc. The theme can also be changed whilst matchbox is executing using the mbcontrol program.

-modifier <mod1|mod2|ctrl>
    Specify the modifier key to be used in combination with keyboard shortcut keys. Defaults to mod2 ( record button on the ipaq )

-use_dock <yes|no>
    Specify whether or not to use the dock. Defaults to yes.

-dockmax
    Specify the height, in pixels, of the dock.

-dockmin
    Specify the height, in pixels, of the dock when collapsed. defaults to 4.

-use_titlebar
    Specify whether or not the main windows have titlebars. Defaults to yes.

-help
     Display a brief help message and exit.

INCLUDED UTILITIES
Matchbox Includes a number of simple utilities.

minitime [options ...]

A dockable clock. Currently supports -f and -c switches for font and colour respectively.

miniapm

A dockable battery monitor, currently a little broken :(

minisys [options...]

A dockable mem/cpu monitor. Run with '-h' to see options.

monolaunch [-k] <xpm to use> <window name> <program to run>

A single app launcher which sits in the dock with the selected xpm icon. Initial click will launch the selected program, next click will hide the programs window, next will show the window, next will hide, and so on for ever.... Passing -k option will kill the program rather than hide it. Originally based on xsingleinstance.

mbcontrol [ options...]

When run with a '-r' it will output the current theme file matchbox is using to stdout.  When run with '-t <full path to theme_file>', matchbox will switch to that theme. Be aware however if the theme file doesn't exist, matchbox will rudely exit ( To be fixed! )

MORE INFO
Visit http://www.handhelds.org/~mallum/matchbox/

SEE ALSO
X(7)

BUGS
Please report to mallum@handhelds.org