wmpuzzle(6)

📦
version 0.5.3 · 2 versions
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 wmpuzzle — the tiny puzzle that lives in your dock 💖

okay so bestie, welcome to wmpuzzle(6), version 0.5.3 ✨ it's a whole 4x4 puzzle that squeezes itself into a 64x64 mini window, and it was literally built to vibe with the WindowMaker dock — but no cap, it plays nice with other window managers too 🫶

🌸 SYNOPSIS 🌸

wmpuzzle [options] [xpm image file]

🎀 DESCRIPTION 🎀

so basically wmpuzzle gives you a 4x4 puzzle on a lil 64x64 mini window 🧩 it's designed to hang out in the WindowMaker dock, but it will also work with other window managers as well — it's flexible like that, main character energy 💅

✨ OPTIONS ✨

  • -h, --help — displays a command line summary. your lil cheat sheet 🫶
  • -a, --auto-save — automatically save the puzzle state on program exit. it remembers so you don't have to 😌
  • -k, --keyboard — enable use of the keyboard for arrow-key navigation. keys >>> mouse, sometimes ⌨️
  • -s, --shuffle=count — shuffle the image count times, defaults to 2000. Using -s prevents loading the saved state from the resource file. so yeah, it's a fresh-start button but it also ghosts your save file 🙈
  • -v, --version — displays the version number. number go brrr ⭐
  • --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. periodt, it is what it is 💀
heads up bestie: 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. so like, crop responsibly 🌸

🌈 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. slay, you did it 💖

🦋 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. ngl this one is a lil fiddly but you got this 🙏

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. shoutout to the whole crew, icons only 🌟

and that's the whole page bestie 🎀 this one came from The Debian Project, dated March 2024, and it's wmpuzzle(6) — go forth and puzzle, you absolute legend 💜

📦 where this page comes from