Preferences

hypershot’s settings are organized into tabs in the Settings window.

Opening Settings

1. Click the hypershot icon in your menu bar / system tray
2. Select Settings

The Settings window uses a tabbed layout with a custom title bar. Each tab covers a different area:

Tab	Description
General	Startup, notifications, updates, update channel, experimental features
Shortcuts	Global hotkey customization — see Hotkeys
Appearance	Theme, accent color, UI scale, reticle style — see Appearance
Captures	Save directory, image format/quality, rolling window, capture delay
OCR	Text recognition output settings
Permissions	macOS privacy permissions (shown only when needed)
About	Version info, license status, update checks

General Tab

Start with System

Launch hypershot automatically when you log in.

Show Notifications

Display system-tray messages for captures, saves, and errors.

Auto-Check for Updates

When enabled, hypershot periodically checks for new versions in the background. You’ll be notified when an update is available.

Update Channel

Choose which release track hypershot follows for automatic updates:

• Stable (default) — Production-ready releases. Recommended for most users.
• Beta — Early access to new features before they ship in Stable. Beta builds may be less polished.

How it works

• Beta and Stable are independent feeds — switching from Beta back to Stable won’t downgrade your current install.
• Changing the channel takes effect after you restart hypershot. A “Restart to apply” hint appears when the chosen channel differs from the one currently running.
• Your current version label (visible in Settings → About) reflects the build you’re running — e.g. v1.1.0-beta.1 (build 1347) for a beta, or v1.0.4 (build 1343) for a stable release. This is determined by the build itself, not your channel setting.
• On fresh installs, the channel follows the build type — beta builds default to the Beta feed, stable builds to Stable.

How releases reach each channel

Each channel is built from its own branch, automatically:

• Stable is published from the main branch — every tagged release there ships to the Stable feed
• Beta is published from the staging branch — merges there produce prerelease builds (e.g. v1.1.0-beta.1) on the Beta feed

Both lines build on every push; versioning keeps beta and stable from ever colliding (a beta of 1.1.0 and the later stable 1.1.0 are distinct, ordered builds). Nothing is published by hand — a release goes out when its branch is tagged.

Tip Beta builds let you try upcoming features early. If you rely on hypershot for daily work, consider staying on Stable.

Experimental Features

Enable cutting-edge features that are still being tested.

⚠️ May be unstable — only enable if you’re adventurous.

Captures Tab

Save Directory

Where screenshots are saved by default.

Default: Pictures/hypershot/

Click Browse to choose a different folder.

Image Format

Default format when saving:

• PNG — Best quality, larger files
• JPEG — Smaller files, good for photos

Image Quality

For JPEG/WebP formats on export/copy: 0–100. Recommended: 90 (good balance of quality and size)

Rolling Window Duration

Controls how many seconds of frames are kept in the capture buffer during a recording.

• Range: 0–5 seconds (adjustable in 0.5s steps)
• Default: 1.0 second
• Set to 0 for single-frame capture only

Capture Delay

Set a countdown timer (in seconds) before a capture fires.

• Range: 0–10 seconds
• Default: 0 (no delay)

Useful for capturing menus, tooltips, and hover states.

Show Cursor in Delayed Capture

When enabled, the mouse cursor is included in delayed captures. Default: Off

After Capture

Choose what happens when you finish a capture:

• Preview — The capture warps into the preview folder as a card
• Edit — The capture opens directly in the editor
• Only Copy — Skip the editor and preview folder entirely. The capture is copied to your clipboard, and a small info pill appears at the bottom of the screen for a few seconds (click it to open the capture in the editor).

In Only Copy mode, the Copy to Clipboard checkbox is locked on — copying is the point of the mode.

Capture Animations

When you take a capture, hypershot plays a warp effect — a subtle screen distortion that ripples outward from the capture area. This gives instant visual confirmation that the screenshot was taken.

By default, hypershot shows the warp animation after capture. You can change this behavior in Settings → General to open the editor directly instead.

OCR Tab

Open OCR text in

Choose which text editor opens extracted text after OCR runs. Leave blank to use the system default.

Open text editor after copying

When enabled, the recognized text file is automatically opened in your editor after being copied to the clipboard.

OCR settings appear on macOS and Windows where OCR APIs are available.

About Tab

Displays the current version number and license status. Click Check for Updates to look for newer versions.

The version label shows the display version (e.g. v1.1.0-beta.1) and a build number (e.g. build 1347). The display version identifies the release track; the build number is used internally by the auto-updater to determine whether a newer version is available.

macOS: Hold ⌘Q to Quit

On macOS, holding ⌘Q shows a prompt: “Hold ⌘Q to Quit” → “Release to Quit”. This prevents accidental quits. Release the keys to confirm, or let go early to cancel.

System Requirements

• macOS: 14.0 (Sonoma) or later
• Windows: Windows 10 or later

Resetting Settings

Click Reset to Defaults to restore all original settings.

---

See also: Appearance | Hotkeys | Licensing