creations/grabit
1
3
Fork 1
Code Issues Pull requests Projects Releases 7 Packages Wiki Activity Actions
screenshot, screen-recording, ocr, and uploader for wlroots compositors.
194 commits 2 branches 7 tags 3.1 MiB
  • C 98.6%
  • Makefile 1.1%
  • Nix 0.3%
Find a file
Exact
creations 5282bd5849
All checks were successful
fmt / fmt-check (push) Successful in 18s
Details
sanitize / sanitize (push) Successful in 34s
Details
ci / build (push) Successful in 37s
Details
Delete missing.md
2026-07-23 15:42:21 -04:00
.forgejo/workflows fix binary no version warning 2026-06-11 09:04:40 -04:00
.github/workflows fix binary no version warning 2026-06-11 09:04:40 -04:00
include plugin options, split files 2026-05-07 07:44:16 -04:00
man speed up screenshots and the selector, fix blur hiding annotations when 2026-07-22 14:26:16 -04:00
protocols fix kwin, fix see terminal for details, its logs now 2026-07-22 08:35:26 -04:00
src line dropdown instead of multiple 2026-07-23 12:57:38 -04:00
tools fix runtime dep on void, remove word wall when tesseract is missing 2026-04-29 09:49:42 -04:00
.clang-format actual formatter 2026-04-28 20:45:26 -04:00
.clangd pre 0.1.0 2026-04-26 20:20:56 -04:00
.gitignore links 2026-05-21 16:08:21 -04:00
flake.lock nix flake 2026-05-07 12:07:09 -04:00
flake.nix optimize size 2026-07-18 13:23:22 -04:00
grabit.desktop finaly fix kde desktop 2026-07-23 00:53:54 -04:00
LICENSE pre 0.1.0 2026-04-26 20:20:56 -04:00
Makefile line dropdown instead of multiple 2026-07-23 12:57:38 -04:00
OPTIONS.md speed up screenshots and the selector, fix blur hiding annotations when 2026-07-22 14:26:16 -04:00
PLUGINS.md slim down the text walls 2026-07-21 00:19:20 -04:00
README.md fix kwin, fix see terminal for details, its logs now 2026-07-22 08:35:26 -04:00

README.md

grabit

screenshot, screen-recording, ocr, and uploader for wlroots wayland compositors.

works on: hyprland, sway, niri, river. kde plasma 6 is screenshots-only. not supported: x11, gnome.

install

Void

see https://void.creations.works/

Arch (AUR)

see https://aur.archlinux.org/packages/grabit

Gentoo

eselect repository add roxy-overlay git https://codeberg.org/key/roxy-overlay.git
eselect repository enable roxy-overlay
emaint sync -r roxy-overlay
emerge --ask media-gfx/grabit  # masked by ~amd64

NixOS

nix run git+https://heliopolis.live/creations/grabit.git -- --help

from source

make
sudo make install

build deps:

json-c libcurl libmagic wayland-client wayland-cursor cairo libxkbcommon libdbus-1

optional: libjpeg libwebp for jpeg/webp output. runtime: ffmpeg for --record, tesseract for --tesseract.

demo

region selector annotator color picker

  • region selector with live freeze; drag, or click a window to snap on hyprland
  • confirm mode flameshot-style: adjust the selection before capturing
  • -F/--fullscreen grabs one monitor, or every monitor stitched together
  • annotator (-e): pen, marker, line, rect, ellipse, arrow, blur, text, eraser
  • color picker with hex input and an eyedropper that samples the freeze
  • --record region recording with overlay and tray icon; mp4, webm, or gif (demo)
  • --pin pins captures to the desktop: click-through, stackable, draggable
  • uploads to six built-in hosts or any sharex .sxcu uploader
  • --tesseract --translate OCRs a region and copies the translation

docs

  • OPTIONS.md - configuration keys, auth tokens, sharex uploaders, keybinds, filename templates
  • PLUGINS.md - plugin cli, manifest format, helper header

source

license

agpl-3.0-or-later. see LICENSE.