OneShot 📸

Open source screenshot utility for macOS with QoL improvements over the native Apple screenshot utility.

🎯 Goals

• Keep the capture flow simple and familiar.
• Add control over preview behavior, save timing, location, clipboard operations, and naming.
• Stay lightweight and focused.
• Add features I’ve always wished the native utility had.

✨ Features

• Selection, window, and full-screen capture.
• Scrolling screenshots.
• Floating preview with save/discard actions and drag-and-drop.
• Optional clipboard copy + configurable save location and filename prefix.
• Customizable hotkeys.
• Optional auto-dismiss preview with save delay control.
• Optional menu bar icon hiding (restore via Spotlight).
• The ability to customize screenshot selection windows.

🚀 Installation

Homebrew (recommended):

brew install --cask grantbirki/tap/oneshot

Demos 📹

Area Selection

selection-demo.mp4

Scrolling Selection

scrolling-demo.mp4

Settings

settings-demo.mp4

📖 Usage

• End-user guide: docs/usage.md
• Settings reference: docs/settings.md

🔐 Verify Releases

Release artifacts are published with SLSA provenance. After downloading OneShot.zip:

gh attestation verify OneShot.zip \
  --repo grantbirki/oneshot \
  --signer-workflow grantbirki/oneshot/.github/workflows/release.yml \
  --source-ref refs/heads/main \
  --deny-self-hosted-runners

Minimal verification by owner:

gh attestation verify OneShot.zip --owner grantbirki

You can also verify the checksum:

shasum -a 256 OneShot.zip

Unsigned Builds

OneShot releases are currently unsigned. macOS Gatekeeper may block the first launch.

To open it:

1. Right-click OneShot.app and choose Open.
2. Or go to System Settings → Privacy & Security and click Open Anyway.
3. If neither shows, remove the quarantine attribute:

xattr -dr com.apple.quarantine /Applications/OneShot.app

Why? Apple Developer ID certs cost $99/year, and I don't want to pay Apple.

👩‍💻 Contributing

See the CONTRIBUTING.md for details on how to contribute to this project.