---
title: "Bigshot user guide"
description: "Bigshot is a macOS screenshot app that lives under the notch. It captures the screen five ways, annotates and measures in its editor, keeps captures in a Library, and can save them into a code repository where Claude Code and Codex can read them."
url: https://www.bigshot.pics/docs
---
# Bigshot user guide

Bigshot is a macOS screenshot app that lives under the notch. It captures
the screen five ways, annotates and measures in its editor, keeps captures
in a Library, and can save them into a code repository where Claude Code and
Codex can read them.

## Start here

- [Getting started](https://www.bigshot.pics/docs/getting-started): install, permission, first capture

## Using Bigshot

- [Capture modes](https://www.bigshot.pics/docs/capture-modes): Display, Window, Area, Smart, Frame,
  and what happens after a capture
- [The island](https://www.bigshot.pics/docs/island): Notch View, Peek View, Expanded View, the pod,
  and the menu bar
- [The Capture Editor](https://www.bigshot.pics/docs/editor): crop, shapes, arrows, text, steps,
  redaction, measuring, colour picking, Live Text
- [The Library](https://www.bigshot.pics/docs/library): browsing, search, export, tags, moving between
  Projects, Keep and automatic cleanup
- [Projects and screenshot context](https://www.bigshot.pics/docs/projects): saving into a workspace,
  task tags, sharing screenshots with agents
- [Code Lens](https://www.bigshot.pics/docs/code-lens): the code behind part of the screen, what the
  Code map reads, and why it only knows your own code
- [Hooks and LLM connections](https://www.bigshot.pics/docs/hooks): running Claude Code, Codex or an
  API on every capture
- [Workflows](https://www.bigshot.pics/docs/workflows): step-by-step recipes

## Reference

- [Shortcuts](https://www.bigshot.pics/docs/shortcuts)
- [Settings](https://www.bigshot.pics/docs/settings)
- [Licence and updates](https://www.bigshot.pics/docs/licence)
- [Troubleshooting](https://www.bigshot.pics/docs/troubleshooting)

## At a glance

| | |
|---|---|
| Capture the selected mode | ⌃⌥C |
| Display / Window / Area | ⌃⌥D / ⌃⌥W / ⌃⌥A |
| Smart / Frame | ⌃⌥S / ⌃⌥F |
| Code Lens | ⌃⌥L |
| Library | ⌃⌥O |
| Expanded View | ⌃⌥I |
| Saved to | Desktop, or the Active Project's `.screenshots/` |
| Format | PNG, also copied to the clipboard |