# The picker

> The magnifier, and what you can do while it's open.

Source: https://dabbit.app/docs/picker

Press <kbd>⌥⌘C</kbd> and a magnifier follows the cursor. It shows the pixels under it enlarged, a crosshair on the one you'll get, and the color's value in your default format. Click to take it.

![The loupe: the pixels under the cursor enlarged with a grid, a crosshair on the one you'll get, and the value in the default format](https://dabbit.app/_astro/loupe@fill.DthJc-OZ.png)

## Exact pixels

Dabbit reads the pixel from the screen buffer, through the display's color profile, so what you copy is the value the app underneath actually drew. `#ff0000` in a web page picks as `#ff0000` on a P3 MacBook display, not the slightly different number a screenshot would give you. How that works, and when you'd want to change it, is in [Color management](https://dabbit.app/docs/color-management).

## Zoom, aperture, freeze

- **Zoom** with <kbd>⌥</kbd>-scroll or <kbd>=</kbd> / <kbd>−</kbd>, from 2× to 16×. The default is 6×; set it in Settings → Picker.
- **Aperture**: press <kbd>1</kbd> for one exact pixel, or <kbd>3</kbd>, <kbd>5</kbd>, <kbd>7</kbd> to average a small square. Averaging is for noisy things like photos and gradients, where one pixel is arbitrary.
- **Freeze** with <kbd>Space</kbd>. The loupe stops following the screen, so you can pick from something that disappears when the mouse moves: a hover state, a tooltip, a menu.
- **Nudge** with the arrow keys, one pixel at a time (ten with <kbd>⇧</kbd>), when the exact pixel matters more than a steady hand.
- **Grid** with <kbd>G</kbd>, to see pixel boundaries at high zoom.
- **Loupe size** with a pinch on the trackpad or <kbd>⌘</kbd>-scroll, or Settings → Picker → Picker size.

![Settings → Picker: engine, picker size, zoom, aperture, pixel grid, palette names](https://dabbit.app/_astro/settings-picker.BFj8NhC9.png)

Plain scrolling isn't captured. It scrolls whatever is under the cursor, so you can pick from further down a page without closing the picker.

## Picking several

<kbd>⇧</kbd>-click (or <kbd>⌘C</kbd>) takes the color and keeps the picker open. Each one is copied and added to Recent picks; the last one stays on the clipboard. <kbd>Esc</kbd> when you're done.

## Names instead of values

If you keep your project's colors as Dabbit palettes, the picker can tell you which one you're looking at. Turn on **Name colors from my palettes** in Settings → Picker and the loupe shows the matching name (say `blue-500`) when a picked pixel is in one of your palettes. <kbd>⌥</kbd>-click copies that name instead of the value. **Copy the name as** chooses the shape: plain name, `var(--blue-500)`, `$blue-500`, or `bg-blue-500`.

## What happens after a pick

By default the color is copied to the clipboard in your default format, added to Recent picks, a small confirmation appears, and a sound plays. Each of those is a switch in Settings → General (eight sound packs to choose from, or none). See [Formats](https://dabbit.app/docs/formats) for what gets copied and [Library](https://dabbit.app/docs/library) for where picks go.

## Apple's sampler

If you don't want to grant Screen Recording, choose **Apple's sampler** in Settings → Picker. Dabbit then uses the system eyedropper, which needs no permission. You lose the loupe, zoom, aperture, freeze and naming, but the color still lands in your formats and history.
