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でIssueを開く — 喜んでお手伝いします！