Omasnap

A native Wayland screenshot and annotation overlay designed for Omarchy and Hyprland. It captures the focused monitor before mapping an exclusive layer-shell surface, so the editor never appears in its own screenshot. The editor retains annotations as movable, resizable vector layers and preserves the monitor's native pixels on scaled displays.

• Freeform region, window, and full-monitor capture modes.
• Clean window-surface capture through Wayland image-copy protocols. A failed native capture stays in the window picker; Omasnap never substitutes a crop of the desktop.
• Select/move/resize layers, mouse-wheel scaling, and eight external recropping handles.
• Arrows, straight lines, smoothed freehand strokes, rectangles, numbered markers, and editable Neucha text.
• Per-layer preset or custom colors, undo/redo history, OCR-region capture, mesh-gradient backdrops, and rendered drop shadows.
• Crash-resistant working snapshots under /tmp/omasnap/snapshot-<pid>.png, written immediately after selection and overwritten after every completed edit. Saving moves that file into ~/Pictures/Screenshots; clipboard output streams the same PNG.
• Verified PNG clipboard output through wl-copy/wl-paste, plus timestamped files under ~/Pictures/Screenshots by default.
• Correct native-pixel export on fractional or integer-scaled monitors.

The supported target is Wayland + Hyprland, with Omarchy as the primary integration. The renderer, layer surface, clipboard, and clean-window capture use Wayland protocols; monitor/window discovery currently calls hyprctl. grim captures the monitor before the layer maps. Selection displays that captured frame, while the annotation editor uses a translucent layer scrim over the live desktop and draws only the selected capture. Another Wayland compositor could support the application after supplying equivalent monitor and window discovery; generic Wayland support is not claimed by 1.0.

Runtime commands used by the application:

• hyprctl
• grim
• wl-copy and wl-paste
• tesseract
• omarchy-notification-send when available; completed captures include a thumbnail and open through xdg-open when clicked. Notification failure does not invalidate output.

Clone the repository and run the Omarchy installer:

git clone https://github.com/tobi/omasnap.git
cd omasnap
./install-omarchy

The installer uses Omarchy's package helper for missing dependencies, builds in ~/.cache/omasnap, and installs under ~/.local. It does not modify Hyprland configuration.

Paste this into a Lua config loaded after require("default.hypr.omarchy"):

hl.unbind("PRINT")
hl.unbind("F12")
hl.unbind("ALT + SHIFT + 4")

o.bind("PRINT", "Screenshot", "omasnap")
o.bind("F12", "Screenshot", "omasnap")
o.bind("ALT + SHIFT + 4", "Screenshot", "omasnap")

hl.layer_rule({
  match = { namespace = "^omasnap$" },
  no_anim = true,
  animation = "none",
})

Apply and verify:

hyprctl reload
hyprctl configerrors
hyprctl binds -j | jq -c \
  '[.[] | select(.description == "Screenshot") | {modmask,key,description}]'

omarchy plugin add is intentionally not used. Omarchy plugins are Quickshell QML extensions; they do not install native executables or system packages.

Set OMASNAP_PREFIX before running install-omarchy to use a prefix other than ~/.local.

Install the complete build/runtime dependency set:

sudo pacman -S --needed \
  base-devel cmake ninja pkgconf qt6-base layer-shell-qt \
  wayland wayland-protocols hyprland grim wl-clipboard \
  tesseract tesseract-data-eng

Build and install:

cmake -S . -B build -G Ninja \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_INSTALL_PREFIX="$HOME/.local"
cmake --build build --parallel
cmake --install build

The install step places:

• ~/.local/bin/omasnap
• ~/.local/share/applications/omasnap.desktop
• ~/.local/share/licenses/omasnap/Neucha-OFL.txt

Ensure ~/.local/bin is on PATH, then verify the installed CLI:

omasnap --version
omasnap --help

Running without arguments opens freeform region selection:

omasnap

Explicit starting modes:

omasnap --capture-region
omasnap --capture-window
omasnap --capture-fullscreen

Compatibility positional names are also accepted:

omasnap region
omasnap windows
omasnap fullscreen
omasnap smart       # maps to region selection

These options choose what is initially selected; the editor still controls whether the result is copied, saved, or both.

Environment overrides:

OMASNAP_SCREENSHOT_DIR="$HOME/Pictures/Captures" omasnap
OMASNAP_OCR_LANGS="eng+deu" omasnap

Install the corresponding Tesseract language data before adding a language to OMASNAP_OCR_LANGS.

Creation tools return to Select after one placement without selecting the new layer. In Select mode, arrows and lines show only their two endpoint handles; other layers show a selection boundary. The eight blue/white handles outside the image recrop its corners or edges.

cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel
QT_QPA_PLATFORM=offscreen \
  ./build/omasnap-smoke /tmp/omasnap-smoke

The smoke executable exercises region/window/fullscreen startup modes, capture selection, temporary snapshot updates, annotation tools, undo/redo, vector movement and scaling, text editing, OCR, native-DPI output, endpoint-only line selection, and external crop handles.

.github/workflows/build-linux.yml performs the same release build and interaction smoke in an Arch Linux container, stages the CMake installation, and uploads a versioned Linux artifact. A v* tag also attaches that artifact to the corresponding GitHub release.

The capture and annotation workflow is inspired by three excellent screenshot tools:

• Shottr — fast region/window capture, OCR, and polished backdrops.
• Satty — a focused, Wayland-native annotation workflow.
• Flameshot — selection-first capture and an approachable annotation toolbar.

Thanks to their authors and contributors for establishing the interaction patterns that made this project possible. Omasnap is an independent implementation and is not affiliated with those projects.

This standalone repository was extracted with git filter-repo from the original Omarchy system-customization repository. The former omasnap/ directory was promoted to the repository root while retaining its relevant commit history.

The bundled Neucha font is distributed under the SIL Open Font License; its license is in assets/OFL.txt and is installed with the application.