デフォルト設定
ShojiWM には完成済みのデフォルト設定が同梱されています
(packages/config/src/index.tsx、~/.config/shojiwm/src/index.tsx に
インストールされます)。このページでは、それが最初の状態で何をするか――
キーバインド・ウィンドウの挙動・マルチモニターのレイアウト・入力・エフェクト・
起動するプログラム――を解説します。これは最良の実例でもあります。何かを変えたいときは
~/.config/shojiwm/src/index.tsx を編集してリロードしてください。
デフォルト設定はメンテナー個人のセットアップなので、いくつかのショートカットは特定の アプリ(kitty・Google Chrome・Discord・Dolphin)を開き、補助ツール(hyprshot・swappy・ cliphist・fcitx5・shoji-bar-2)に依存しています。該当ツールが無い場合、そのショートカットは 何も起こさないだけです――好みのプログラムに割り当て直してください。 キーバインドとポインター を参照。
キーバインド
モディファイアは Super(「Windows」キー)です。デフォルトでは Caps Lock が Ctrl として
機能する点に注意してください(入力 参照)。
プログラムの起動
| ショートカット | 動作 |
|---|---|
Super + T | ターミナル(kitty) |
Super + B | ブラウザ(Google Chrome、Wayland) |
Super + D | Discord |
Super + E | ファイルマネージャー(Dolphin) |
Super + A | スタートメニューの切り替え(shoji-bar-2) |
Super(タップ) | スタートメニューの切り替え――他のキーを押さない素早いタップ |
Super + V | クリップボード履歴の切り替え(shoji-bar-2) |
Super + P | 範囲スクリーンショット(hyprshot → swappy) |
Super + Ctrl + P | 画面を静止させてから範囲スクリーンショット |
ウィンドウ管理
| ショートカット | 動作 |
|---|---|
Super + ドラッグ | ウィンドウを移動――Super を押しながらウィンドウ上の任意の場所をドラッグ |
Super + Q | フォーカス中のウィンドウを閉じる |
Super + M | フォーカス中のウィンドウの最大化を切り替え |
Super + S | 現在のワークスペースのタイルモードを切り替え |
タイルとワークスペース
| ショートカット | 動作 |
|---|---|
Super + ← / → | 左/右のタイルへフォーカスを移動 |
Super + Ctrl + ← / → | 左/右のタイルへフォーカスを移動(別名) |
Super + Shift + ← / → | フォーカス中のタイルを左/右へ移動 |
Super + Ctrl + ↑ / ↓ | 前/次のワークスペースへ切り替え |
Super + Shift + ↑ / ↓ | フォーカス中のウィンドウを前/次のワークスペースへ移動 |
デバッグ
| ショートカット | 動作 |
|---|---|
Super + Shift + F | FPS/フレーム時間オーバーレイの切り替え |
ウィンドウの見た目
各ウィンドウには、アプリアイコン・ウィンドウタイトル・最小化/最大化/閉じるボタンを
備えたタイトルバーが付きます。ボーダーはフォーカス時は金色(#d7ba7d)、それ以外は
グレー(#4f5666)で、角は丸められています。
- ターミナル(kitty・ghostty)は、ソリッドなタイトルバーの代わりに半透明の リキッドグラスなブラー背景になります。
- フルスクリーンのウィンドウは、すべてのクローム(ボーダー・タイトルバー・角丸)を 外して端から端まで描画します。この素の経路により、コンポジターがバッファを直接ディスプレイに 渡せ(ダイレクトスキャンアウト)、テアリングも許可されるため、ゲームで最小のレイテンシに なります。
タイルとワークスペース
ウィンドウ管理は HybridWindowManager が担当し、ワークスペースごとにタイルと フローティングを混在させます。
- ワークスペースはフローティングモードで始まります(ウィンドウは自由に配置でき、
Super+ ドラッグで動かせます)。Super+Sで現在のワークスペースのタイルモードを 切り替えると、ウィンドウが自動的に左右に並びます。 - モニターごとに複数のワークスペースを持ち、
Super+Ctrl+↑/↓で移動、Super+Shift+↑/↓でウィンドウをワークスペース間で移動します。 - 開閉・移動・リサイズ・ワークスペース切り替えにはアニメーションが付きます。
デフォルト設定は、ワークスペースのレイアウトを IPC ソケットで公開しているので、外部の バー(shoji-bar-2)がワークスペースインジケーターを描画したり、変化に反応したりできます。
マルチモニター
デフォルトの output.configure は、コネクタごとにスケールを設定し、すべてのディスプレイを
自動配置で左から右へ拡張します。外部モニターが接続されているとき(ドック構成)は、
ノートPC内蔵パネルをオフにします。
デフォルト設定のコネクタ名(eDP-1・HDMI-A-1・DP-1 など)とスケール値は、メンテナーの
ハードウェアのものです。自分のモニターに合わせてほぼ確実に調整したくなるはずです――
出力(ディスプレイ) を参照してください。
入力
input.configure が適用するデフォルト:
- キーボード —— Caps Lock が Ctrl として機能(
caps:ctrl_modifier)。キーリピートは 毎秒60回、開始遅延250 ms。 - タッチパッド —— タップでクリック、ナチュラルスクロール、2本指スクロール
(係数
0.3)、タイプ中は無効化。 - ポインター —— フラットな加速プロファイル(ポインター加速なし)。
変更方法は 入力デバイス を参照してください。
視覚エフェクト
ext-background-effect-v1プロトコルで要求したクライアント(例: 背後をぼかすよう コンポジターに要求する半透明アプリ)向けに、背景ブラーを提供します。- レイヤーサーフェス(バー・ドック)とレイヤーポップアップ(メニュー)は、その背後が
ぼかされます。ただしサーフェスが
no_blur名前空間でオプトアウトしている場合は除きます。
これらの作り方は エフェクト を参照してください。
起動プログラムと環境変数
起動時にデフォルト設定は次を行います。
- Wayland と fcitx5 入力メソッドのための環境変数を設定します
(
QT_QPA_PLATFORM・QT_IM_MODULEなど)。 - fcitx5(入力メソッド)、shoji-bar-2(シェル)、cliphist クリップボード履歴 ウォッチャーを起動します。
これらは対応するプログラムがインストールされていることを前提とします。別のツールを使う
場合は、設定内の process / env の呼び出しを削除または調整してください――
プロセスと環境変数 を参照。
カスタマイズ
設定は ~/.config/shojiwm/src/index.tsx にあります。編集してリロードすると、ウィンドウ
マネージャの状態(ワークスペース・タイル)はリロードをまたいで保持されます。ここから先、
このセクションの残りのページでは、デフォルト設定が使うすべての API を解説しています。