설치 방법 | Snapzy Docs

시스템 요구 사양

macOS 13 Ventura 이상
Apple Silicon 또는 Intel Mac
약 120 MB의 여유 디스크 공간
클라우드 업로드 사용 시에만 인터넷 연결 필요 (선택 사항)

DMG 파일로 다운로드

다운로드 페이지에서 최신 .dmg 파일을 내려받습니다.
DMG 파일을 열고 Snapzy를 Applications(응용 프로그램) 폴더로 드래그합니다.
Applications 폴더 또는 Spotlight에서 Snapzy를 찾아 실행합니다.

최초 실행 시 — Snapzy는 Mac App Store 외부에서 배포되며 아직 Apple의 공증을 받지 않았기 때문에 macOS에서 보안 경고가 표시될 수 있습니다. 시스템 설정 → 개인정보 보호 및 보안으로 이동하여 확인 없이 열기를 클릭하십시오. 또는 앱을 Applications 폴더에 배치한 후 터미널에서 sudo xattr -rd com.apple.quarantine /Applications/Snapzy.app 명령을 실행해 해결할 수도 있습니다.

Homebrew를 이용한 설치

Homebrew를 사용하는 경우, Snapzy 탭(Tap)을 추가하고 다음과 같이 설치합니다:

brew tap duongductrong/snapzy https://github.com/duongductrong/Snapzy
brew install --cask snapzy

앱 업데이트는 brew upgrade 명령을 실행할 때 자동으로 처리됩니다.

쉘 스크립트

curl을 사용하여 특정 버전을 설치합니다:

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

소스코드에서 직접 빌드

Snapzy는 오픈 소스 프로젝트입니다. Xcode를 사용하여 로컬에서 직접 빌드할 수 있습니다:

저장소를 클론합니다: git clone https://github.com/duongductrong/Snapzy.git
Xcode 15 이상 버전에서 Snapzy.xcodeproj를 엽니다.
빌드 타겟을 Snapzy로 선택하고 대상 기기를 본인의 Mac으로 설정합니다.
⌘R 키를 눌러 빌드 및 실행을 진행합니다.

팁 — 단축키를 직접 커스터마이징하거나 기여하고자 한다면 소스코드 빌드가 매우 유용합니다. 로컬에서 실행할 때는 Apple 개발자 계정이 없어도 가능합니다.

최초 실행 권한 설정

Snapzy를 처음 실행하면 다음과 같은 macOS 권한 허용을 요청합니다:

화면 기록(Screen Recording) — 스크린샷 및 화면 녹화를 캡처하기 위해 필수적으로 필요합니다.
마이크(Microphone) — 선택 사항이며, 화면 녹화 시 사용자의 음성 오디오를 추가하려는 경우에만 필요합니다.
손쉬운 사용(Accessibility) — 선택 사항이며, 전역 키보드 단축키 및 창 감지 기능을 위해 사용됩니다.

권한 설정 및 철회에 대한 자세한 내용은 권한 및 개인정보 보호 문서를 참조하십시오.

프로그램 삭제

Snapzy를 시스템에서 완전히 지우고, 설정된 권한 및 앱 데이터를 깔끔하게 제거하려면 아래 명령을 실행하십시오:

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

이 명령은 /Applications 폴더에서 앱을 제거하고, 환경 설정 및 캐시 파일을 지우며, 설정된 TCC 권한(화면 기록, 마이크, 손쉬운 사용)을 모두 초기화합니다. 권한 변경 사항이 온전히 반영되기 위해 로그아웃이나 시스템 재부팅이 필요할 수 있습니다.