Skip to content
Capture-Craft

The guide

From setup to the command line, in eight steps. Each step has its own address: send the link to the one that helps.

1

Set up, once

Capture-Craft lives in the background: its icon sits in the menu bar on macOS, in the notification area on Windows. It takes over the system's shortcut, so the system has to let it go.

macOS

The shortcut. In System Settings › Keyboard › Keyboard Shortcuts… › Screenshots, untick “Save picture of selected area as a file”.

Screen recording. macOS asks on the first capture. Grant it in System Settings › Privacy & Security › Screen & System Audio Recording, then restart Capture-Craft.

Windows

The shortcut. Windows 11 keeps Print Screen for its Snipping Tool. In Settings › Accessibility › Keyboard, turn off “Use the Print screen key to open screen capture”.

The rest. No permission to grant.

Capture-Craft's welcome window tells you whether the shortcut is free; Try Again reads the setting again.

First, install it. The Download page has the archive for each system, and what it asks on first launch.

2

Capture a region

  1. Press ⇧ ⌘ 4 on macOS, Print Screen on Windows. Every screen freezes, menu bar and taskbar included.
  2. Draw the region. The label on its edge gives the image size in real pixels; the loupe shows pixels one by one, so you land exactly.
  3. Release: the capture is filed in the library, and the thumbnail appears in the corner of the screen.

Esc cancels everything, filing nothing. A region stops at the edge of the screen it starts on: across two screens of different densities, a straddling image would be blurry on one side.

3

Capture a window

  1. After the shortcut, press F or Space. A bar at the bottom of the screen shows the mode; you can click it too.
  2. Hover over windows: the one under the pointer lights up, with its app's name.
  3. Click: the window is taken, and the capture carries its app's name.

The window is cut out of the frozen screen: no shadow, and whatever covered it at that moment is in the image.

4

The thumbnail

After each capture, a thumbnail appears in the corner of the screen it was taken on. The capture is already filed: the thumbnail is there to decide what comes next.

IconGestureEffect
CopyThe image goes to the clipboard, ready to paste into a ticket, a message, a document.
DragDrag the thumbnail, or this button, into another app: the image arrives, not a link.
AnnotateThe pencil opens the editor on the capture.
CloseThe thumbnail goes away; the capture stays in the library.
5

Annotate

The editor opens on the capture. Each tool has its letter; seven colours, three stroke widths. Saving updates the library image, flattened.

IconToolLetterUse
SelectVPick, move, edit an annotation; or several, by drawing around them.
ArrowFPoint at one precise spot.
LineLConnect, underline.
RectangleRBox a button, an area.
EllipseECircle something.
PencilCDraw freehand.
HighlighterSMake a line of text stand out.
TextTWrite on the capture.
MaskMHide an address, a name, a token: as a rectangle, an ellipse, a lasso or freehand.
NumberNPlace numbered steps, each one following the last.
FrameBSurround the image: rule, shadow, torn edge, mat.

Mosaic and fill destroy information. Never a blur: a light blur can be read. Under these two patterns, the image that leaves the tool, copied, dragged or filed, no longer contains what was masked; the original stays on your machine, apart. Pixelation, on the other hand, keeps the look of the area, and short text can be recovered from it: for a password, a token, an address, use mosaic or fill.

The watermark is set in Settings…, from the icon's menu: a text, a logo, or both, applied on copy, on save, or both. The original and the annotations never carry it.

Editor shortcuts

ActionmacOSWindows
Undo⌘ ZCtrl Z
Redo⌘ ⇧ ZCtrl Y
Copy the image⌘ CCtrl C
Save⌘ SCtrl S
Open⌘ OCtrl O
Export⌘ ECtrl E
Open or close the library drawer⌘ BCtrl B

Text is typed on AZERTY as on QWERTY keyboards, dead-key accents included.

6

The library

Each capture is a file, kept on your machine:

Pictures/Capture-Craft/
  2026-11/
    2026-11-19 14.02.11 Firefox.png
    2026-11-18 16.40.27 Excalidraw.png
  .originaux/     # hidden: originals and annotations
  • The library window opens from the icon's menu: captures by month, newest first. In the editor, the drawer on the left (⌘ B, Ctrl B) holds it too.
  • Search (⌘ F, Ctrl F): by app, window title or date. Not yet the text inside images.
  • On a capture: copy, drag, annotate (double-click or ↩), show in Finder or Explorer.
  • To the bin (⌘ ⌫, Delete): the image, its original and its annotations go together.
  • An image deleted elsewhere, in Finder for instance: the window says so, and offers to restore it from its original, masks included.
7

The command line

ccraft works without a window, for a script or continuous integration. It doesn't capture: it creates and renders annotated documents. Its commands are French words.

# a document with no annotation, for an image
ccraft nouveau capture.png

# the flattened image of an annotated document
ccraft rendre capture.json --sortie flattened.png

On standard output, a JSON description of what was produced. Exit codes: 0 success, 1 refused (document, image or file), 2 misused. ccraft rendre refuses if the original image is no longer the one the document annotated.

8

Quit

Closing the editor or the welcome window doesn't quit Capture-Craft: it stays in the background, ready for the shortcut. You quit it from its icon's menu.

If an annotation isn't saved, Capture-Craft asks before quitting; Cancel keeps it open.