# Keyboard shortcuts

> Every key Dabbit listens to, in one place.

Source: https://dabbit.app/docs/keyboard-shortcuts

The same list is in the app: Settings → Shortcuts, or Help → Keyboard Shortcuts.

## Anywhere

These work in any app. Both can be changed or cleared in Settings → Shortcuts.

| Shortcut       | Action                      |
| -------------- | --------------------------- |
| <kbd>⌥⌘C</kbd> | Pick a color                |
| <kbd>⌥⌘D</kbd> | Show or hide the Color Dock |

## While picking

The magnifier is open and following the cursor.

| Input                                               | Action                                                                                                               |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| Click, <kbd>↩</kbd>                                 | Pick and close                                                                                                       |
| <kbd>⇧</kbd>-click, <kbd>⇧↩</kbd>, <kbd>⌘C</kbd>    | Pick and keep picking                                                                                                |
| <kbd>⌥</kbd>-click, <kbd>⌥↩</kbd>                   | Pick and copy the color's palette name instead of its value (see [The picker](https://dabbit.app/docs/picker#names-instead-of-values)) |
| <kbd>Esc</kbd>, right-click                         | Cancel                                                                                                               |
| <kbd>Space</kbd>                                    | Freeze the screen under the loupe; <kbd>Space</kbd> again to release                                                 |
| <kbd>←</kbd> <kbd>↑</kbd> <kbd>→</kbd> <kbd>↓</kbd> | Nudge one pixel; with <kbd>⇧</kbd>, ten                                                                              |
| <kbd>1</kbd> <kbd>3</kbd> <kbd>5</kbd> <kbd>7</kbd> | Aperture: one exact pixel, or a 3×3, 5×5, 7×7 average                                                                |
| <kbd>=</kbd> / <kbd>−</kbd>                         | Zoom in / out                                                                                                        |
| <kbd>G</kbd>                                        | Show or hide the pixel grid                                                                                          |
| <kbd>⌥</kbd>-scroll                                 | Zoom                                                                                                                 |
| <kbd>⌘</kbd>-scroll, or pinch                       | Make the loupe bigger or smaller                                                                                     |
| Plain scroll                                        | Scrolls the page underneath, so you can reach a color that's off screen                                              |

## Library window

| Shortcut                                      | Action                                                                        |
| --------------------------------------------- | ----------------------------------------------------------------------------- |
| <kbd>⇧⌘P</kbd>                                | Pick Color                                                                    |
| <kbd>⌘N</kbd>                                 | New Palette                                                                   |
| <kbd>⇧⌘N</kbd>                                | New Palette from Image, Camera or Website…                                    |
| <kbd>⇧⌘I</kbd>                                | Import Palette…                                                               |
| <kbd>⇧⌘E</kbd>                                | Export Palette…                                                               |
| <kbd>⌘⌫</kbd>                                 | Delete Palette…                                                               |
| <kbd>⌘Z</kbd> / <kbd>⇧⌘Z</kbd>                | Undo / Redo. Every edit to palettes and recent picks is a step: a color edit, a rename, a delete, a drag, a generator update. The Edit menu names the step (“Undo Delete 3 Colors”) |
| <kbd>⌘1</kbd> <kbd>⌘2</kbd> <kbd>⌘3</kbd>     | Library · Scale · Design System                                               |
| <kbd>⌘+</kbd> / <kbd>⌘−</kbd> / <kbd>⌘0</kbd> | Bigger or smaller swatches in the grid; back to the size that fits the window |
| <kbd>⇧⌘D</kbd>                                | Toggle Color Dock                                                             |
| <kbd>⌘,</kbd>                                 | Settings                                                                      |
| <kbd>⌘?</kbd>                                 | Dabbit Help                                                                   |

The same list is in the app under Help → Keyboard Shortcuts.
