설치 가이드

시스템 요구 사양

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

DMG 파일 다운로드

1. 다운로드 페이지에서 최신 .dmg 파일을 다운로드합니다.
2. DMG 파일을 열고 Snapzy를 Applications(응용 프로그램) 폴더로 드래그합니다.
3. Applications 폴더 또는 Spotlight를 통해 Snapzy를 실행합니다.

Homebrew를 이용한 설치

Homebrew를 사용하는 경우, 다음 명령어로 직접 설치할 수 있습니다:

brew install --cask snapzy

brew upgrade 명령어를 실행하면 최신 버전으로 자동 업데이트됩니다.

Shell 스크립트

curl을 사용하여 최신 버전을 설치합니다 (최신 릴리스 자동 감지):

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

특정 버전을 설치하려면 VERSION 파라미터를 지정합니다:

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

소스코드에서 직접 빌드

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

1. 저장소를 클론합니다: git clone https://github.com/duongductrong/Snapzy.git
2. Xcode 15 이상에서 Snapzy.xcodeproj 파일을 엽니다.
3. Snapzy 타깃(Target)을 선택하고 본인의 Mac을 실행 대상으로 지정합니다.
4. ⌘R 키를 눌러 빌드 및 실행합니다.

최초 실행 시 필수 권한

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

• 화면 기록 (Screen Recording) — 스크린샷 캡처 및 화면 녹화에 필수적으로 요구됩니다.
• 마이크 (Microphone) — 선택 사항으로, 화면 녹화 시 마이크 음성을 함께 담고자 할 때만 필요합니다.
• 손쉬운 사용 (Accessibility) — 선택 사항으로, 전역 단축키 동작 및 활성 창 감지 기능을 위해 사용됩니다.

권한 설정 및 변경에 대한 자세한 내용은 권한 및 개인정보 보호 가이드를 확인하세요.

삭제 (Uninstall)

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

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

이 스크립트는 /Applications에서 앱을 제거하고 환경설정 및 캐시 파일을 삭제하며, TCC 권한(화면 기록, 마이크, 손쉬운 사용)을 초기화합니다. 변경된 권한 설정을 완전히 적용하기 위해 로그아웃하거나 시스템을 재부팅해야 할 수 있습니다.