wmpuzzle [options][xpmimagefile]


wmpuzzle provides a 4x4 puzzle on a 64x64 mini window. It is designed to work with the WindowMaker dock, but will work with other window managers as well.


-h, --help

displays a command line summary.

-a, --auto-save

automatically save the puzzle state on program exit.

-k, --keyboard

enable use of the keyboard for arrow-key navigation.

-s, --shuffle=count

shuffle the image count times, defaults to 2000. Using -s prevents loading the saved state from the resource file.

-v, --version

displays the version number.


Set the display to use, e.g. --display=:0.0.


Set the position of the dock app, e.g. --geometry=+10+10. Note that the size (64x64) is hard-coded and cannot be changed.

The image file must be an XPM file with minimum (and recommended) size of 48x48 pixels. If it is larger then the upper left corner will be shown.


Left mouse click moves the puzzle tiles, right click saves the current state and middle click recovers the last saved state. If -k has been specified the arrow keys and key s and key r will do as well.

If the picture has been completed the last element will be shown.



contains the puzzling state of the images. The basename of an image file will be used as its identifier. Use option -s to ignore this file on startup.


When wmpuzzle complains about not enough free color symbols that's because it needs to add six colors to the XPM's color table and found no free symbols using the according number of characters per pixel. Try to find some unused entries, delete them and correct the size of the color table (the third number in the first line), or enlarge the number of characters per pixel using some imaging program.

Please send any bugs to <[email protected]>. Debian users are encouraged to use the Debian Bug Tracking System at


wmpuzzle is written by Martin A. Godisch <[email protected]>. Thanks to Gordon Fraser for his suggestions, and to Kyle Boyle for the contribution of his numbers puzzle. Thanks to Matthias Klose for bug reports and fixes.