What drawing tools and features does wayscriber offer?
Updated
wayscriber includes a full annotation toolkit in a single native Rust binary — no plugins, no accounts. The tools cover freehand drawing, shapes, text, boards, and zoom, and they're all reachable from one keybind that drops a drawing layer over any application. If you present, teach, or review work on Linux/Wayland and want to mark up the screen live, the toolset below is what you get.
The drawing toolkit
- Pen, highlighter, eraser — the core freehand tools.
- Shapes — lines, rectangles, ellipses, and fillable polygons.
- Arrows with auto-numbered labels — useful for pointing at steps in sequence.
- Step markers — numbered callouts for walkthroughs.
- Blur — hide sensitive regions on screen.
- Multiline text and sticky notes — annotate with typed content, not just ink.
- Screen eyedropper with a magnified pixel loupe — pick an exact color from anywhere on screen.
- Undo and redo — works across all of the above.
The page describes the ink as keeping up with your hand: 8–9 ms p95/p99 input-to-commit at 120 FPS, with 120 FPS as the default cap (vsync off, 144/240+ configurable). That matters for annotation because laggy strokes make handwriting and quick arrows unusable in a live setting.
Interaction: command palette and radial menu
Two mechanisms keep the ~130 rebindable actions out of your way:
- Command palette — fuzzy search over actions with icons and category headers. You can reopen a recent item, save a preset slot, or edit a shortcut in place. Open with
Ctrl+KorCtrl+Shift+P. - Radial menu at the cursor — a fixed eight-way compass with tool glyphs, recent colors, and an outer size ring. Hold middle-click, move the pointer to a tool, release.
The radial menu is the faster path during a live session because it appears where your cursor already is; the palette is better when you know the action name but not the binding.
Boards, pages, and backgrounds
Every board keeps separate pages with auto-contrast pens, so ink stays readable regardless of background.
| Background | Typical use |
|---|---|
| Transparent overlay | Annotate the app underneath |
| Whiteboard | Light-background teaching |
| Blackboard | Dark-background teaching |
| Blueprint | Technical or diagram work |
| Corkboard | Planning and arrangement |
Navigation details from the site: Ctrl+Shift+1..9 jumps to a slot, and Space+drag pans a solid board.
Setup and verification
- Install the package — native repositories exist for Debian, Ubuntu, and Fedora, plus the AUR for Arch, a Nix flake, and one-off
.deb/.rpmdownloads. - Bind one key — run the daemon, then bind
wayscriber --daemon-toggleto a global shortcut. The configurator can do both steps for you; the service command shown issystemctl --user enable --now wayscriber.service. - Draw over anything — press your key, and the overlay appears with pen, shapes, text, boards, and zoom. Press
F1for searchable, clickable Help, andEscto hide the overlay.
To confirm it works for your use case, open a slide deck or a browser page, trigger the overlay, and test a stroke, an arrow with a numbered label, and a board switch. If strokes track your hand without visible lag and the radial menu opens on middle-click, the toolset is behaving as documented.
What to check before committing
- Compositor support — the site lists Hyprland, Sway, River, Wayfire, Niri, COSMIC, KDE Plasma, and GNOME with limits. If you're on GNOME, treat the annotation layer as partially supported rather than equivalent to the others.
- Configuration surface — roughly 130 rebindable actions live in one TOML file, so budget a little time if you want custom bindings instead of defaults.
- Licensing and cost — free and open source under MIT, with no plugins and no accounts mentioned.
If your workflow is live markup during presentations, teaching, or screen review on a supported Wayland compositor, the toolkit here covers the common cases — freehand, shapes, numbered arrows, text, boards, and zoom — without leaving the overlay.