---
name: "grimpicker"
section: "1"
platform: "linux"
package: "sway-contrib"
version: "1.12-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/grimpicker"
---

# grimpicker(1)

a simple color picker for wlroots

## NAME

grimpicker - a simple color picker for wlroots

## SYNOPSIS

**grimpicker** \[*OPTIONS*\]

## OPTIONS

- **-p**, **--print**

  Print to stdout

- **-d**, **--draw**

  Draw a colored block

- **-e**, **--escape**

  Print shell escape sequences

- **-c**, **--copy**

  Copy to clipboard

- **-f**, **--freeze**

  Freeze screen before picking

- **-n**, **--notify**

  Send a notification

- **-h**, **--help**

  Show help message and quit

- **-v**, **--version**

  Show version number and quit

## DESCRIPTION

**grimpicker** is a color picker that uses **slurp** and **grim**. These programs rely on *zwlr\_layer\_shell\_v1* and *wlr-screencopy-unstable-v1* (maybe be replaced with *ext-image-capture-source-v1* and *ext-image-copy-capture-v1* in the future) wayland protocols (implemented in wlroots-based compositors, e.g. **sway**).

It has several output options, they can be combined.

*--copy* needs **wl-clipboard** to be installed.

*--freeze* needs **wayfreeze** to be installed.

*--draw* and *--escape* need a terminal with truecolor support (e.g. **foot**).

*--notify* needs **libnotify** to be installed and a notification daemon (e.g. **mako** or **fnott**) to be running.

*--print* and *--draw* are selected by default if no arguments are provided.

## EXAMPLES

An example usage pattern is to add this binding to your sway config:

```
# Super+Print: color picker
bindsym --to-code $mod+Print exec grimpicker --notify
```

## SEE ALSO

[**slurp**(1)](/slurp/1.md), [**grim**(1)](/grim/1.md), [**grimshot**(1)](/grimshot/1.md)