Capture

Pick a color from the screen

Eyedropper color picker — opens the native macOS magnifier loupe and waits for the user to click a pixel, then returns the sampled color. User cancellation (Escape) returns {cancelled: true} rather than an error. Requires user interaction; not scriptable at coordinates.

post/v1/color/pick

Request

  • Base URL: http://localhost:9998
  • URL: http://localhost:9998/v1/color/pick
  • Auth: HTTP bearer

Request body

format'hex' | 'rgb' | 'hsl' | 'hsv' | 'all'

Output format. Default all.

Response

Sampled color (or cancelled)

cancelledboolean required

True when the user pressed Escape without clicking a pixel

hexstring

Hex color, e.g. #4ADE80 (omitted when cancelled)

Changes

No recorded changes to this operation across all 1 revision of this API.