Screen Annotation for Wayland

A ZoomIt-like screen annotation tool for Wayland compositors, written in Rust

Works on Hyprland, Sway, River, and other compositors with wlr-layer-shell

What is wayscriber?

wayscriber is a powerful screen annotation tool designed for Wayland compositors. Perfect for live presentations, classroom sessions, and screenshares, it lets you toggle drawing mode with a single key and annotate your screen instantly without breaking your flow.

Formerly known as hyprmarker - Renamed in v0.5.0 to reflect broader compositor support beyond Hyprland.

Features at a Glance

Drawing Tools

  • Freehand pen
  • Straight lines
  • Rectangles
  • Ellipses & circles
  • Arrows
  • Multi-line text annotations

Board Modes

  • Whiteboard mode
  • Blackboard mode
  • Auto pen contrast
  • Isolated frames
  • Transparent overlay

Customization

  • Quick color palette (8 colors)
  • Adjustable line thickness
  • Custom fonts (Pango)
  • Scroll wheel adjustments
  • TOML configuration file

User Experience

  • Status bar with live feedback
  • In-app help overlay (F10)
  • Native configurator (F11)
  • Background daemon mode
  • System tray integration

Installation

Arch Linux (AUR)

# Using yay
yay -S wayscriber

# Or using paru
paru -S wayscriber

Build from Source

First, install dependencies:

# Ubuntu / Debian
sudo apt-get install libcairo2-dev libwayland-dev libpango1.0-dev

# Fedora
sudo dnf install cairo-devel wayland-devel pango-devel

Then build:

git clone https://github.com/devmobasa/wayscriber.git
cd wayscriber
cargo build --release

Optional Screenshot Tools

For the fastest screenshot workflow, install:

# Debian/Ubuntu
sudo apt-get install wl-clipboard grim slurp

# Fedora
sudo dnf install wl-clipboard grim slurp

How to Use

One-Shot Mode (Simple)

Launch wayscriber when you need it, exit when done:

wayscriber --active

Or bind to a key in ~/.config/hypr/hyprland.conf:

bind = SUPER, D, exec, wayscriber --active

Press F10 for help, F11 for configurator, Escape to exit.

Daemon Mode (Background Service)

Run wayscriber in the background and toggle with a keybind:

# Enable the service
systemctl --user enable --now wayscriber.service

Add keybinding to ~/.config/hypr/hyprland.conf:

bind = SUPER, D, exec, pkill -SIGUSR1 wayscriber

Reload Hyprland:

hyprctl reload

Quick Controls Reference

Drawing

  • Freehand: Drag with mouse
  • Line: Shift + drag
  • Rectangle: Ctrl + drag
  • Ellipse: Tab + drag
  • Arrow: Ctrl+Shift + drag
  • Text: Press T, click, type

Modes

  • Whiteboard: Ctrl+W
  • Blackboard: Ctrl+B
  • Transparent: Ctrl+Shift+T

Colors

  • R - Red
  • G - Green
  • B - Blue
  • Y - Yellow
  • O - Orange
  • P - Pink
  • W - White
  • K - Black

Editing

  • Undo: Ctrl+Z
  • Clear all: E
  • Help: F10
  • Configurator: F11
  • Exit: Escape

Ready to Get Started?

Check out the full documentation and source code on GitHub

View on GitHub