Snapzy를 깔끔하게 완전 삭제하고 재설치하는 방법

일부 사용자가 macOS 권한(화면 녹화, 마이크, 손쉬운 사용)을 시스템 설정에서 켜도 적용되지 않는 문제를 보고했습니다. 이는 일반적인 삭제 과정에서 남은 앱 데이터, 캐시된 환경 설정, 또는 오래된 TCC 기록이 완전히 지워지지 않을 때 주로 발생합니다.

v1.25.0 업데이트 글에서 오셨나요? Snapzy가 v1.25.0으로 업데이트된 후 권한을 다시 요청할 뿐이라면 보통 클린 삭제가 필요하지 않습니다. 먼저 권한을 다시 부여해 보세요 — Snapzy가 v1.25.0 업데이트 후 권한을 다시 요청함을 참조하세요. 권한 재부여로 해결되지 않을 때만 이 글로 돌아오세요.

해결 방법? 공식 스크립트를 이용한 클린 삭제 후 재설치하는 것입니다.

왜 클린 삭제가 필요한가요?

Snapzy를 휴지통으로 끌어다 놓는 것만으로는 모든 것이 삭제되지 않습니다. Snapzy는 샌드박스된 macOS 앱이므로 데이터가 여러 위치에 분산되어 있습니다:

샌드박스 컨테이너 — ~/Library/Containers/com.trongduong.snapzy (샌드박스 앱이 환경 설정, 캐시, 파일을 저장하는 메인 데이터 컨테이너)
TCC 권한 기록 — 시스템이 이전에 부여한(또는 거부한) 권한을 내부 데이터베이스에 기억하고 있습니다
앱 환경 설정 — ~/Library/Preferences/com.trongduong.snapzy.plist
캐시 파일 — ~/Library/Caches/com.trongduong.snapzy
애플리케이션 지원 데이터 — ~/Library/Application Support/Snapzy
저장된 앱 상태 — ~/Library/Saved Application State/com.trongduong.snapzy.savedState
HTTP 저장소 — ~/Library/HTTPStorages/com.trongduong.snapzy

이 중 하나라도 손상되거나 동기화되지 않으면, 토글이 켜져 있음에도 권한이 부여되지 않거나 온볼딩이 설정을 제대로 감지하지 못하는 문제가 발생할 수 있습니다.

1단계: Snapzy 완전 삭제

터미널을 열어주세요 (/Applications/Utilities/Terminal.app에서 찾거나 Spotlight에서 "Terminal"을 검색하세요 ⌘ + Space) 그리고 다음 명령어를 실행하세요:

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

Snapzy 저장소를 로컬에 클론하신 경우, 프로젝트 루트에서 ./uninstall.sh를 직접 실행하실 수도 있습니다.

삭제 스크립트가 하는 일

이 스크립트는 철저한 정리를 수행합니다:

실행 중인 앱 종료 — Snapzy가 현재 열린 경우 중지합니다
Snapzy.app 제거 — /Applications에서 제거합니다
애플리케이션 지원 데이터 삭제 — ~/Library/Application Support/Snapzy를 제거합니다 (임시 캡처/녹화본)
환경 설정 삭제 — com.trongduong.snapzy 기본 설정 및 plist 파일을 제거합니다
캐시 삭제 — ~/Library/Caches 및 HTTP 저장소에서 캐시된 데이터를 제거합니다
저장된 앱 상태 제거 — 창 상태 데이터를 지웁니다
Sparkle 업데이트 데이터 제거 — 자동 업데이터 캐시 및 기본 설정을 지웁니다
TCC 권한 초기화 — Snapzy에 대한 화면 녹화, 마이크, 손쉬운 사용, 입력 모니터링 항목을 지웁니다
샌드박스 컨테이너 경고 — 스크립트가 ~/Library/Containers/com.trongduong.snapzy를 감지하지만, 필요한 경우 sudo를 사용해 수동으로 제거하라고 안내합니다

중요: 스크립트가 완료된 후, TCC 권한 초기화가 완전히 적용되려면 로그아웃하거나 재부팅하셔야 할 수 있습니다. 이는 macOS의 요구사항입니다 — 시스템이 내부 권한 데이터베이스를 새로고침해야 합니다.

2단계: Snapzy 재설치

로그아웃/재부팅 후, 다음 방법 중 하나를 선택해 Snapzy를 새로 설치하세요:

옵션 A: 셸 스크립트 (권장)

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

v1.25.0를 Releases 페이지에서 확인한 최신 버전 번호로 교체하세요.

옵션 B: Homebrew

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

옵션 C: 수동 다운로드

Releases 페이지로 이동하세요
최신 Snapzy-v<version>.dmg를 다운로드하세요
.dmg를 열고 Snapzy.app을 /Applications로 드래그하세요

3단계: 권한 부여

클린 설치 후 Snapzy를 처음 실행하면:

화면 녹화 — macOS가 화면 녹화 접근 권한을 요청합니다. 시스템 설정 → 개인정보 보호 및 보안 → 화면 녹화로 이동해 Snapzy를 활성화하세요
마이크 (선택사항) — 녹화에 음성을 넣고 싶다면, 안내창이 뜰 때 마이크 접근 권한을 부여하세요
손쉬운 사용 (선택사항) — 고급 기능을 위해 안내창이 뜨면 활성화하세요

화면 녹화 권한을 부여한 후, macOS가 Snapzy를 다시 실행하라고 요청할 수 있습니다 — 이는 정상적인 동작입니다.

문제 해결 팁

권한이 여전히 작동하지 않나요? — 삭제 스크립트 실행 후 재부팅하셨는지 확인하세요. macOS는 TCC 권한을 적극적으로 캐싱합니다
"앱이 손상되었다"는 오류가 뜨나요? — 이는 오래된 ad-hoc 빌드에서 발생할 수 있습니다. v1.25.0부터 Snapzy는 Apple에 의해 공증되었으므로 이 오류는 나타나지 않아야 합니다. 그럼에도 나타나면 시스템 설정 → 개인정보 보호 및 보안으로 이동해 Snapzy 메시지 옆의 **"그래도 열기"**를 클릭하세요
Homebrew 버전이 오래되었나요? — brew update && brew upgrade snapzy를 실행해 최신 릴리스를 받으세요

빠른 참고

전체 과정을 한 곳에 정리했습니다:

# 1단계: 삭제
curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

# 2단계: Mac을 재부팅한 후 재설치
curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/v1.25.0/install.sh | bash

클린 재설치 후에도 문제가 지속되면 GitHub에서 이슈를 열어주세요 — 기꺼이 도와드리겠습니다!