---
name: "minisys"
section: "1"
platform: "linux"
package: "matchbox"
version: "0.1.8-2"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/minisys"
---

# minisys(1)

A X11 Window Manger for handheld devices.

## 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)](/X/7.md)

## BUGS

Please report to mallum@handhelds.org