.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "GRIMPICKER" "1" "2025-08-03"
.PP
.SH NAME
.PP
grimpicker - a simple color picker for wlroots
.PP
.SH SYNOPSIS
.PP
\fBgrimpicker\fR [\fIOPTIONS\fR]
.PP
.SH OPTIONS
.PP
\fB-p\fR, \fB--print\fR
.RS 4
Print to stdout
.PP
.RE
\fB-d\fR, \fB--draw\fR
.RS 4
Draw a colored block
.PP
.RE
\fB-e\fR, \fB--escape\fR
.RS 4
Print shell escape sequences
.PP
.RE
\fB-c\fR, \fB--copy\fR
.RS 4
Copy to clipboard
.PP
.RE
\fB-n\fR, \fB--notify\fR
.RS 4
Send a notification
.PP
.RE
\fB-h\fR, \fB--help\fR
.RS 4
Show help message and quit
.PP
.RE
\fB-v\fR, \fB--version\fR
.RS 4
Show version number and quit
.PP
.RE
.SH DESCRIPTION
.PP
\fBgrimpicker\fR is a color picker that uses \fBslurp\fR and \fBgrim\fR.\&
These programs rely on \fIzwlr_layer_shell_v1\fR and \fIwlr-screencopy-unstable-v1\fR
(maybe be replaced with \fIext-image-capture-source-v1\fR and
\fIext-image-copy-capture-v1\fR in the future) wayland protocols
(implemented in wlroots-based compositors, e.\&g.\& \fBsway\fR).\&
.PP
It has several output options, they can be combined.\&
.PP
\fI--copy\fR needs \fBwl-clipboard\fR to be installed.\&
.PP
\fI--draw\fR and \fI--escape\fR need a terminal with truecolor support (e.\&g.\& \fBfoot\fR).\&
.PP
\fI--notify\fR needs \fBlibnotify\fR to be installed
and a notification daemon (e.\&g.\& \fBmako\fR or \fBfnott\fR) to be running.\&
.PP
\fI--print\fR and \fI--draw\fR are selected by default if no arguments are provided.\&
.PP
.SH EXAMPLES
.PP
An example usage pattern is to add this binding to your sway config:
.PP
.nf
.RS 4
# Super+Print: color picker
bindsym --to-code $mod+Print exec grimpicker --notify

.fi
.RE
.PP
.SH SEE ALSO
.PP
\fBslurp\fR(1), \fBgrim\fR(1), \fBgrimshot\fR(1)