A local whiteboard for brainstorming, mind maps and diagrams on Omarchy.
Sticky notes, pictures, shapes and connectors on an infinite canvas, driven from the keyboard and drawn in your Omarchy theme. Each board is a plain JSON file on your own disk: no account, no network, no service running beside it.
omarchy plugin add https://github.com/thepixelgardener-create/omarchyform.git --enableAnswer the question about where the bar icon goes: the sticky-note icon opens
and closes the board. To open it from the keyboard as well, add a binding to
~/.config/hypr/bindings.lua:
o.bind("SUPER + SHIFT + I", "Omarchyform", "omarchy-shell shell toggle thepixelgardener.omarchyform")To remove it, run the command below. Your boards are left in
~/.local/share/omarchyform/. If you installed the optional desktop entry,
uninstall that first.
omarchy plugin remove thepixelgardener.omarchyformIt is also in the Omarchy plugin directory. Updating, the optional desktop entry and removing it are in the install guide.
| Key | Does |
|---|---|
q |
New note, ready to type |
w e r t |
New box, ellipse, diamond, line |
z, move, z |
Glue: join two shapes with an arrow, or glue an arrow to a shape |
Z |
Unglue: an arrow lets go of both ends, a shape of every arrow on it |
esc |
Stop typing; press again to close the board |
h j k l |
Move to the nearest note that way |
x, move, x |
Connect two items |
u |
Undo |
: |
Run any command by name, with its key shown beside it |
? |
Every key |
You do not have to learn the keys first: : lists every command, and . or a
right-click lists what can be done with the selection. The mouse works too.
- Notes, boxes, ellipses, diamonds and pictures pasted from the clipboard, joined by connectors
- Plain-text notes: received board text is never interpreted as markup
- An ordinary tiled window by default;
F11switches to a fullscreen overlay and back - Split view,
vorV: two boards side by side, or two views of one - Boards in folders, with search and a trash, on
b - PNG export in your theme, on white for documents, or in black and white for print
- A board shared as one file with its pictures inside it
- A command line for scripts and coding agents
Omarchyform is young and made by one person, so every report shapes what comes next. I want to hear what you used it for, what got in your way, and what you expected to find and did not.
- Share feedback or an idea: a few short questions
- Report a bug
- Security problems go through the private route in SECURITY.md
If it is useful to you, a star here or a heart in the plugin directory helps other people find it.
- Install, update and remove: the key binding, the desktop entry, dependencies, tested versions
- Using the board: every key, plain-text notes, connectors, split view, export and saving
- Boards on disk and the command line: where boards live, the file format and
bin/omarchyform - Development: running from a clone, the source layout, tests and benchmarks
- Changelog, roadmap and the documentation guide
MIT. Clipboard support invokes wl-clipboard (GPL-2.0-or-later) as a separate
process; it is not redistributed here. The panels are drawn with the
Omarchy UI kit (MIT), copied into
kit/ with its licence.