Documentation

Onboarding

Get up and running with Snapzy in minutes. Choose your language, grant permissions, and set up shortcuts on first launch.

Splash Screen

When you open Snapzy for the first time, a splash screen introduces the app and confirms that it is ready to set up. You can start the guided flow or skip to the menu bar and configure things later.

Language Selection

Snapzy supports 10 languages. During onboarding you can pick your preferred language before the main interface appears.

  • Select Auto to match your macOS system language.
  • Preview the interface in the selected locale immediately inside the onboarding flow.
  • The choice is committed when onboarding finishes and the app relaunches only if the language actually changed.

Tip — You can change the language later in System Settings → General → Language & Region → Applications.

Guided Permissions

Snapzy walks you through the macOS permissions it needs. You will be prompted to grant:

  • Screen Recording — required for all capture modes.
  • Save Folder — required so Snapzy can write screenshots and recordings to your chosen location.
  • Accessibility — recommended for global shortcuts and window detection.
  • Microphone — optional, only if you want voice in recordings.

The onboarding flow explains why each permission is needed and opens the correct System Settings pane for you.

Updating from a pre-v1.25.0 build

Starting with v1.25.0, Snapzy is notarized by Apple and signed with a new Developer ID. Because macOS ties privacy permissions to the app's signing identity, permissions you granted to earlier ad-hoc builds do not carry over automatically.

After updating to v1.25.0, you may be asked to grant permissions again. To keep everything working:

  • Restart onboarding — open Snapzy → Help → Restart Onboarding and step through the permission prompts again.
  • Or re-grant manually — open System Settings → Privacy & Security, then toggle Snapzy off and back on in Screen Recording, Files & Folders (Save Folder), Microphone, and Accessibility.

Important — If a permission still shows as granted but Snapzy cannot capture, quit Snapzy completely and reopen it. macOS refreshes TCC entries only after a full app restart.

Shortcut Configuration

The final step shows the default shortcut map and lets you customize keys before you start using Snapzy.

  • Every shortcut can be remapped or disabled individually.
  • Snapzy detects conflicts with macOS system shortcuts and warns you.
  • You can revisit shortcut settings anytime in Snapzy → Preferences → Shortcuts.

Ready to capture
your best work?

Join the open source community building the best screen capture tool for macOS.

macOS 13+ · Intel & Apple Silicon