CopyQ macOS トラブルシューティング: 非表示の GUI と手動ホットキー設定¶

このガイドでは、CopyQ グラフィカルインターフェイス (GUI) が表示されない、または GUI にアクセスせずにグローバルショートカット (F10 など) を再割り当てする必要がある、macOS (特に Apple Silicon M シリーズデバイス) で発生する一般的な問題について説明します。

1. 非表示の GUI のトラブルシューティング¶

macOS では、CopyQ は、次の 2 つの主な理由により、視覚的には非表示のままで、バックグラウンドで適切に実行される場合があります。

オフスクリーンウィンドウの座標: 解像度の変更後、または外部モニターの接続解除後、CopyQ は表示可能な表示領域外の座標を保持する場合があります。
メニューバーのノッチの障害: カメラノッチのある MacBook モデルでは、トレイがいっぱいになると、macOS が余分なメニューバーアイコンをノッチの後ろに自動的に隠します。

解決策: ジオメトリをリセットして表示を強制する¶

ターミナルで次のコマンドを実行して、オフスクリーン座標をクリアし、ウィンドウを最前面に表示します。

copyq config geometry ""
copyq show

それでもウィンドウが表示されない場合は、CLI を使用してウィンドウの状態を切り替えます。

copyq toggle

2. CudaText を使用してホットキーを手動で変更する¶

グローバルショートカット (「F10」など) が別のアプリケーションによって要求またはインターセプトされた場合、CopyQ GUI を開かずに、CudaText を使用して設定ファイル内でショートカットを直接編集できます。

ステップ 1: CopyQ プロセスを終了する¶

CopyQ は、終了時に変更が上書きされないように、構成ファイルを編集する前に停止する必要があります。

copyq exit

ステップ 2: CudaText で設定を開く¶

macOS では、CopyQ コマンドのショートカットは「copyq-commands.ini」に保存されます。

CudaText でファイルを開きます。

cudatext "$HOME/Library/Application Support/copyq/copyq-commands.ini"

注意: ファイルが「Application Support」に存在しない場合は、XDG フォールバックの場所を開きます。

cudatext "$HOME/.config/copyq/copyq-commands.ini"

ステップ 3: ショートカットを再割り当てする¶

1- CudaText で、「Cmd + F」を押して検索バーを開きます。 2- 「F10」または「GlobalShortcut=F10」を検索します。 3- F10 を利用可能なショートカット (たとえば、F9 または Ctrl+F10 または Meta+F10) に置き換えます。 4- ファイルを保存し (Cmd + S)、CudaText を閉じます (Cmd + Q)。

ステップ 4: CopyQ を再起動する¶

CopyQ を再度起動して、更新されたショートカット構成をロードします。

open -a CopyQ

新しいグローバルショートカットがアクティブになります。

(更新: 2026 年 8 月 9 日 08:01 火)