A native, blazing-fast 🚀🚀🚀 area selection tool for wlroots based compositors such as sway and river.

NOTE: Run waysip --help for the full list of flags and options.

Interactive rectangular area (prints position and size using the default format):

waysip -d

Pick a single point:

waysip -p

Print information about the focused screen:

waysip -i

Select a display output:

waysip -o

Combined dimensions / output mode (single click selects an output; drag selects a region):

waysip -d -o

Restrict selection to predefined boxes (pipe one box per line: x,y WIDTHxHEIGHT):

printf '100,200 400x300\n' | waysip -r

Custom output format (see % placeholders in --help; default is %x,%y %wx%h\n):

waysip -d -f '%x %y %w %h\n'

Shell completions:

waysip --completions fish | source
waysip --completions zsh > ~/.zfunc/_waysip
waysip --completions bash > /etc/bash_completion.d/waysip
waysip --completions elvish >> ~/.config/elvish/rc.elv
waysip --completions pwsh >> $PROFILE
waysip --completions nushell | save -f ~/.config/nushell/completions/waysip.nu

All features except benchmark are enabled in the default build. To reduce binary size or compile-time dependencies, features can be selectively disabled:

cargo build --no-default-features --features frame-limiter
cargo build --no-default-features --features logger
cargo build --no-default-features --features completions
cargo build --no-default-features --features frame-limit,logger,completions

• rustup (Rust toolchain)
• pkg-config
• wayland
• cairo
• pango

• git clone https://github.com/waycrate/waysip && cd waysip
• cargo build --release
• sudo mv ./target/release/waysip /usr/local/bin

This repository provides a Nix flake for building and running waysip.

nix build github:waycrate/waysip

nix run github:waycrate/waysip

To enable benchmarking options use one of those options depending on usecase described later:

cargo build --no-default-features --features "logger completions benchmark"
cargo build --no-default-features --features "logger completions frame-limit benchmark"

Regarding frame-limit feature. It is a workaround enabled by default meant to solve issue with unstable frametime on low freq CPUs or under heavy load.

Records each wl_callback.done timestamp from the compositor for the focused screen (duplicate timestamps are dropped, so it's roughly one entry per frame) and prints frame stats on stderr when the selection ends.

Reported metrics (written to stderr):

• fps avg
• frametime: min / avg / max
• latencies - array of entries meant track where frametime issues happened

For drag modes the raw duration and the amount trimmed from each end are also printed. For non-drag options less frames-better.

To test frametime stability try lowering your cpu freq to 0.8 GHz and build without frame-limit feature before testing.

1. https://matrix.to/#/#waycrate-tools:matrix.org
2. https://discord.gg/KKZRDYrRYW