All resources

Long-form guide

Onboarding guide — first 5 minutes with DrawShot

6 pages, from install through workflow patterns.

Render the source to PDF — instructions in the markdown file header

A 6-page walkthrough to get from install to first screenshot in 5 minutes, plus the workflow patterns that compound over your first week.

By Shraddha Mittal · drawshot.dev · v1.0


1. Install and permissions

DrawShot is a small native macOS app. macOS 13 or newer, free, no account.

Install

  1. Download the .dmg from drawshot.dev.
  2. Drag DrawShot to your Applications folder.
  3. Double-click to launch. macOS may show a Gatekeeper prompt — click Open (the app is Apple-notarized).

After install, you'll see a small D mark icon in your menu bar. No Dock icon — DrawShot lives at the edge of your screen.

Screen Recording permission

On your first capture attempt, macOS will prompt you for Screen Recording access. DrawShot needs this to read the pixels in your selected region. Nothing else.

  • Open System Settings → Privacy & Security → Screen Recording.
  • Toggle DrawShot on.
  • Quit and relaunch DrawShot for the permission to take effect.

You only do this once.

Optional: Accessibility permission

Required only if you want the global hotkey to work while another app is focused — which is most people. Grant in System Settings → Privacy & Security → Accessibility.


2. Your first screenshot

Press ⌘⇧2 anywhere on your Mac.

Your cursor turns into a crosshair. Click and drag to select a region — the same gesture you already use for native macOS captures.

Release the mouse. Two things happen:

  1. A small toast card appears in the bottom-right corner of your screen.
  2. The annotation canvas opens on top of it.

You're now in the annotation phase.

Annotate

The annotation toolbar is at the bottom of the canvas. Each tool has a single-key shortcut so you never have to use the mouse:

Key Tool
A Arrow
R Rectangle
H Highlighter
T Text
B Blur
S Step marker

Press A, then click + drag from one point to another to draw an arrow. The arrowhead is at where you released.

Want a different color? Press 1 through 6. Red, orange, green, cyan, yellow, indigo.

Made a mistake? ⌘Z undoes.

Send it

Three options to finish:

  • ⌘C — copy the annotated image to your clipboard, ready to paste into Slack, Linear, Notion, etc. Most common option.
  • ⌘S — save to ~/Pictures/DrawShot/ and copy to clipboard.
  • Esc — close without saving. Toast stays in case you want to return.

That's the full loop. Median time from ⌘⇧2 to clipboard in user testing: ~4 seconds.


3. The toast stack

After your first capture, you'll notice the small card in the bottom-right corner. That's a toast.

Each capture you take adds a new toast. The most recent appears on the right; older toasts shift left.

Why toasts exist

Most capture tools trap your annotation inside a single window. Close that window and your work is gone. In user research, 5 of 7 people said they'd lost annotation work this way.

DrawShot's toast stack solves it:

  • The toast is a persistent reference to your capture, not just a window.
  • Click any toast to re-open the annotation canvas with all your annotations preserved.
  • Toasts survive app switches, macOS sleep, and even DrawShot crashes — every annotation is written to disk as you make it.

Managing toasts

  • Click a toast → re-open the annotation canvas.
  • Click the × on a toast → dismiss it.
  • ⌘⇧⌫ → dismiss the focused toast.
  • ⌘⇧J → jump to the most recent toast.

After ~8 toasts the stack starts scrolling horizontally. Hover to scroll.

Where toasts go when dismissed

When you dismiss a toast, the underlying session folder stays for 24 hours (configurable in Preferences → Privacy → Session retention). This is a safety net — if you dismiss something by accident, you can recover it within a day.

After 24 hours, the session is permanently deleted.


4. The annotation tools

The 10 tools in DrawShot, in roughly the order I'd recommend learning them:

Arrow (A) — start here

The most-used tool. 80% of useful annotations in user testing were just an arrow. Click and drag from start to end; the arrowhead is at the release point. Hold Shift to constrain to 45° angles.

Rectangle (R)

Framing tool. Drag to define corners. Hold Shift for a square. Press R again on a selected rectangle to fill it.

Highlighter (H)

Semi-transparent overlay for "look at this region." Default color is yellow.

Text (T)

Click to drop a cursor, type your label. The background pill auto-sizes. Press Esc to finish, Return for line breaks.

Blur (B)

Pixelated overlay for redacting sensitive data. Three blur strengths — cycle with [ and ]. Destructive at save time: saved files contain blurred pixels, not the original.

For higher-stakes redaction (legal, PII), use ⌘E → Export → "Flatten with redaction" which replaces blurred pixels with solid black.

Step marker (S)

Numbered circle that auto-increments. Click anywhere to drop the next number. Great for how-to documentation.

Ellipse (O), Line (L), Pen (P), Select (V)

Less common but worth knowing:

  • Ellipse — circle a value in a chart.
  • Line — straight line without arrowhead, for "this connects to this."
  • Pen — freehand drawing for irregular shapes. Stroke is auto-smoothed.
  • Select — switch to move/edit existing annotations.

Style controls

Key Style
16 Color presets
[ / ] Stroke weight (thin / medium / thick)
\ Line style (solid / dashed / dotted)

5. Workflow patterns

Things that compound over your first week.

Pattern 1: One color = one meaning

Pick a color for "wrong" (red, key 1) and "right" (green, key 3). Use them consistently. Over weeks, your annotations become readable at a glance.

Pattern 2: Capture more than you think you need

The cost of an extra capture is nothing. The cost of having to recreate a screen state you lost is real. Capture liberally; dismiss the ones you don't need (⌘⇧⌫).

Pattern 3: Step markers for multi-step explanations

For "do this, then this, then this" content, drop step markers (S) in a single capture. One image, four numbered clicks, much easier to follow than four separate screenshots.

Pattern 4: Blur generously

Anything with customer data, emails, account IDs, auth tokens — blur it. The B tool is fast; use it as a habit.

Pattern 5: The toast stack as a debugging trail

While debugging a complex bug or reviewing a long flow, capture screenshots as you go. End up with 8 toasts. Keep the 2 that matter, dismiss the other 6. Your final shared screenshots are exactly what's needed, no extra.


6. Where to next

Customize the hotkey

If ⌘⇧2 conflicts with another app or you'd prefer ⌘⇧4: Preferences → Hotkeys.

Customize colors

If your team has brand colors: Preferences → Style → Color palette (Pro adds 8 additional brand presets).

Customize the save location

Default is ~/Pictures/DrawShot/. Change in Preferences → Save → Location.

Learn one new thing per session

Don't try to learn all 10 tools and all 30 shortcuts in one sitting. Pick one tool per day, get fluent, move on.

Read the docs

Get in touch

For bugs, feedback, privacy questions, or anything else — use the contact form at drawshot.dev/contact. I read every message personally.


Welcome to DrawShot. Hope it makes your day a little faster.

— Shraddha

drawshot.dev · v1.0 · macOS 13+ · free