Skip to content

bitraid/grim

 
 

Repository files navigation

grim

Grab images from a Wayland compositor. Works great with slurp and with sway >= 1.0.

Example usage

Screenshoot all outputs:

grim screenshot.png

Screenshoot a specific output:

grim -o DP-1 screenshot.png

Screenshoot a region:

grim -g "10,20 300x400" screenshot.png

Select a region and screenshoot it:

grim -g "$(slurp)" screenshot.png

Use a timestamped filename:

grim $(xdg-user-dir PICTURES)/$(date  '%Y-%m-%d-%H%M%S_grim.png')

Screenshoot and copy to clipboard:

grim - | wl-copy

Grab a screenshot from the focused monitor under Sway, using swaymsg and jq:

grim -o $(swaymsg -t get_outputs | jq -r '.[] | select(.focused) | .name') screenshot.png

Installation

  • Arch Linux: pacman -S grim

Building

Install dependencies:

  • meson
  • wayland
  • cairo
  • libjpeg (optional)

Then run:

meson build
ninja -C build
build/grim

Contributing

Either send GitHub pull requests or send patches on the mailing list.

License

MIT

About

Grab images from a Wayland compositor

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 86.8%
  • Meson 9.0%
  • SuperCollider 4.2%