Soleone/picross-omarchy

★ 0Forks 0QMLGitHub ↗Compare

README

Picross for Omarchy

A native Omarchy shell plugin for playing 10×10 Picross (nonograms) from the status bar. It uses the shell's themed Panel and KeyboardPanel controls, so it works with the current bar layout, keyboard navigation, and panel switching.

Install

From a checked-out copy, validate the plugin and install it into the user plugin directory:

omarchy plugin validate .
mkdir -p ~/.config/omarchy/plugins/picross
cp manifest.json Picross.qml PicrossModel.js ~/.config/omarchy/plugins/picross/
omarchy-shell shell rescanPlugins
omarchy plugin enable picross right

For live development, use the watcher instead of a symlink. Omarchy rejects symlinks inside plugin directories; this script keeps a regular plugin folder in sync and rescans the shell after each saved file:

./dev-sync.sh
# In another terminal, once:
omarchy plugin enable picross right

Stop it with Ctrl-C. Set OMARCHY_PICROSS_PLUGIN_DIR to use a different regular destination.

For a published git repository, the same flow is:

omarchy plugin add <git-url> --enable --yes

The plugin starts disabled when installed by omarchy plugin add unless --enable is supplied.

Play

  • Click the ▦ bar icon to open the board.
  • Left click or Space fills a square.
  • Right click or X marks a square as empty.
  • Middle click or C clears a square.
  • Arrow keys or H/J/K/L move the cursor.
  • I gives a hint, R resets the puzzle, and N starts the next one.
  • Hold Space or X while moving with arrows/HJKL to paint continuously; revisiting a cell toggles it back off. Hold Shift to show the current length (5, 6, etc.) at both ends of an unfinished 5+ clue run under the cursor.
  • Double-tap Space or X to apply full single-number lines in the current row and column (for example, a 10 clue fills an entire 10-cell line). Double-tap X also marks the unknown remainder of a line whose clue is already solved. Multi-run clues are otherwise never bulk-edited.
  • Esc closes the panel; Tab switches to another bar panel.

The current puzzle is selected from the local date, and N cycles through the included puzzle set. Incorrect fills and marks are highlighted, while solved row and column clues turn into the accent color.

IPC

omarchy-shell picross toggle
omarchy-shell picross open
omarchy-shell picross newGame
omarchy-shell picross reset
omarchy-shell picross hint

The game has no external runtime dependencies beyond the Omarchy shell. PicrossModel.js contains the pure puzzle rules and is covered by the Node unit tests in tests/.

Contributors

Soleone

Issues