Omaboard

Omaboard is a local whiteboard for Omarchy. It is a single-user reimplementation of a Microsoft Whiteboard-style canvas, built as a native Qt Quick / C++ app in the same vein as Omawrite and omaths.

It is not a cloud client. There are no accounts, sharing links, or real-time collaboration. Boards live on this machine, auto-save as you work, and never leave the disk.

Install

Build and install the omaboard package locally with ./bin/install (Arch, via makepkg), or build the binary only with ./bin/build.

Boards are stored in ~/.local/share/omaboard.

Command line

A second launch talks to the running window instead of starting another copy.

omaboard                 # gallery, or raise the running app
omaboard --new           # create and open a board
omaboard --open <id>     # jump into an existing board
omaboard --help

These flags are what the Omaboard Omarchy plugin uses for quick access.

Omarchy bar plugin

Preview boards from the Omarchy bar and jump into them without opening the gallery first:

omarchy plugin add https://github.com/ewinnington/omaboard-plugin.git --enable

Requires this app at 0.2.3 or later. The plugin only reads ~/.local/share/omaboard and launches omaboard --open / omaboard --new. Board titles and other UI strings are sanitized and rendered as plain text. Security review: docs/security-review.md.

What it does

• Gallery of boards with thumbnails, rename, duplicate, delete, and PNG export
• Near-infinite canvas with zoom, pan, and a dotted paper background
• Pen, highlighter, eraser, sticky notes, text, vector shapes, arrows, and images
• Straight connectors that snap to shape edges and stay attached when a shape moves
• Multi-select, move, resize, copy/paste, bring-to-front / send-to-back
• Per-board background: system theme or a few paper colours, with dots or plain
• Undo / redo
• High-resolution PNG export of the used area plus a margin

Shortcuts

• Ctrl+N new board
• Ctrl+Z / Ctrl+Y undo / redo
• Ctrl+C Ctrl+X Ctrl+V copy / cut / paste
• Delete remove selection
• Ctrl+A select all
• Ctrl+0 fit to content, Ctrl+1 100%
• Ctrl++ / Ctrl+- zoom
• V select, H pan, P pen, E eraser, N sticky, T text, R rectangle, L line
• Space-drag pans, scroll zooms toward the cursor
• Ctrl+Shift+E export PNG
• Top-bar paper icon: board background colour and pattern
• Escape returns to the gallery
• Ctrl+/ shortcut reference

Security

Local single-user app: no network, no accounts. On-disk board metadata is still treated as untrusted (the Omarchy plugin reads it from the shared shell). Controls, bounds, and residual risk: docs/security-review.md.

Requirements

• Qt 6: qt6-base, qt6-declarative, qt6-svg
• xdg-desktop-portal and a portal backend