---
name: "wmpuzzle"
section: "6"
platform: "linux"
package: "wmpuzzle"
version: "0.5.3-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/wmpuzzle"
---

# wmpuzzle(6)

WindowMaker dock app 4x4 puzzle

## NAME

wmpuzzle - WindowMaker dock app 4x4 puzzle

## SYNOPSIS

**wmpuzzle** \[*options*\] \[*xpm image file*\]

## DESCRIPTION

**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.

## OPTIONS

- **-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.**

- **--display=***id*

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

- **--geometry=***pos*

  **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.**

## USAGE

**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.**

## FILES

- **~/.wmpuzzlerc**

  **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.**

## BUGS

**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 \<martin@godisch.de\>. Debian users are encouraged** **to use the Debian Bug Tracking System at** *http://bugs.debian.org/wmpuzzle*.

## AUTHOR

**wmpuzzle is written by Martin A. Godisch \<martin@godisch.de\>. 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.**