本文へスキップ
Chapters
  1. Omarchy へようこそ!
  2. はじめに
  3. MacやWindowsから乗り換えたら
  4. ナビゲーション
  5. トップバー
  6. テーマ
  7. ホットキー
  8. 統一クリップボードと履歴
  9. リマインダー
  10. 通知
  11. テキスト抽出とディクテーション
  12. スクリーンショットと録画
  13. トグル、アイドルとスクリーンセーバー
  14. Omarchy CLI
  15. ターミナル
  16. Neovim
  17. AI
  18. 開発ツール
  19. シェルツール
  20. シェル関数
  21. TUIs
  22. GUI
  23. ブラウザ
  24. 商用アプリ/サービス
  25. Web アプリ
  26. ゲーミング
  27. PDF への記入
  28. Windows VM
  29. その他のパッケージ
  30. アップデート
  31. Dotfiles
  32. シェルプラグイン
  33. モニター
  34. キーボード、マウス、トラックパッド
  35. ネットワーキング
  36. システムスリープ
  37. ハードウェア認証
  38. フォント
  39. 背景
  40. プロンプト
  41. ブランディング
  42. よくある調整
  43. 独自のテーマを作る
  44. Mac サポート
  45. トラブルシューティング
  46. FAQ
  47. システムスナップショット
  48. セキュリティ
  49. Omarchy on...
  50. デュアルブートインストール
  51. 無人インストール

マニュアル

シェルプラグイン

Omarchy デスクトップは omarchy-shell と呼ばれる単一の長期稼働する Quickshell プロセスとして動作し、画面上に見えるほぼすべてはその内部のプラグインです。バーはプラグインです。そこからの下がるパネル、絵文字ピッカーやクリップボードマネージャーなどのフルスクリーンオーバーレイ、Omarchy メニュー自体、ロック画面、polkit ダイアログ、そしてバッテリーを監視し夜に画面を温かく保つヘッドレスサービスも同様です。

これは単なる実装の詳細ではありません。デスクトップの一部をオフにしたり、交換したり、独自のものを書いたりするのに、Omarchy のソースを1行も触らないで済むということです。

ファーストパーティプラグインは Omarchy に同梱され、$OMARCHY_PATH/shell/plugins/ に存在します。独自の実験や GitHub で見つけた何かを自分で追加したものは、~/.config/omarchy/plugins/ に存在します。どちらも起動時に同じ方法で発見されますが、内蔵プラグインは信頼済みのシェルインターフェースを受け取るのに対して、サードパーティプラグインは独自のサービスとライフサイクルに限定されたインターフェースを受け取ります。内蔵プラグインのクローンは、元の振る舞いに必要な、ソース固有の設定と UI 呼び出ししか保持しません。

有するものを確認する

omarchy plugin list

これにより、発見されたすべてのプラグインと、その id、有効かどうか、ファーストパーティかサードパーティか、その種類(kinds)、表示名が表示されます。他の何かに渡す場合は --json を追加してください。

プラグイン id は名前空間化されています。内蔵はすべて omarchy. で始まります - omarchy.clock、omarchy.network、omarchy.notifications - そしてその名前空間は予約済みであるため、サードパーティプラグインは決してそれを主張できません。

オンとオフの切り替え(切り替え)

omarchy plugin enable omarchy.tailscale
omarchy plugin disable omarchy.weather

あるいはメニューを使ってください:設定 > Plugins には Enable、Disable、Add、Clone、Remove があり、各々にはそのアクションに適合するプラグインのみを提案するピッカーがあります。

有効状態は ~/.config/omarchy/shell.json 内に保存され、ルールは2種類のプラグインでわずかに異なります。サードパーティプラグインは、その id がバーレイアウトエントリとして、plugins[] のエントリとして、または bar.id としてそのファイルのどこかにある場合にまさに有効になります。バーウィジェットでないファーストパーティプラグインは逆です:デフォルトでオンであり、disabledPlugins[] に登録されることによってのみオフになります。

完全なバープラグインにはオフ状態がまったくありません。常にバーは正確に1つ存在するため、別のバーを有効にすることで置き換えます。バーウィジェットの配置は 上部バー で扱われます。

git からプラグインを追加する

サードパーティプラグインは、ルートに manifest.json がある単なる git リポジトリです。

omarchy plugin add https://github.com/acme/omarchy-weather.git --enable

何かを行う前に、それはあなたにプラグインが長期稼働するシェルプロセス内部で任意のサンドボックス化されていないコードとして実行される旨を率直に告げ、URL を表示し、確認を求めます。それを真剣に受け止めてください。サードパーティプラグインのインターフェースは認証サービスを直接露出しておらず、置き換えバーは、設定された非認証 UI 向けに限られた能力のみを受け取ります。視覚プラグインは依然としてシェルの QML シーンを共有し、通常の親オブジェクトをたどることができます。一方、すべてのプラグインコードはあなたのユーザーアカウントが到達できるもののすべてとともに動作します。認証状態は、それらのサービスを到達可能なホストオブジェクトグラフの外部に保持することで別個に保護されます。あなたが実行しても構わないリポジトリのみを追加し、有効にする前に読んでください。

置き換えバーはインストールされたウィジェットを表示できますが、サービスに支えられたサードパーティウィジェットは、バーが別のプラグインのライブサービスオブジェクトを要求することが許されていないため、そこで機能が制限されることがあります。そのウィジェットがコンパニオンサービスを必要とする場合、内蔵の omarchy.bar へ切り替え戻してください。

次にそれはリポジトリを staging ディレクトリにクローンし、manifest を検証し、別のプラグインがすでにその id を主張している場合インストールを拒否し、それを ~/.config/omarchy/plugins/<id>/ へ移動します。--enable なしでは、今すぐオンにするか尋ねられ、no と答えてまずコードを読めます。プラグインの何かを実行したり、インストールフックを実行したり、sudo を求めたりすることは決してありません - ファイルをクローンし、manifest をチェックし、IPC 経由でビットを切り替えるだけです。

更新は、その同じチェックアウトの fast-forward pull です:

omarchy plugin update acme.weather
omarchy plugin update

id なしで実行すると、あなたが持つすべての git 管理プラグインを更新します。適用前に差分を表示し、fast-forward できないローカル変更がある場合更新を拒否し、新しいリビジョンが検証に失敗した場合はロールバックします。

omarchy plugin remove acme.weather

削除はまずプラグインが無効化し、次に git チェックアウトであれば削除(リポジトリは依然アップストリームにあります)、シンボリックリンクであればリンクを解除します。git リポジトリのない手製のプラグインフォルダは、丸ごと削除する代わりに、プラグインディレクトリ内のタイムスタンプ付きバックアップへ移動されます。

変更するための内蔵のクローン

これは私のお気に入りの部分です。内蔵ウィジェットの振る舞いを変更したい場合は、$OMARCHY_PATH 下のファイルを編集しないでください - それらはパッケージに属し、次の更新で上書きされます。代わりにクローンしてください:

omarchy plugin clone omarchy.clock

これによりプラグイン全体が ~/.config/omarchy/plugins/dhh.clock(私ではなく、あなたのユーザー名)へコピーされ、「My Clock」に改名され、有効化され、シェルが内蔵からあなたのコピーへと切り替えられます - 既存のバーウィジェットの位置と設定を保持します。--edit を追加すれば新しいディレクトリがあなたの $EDITOR ですぐに開きます。これはメニューの 設定 > Plugins > Clone Plugin があなたのために行うことです。

ユーザー名の接頭辞により、あなたのクローンの id はあなた独自のものに保たれるため、共有しても他人のものと衝突しません。元の内蔵 id への呼び出しはあなたのクローンへルーティングされるため、omarchy.clock を参照したものはどれも更新する必要はありません。そして混乱してしまった場合、omarchy plugin remove dhh.clock で内蔵が戻ってきます。

~/.config/omarchy/plugins/ 下のどこかのファイルが保存されるとプラグインコードは自動でリロードされます。そのためエディタを開きっぱなしにして変化が届くのを見られます。

独自のものを書く

プラグインは manifest.json といくらかの QML のあるディレクトリです。manifest は schemaVersion: 1、id、name、version、1つ以上の kinds、そして各 kind 向けの QML ファイルを指す entryPoints オブジェクトを宣言します:

Kind What it is
bar-widget 有効なバーがセクション内へ差し込めるコンポーネント
panel 永続的または呼び出されるフローティングウィンドウ
overlay フルスクリーンオーバーレイ
menu 呼び出されるメニューサーフェス
service UI のないヘッドレスシングルトン
bar 内蔵バーを置き換える完全なバー

プラグインは一度に複数の kind を宣言できます - メディアプラグインは service であると同時に bar-widget でもあります。バーウィジェットは、表示名、カテゴリ、任意の defaultSection、そして allowMultiple を含む barWidget ブロックが別途付いていて、これはバー上に複数置く意味があるかどうかを示します。ほとんどのウィジェットは false に設定し、スペーサーやインジケーターは true に設定します。

何かを公開する前に、確認してください:

omarchy plugin validate ./my-plugin

これにより、シェルがロード時に行う同じチェックが実行されます:スキーマバージョン、必須フィールド、予約されていない id、安全な相対パスで実際に存在するエントリポイント、主張したすべての kind 向けにエントリポイント、フォルダ内のどこにもシンボリックリンクがないことのすべてです。

プラグイン開発については、シェルリファレンス と ファーストパーティプラグインカタログ を参照してください。

あなたのものを世界にシェアする

気に入るものを作ったら、公開の git レポジトリに入れてください。それが配信の仕組みのすべてです - そうしたら誰かがあなたの URL に対して omarchy plugin add を実行でき、数秒で実行できます。

人々に実際にそれを見つけてもらうためには、plugins.omarchy.org にリストしてください。ここは Omarchy シェルプラグインのマーケットプレイスであり、今から書こうとするウィジェットをすでに誰かが作っていないか調べるときに真っ先に見るところです。始める前にブラウズしてください!