emersion/grim
0
Fork 0
mirror of https://github.com/emersion/grim.git synced 2026-10-22 19:11:38 +00:00
Code Issues Releases Packages Activity
Grab images from a Wayland compositor https://wayland.emersion.fr/grim
94 commits 2 branches 7 tags 248 KiB
  • C 88.4%
  • Meson 8.6%
  • Shell 3%
Find a file
Simon Ser c860a2473a Bump to v1.3.2
History 2021-04-17 19:41:14 +02:00
contrib/completions contrib/completions: fix unset datadir variable 2020-03-20 15:23:50 +01:00
include Add support for the ppm output format 2019-06-01 18:09:39 +03:00
protocol Add support for wlr-screencopy-unstable-v1 2018-07-13 19:25:56 +01:00
.build.yml fix: build.sr.ht archlinux image libjpeg-turbo package 2018-07-27 13:26:23 +02:00
.editorconfig Add .editorconfig 2018-05-13 21:38:37 +01:00
.gitignore First commit 2018-05-11 22:26:31 +01:00
box.c Only screenshot outputs we're interested in 2018-05-18 08:54:33 +01:00
buffer.c Use shm_open instead of XDG_RUNTIME_DIR 2018-11-14 18:38:33 +01:00
cairo_jpg.c fix: sign-compare warning 2019-06-09 20:15:03 +03:00
cairo_ppm.c fix: sign-compare warning 2019-06-09 20:15:03 +03:00
grim.1.scd Explain that '.' is grim's final fallback dir 2020-06-22 10:22:16 +02:00
LICENSE Initial commit 2018-05-04 13:59:53 +01:00
main.c main,render: replace assert(false) with abort(). 2021-02-03 00:39:15 +01:00
meson.build Bump to v1.3.2 2021-04-17 19:41:14 +02:00
meson_options.txt Add completions for fish-shell 2020-03-06 18:24:21 +01:00
output-layout.c Split rendering and output layout functions in separate files 2018-05-18 09:16:59 +01:00
README.md readme: remove explicit sway version, remove package manager section 2020-01-16 12:25:26 +01:00
render.c main,render: replace assert(false) with abort(). 2021-02-03 00:39:15 +01:00

README.md

grim

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

Example usage

Screenshoot all outputs:

grim

Screenshoot a specific output:

grim -o DP-1

Screenshoot a region:

grim -g "10,20 300x400"

Select a region and screenshoot it:

grim -g "$(slurp)"

Use a custom filename:

grim $(xdg-user-dir PICTURES)/$(date +'%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')

Pick a color, using ImageMagick:

grim -g "$(slurp -p)" -t ppm - | convert - -format '%[pixel:p{0,0}]' txt:-

Building from source

Install dependencies:

  • meson
  • wayland
  • cairo
  • libjpeg (optional)

Then run:

meson build
ninja -C build

To run directly, use build/grim, or if you would like to do a system installation (in /usr/local by default), run ninja -C build install.

Contributing

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

Join the IRC channel: ##emersion on Freenode.

License

MIT