Installation

System Requirements

• macOS 13 Ventura or later
• Apple Silicon or Intel Mac
• ~120 MB free disk space
• Internet connection only required for cloud uploads (optional)

DMG Download

1. Grab the latest .dmg from the Download page.
2. Open the DMG and drag Snapzy to your Applications folder.
3. Launch Snapzy from Applications or Spotlight.

Homebrew

If you use Homebrew, install Snapzy directly:

brew install --cask snapzy

Upgrades are handled automatically when you run brew upgrade.

Shell Script

Install the latest version via curl (automatically detects and fetches the latest release):

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/install.sh | bash

To install a specific version, pass the VERSION parameter:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/install.sh | VERSION=<version> bash

Build from Source

Snapzy is open source. You can build it locally with Xcode:

1. Clone the repo: git clone https://github.com/duongductrong/Snapzy.git
2. Open Snapzy.xcodeproj in Xcode 15 or later.
3. Select the Snapzy scheme and your Mac as the destination.
4. Press ⌘R to build and run.

First-Run Permissions

On first launch, Snapzy will request these macOS permissions:

• Screen Recording — Required to capture screenshots and recordings.
• Microphone — Optional, only if you want audio in screen recordings.
• Accessibility — Optional, used for global hotkeys and window detection.

See Permissions & Privacy for details on how to grant or revoke these.

Uninstall

To completely remove Snapzy, reset permissions, and clean up app data:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

This removes the app from /Applications, deletes preferences and caches, and resets TCC permissions (Screen Recording, Microphone, Accessibility). You may need to log out or reboot for permission changes to fully take effect.