インストール
MaccyはmacOS Sonoma 14以降に対応し、Apple siliconとIntelの両方で動作するユニバーサルバイナリです。使い方に合ったインストール方法を選んでください。
.dmgから直接インストール
署名とAppleの公証を受けたディスクイメージを 公式ダウンロードページからダウンロードします。 .dmgをダブルクリックし、Maccyを「アプリケーション」フォルダにドラッグして起動します。Appleの公証を受けているため、初回起動時もGatekeeperの警告は表示されません。すぐに使い始める場合に最適です。
Homebrew
Homebrewでツールを管理している場合は、次のコマンドを実行してください。署名済みの最新版がインストールされ、ほかのCaskと一緒に自動更新できるようになります。以降の更新には次を使います。 brew upgrade --cask maccy。
brew install --cask maccyソースからビルド
をクローンし、 GitHubリポジトリ を開いて Maccy.xcodeproj をXcodeで開きます。標準のSwiftとAppKitフレームワークでビルドでき、CocoaPodsやSPMなどの外部依存関係は不要です。MITライセンスのため、法務確認なしでフォークし、社内で配布できます。
使い方とショートカット
Maccyはコピーした内容を自動で記録します。キーボードショートカットで履歴を開き、入力して絞り込み、Returnキーでペーストします。以下に初期設定の操作方法をまとめます。
| 操作 | ショートカット／方法 |
|---|---|
| クリップボード履歴を開く | ⌘ ⇧ C またはメニューバーのアイコンをクリック |
| 選択してペースト | ⌥ ↵ または ⌥-click |
| 書式なしでペースト | ⌥ ⇧ ↵ または ⌥ ⇧-click |
| 1～9の項目をすばやく選択 | ⌘ 1…9 |
| クイック選択で書式なしペースト | ⌥ 1…9 |
| 項目を1つ削除 | ⌥ ⌫ |
| 項目をピン留め／解除 | ⌥ P |
| ピン留め以外の履歴を消去 | メニューから 「消去」 または ⌥ ⌘ ⌫ |
| ピン留めを含むすべての履歴を消去 | 「消去」 を押しながら ⇧ ⌥ を押したまま操作するか、 ⇧ ⌥ ⌘ ⌫ |
| 一時的に無効化 | ⌥＋メニューバーのアイコンをクリック |
| 次のコピーだけ無視 | ⌥ ⇧＋メニューバーのアイコンをクリック |
| 設定を開く | ⌘ 、 |
| 全文ツールチップを表示 | 省略表示された項目に数秒間カーソルを合わせる |
すべてのショートカットは次の画面で変更できます： 設定 → ホットキー。印刷用の一覧は ショートカット一覧ページ をご覧ください。
詳細設定（defaults）
Maccyの詳細は次のコマンドで調整できます： defaults write、カスタムペーストボードタイプ、クリップボードの確認間隔を設定できます。設定ファイルの保存先： ~/Library/Preferences/org.p0deje.Maccy.plist。
コピー内容の記録を一時停止
機密情報を扱うときは、アプリを終了せずに記録を一時停止できます。次のコマンドを実行してコピー作業を行い、その後 falseに戻してください。また、 ⌥＋メニューバーのアイコンをクリックして一時的に切り替えることもできます。
defaults write org.p0deje.Maccy ignoreEvents true
# ... 作業を行う ...
defaults write org.p0deje.Maccy ignoreEvents falseコピー形式を個別に無視
Maccyは一時データや非表示のペーストボードタイプを初期設定で無視します。追加するには 設定 → 無視する項目 を開いてタイプ識別子を入力します。アプリ独自のタイプを調べるには Pasteboard Viewerを使い、対象アプリでコピーして左側の一覧を確認します。よく使われる例： de.petermaurer.TransientPasteboardType および com.typeit4me.blocked。
クリップボードの確認間隔を短縮
初期設定では500ミリ秒ごとにクリップボードを確認します。コピーをより素早く検出するには、秒単位の値を小さくします。間隔を短くすると、バッテリー駆動時にCPUの起動回数がわずかに増える場合があります。
defaults write org.p0deje.Maccy clipboardCheckInterval 0.1非表示になったフッターを戻す
履歴一覧の下にあるフッターが消えた場合は、次の設定で再度有効にしてください： 設定 → 外観。またはTerminalで次のコマンドを実行し、Maccyを再起動します。
defaults write org.p0deje.Maccy showFooter 1セキュリティとプライバシー
Maccyが自動でペーストするにはアクセシビリティへのアクセスが必要です。iCloud同期を明示的に有効にしない限り、クリップボードのデータがMacの外部へ送信されることはありません。
アクセシビリティの許可
履歴から初めてペーストするとき、macOSからMaccyの操作を許可するよう求められます。次の画面で許可してください： システム設定 → プライバシーとセキュリティ → アクセシビリティ。許可しなくても項目をシステムクリップボードにコピーできますが、ペーストのキー操作を代わりに実行できません。
非表示のペーストボードタイプ
一時データや機密情報を含むため、次のタイプは初期設定で無視されます： org.nspasteboard.TransientType、 org.nspasteboard.ConcealedType、 org.nspasteboard.AutoGeneratedType、さらに com.agilebits.onepassword など、1Password、Bitwarden、Apple Passwordsの同様の識別子も対象です。
ユニバーサルクリップボードを無視
iPhoneやiPadからHandoff経由でコピーした項目をMaccyに記録させないようにするには、 com.apple.is-remote-clipboard を次の設定の無視リストに追加します： 設定 → 無視する項目。
アプリごとの除外リスト
次の設定からアプリを除外リストに追加できます： 設定 → 無視する項目記録したくないワンタイムコードを扱う銀行アプリ、トークン生成アプリ、VPNクライアントなどに便利です。データの流れについては プライバシーポリシー をご覧ください。
トラブルシューティング
再インストールせずに解決できる、よくある問題を紹介します。
履歴から項目を選んでもペーストされないのはなぜですか？
- 次の設定を確認してください： 自動でペースト が設定で有効になっていること。
- Maccyが次の設定に追加されていること： システム設定 → プライバシーとセキュリティ → アクセシビリティ。
- 一部のアプリ（特にElectron製やWebベースのアプリ）はキー操作の再現をブロックします。その場合は項目を選択し、 ⌘ V を手動で押してください。
- 対象アプリが管理者として実行されている場合、macOSはMaccyからのペーストを許可しません。両方を同じ権限で実行してください。
ホットキーを設定すると「システム設定ですでに使用されています」と表示されます
次を開きます： システム設定 → キーボード → キーボードショートカット。「サービス → テキスト」にある次のような項目を探してください： テキストを簡体字中国語に変換 または 文字ビューアを表示。競合するショートカットを無効にし、Maccyを再起動してから割り当て直してください。既定のmacOSショートカットと競合しにくい次の組み合わせがおすすめです： ⌘ ⇧ C は、macOSの標準ショートカットと競合しません。
パスワード欄でキーボードショートカットが動作しません
macOSのセキュアイベント入力は、文字が入力されるショートカット（例： ⌥ C で「ç」が入力されます）をブロックします。呼び出し用ショートカットを、文字を入力しない次のような組み合わせに変更してください： ⌘ ⇧ C。変更できない場合は Karabiner-Elements を使って、macOSに認識される前に物理キーの組み合わせを別のキーに変換します。
非表示のフッターを戻すには？
フッターには保存容量の統計と「消去」ボタンが表示されます。消えた場合は 設定 → 外観 で再度有効にしてください。設定画面で変更できない場合は、次を実行します： defaults write org.p0deje.Maccy showFooter 1 をTerminalで実行し、アプリを再起動してください。
ユニバーサルクリップボードからのコピーを無視するには？
次を開きます： 設定 → 無視する項目で、プラスのアイコンをクリックして、次を追加します：com.apple.is-remote-clipboard。これによりHandoff経由のコピーは保存されません。iOSデバイスから項目をコピーし、履歴に表示されないことを確認してください。
再起動すると履歴が消えます
次を確認してください： 設定 → 保存。履歴の上限が低いと、起動時に古い項目が削除されます。上限を増やすか、重要な項目を次の方法でピン留めしてください： ⌥ P 。ピン留めした項目は別に保存され、自動削除されません。
ログイン時にMaccyが起動しません
Maccyを次の設定から手動で追加してください： システム設定 → 一般 → ログイン項目。Maccyは常駐の起動エージェントをインストールしません。起動項目を整理し、管理をユーザーに委ねるためです。
翻訳
Maccyの翻訳はコミュニティが次のサービスを通じて行っています： Weblate。コードに触れずに既存の翻訳を改善したり、新しい言語を追加したりできます。macOSの標準用語との一貫性を保つため、変更はすべてマージ前に確認されます。
開発の背景
macOS向けクリップボードマネージャーは数多くありますが、不要な機能が多すぎたり、サブスクリプションが必要だったりするものがほとんどです。MaccyはLinuxの Parcellite のように無料でシンプルなツールを目指し、開発者がSwiftを学ぶ機会として作られました。機能は高速で検索できる履歴に絞っています。スニペット展開、AIによる書き換え、共有ワークスペースはありません。
ライセンス
Maccyは次のライセンスで公開されています： MITライセンス個人・商用を問わず、使用、改変、再配布、サブライセンスが可能です。ライセンス全文は GitHubリポジトリ。
ドキュメントに関する質問
設定ファイルはどこに保存されていますか？
すべての設定は次の場所に保存され、 ~/Library/Preferences/org.p0deje.Maccy.plist で読み取りや変更ができます： defaults read/write。クリップボード履歴データベースは別の場所に保存されます： ~/Library/Application Support/Maccy。履歴をバックアップするには、Maccyを終了してこのフォルダをコピーしてください。
macOS Ventura以前でもMaccyを使えますか？
Maccy 2.7.3の公式対応はmacOS Sonoma 14以降です。古いシステム向けの旧バージョンがGitHubのリリースに残っている場合がありますが、保守やセキュリティ修正は行われていません。
Maccyはシステムのクリップボードを置き換えますか？
いいえ。システムのペーストボードを監視しながら、別に履歴データベースを管理します。Maccyをいつでもアンインストールでき、その後もシステムのクリップボードは通常どおり動作します。カーネル拡張機能やバックグラウンドデーモンはインストールされません。
履歴をバックアップするには？
Maccyを終了して、次のフォルダを ~/Library/Application Support/Maccy バックアップ先のドライブにコピーします。復元するにはMaccyを終了し、フォルダを置き換えてから再起動します。iCloud同期を使っている場合、データはサインイン済みのMac間ですでに同期されています。
Maccyが記録できる項目数に上限はありますか？
初期設定の履歴件数は十分な数ですが、次の設定で変更できます： 設定 → ストレージMaccyはファイル内容を複製せず、軽量な参照情報とプレビューを保存するため、容量をほとんど使いません。ほとんどのシステムで1万件の履歴は50 MB未満です。