/ Published in Gümrük Malları

Maccyのバックアップと復元方法:設定・ピン留め・クリップボード履歴を丸ごと保存する

Maccyのバックアップと復元方法:設定・ピン留め・クリップボード履歴を丸ごと保存する

結論: Maccyにはワンクリックのエクスポート機能はありませんが、データの保存先は「設定ファイル(plist)」と「小さなSQLiteデータベース(履歴とピン留め)」の2か所だけです。Maccy Appを終了してこの2つを安全な場所にコピーしておき、復元するときは同じ場所に戻してから再起動すれば元通りになります。設定だけなら defaults コマンド1行でもエクスポートできます。

Maccyは何を保存していて、何をバックアップすべきか?

Maccy Macはローカルファーストなアプリなので、アカウントもクラウド上のコピーもありません。データはあなたのMacの中にしか存在しないということです。保存されているデータは3つの層に分かれており、それぞれ扱い方が異なります。

層 中身 バックアップする価値は? 方法
設定 グローバルショートカット、履歴の保存件数、除外リスト、外観、ペーストの挙動 あり。常に取っておくべき defaults export、または .plist をコピー
ピン留めアイテム 再利用のためにピン留めしたスニペット あり。手作業で選んだもので、作り直すのが大変 データベースをコピー
クリップボード履歴 最近コピーしたものすべて 基本的には不要。一時的なデータで、機密情報も多い データベースをコピー(任意)

ピン留めと履歴は同じデータベースに入っているため、片方だけをバックアップすることはできません。ピン留めだけ残したい場合は、データベースを復元したあとでメニューからピン留めしていないアイテムを消去しましょう。

ステップ0:使っているMaccyはどのビルド?

このチュートリアルで最も大事なのがここです。ビルドによってファイルの場所が違うからです。Mac App Store版はAppleのサンドボックス内で動作するため、データはコンテナフォルダ内に保存されます。一方、GitHubやHomebrew(brew install maccy)経由で入れたビルドはサンドボックス化されていません。[要確認:現在の配布チャネルと、両方がいまもメンテナンスされているかを確認]

App Store版(サンドボックスあり) GitHub / Homebrew版
データフォルダ ~/Library/Containers/org.p0deje.Maccy/Data/Library/Application Support/Maccy/ ~/Library/Application Support/Maccy/
設定ファイル ~/Library/Containers/org.p0deje.Maccy/Data/Library/Preferences/org.p0deje.Maccy.plist ~/Library/Preferences/org.p0deje.Maccy.plist

どちらか分からない場合は、ターミナルで ls ~/Library/Containers | grep -i maccy を実行してください。org.p0deje.Maccy Clipboard と表示されればサンドボックス版です。何も表示されなければ、~/Library/Application Support/Maccy/ を確認しましょう。(ライブラリフォルダはFinderではデフォルトで非表示です。メニューの移動 → フォルダへ移動…からパスを貼り付けて開いてください。)

Maccyの設定をバックアップする方法

方法A:defaultsコマンドを使う(非サンドボックス版)

Maccyの設定は org.p0deje.Maccy というdefaultsドメインに保存されています。次のコマンドで持ち運びできるファイルに書き出せます。

defaults export org.p0deje.Maccy ~/Desktop/maccy-settings.plist

設定ファイルを直接コピーするより確実です。macOSが最後にディスクへ書き出した内容ではなく、現在の値そのものを読み出せるためです。

方法B:plistファイルを直接コピーする(両方のビルドで使える)

まずメニューバーのアイコンからMaccyを終了し、上の表にある設定ファイルのパスからコピーします。終了しておくことが重要です。macOSは設定をメモリ上にキャッシュしていて、アプリ終了時にコピーしたファイルや復元したファイルを上書きしてしまうことがあるためです。

App Store版ユーザーへの注意: defaults export が読みにいくのは通常の設定保存場所であり、サンドボックスのコンテナ内ではありません。そのため、サンドボックス版では空の値や古い値が返ってくることがあります。このビルドでは方法Bを使ってください。

ピン留めアイテムとクリップボード履歴をバックアップする方法

  1. Maccyを完全に終了する。アプリの実行中はデータベースが使用中です。
  2. 自分のビルドに対応するデータフォルダを開く(上の表を参照)。
  3. Maccy フォルダ全体をコピーする。ファイルを1つだけ選んでコピーするのはNGです。WALモードのSQLiteデータベースは、直近の書き込みを付随ファイル(通常はメインの .sqlite ファイルの隣にある -wal と -shm)に保持しているため、メインファイルだけをバックアップすると、最新のピン留めが気づかないうちに抜け落ちる可能性があります。[要確認:現在のMaccyリリースでの正確なファイル名]
  4. フォルダを安全な場所に貼り付ける。maccy-2026-10-21 のように日付を名前に入れておくのがおすすめです。
  5. Maccyを再起動する。

非サンドボックス版なら、次のワンライナーで済みます。

osascript -e 'quit app "Maccy"'
cp -R ~/Library/Application\ Support/Maccy ~/Desktop/maccy-backup-$(date +%F)
open -a Maccy

同じMacまたは新しいMacでMaccyを復元する方法

  1. Maccyをインストールする。パスが一致するよう、以前と同じ配布チャネルから入れてください。一度起動してフォルダを作成させてから、終了します。
  2. データベースを復元する。Maccy データフォルダの中身を、バックアップしたコピーで置き換えます。
  3. 設定を復元する。
    • 非サンドボックス版:defaults import org.p0deje.Maccy ~/Desktop/maccy-settings.plist
    • どちらのビルドでも:保存しておいた .plist を、設定ファイルのパスにあるファイルに上書きコピーします。
  4. 設定キャッシュをクリアする:killall cfprefsd
  5. Maccyを再起動し、ショートカットで呼び出します。ピン留めと設定が戻っているはずです。
  6. 権限を再付与する。macOSはアクセシビリティの許可をインストールされたアプリ単位で管理しています。そのため新しいMacでは、システム設定 → プライバシーとセキュリティ → アクセシビリティでMaccyを有効にしないと、自動ペーストが動作しません。

サンドボックス版と非サンドボックス版の間で移行する場合は、移行先ビルドの対応するパスにファイルをコピーしてください。フォーマット自体は同じで、変わるのは保存場所だけのはずですが、まずはコピーを使って試すことをおすすめします。[要確認]

自動化する:Time Machineと簡単なスクリプト

Time Machineが動いているなら、実はそれだけでカバーできています。どちらのデータ保存場所もホーム配下のLibraryにあり、Time Machineはデフォルトでここをバックアップ対象に含めます。復元するときは、Maccyを終了した状態でFinderから該当フォルダを開き、Time Machineに入って古い Maccy フォルダを戻すだけです。たいていの人にとっては、これがバックアップ戦略のすべてです。

dotfilesや新しいMacへの移行チェックリスト用に、意図的に持ち運べるコピーを作りたいなら、設定だけを対象にしたスクリプトがちょうどいい落としどころです。

#!/bin/bash
# Back up Maccy settings only (non-sandboxed build)
mkdir -p ~/Backups/maccy
defaults export org.p0deje.Maccy ~/Backups/maccy/settings-$(date +%F).plist

設定ファイルは小さく、機密性も低いので、dotfilesリポジトリに入れても問題ありません。データベースはそうはいきません。

見落としがちな注意点:バックアップは機密情報の塊

クリップボードのデータベースは、コピーしたものすべての日記のようなものです。APIキー、住所、プライベートなメッセージの断片、ときにはパスワードまで入っています。Maccyはパスワードマネージャーが「秘匿」とマークしたコピーを無視するので多少は安心ですが、これはコピー元アプリが正しく動作することが前提です。データベースは次のように扱いましょう。

  • Gitに絶対コミットしない。共有クラウドフォルダにも置かないこと。
  • 暗号化して保管する。暗号化したディスクイメージ(ディスクユーティリティ → 新規イメージ → 空のイメージ、暗号化を有効にする)か、FileVaultで保護されたボリュームを使いましょう。
  • ピン留めだけを残すことも検討する。データベースを復元してMaccyのメニューを開き、消去でピン留めしていない履歴を削除します。バックアップを共有する前には、不要なものを取り除いておきましょう。
  • 古いコピーは削除する。半年前のバックアップにも、当時コピーした機密情報がすべて残っています。

これはローカルファーストなツールが抱える正直なトレードオフです。データを預かるサーバーが存在しないのはプライバシー面での大きな利点ですが、そのぶんファイルを適切に扱う責任は自分にある、ということでもあります。

復元がうまくいかないとき

症状 考えられる原因 対処法
インポートしても設定が変わらない macOSの設定キャッシュ Maccyを終了し、killall cfprefsd を実行してから再起動
復元後に履歴が空になっている 別ビルドのフォルダを使った、またはメインのデータベースファイルだけをコピーした パスの表を再確認し、付随ファイルを含むフォルダ全体をコピーする
ピン留めは出るが、最新のものが欠けている Maccyを起動したままバックアップした Maccyを完全に終了した状態でバックアップをやり直す
ショートカットは動くが自動ペーストが動かない 新しいインストールでアクセシビリティの許可を付与していない プライバシーとセキュリティ → アクセシビリティでMaccyを有効にする
復元した設定が終了時に元に戻る ファイルをコピーしたとき、Maccyが起動中だった ファイルを触る前に必ずMaccyを終了する

まとめ

設定はこまめにバックアップしましょう(手間もかからず、リスクもありません)。データベースは、残しておきたいピン留めがあるときだけバックアップします。そしてどちらの場合も、必ずMaccyを終了した状態で行ってください。履歴を含むものは暗号化すること。仕組みはこれだけで、初回でも2分ほどで終わります。

Maccyは無料のオープンソースソフトウェアです。ここで説明した内容と動作が違う場合は、プロジェクトのGitHub Issuesで最新の挙動を確認するのが確実です。あなたにとって大切なのは、設定とピン留めのどちらでしょうか?ピン留めなら、次はピン留めの整理術のガイドがおすすめです。

よくある質問

Maccyにはエクスポート・インポート機能が標準で付いていますか?

私の知る限りありません。そのため、このチュートリアルではファイルのコピーと defaults コマンドを使っています。[要確認:最新リリースの設定画面で確認]

MaccyはiCloudでクリップボード履歴を同期できますか?

いいえ。Maccyはすべてローカルに保存し、同期サービスは持っていません。AppleのユニバーサルクリップボードはデバイスWaitingではなく現在のクリップボードの内容をデバイス間で共有する機能で、Maccyの履歴を同期するものではありません。

MaccyはMac上のどこにデータを保存していますか?

GitHub版とHomebrew版では ~/Library/Application Support/Maccy/、Mac App Store版では ~/Library/Containers/org.p0deje.Maccy/ の中です。

Time MachineでMaccyの履歴もバックアップされますか?

はい。どちらの保存場所もユーザーのLibraryフォルダ内にあり、Time Machineはデフォルトでこれを含めます。除外設定を追加している場合は対象外です。

ピン留めアイテムだけをバックアップできますか?

単独ではできません。ピン留めと履歴は1つのデータベースを共有しています。データベースをバックアップし、復元後にピン留めしていないアイテムを消去すれば、ピン留めだけの状態にできます。