Omahub
← All plugins
D

Puzzle Maker

by DLP Waters

Encode and decode twenty classic puzzle ciphers from the Omarchy bar.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
5ac48d0
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
5ac48d0
Reviewed
1 month ago

This is a well-structured, local-only cipher tool with no network access, no persistence mechanisms, and no dangerous operations. The only external command executed is `wl-copy` for clipboard copy, which is passed as an argument array (not a shell string), making it safe from injection. The code is clean, well-tested, and matches its documented behavior.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/dlpwaters/omarchy-puzzlemaker --enable
Productivity #bar #quickshell

Puzzle Maker for Omarchy

A compact, local-first puzzle-cipher workbench for the Omarchy Quattro bar. Click the puzzle icon, choose one of twenty tools, type or paste a message, and encode or decode without leaving the desktop.

Puzzle Maker panel

Features

  • Twenty encoders and decoders: Caesar, ROT13, Atbash, Vigenère, A1Z26, Morse, Bacon, Rail Fence, Affine, Playfair, Polybius, Columnar Transposition, Pigpen, Tap Code, Binary, Hex, Base64, Braille, Semaphore, and QWERTY Keyboard Shift
  • Live output while you type
  • Previous/next buttons and searchable native tool dropdown
  • Per-tool keyword and numeric settings
  • Encode/decode toggle, swap, clear, and clipboard actions
  • Theme-aware native Omarchy panel
  • No API keys, network requests, background services, data files, or standalone-app dependency

Requirements

  • Omarchy Quattro with the current omarchy-shell plugin system
  • wl-copy, included by default with Omarchy, for the Copy button

The plugin runs unsandboxed inside omarchy-shell, like every Quattro shell plugin. Its source is intentionally small and has no third-party dependencies.

Install

Review the source, then add and enable it:

omarchy plugin add https://github.com/dlpwaters/omarchy-puzzlemaker.git --enable

The widget defaults to the right side of the bar. Move it if desired:

omarchy bar move io.github.dlpwaters.puzzlemaker --section right

Usage

  1. Click the puzzle icon in the bar.
  2. Choose a tool with the dropdown or the previous/next arrows.
  3. Select Encode or Decode.
  4. Enter any required keyword, shift, rails, or affine values.
  5. Type or paste into Input. The result updates immediately.
  6. Copy the result or swap it back into the input to reverse the operation.

Press Escape to close the panel. The panel follows the active Omarchy theme.

Cipher conventions

  • Playfair merges I/J and leaves filler X characters visible after decoding.
  • Polybius merges I/J; Tap Code shares C/K.
  • Bacon uses the modern 26-letter five-bit variant.
  • Columnar Transposition uses stable left-to-right ordering for duplicate keyword letters and no padding.
  • Pigpen and Semaphore use copyable symbol/position notation in the compact panel.
  • Binary, hexadecimal, and Base64 operate on UTF-8, including emoji and accented text.
  • Braille uses uncontracted Grade 1 Unicode cells.
  • Keyboard Shift uses wrapping US QWERTY rows.

Validate

omarchy plugin validate .
qmllint -I "$OMARCHY_PATH/shell" BarWidget.qml Panel.qml
node --test test/engine.test.mjs

Update

omarchy plugin update io.github.dlpwaters.puzzlemaker

Remove

omarchy plugin remove io.github.dlpwaters.puzzlemaker

Removal only deletes the cloned plugin directory and its bar entry. The plugin never modifies unrelated user configuration.

Standalone app

For a larger responsive interface with visual Pigpen and Semaphore cards, see Puzzle Forge.

License

MIT