Select. Annotate. Make it yours.
A native screenshot atelier for Omarchy. Draw on the capture, give it a finish, then copy or save — all in the same overlay.
Install · Finishes · Shortcuts · Credits
Select a region or window. Add an arrow, a note or a brushstroke directly to the frozen capture. Press Super+C to copy the image, or Super+S to save it and put its path on the clipboard. There is no extra editor window in the normal capture flow.
- Explain the detail. Arrows, shapes, text, highlights, step numbers, crop, blur and redaction.
- Give it a gesture. A smooth brush with tapered ends, adjustable width and opacity. A uniform pen remains available.
- Find your palette. Atelier, Graphite and Botanical; five editable colours and your own saved palettes.
- Capture the whole story. Automatic scrolling capture stitches a scrollable window into one tall image. A delay timer keeps menus and hover states open.
- Find it later. History lists saved captures, recordings and editable drafts by day. Files are named by date and time.
- Finish before sharing. Paper, a dark backing or a gallery mat; custom backgrounds, padding, corners, shadows and reusable looks.
- Keep it local. OCR, code cards, image composition and PNG/JPEG export at 1–3×. No accounts or image uploads.
The same rendering engine produces the preview and the saved image. Paper grain stays outside your screenshot.
| Sketchbook | Ink | Gallery |
|---|---|---|
![]() |
![]() |
![]() |
| Warm paper, subtle grain, quiet edges. | A charcoal surface and soft shadow. | A light mat and a little more breathing room. |
Choose Original to keep the capture without a finish. Customize the materials and save a look for later.
Framelet targets Omarchy Quattro / Omarchy 4, Hyprland and Qt 6.8+. The plugin ID is vxavierr.framelet. It is a single plugin with a native C++/Qt engine, an overlay and a bar button.
On Arch/Omarchy, install the development libraries and clipboard support:
sudo pacman -S --needed base-devel cmake ninja pkgconf \
qt6-base qt6-declarative qt6-multimedia qt6-svg qt6-wayland \
layer-shell-qt wayland wayland-protocols libpulse wl-clipboardOptional tools:
| Feature | Dependency |
|---|---|
| OCR | tesseract, plus the language data you need |
| Code highlighting | bat |
| Screen recording | gpu-screen-recorder and ffmpeg |
| WebP images | qt6-imageformats |
omarchy plugin add https://github.com/vxavierr/framelet
omarchy plugin enable vxavierr.frameletThe first launch compiles the native engine. The Omarchy plugin command clones the repository; it does not run build hooks. Framelet builds itself on first use when the required libraries are installed. This can take a while. To see build progress or diagnose a missing library, build explicitly:
cd ~/.config/omarchy/plugins/vxavierr.framelet
./build.shThe build script performs no downloads, package installation or privileged system changes. This release distributes source rather than a binary tied to one machine's Qt libraries.
The bar button works after the engine is built. To use Print, Shift+Print (delayed capture) and Super+C/S with Hyprland, merge bindings.example.lua into your existing ~/.config/hypr/bindings.lua.
That example includes the framelet submap that forwards Super+C/S to the overlay. Keep your existing imports and key choices; Framelet does not rewrite your bindings or replace another capture app. Ctrl+C/S and the overlay buttons work without the forwarding submap.
| Action | Key |
|---|---|
| Copy capture | Super+C or Ctrl+C |
| Save capture and copy its path | Super+S or Ctrl+S |
| Delayed capture | Shift+Print, or T in the selector |
| Arrow / text / shape | A / T / B |
| Brush / pen | D / P |
| Highlight / blur / redact | H / G / R |
| Move / ellipse / step number / crop | V / O / N / X |
| Finishing controls | E |
| Undo / redo | Ctrl+Z / Ctrl+Shift+Z |
| 45° lines, squares and circles | Hold Shift while drawing |
| Close a popup or return from finishing; cancel capture | Esc |
Super+C/S require the forwarding submap described above. Copy always uses PNG, even when JPEG is selected for saving. Saving puts the absolute path of the new file on the clipboard as text; turn this off with Saving copies the file path in the Framelet window's settings.
Bar button: left-click selects a region, middle-click starts scrolling capture, right-click opens the capture menu. The menu also offers delayed capture, full-screen capture, code cards, recording and History. The symbol has a small image within the bar's standard click slot.
- OCR: extract text from an image locally with Tesseract.
- Code cards: paste code, highlight it and give the card a finish.
- Composition: combine images in the native interface.
- Recording: screen recording and webcam tools inherited from Omaframe are included.
- Export: PNG/JPEG at 1×, 2× or 3×. The export limit is 50 megapixels and 32,000 pixels on either edge.
The launcher accepts --inline image.png, --scroll, --screen, --record, --code, --history, --delay N (0–30 seconds), --delayed-capture and --studio.
The capture overlay, style panel, selection, countdown, recording controls, History and status messages are available in English and Brazilian Portuguese. Language in the Framelet window's settings chooses System, English or Português, and applies right away. language=pt_BR in Framelet.conf or FRAMELET_LANG=pt_BR do the same. The editor window is in English.
Settings live in ~/.config/Framelet/Framelet.conf. Originals and drafts, when enabled, live in ~/.local/share/Framelet/Framelet/. A fresh install saves to ~/Pictures/Framelet; an existing selected output folder is preserved. New files are named Framelet-YYYY-MM-DD_HH-MM-SS.png, numbered when two share a second.
Previous CapturaUnificada settings and drafts are copied once. Originals remain untouched, and existing Framelet files are not overwritten. Installing Framelet does not uninstall Postcard or another screenshot app.
- Automatic scrolling needs a responsive, scrollable area with enough visual detail to stitch. Animated or repetitive content may need manual scrolling.
- Composition flattens existing annotations into the combined image; images cannot yet be reordered independently.
- Postcard's magnifier, spotlight, wallpaper backgrounds, four-colour gradients and full code-theme catalogue are not included.
- The editor window and video tools are in English only.
- History lists PNG screenshots; JPEG saves are not listed yet.
- Tested on x86_64, Omarchy 4.0.4 and Qt 6.11.2. Other configurations need verification.
omarchy plugin disable vxavierr.framelet
omarchy plugin remove vxavierr.frameletRemove any Framelet bindings you added yourself. Saved screenshots and settings are separate from the plugin folder and remain available.
Native sources are in native-src/. The root is an Omarchy schema-1 plugin; native/ and .build/ are local build outputs excluded from Git.
./build.sh
omarchy plugin validate .Tests: configure native-src with -DBUILD_TESTING=ON and run ctest -L headless. CI runs the same suites in an Arch container on every pull request and tag. A string wrapped in qsTr() or tr() needs an entry in native-src/i18n/pt_BR.json; the i18n suite fails otherwise.
Product principles and native visual decisions are documented in PRODUCT.md and DESIGN.md. Artwork sources, font licences and the cover brief are in design/ and docs/launch/.
Framelet is a fork of Omaframe 0.7.4 by Tyler South, distributed under MIT. Its capture, scrolling, recording, OCR and native annotation work form the foundation of this app. Framing, composition and code-card additions take inspiration from Postcard.
The Framelet brush, palettes, named finishes, overlay integration and original symbol are additions in this fork. The cover's botanical artwork was generated with OpenAI ImageGen; the interface screenshots and three finish examples come from the running app. Cover typography uses Fraunces and DM Sans, under the SIL Open Font License.
The native Wayland capture code comes from Omasnap through Omaframe. ShareX inspired the capture-and-annotate interaction; Omaframe also acknowledges MatteShot and Omaroll as workflow and style influences. All origins are detailed below.
See CREDITS.md, LICENSE and the retained Omasnap licence. This project is an independent community plugin.





