GRIMPICKER(1)

📦
version 1.12 · 4 versions
, in arch rolling

🎨 grimpicker(1) — your fave simple color picker for wlroots 💅

🌸 NAME 🌸

grimpicker — a simple color picker for wlroots. That's it, that's the name, and honestly? Iconic.

🦋 SYNOPSIS 🦋

grimpicker [OPTIONS]

Run it with options, or don't — the defaults got you, bestie.

✨ OPTIONS ✨

  • -p, --print — Print to stdout. yes, the classic.
  • -d, --draw — Draw a colored block. a whole block of color, slay.
  • -e, --escape — Print shell escape sequences. for your terminal's inner aesthetic.
  • -c, --copy — Copy to clipboard. clipboard go brrr.
  • -f, --freeze — Freeze screen before picking. hold still, we're picking.
  • -n, --notify — Send a notification. ping! you got a color.
  • -h, --help — Show help message and quit. the classic escape hatch.
  • -v, --version — Show version number and quit. numbers, but make it cute.

🫶 DESCRIPTION 🫶

Okay so grimpicker is a color picker that uses slurp and grim. Those programs rely on the zwlr_layer_shell_v1 and wlr-screencopy-unstable-v1 wayland protocols — and ngl, those might be replaced with ext-image-capture-source-v1 and ext-image-copy-capture-v1 in the future. Those protocols are implemented in wlroots-based compositors, e.g. sway.

It's giving several output options, and bestie, they can be combined. Mix and match, go off.

  • --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.

If you provide no arguments, --print and --draw are selected by default. the vibes choose for you, and honestly they ate.

🌈 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

literally just bind it and press the keys, bestie.

💜 SEE ALSO 💜

slurp(1), grim(1), grimshot(1)

mwah 💋 — this page came from the General Commands Manual / GRIMPICKER(1) edition, dated 2026-10-28. go pick a color and slay. 🎀

📦 where this page comes from