Getting Started
Install Reticle and take your first screenshot in about 5 minutes.
Quick Install
Homebrew Recommended
brew tap croc100/reticle brew install --cask reticle
Download DMG
Grab the latest Reticle-x.x.x.dmg from
GitHub Releases.
Drag Reticle.app to /Applications.
First launch only (not yet notarized): Right-click → Open, or run once in Terminal:
xattr -dr com.apple.quarantine /Applications/Reticle.app
Requirements
✓
macOS 13 Ventura or later
Works on Ventura, Sonoma, Sequoia and newer.
✓
Apple Silicon or Intel Mac
Native support for both chip families.
✓
Xcode (free)
Used to build and run the app. Available on the Mac App Store.
✓
~500 MB free disk space
For Xcode toolchain and build artifacts.
Step 1 — Install Xcode
Xcode is Apple's free development tool. You need it to build Reticle (until a DMG is available).
1
Open the Mac App Store on your Mac.
2
Search for "Xcode" and click Get. It's free and made by Apple.
3
Wait for it to download and install (~5 GB). Launch it once when done — it will ask to install additional components. Accept.
Already a developer? Skip Xcode and just run
swift build -c release
from the project folder.
Step 2 — Download Reticle
No GitHub account needed — just download a ZIP file.
1
Go to github.com/croc100/Reticle in your browser.
2
Click the green Code button near the top of the page, then click Download ZIP.
3
Open your Downloads folder and double-click the ZIP to unzip it. You'll get a folder called
Reticle-main.
Step 3 — Open in Xcode & Run
Xcode will automatically handle everything once you open the project.
1
Inside the
Reticle-main folder, find the file named Package.swift and double-click it. It will open in Xcode.
2
In Xcode's toolbar at the top, click the scheme selector (it may say "My Mac" or something similar) and choose ReticleApp.
3
Click the ▶ Run button (or press ⌘R). Xcode will build Reticle and launch it.
4
First build takes 1–3 minutes. After that, you'll see a small Reticle icon in your menu bar (top-right of your screen).
Step 4 — Grant Permissions
macOS requires explicit permission for apps to record your screen. Reticle will prompt you automatically.
🎥
Screen Recording
Required for all capture. When prompted, click Open System Settings → toggle the switch next to Reticle → re-launch Reticle.
System Settings → Privacy & Security → Screen Recording → Reticle ✓
♿️
Accessibility
Required for scrolling screenshots and global hotkeys. Same process — System Settings → toggle Reticle.
System Settings → Privacy & Security → Accessibility → Reticle ✓
⚠️ After granting permissions, you need to quit and relaunch Reticle for the permissions to take effect.
Step 5 — Take Your First Screenshot
You're ready. Here's the basic flow.
1
Click the Reticle icon in the menu bar
It lives in the top-right of your screen, next to the clock.
2
Choose "Capture Region"
Or press your configured hotkey (default: ⌃⌘4).
3
Your screen freezes — drag to select an area
Or click a window to instantly capture it.
4
Use the toolbar to annotate (optional)
The toolbar slides in from the top. Draw, highlight, blur, add text…
5
Press Return or click Done
The screenshot is copied to your clipboard and/or saved automatically.