herbstluftwm - クラウド上のオンライン

プログラム：

NAME

herbstluftwm - X 用の手動タイル ウィンドウ マネージャー

SYNOPSIS

草むら [オプション ...]

DESCRIPTION

を開始します 草むら ウィンドウマネージャーがオンになっている DISPLAY。 また、からの呼び出しもリッスンします。
ハーブストクライアント(1)を実行します。 利用可能なリスト コマンド 以下にリストされています。

オプション することができます：

-c, - 自動スタート パス
つかいます パス のファイルの代わりに自動起動ファイルとして $ XDG_CONFIG_HOME

-v, - バージョン
バージョンを印刷して終了します

-l, --ロックされています
最初に、monitors_locked 設定を 1 に設定します。

-詳細
詳細情報を標準エラー出力に出力します

このマニュアルでは、スクリプトと構成インターフェイスについて説明します。 より詳細に説明するには
はじめに参照 herbstluftwm-チュートリアルとします。

タイリング アルゴリズム

タイリングの基本的な概念は、レイアウトがバイナリ ツリーで表されるということです。 始めるとき
画面全体に XNUMX つの大きなフレームが表示されます。 フレームは次のいずれかを正確に満たします。
次の条件：

1. フレームには窓が含まれています。

いくつかのクライアントを表示して手配します。 現在のレイアウト アルゴリズムは次のとおりです。

・0： 垂直 - クライアントは互いに下に配置されます

・1： 水平な - クライアントは隣り合って配置されます

・2： マックス - すべてのクライアントがこのフレーム内で最大化されます

・3： グリッド - クライアントはほぼ二次グリッドに配置されます

2. フレームはサブフレームに分割されます。

ちょうどXNUMXつに分かれています サブフレーム 構成可能で 分数 縦のどちらかで
または水平方向。 したがって、XNUMX つ生成されます フレーム 同じ条件を満たすもの（新規
フレームには常に含まれようとしています ウィンドウズ）。 すでにフレームを分割した場合
ウィンドウが含まれている場合、そのウィンドウは最初の新しい子フレームに継承されます。

新しいウィンドウが表示されると、そのウィンドウは現在フォーカスされているフレームに配置されます。 の葉だけ
フレームツリーに焦点を当てることができます。

フレームを削除すると、隣接するフレームと結合されます。 レイアウトのせいで
バイナリ ツリーの構造では、各フレーム (つまりバイナリ ツリーのノード) には XNUMX つだけがあります。
隣人。

バイナリ ツリーへの類似性は、小さな例で最もよく説明されています。起動時
クライアントを含めることができる XNUMX つのフレームを持つ単純なバイナリ ツリーがあります。

C

分割するとき（たとえば、コマンドを使用して） split 垂直 0.5) これが得られます:

V
／＼
CC

左側のフレームを水平に分割することもでき、次のようになります。

V
／＼
HC
／＼
CC

フォーカスを右側のクライアントに変更し、このフレームを削除すると、次のようになります。
左側のサブツリーとマージすると、次のようになります。

H
／＼
CC

　 レイアウト このコマンドは、すべてのタグの現在のレイアウトをツリーとして出力します。

FRAME INDEX

レイアウト ツリー内のフレームの正確な位置は、そのフレームによって記述される場合があります。 index どちらである
ただの文字列。 ルックアップ アルゴリズムはルート フレームから開始され、XNUMX つのフレームを選択します。
インデックス内の各文字に基づいて XNUMX つのサブツリーを抽出します。

文字は次のように解釈されます。

· 0: 最初のサブツリーを選択します

· 1: XNUMX 番目のサブツリーを選択します

· .: フォーカスのあるサブツリーを選択します

· /: フォーカスのないサブツリーを選択します

したがって、空の文字列はルート フレームを指し、「00」はそのフレームの最初のサブツリーを指します。
ルートフレームの最初のサブツリー。

特殊な場合として、文字列「@」は常に現在フォーカスされているフレームを参照します。

タグ

タグは、ワークスペース、仮想デスクトップ、またはウィンドウ グループに非常に似ています。 各タグには XNUMX つあります
レイアウト。 タグの一覧があります。 タグを動的に追加または削除できます。

MONITORS

のモニター 草むら 実際の物理画面からは完全に独立しています。 これ
これは、たとえば画面を XNUMX つの仮想モニターに分割して XNUMX つのタグを表示できることを意味します。
一度大きなスクリーンで。

各モニターは、画面上の指定された四角形に XNUMX つのタグだけを表示します。

各モニターには名前が付いている場合があり、次のように設定できます。 追加モニター & モニター名の変更。 それができる
と不安になる モニター名の変更 指示。 モニター名は空ではない任意の文字列です。
+、-、または任意の数字で始めてはなりません。

モニターはさまざまな方法で参照できます。

· にリストされている絶対インデックスによる リストモニター

· 相対インデックスによる: + または - の後にデルタが続きます (例: +3)

· 焦点を合わせたモニターに対する相対位置によって。 -l は、モニターの左側を示します。
フォーカスされたモニター、-r の右、-u の上、-d の下。

· 現在のモニターを表す "" (空の文字列)。

· その名前で。

コマンド

草むら 内部コマンドによって制御され、次の方法で実行できます。 ハーブストクライアント(1)
またはキーバインド経由で。

やめます
herbstluftwm を終了します。

リロード
自動起動ファイルを実行します。

バージョン
実行中の herbstluftwm インスタンスのバージョンを出力します。

エコー [ARGS ...]
与えられたものをすべて印刷します ARGS 単一のスペースとその後の改行で区切られます。

true
すべての引数を無視し、常に成功、つまり 0 を返します。

false
すべての引数を無視し、常に失敗、つまり 1 を返します。

リストコマンド
使用可能なすべてのコマンドをリストします。

リストモニター
現在構成されているモニターをインデックス、エリア (四角形として)、名前 (場合によっては) とともにリスト表示します。
という名前）と現在表示されているタグ。

リストルール
すべてのアクティブなルールをリストします。 各行は、ルールが呼び出されたすべてのパラメータで構成されます。
とそのラベルをタブで区切って表示します。

リストキーバインド
すべてのバインドされたキーとそれに関連付けられたコマンドをリストします。 各行は XNUMX つのキーで構成されます
組み合わせとコマンドとそのパラメータをタブで区切って指定します。

警告
コマンドパラメータ内のタブはエスケープされません。

ロック
増加します モニターロック済み 設定。 マルチウィンドウを行いたい場合はこれを使用してください
アクションを一度に実行します (つまり、単一のステップ間で再描画する必要はありません)。 以下も参照してください。 アンロック

アンロック
を減少させます モニターロック済み 設定。もし モニターロック済み 0に変更され、その後すべて
モニターも再塗装。 以下も参照してください。 ロック

キーバインド キー COMMAND [ARGS ...]
キーバインドを追加します。 いつ キー が押されると、内部 COMMAND （その ARGS）であり、
実行されました。 キー バインディングは、修飾子の (空の場合もある) リスト (Mod1、Mod2、Mod3、
Mod4、Mod5、Alt、Super、Control/Ctrl、Shift）および XNUMX つのキー（リストについては、keysymdef.h を参照）
キーの数）。 修飾子とキーは次のように連結されます。 - or + セパレータとして。 もしあるなら
すでにこれのバインディングです キー、上書きされます。 例:

· キーバインド Mod4+Ctrl+q 終了

· キーバインド Mod1-i で always_show_frame を切り替えます

· キーバインド Mod1-Shift-スペースcycle_layout -1

キーアンバインド キー|-F|- すべて
のキーバインドを削除します キー。 の構文 キー で定義されています キーバインド。 場合 -F or
- すべて を指定すると、すべてのキー バインドが削除されます。

マウスバインド ボタン ACTION [COMMAND ...]
フローティング モード用のマウス バインドを追加します。 いつ ボタン を押すと、指定した
ACTION 実行されます。 ボタン と似た構文があります キー キーバインドの引数:
これは修飾子のリストで構成されます (で区切られています) - or +、有効な修飾子は次のとおりです。
の説明 キーバインド) およびボタン名は XNUMX つだけです。

・B1またはボタン1

・B2またはボタン2

・B3またはボタン3

・B4またはボタン4

・B5またはボタン5

ACTION 次のアクションのいずれかである必要があります。

・move: カーソルをドラッグしてウィンドウを移動します。

· サイズ変更: 角をドラッグしてウィンドウのサイズを変更します。

· ズーム: ウィンドウの中心を維持したまま、ウィンドウのサイズを XNUMX 方向すべてに変更します。
ウィンドウ定数。

· call: 指定されたもののみを呼び出します COMMAND client.dragg はクライアントへのリンクをオンにします
これ ボタン 実行されました。

一方、 ACTION client.dragged はドラッグされるクライアントです。 例えば：

· マウスバインド Mod1-Button3 ズーム

· Mousebind Mod1-B4 呼び出し代替 WID clients.dragged.winid spawn transset-df
--inc -i WID 0.05

· Mousebind Mod1-B5 呼び出し代替 WID clients.dragged.winid spawn transset-df
--dec -i WID -m 0.2 0.05

マウスバインド解除
すべてのマウス バインドを削除します。

スポーン 実行可能 [ARGS ...]
をスポーンします 実行可能 そのと ARGS。 詳細については、を参照してください man 3 execvp。 例：

· spawn xterm -e man 3 execvp

wmexec [ウィンドウマネージャー [ARGS ...]]
を実行します ウィンドウマネージャー そのと ARGS。 これはウィンドウマネージャーを切り替えるのに便利です
セッションを再起動せずに、実行中のセッションで。 「いいえ」または無効な場合
ウィンドウマネージャー が与えられると、herbstluftwm が再起動されます。 詳細については、を参照してください man 3 execvp.
例：

· wmexec オープンボックス

チェーン セパレーター [コマンド ...]
チェーンは セパレーター とのリスト コマンド 引数付き。 コマンドは次のことを行う必要があります。
指定された間隔で区切られる セパレーターを選択します。 セパレーター どんな言葉でもできる、そしてそれだけが
完全に一致する場合、コマンド間の区切り文字として認識されます。 セパレーター。 "鎖"
すべてのコマンドの追加出力を出力し、最後のコマンドの終了コードを返します。
実行されたコマンド。 例は次のとおりです。

· 「foo」というタグを作成し、それを直接使用します。

チェーン、 foo を追加、 foo を使用

· レイアウトを時計回りに回転します。

鎖 。-。 ロック 。-。 回転させます。 回転させます。 回転させます。 ロックを解除する

反例は次のとおりです。

· これにより、「foo」というタグのみが作成されます。

chain 、 foo を追加、 foo を使用

・区切り文字「。」 定義されていますが、「,」が使用されています。

鎖 。 foo を追加し、 foo を使用します

& セパレーター [コマンド ...]
「and」はチェーンコマンドのように動作しますが、指定されたコマンドのみを実行します。 コマンド while
コマンドは終了コード 0 を返します。

or セパレーター [コマンド ...]
「or」はチェーンコマンドのように動作しますが、指定されたコマンドのみを実行します。 コマンド XNUMXつまで
コマンドは終了コード 0 を返します。

! COMMAND
「！」 提供されたコマンドを実行しますが、その戻り値は反転されます。 提供されている場合は、
コマンドはゼロ以外の「!」を返します。 コマンドがゼロを返す場合、「!」は 0 を返します。 戻り値
1。

試します COMMAND
「try」は指定されたコマンドを実行し、その出力を出力しますが、常に成功を返します。
つまり0。

サイレント COMMAND
「silent」は、指定されたコマンドを実行しますが、その出力を破棄し、そのコマンドのみを返します。
終了コード。

フォーカス_nth INDEX
フレーム内の n 番目のウィンドウにフォーカスします。 最初のウィンドウには、 INDEX 0。 もし INDEX 負です
最後のウィンドウ インデックスよりも大きい場合は、最後のウィンドウがフォーカスされます。

サイクル [DELTA]
現在のフレーム内の選択範囲を循環します。 DELTA。 場合 DELTA 省略、 DELTA = 1
使用されます。 DELTA 負の場合もあります。 DELTA = -1 は、逆のサイクルを意味します。
1による方向。

サイクルオール [--スキップ-不可視] [方向]
現在のタグのすべてのウィンドウとフレームを循環します。 方向 = 1 は、
フォワード、 方向 = -1 は逆方向を意味し、 方向 = 0 は効果がありません。 方向
デフォルトは 1 です。フレーム内に複数のウィンドウがある場合、次のように動作します。
　 サイクル 指示。 ( サイクルオール コマンドは次/前の休暇に焦点を当てます。
レイアウト 木。）。 もし --スキップ-不可視 が与えられた場合、これは表示されているすべての項目を循環するだけです
最大レイアウトで非表示のウィンドウをスキップします。 フォーカスされたウィンドウが表示されます。

サイクルフレーム [方向]
現在のタグのすべてのフレームを循環します。 方向 = 1 は前進を意味し、 方向
= -1 は逆方向を意味し、 方向 = 0 は効果がありません。 方向 デフォルトは1です。

サイクルレイアウト [DELTA [レイアウト ...]]
現在のフレーム内のレイアウト アルゴリズムを次のように循環させます。 DELTA. DELTA デフォルトは 1 です。
上記のレイアウト アルゴリズムのリストをご覧ください。 のリストであれば、 レイアウト 与えられる、
cycle_layout は、デフォルトのレイアウト アルゴリズム リストの代わりにこれらを循環します。
各レイアウト名は最大 XNUMX 回出現する必要があります。 例：

· サイクルレイアウト -1

·cycle_layout 1 つの垂直グリッド

セットレイアウト レイアウト
現在のフレームのレイアウト アルゴリズムを次のように設定します。 レイアウト。 レイアウトのリストについては、
上記のレイアウト アルゴリズムのリストを確認してください。

閉じる WINID
指定されたウィンドウを正常に閉じるか、何も指定されていない場合はフォーカスされたウィンドウを閉じます。
明示的に。 特定のウィンドウを参照する方法については、WINDOW IDS のセクションを参照してください。

閉じるか削除する
フォーカスされているウィンドウを閉じるか、フォーカスされているウィンドウがない場合は現在のフレームを削除します。

閉じて削除
他のウィンドウが存在しない場合は、フォーカスされたウィンドウを閉じ、現在のフレームを削除します。
その枠の中で。

split アライメント [分数]
フォーカスされたフレームを指定された XNUMX つのサブフレームに分割します。 分数 0と1間
デフォルトは 0.5 です。 アライメント の一つである

· top

· ボトム (= 垂直)

· 左,

· 右 (= 水平な)

· 爆発する

· オート (最長辺に沿って分割)

分割後に XNUMX つの半分のどちらが空になるかを指定します。 残りの半分
現在フォーカスされているフレームが占有します。 分割後は、もともと
focuse フレームはフォーカスされたままになります。 特別なXNUMXつ アライメント モードは 爆発する、分割
ウィンドウのサイズと位置ができるだけ維持されるようにフレームを調整します。
可能。 いいえの場合 分数 に与えられる 爆発する 最適な部分が選択されるモード
自動的に。 例：

・スプリットエクスプロージョン

・割底0.5

· 水平分割 0.3

・縦分割0.5

・スプリットh

集中 [-i|-e] 方向
現在のフレームから次のフレームまたはクライアントにフォーカスを移動します。 方向 どちらである
に：

・ 左]

・ 右]

・ 上]

・ 下]

If -i (internal) が指定されているか、default_direction_external_only が設定されていない場合、次の
クライアントの 方向 同じフレーム内に入れることもできます。 中にクライアントがいない場合
このフレームか -e (外部) が与えられた場合、指定された次のフレーム 方向 意志
集中してください。

フレーム間の方向は次のように定義されます。 焦点はフレームの葉にあります。
二分木。 ツリー内の各内部ノードは、最後のフォーカス方向 (子 0) を記憶しています。
または子供1）。 このアルゴリズムでは、リーフからの可能な限り最短の方法が使用されます (現在、
指定したフレームでフォーカスを変更できるようになるまで、フォーカスされたフレーム) をルートに移動します。
方向。 そこから焦点は葉に戻ります。

例：フォーカスはフレームAにあります。 フォーカス 右 フォーカスはフレームにあります
C.

ツリー: V,0 画面: ┌────┐┌────┐ (前)
╱ ╲ │ B ││ C │
╱ ╲ ━━━━┘━━━━┘
H,1 H,0 ┌─────┐┌─────┐
╱ ╲ ╱ ╲ │ A* ││ D │
A* BCD └─────┘ └─────┘

ツリー: V,0 スクリーン: ┌─────┐┌─────┐ (右フォーカス後)
╱ ╲ │ B ││ C* │
╱ ╲ ━━━━┘━━━━┘
H,1 H,0 ┌─────┐┌─────┐
╱ ╲ ╱ ╲ │ A ││ D │
ABC* D └─────┘ └─────┘

現在フォーカスされているクライアントがフローティングの場合、次のフローティング ウィンドウが
指定した方向にフォーカスして浮き上がります。

If focus_crosses_monitor_boundaries が設定されており、クライアントまたはフレームが見つかりません。
指定の 方向、その中の次のモニター 方向 焦点を当てています。

フォーカスエッジ [-i|-e] 方向
指定されたタグの端にウィンドウをフォーカスします。 方向を選択します。 道順
& -e で指定されたとおりに動作します フォーカス

If -i (internal) が指定されているか、default_direction_external_only が設定されていない場合、ウィンドウは
タグの端にある がフォーカスされます。 それ以外の場合は、タグの端のフレームのみ
がフォーカスされ、そのフレーム内で最後にフォーカスされていたウィンドウがフォーカスされます。

上げる WINID
指定されたウィンドウを表示します。 参照方法については、WINDOW IDS のセクションを参照してください。
とある窓。 その結果はフローティング モードでのみ表示されます。

先端
　 WINID アンマネージ ウィンドウを指定することもできますが、レイズのための完了は
このコマンドは、管理対象外のウィンドウの ID をリストしません。

ジャンプする WINID
指定されたウィンドウにフォーカスを置きます。 方法については、WINDOW IDS のセクションを参照してください。
特定のウィンドウを参照します。

持って来る WINID
指定されたウィンドウを現在のフレームに移動し、フォーカスします。 のセクションを参照してください。
特定のウィンドウを参照する方法に関する WINDOW IDS。

リサイズ 方向 分数デルタ
指定された次の分数を変更します 方向 by 分数デルタ. 方向 振る舞う
で指定されているように、 フォーカス 指示。 記号を省略してはいけません - or +、なぜなら
将来のバージョンでは、記号を省略した場合の動作が変わる可能性があります。 例：

・右サイズ変更+0.05

· サイズダウン -0.1

シフトエッジ [-i|-e] 方向
フォーカスされたウィンドウを指定されたタグの端に移動します。 方向を選択します。
道順 で指定されたとおりに動作します フォーカス コマンドと -i & -e 指定されたとおりに動作する
フォーカスエッジ

シフト [-i|-e] 方向
フォーカスされたウィンドウを指定されたフレームの次のフレームに移動します。 方向を選択します。 道順
& -i|-e で指定されたとおりに動作します フォーカス 指示。 フォーカスされたクライアントがフローティングの場合
タイル化される代わりに、クライアントは次のウィンドウまたは画面の端に移動します。

シフト・トゥ・モニター MONITOR
フォーカスされたウィンドウを指定されたタグに移動します。 MONITOR.

削除します
フォーカスされたフレームを削除し、そのウィンドウを隣接するフレームにマージします。

回転させる
フォーカスされているタグのレイアウトを反時計回りに 90 度回転します。 これだけ
フレームの内容ではなく、フレームの配置を操作します。

セッションに NAME VALUE
指定した設定を行います NAME 〜へ VALUE。 すべて SETTINGS セクションに記載されています
を参照してください。

取得する NAME
設定値を出力します NAME。 すべて SETTINGS 以下のセクションにリストされています。

トグル NAME
設定を切り替えます NAME 整数設定の場合: その値が 0 に等しくない場合、
0になります。 それ以外の場合は、以前の値 (0 に等しくない) が復元されます。

サイクル値 NAME VALUES ...
設定のサイクル値 NAME 　 VALUES: つまり、最初に出現したものを検索します
現在の値の VALUES そして、値をリスト内の次の値または
最後に到達したか、現在の値が見つからなかった場合は最初の XNUMX つ。 例：

· サイクル値フレームギャップ 0 5 10 15

·cycle_valueframe_bg_normal_color赤緑青

サイクルモニター [DELTA]
サイクルモニターに焦点を当てたもの DELTA. DELTA デフォルトは1です。

フォーカスモニター MONITOR
指定されたモニターにフォーカスを置きます。

加えます TAG
という名前の新しい空のタグを作成します。 TAG.

つかいます TAG
フォーカスしているモニターを指定したモニターに切り替えます TAG.

use_index INDEX [--skip-visible]
フォーカスしているモニターを TAG 指定された INDEX。 場合 INDEX で始まる
+ または - の場合 INDEX 現在を基準にして扱われます TAG。 場合 --skip-visible 合格
& INDEX が相対的な場合、モニター上にすでに表示されているタグはスキップされます。
たとえば、これはタグを逆方向に循環します。

· use_index -1 --skip-visible

use_previous
フォーカスされているモニターを以前に表示したタグに切り替えます。

マージタグ TAG [TARGET]
という名前のタグを削除します TAG すべてのウィンドウをタグに移動します TARGET。 場合 TARGET 省略、
フォーカスされたタグが使用されます。

リネーム 古いタグ ニュータグ
という名前のタグの名前を変更します 古いタグ 〜へ ニュータグ.

TAG
フォーカスされたウィンドウを という名前のタグに移動します TAG.

移動インデックス INDEX [--skip-visible]
フォーカスされたウィンドウを、指定されたタグに移動します。 INDEX。 の議論に類似
use_index：もし INDEX + または - で始まる場合、相対的に扱われます。 もし --skip-visible
相対インデックスを使用して渡されると、すでに表示されているタグはスキップされます。

ロックタグ [MONITOR]
指定したモニターのタグ切り替えをロックします。 引数が指定されていない場合、
現在フォーカスされているモニターが使用されます。 モニターのタグスイッチングが無効になっている場合、
コマンド つかいます & use_index そこで実行されても効果はありません。 いつ
swap_monitors_to_get_tag が有効になり、ロックされた場所にあるタグに切り替わります
モニターを選択すると、そこからモニターを盗むのではなく、そのモニターに切り替えます。 ロック状態は、
モニターには「[LOCKED]」と表示されます。 リストモニター 出力。

ロック解除タグ [MONITOR]
指定されたモニターでタグの切り替えを再度有効にします。 引数が指定されていない場合、
現在フォーカスされているモニターが使用されます。 これは逆の操作です ロックタグ としている
このロックを削除する以外に副作用はありません。

disjoin_rects レクト ...
長方形のリストを取得し、すべての長方形が揃うまでそれらを小さな部分に分割します。
互いに素である場合、結果の四角形は行ごとに出力されます。 このコマンドは、
現在のモニターのリストを変更してください。 したがって、これは
set_monitors コマンド。

· たとえば、 disjoin_rects 600x400+0+0 600x400+300+250 はこれを出力します:

300×150+300+250
600×250+0+0
300×150+0+250
300×150+600+250
600×250+300+400

· 上記の例では、5 つのモニターが XNUMX つのモニターに分割されています。
手段：

┌──────┐ ┌──────┐
│ │ └─────┘
│ ┌───┼───┐ ┌─┐┌──┐┌─┐
│ │ │ │ バラバラ │ ││ ││ │
━━━┼───┘ │ ─────> └─┘└───┘└──┘
│ │ ┌──────┐
━━━━━┘ ━━━━━┘

セットモニター レクト ...
モニターのリストを設定します 正確に 指定された四角形のリストに変換します。

· i 番目の既存のモニターが i 番目の指定されたモニターに移動されます レクト

· さらに多くのモニターがある場合は、新しいモニターが作成されます レクト それから監視します

· さらに多くのモニターがある場合、既存のモニターは削除されます。 レクト

検出モニター -l|- リスト|--非結合
モニターのリストを使用可能な Xinerama モニターに設定します。 シネラマなら
拡張子が見つからない場合は、画面全体で XNUMX つのモニターにフォールバックされます。 もし
検出されたモニターが重複している場合は、互いに素な複数のモニターに分割されます。
ただし、disjoin_rects を使用して同じ領域をカバーします。

If -l or - リスト が渡されると、検出された物理モニターの四角形のリストは次のようになります。
印刷された。 したがって、 hc detect_monitors は bash コマンド hc set_monitors $(hc
disjoin_rects $(hc detect_monitors -l))。

追加モニター レクト [TAG [NAME]]
指定された四角形にモニターを追加します レクト と表示 TAG その上に。 TAG 現在
他のモニターには表示しないでください。 レクト 次の形式の文字列です 幅×高さ±X±Y。 場合
いいえ、または空です TAG が与えられると、任意の空きタグが選択されます。 もし NAME 与えられています、あなた
インデックスを使用する代わりに、名前でこのモニターを参照できます。 例：

· add_monitor 1024x768-20+0 mynewtag main

モニターの削除 MONITOR
指定されたモニターを削除します。

移動モニター MONITOR レクト [パダップ [パドライト [パッドダウン [パドレフト]]]]
指定されたモニターを四角形に移動します レクト. レクト は次のように定義されます 追加モニター。 場合
no または空のパッドが指定された場合、変更されません。

raise_monitor [MONITOR]
指定されたモニターまたは現在のモニターを起動します。 MONITOR 省略されます。

モニター名の変更 MONITOR NAME
既存のモニターの名前を(変更)します。 もし NAME が空の場合、モニターが削除されます。
名前。

スタック
表示されているタグとそのレイヤーを含むモニターのスタックをツリーとして印刷します。 の
印刷されたスタックの順序は上から下です。 スタイルは次のように構成されます。 ツリースタイル
設定。

モニター_rect [[-p] MONITOR]
指定されたモニターの四角形を次の形式で印刷します。 X Y W H ない場合 MONITOR or
尻 が与えられると、現在のモニターが使用されます。 もし -p 供給された場合、残りは
このモニターの周りのパッドのない四角形が印刷されます。

パッド MONITOR [パダップ [パドライト [パッドダウン [パドレフト]]]]
指定されたモニターのパッドを指定されたパディングに設定します。 パディングがないか空の場合
与えられても変更されません。

リストパディング [MONITOR]
指定されたモニターのパディングをリストします。存在しない場合は、現在フォーカスされているモニターをリストします。
モニターが与えられます。

レイアウト [TAG [INDEX]]
フレームのレイアウトを印刷します INDEX on TAG、素敵なツリースタイルで。 そのスタイルは、
によって定義されます ツリースタイル 設定。 いいえの場合 TAG が与えられると、現在のタグが使用されます。 いいえの場合
INDEX が与えられた場合、ルートフレームが使用されます。 指定します INDEX 指定せずに TAG （すなわち、
現在のタグを使用)、空の文字列を次のように渡します TAG.

出力例は次のとおりです。

╾─┐ 横50%選択=1
§─╼縦：0xe00009
└─┐ 縦50%選択=0
§─╼ 縦: 0xa00009 [フォーカス]
└─╼縦：0x1000009

ごみ [TAG [INDEX]]
と同じ情報を出力します。 レイアウト コマンドですが、機械可読形式です。
その出力は次のコマンドで読み取ることができます。 負荷

出力例 (後でフォーマットされる) は次のとおりです。

(水平分割:0.500000:1
(垂直クライアント:0 0xe00009)
(垂直分割:0.500000:1
(垂直クライアント:0 0xa00009)
(垂直クライアント:0 0x1000009)))

負荷 [TAG] レイアウト
指定されたものをロードします レイアウト 指定された説明 TAG ない場合は現在のタグ TAG 与えられます。

あぶない
レイアウト はまさに XNUMX つのパラメータです。 シェルから手動で呼び出している場合、または
スクリプトから、適切に引用してください。

コンプリート POSITION [COMMAND ARGS ...]
部分的なタブ補完の結果を出力します。 COMMAND オプション付き ARGS。 あなた
bash にはすでにタブ補完があるため、通常これは必要ありません。 例：

・完全0m

m で始まるすべてのコマンドを出力します

· 1 つのトグルフラを完了

切り替え可能な fra で始まるすべての設定を出力します

完全なシェル POSITION [COMMAND ARGS ...]
次のように動作します コンプリート 以下の追加機能があり、posix での完了に役立ちます
シェル:

· エスケープ シーケンスは削除されます。 COMMAND & ARGS.

· 各完全補完結果にはスペースが追加されます。

· 特殊文字は出力でエスケープされます。

エミットフック ARGS ...
アイドル状態のすべての Herbstclient にカスタム フックを発行します。

タグステータス [MONITOR]
指定されたすべてのタグのタブ区切りリストを出力します。 MONITOR 索引。 いいえの場合 MONITOR
インデックスが指定されている場合は、フォーカスされたモニターが使用されます。 各タグ名には XNUMX つの文字が接頭辞として付けられます。
これはその状態を示します。

· . タグが空です

· : タグが空ではありません

· + タグは指定された場所で表示されます MONITOR, しかし、このモニターには焦点が合っていません。

· # タグは指定された場所で表示されます MONITOR そして集中しているのです。

· - タグは別の場所で表示されます MONITOR, しかし、このモニターには焦点が合っていません。

· % タグは別の場所で表示されます MONITOR そして集中しているのです。

· ! タグには緊急ウィンドウが含まれています

警告
タグ名のいずれかでタブを使用している場合、tag_status はおそらくまったく役に立ちません。
あなたのために。

浮遊[[TAG] on|オフ|トグル|status]
現在のタグを指定されたフローティング/タイリング モードに変更します。 TAG または現在のものを印刷します
状態。 いいえの場合 TAG が与えられると、現在のタグが使用されます。 引数が指定されていない場合は、浮動小数点数
モードが切り替わります。 もし status 与えられた後 on or オフ に応じて印刷されます。
浮遊状態 TAG.

ルール [[ - ]FLAG|[--]LABEL|[--]調子|[--]結果 ...]
すべての新しいクライアントに適用されるルールを定義します。 その動作については、
　 RULES .

ルールを解除する LABEL|- すべて|-F
という名前のルールをすべて削除します LABEL。 --all または -F を渡すと、すべてのルールが削除されます。

全画面表示 [on|オフ|トグル]
フォーカスされているクライアントの全画面状態を設定または切り替えます。 引数が指定されていない場合、
全画面モードが切り替わります。

擬似タイル [on|オフ|トグル]
フォーカスされたクライアントの擬似タイル状態を設定または切り替えます。 クライアントが
擬似タイル化され、タイリング モードではクライアントは移動されるだけでサイズ変更されません - クライアント
サイズは浮動サイズのままになります。 クライアントのサイズを変更する唯一の理由は、
それがタイルに収まることを確認します。 引数が指定されていない場合、擬似タイル モードが切り替わります。

オブジェクトツリー [パス]
オブジェクトのツリーを出力します。 オブジェクトパスの場合 パス サブツリーのみが与えられます
始まる パス と印刷されています。 を参照してください。 OBJECTS のガイドをご参照ください。

属性 [パス [新しい価値]
によってアドレス指定された指定されたオブジェクトの子と属性を出力します。 パス。 場合 パス is
属性を指定し、その属性値を出力します。 もし 新しい価値 与えられる、割り当てる 新しい価値 〜へ
によって与えられる属性 パス。 見る OBJECTS のガイドをご参照ください。

get_attr 属性
指定された値を出力します 属性 で説明されているように OBJECTS .

セット属性 属性 新しい価値
割り当てます 新しい価値 指定する 属性 で説明されているように OBJECTS .

新しい属性 [ブール|カラー|int型|文字列|uint] パス
で指定されたオブジェクト内に、名前を持つ新しい属性を作成します。 パス。 その種類は
最初の引数で指定します。 属性名は my_ で始まる必要があります。

削除属性 パス
ユーザー定義の属性を削除します パス.

代替 識別子 属性 COMMAND [ARGS ...]
正確に出現するものをすべて置き換えます。 識別子 in COMMAND とその ARGS の値によって
　 属性。 なお、 COMMAND 場合は属性値にも置き換えられます。
等しい 識別子。 置換されたコマンドとその引数が実行されます。 例：

· MYTITLE を client.focus.title echo MYTITLE に置き換えます

現在フォーカスされているウィンドウのタイトルを印刷します。

スプリント 識別子 FORMAT [ATTRIBUTES ...] COMMAND [ARGS ...]
正確に出現するものをすべて置き換えます。 識別子 in COMMAND とその ARGS 文字列によって
によって指定された FORMAT。 各 %s の FORMAT は次の属性の値を表します
ATTRIBUTESに似ています printf(1) コマンド。 置き換えられたコマンドとその引数
その後実行されます。 例:

· sprintf STR title=%s client.focus.title echo STR

現在フォーカスされているウィンドウのタイトルを先頭に title= を付けて出力します。

· sprintf X tag=%s tags.focus.name ルール XNUMX 回 X

次に表示されるクライアントを、現在フォーカスされているタグに移動します。

· sprintf X %s/%s tags.focus.index tags.count echo X

どのタグがフォーカスされているか、およびタグがいくつあるかを示します

· sprintf l somelongstring echo lll

長い文字列をスペースで区切って XNUMX 回出力します。

mktemp [ブール|int型|文字列|uint] 識別子 COMMAND [ARGS ...]
指定されたタイプの一時属性を作成し、出現するすべての属性を置き換えます。
識別子 in COMMAND & ARGS by 一時属性のパスによって。 交換されたのは
コマンドとその引数が実行されます。 の終了ステータス COMMAND 返されます。

比較します 属性 オペレーター VALUE
の値を比較します 属性 　 VALUE 比較メソッドを使用して オペレーター。 場合
比較が成功すると 0 が返され、それ以外の場合は 1 が返されます。演算子は次のとおりです。

· =: 属性の値は等しい VALUE

· !=: 属性の値が等しくない VALUE

· le: 属性の値 <= VALUE

· lt: 属性の値 VALUE

· ge: 属性の値 >= VALUE

· gt: 属性の値 > VALUE

　 オペレーター le,lt,ge,gt 以下の場合にのみ使用できます 属性 整数型であるか、
符号なし整数。 最初のパラメータは常に属性でなければならないことに注意してください。
XNUMX 番目は定数値です。 XNUMX つの属性を比較する場合は、置換を使用します。
コマンド：

FC tags.focus.frame_count \ を置き換えます
tags.focus.client_count gt FC を比較します。

フォーカスされたタグにフレームよりも多くのクライアントが存在する場合、成功を返します。

ゲテンブ NAME
環境変数の値を取得します NAME.

設定環境 NAME VALUE
環境変数の値を設定する NAME 〜へ VALUE.

設定解除 NAME
環境変数の設定を解除します NAME.

SETTINGS

設定は、herbstluftwm の動作を構成し、 セッションに, 取得する
& トグル コマンド。 設定には、文字列と整数値の XNUMX 種類があります。 アン
その値が 1 または 0 に等しくない別の値の場合、整数値が設定されます。整数値は
値が 0 の場合は設定解除されます。

フレームギャップ (整数)
タイリングモードにおけるフレーム間のギャップ。

Frame_padding (整数)
タイリング モードでのフレーム内のパディング、つまりフレームの境界間のスペース
フレームとその中の窓。

window_gap (整数)
タイリングモードにおけるXNUMXフレーム内のウィンドウ間の隙間。

スナップ距離 (整数)
クライアントがフローティング モードでドラッグされている場合、クライアントは隣接するクライアントにスナップします。
それらの間の距離は snap_ distance よりも小さいです。

snap_gap (整数)
ドラッグされたクライアントがフローティング モードでエッジにスナップする場合の残りのギャップを指定します。 もし
snap_gap が 0 に設定されている場合、ギャップは残りません。

Mouse_recenter_gap (整数)
モニター周囲の隙間を指定します。 モニターが選択されている場合とマウスの位置
この隙間に復元されると、モニターの中央に設定されます。 これは
マウスの移動によってモニターから離れたが、キーボードによって再選択された場合に便利です。
ギャップが 0 (デフォルト) の場合、マウスは再センタリングされません。

Frame_border_active_color (文字列/色)
フォーカスされたフレームの境界線の色。

Frame_border_normal_color (文字列/色)
フォーカスの合っていないフレームの境界線の色。

Frame_border_inner_color (文字列/色)
フレームの内側の境界線の色。

Frame_bg_active_color (文字列/色)
フォーカスされたフレームの塗りつぶしの色。

Frame_bg_normal_color (文字列/色)
フォーカスされていないフレームの塗りつぶしの色 (always_show_frame が設定されている場合にのみ表示されます)。

Frame_bg_transparent (整数)
設定すると、フレームの背景が透明になります。 つまり長方形が切り取られるということです
内側からフレームの境界線と幅のストライプのみになるようにします
フレーム透明幅 見られます。 使用 フレームアクティブ不透明度 & フレーム_通常_不透明度
本当の透明性を実現します。

Frame_transparent_width (整数)
で色付けされた残りのフレームの幅を指定します フレームbg_active_color if
フレーム_bg_透明 設定されています。

Frame_border_width (整数)
フレームの境界線の幅。

Frame_border_inner_width (整数)
フレームの内側の境界線の幅。 Frame_border_width より小さくなければなりません。
フレーム境界線の幅に追加されるわけではありませんが、フレーム境界線の幅の一部です。

focus_crosses_monitor_boundaries (整数)
設定されている場合、focus コマンドはモニターの境界を越えます。 クライアントがいない場合は、
フォーカス方向を指定すると、指定した方向のモニターにフォーカスが合います。

raise_on_focus (整数)
設定すると、フォーカスがある場合にウィンドウが表示されます。 この設定の値は次の場合にのみ使用されます。
フローティングモード。

raise_on_focus_temporarily (整数)
設定すると、タグにフォーカスされている場合にウィンドウが一時的に表示されます。 一時的に入っています
この場合は、次の場合にウィンドウが前のスタック位置に戻ることを意味します。
別のウィンドウがフォーカスされています。

raise_on_click (整数)
設定すると、クリックするとウィンドウが表示されます。 この設定の値のみが注目されます
フローティングモードで。

window_border_width (整数)
ウィンドウの境界線の幅。

window_border_inner_width (整数)
ウィンドウの内側の境界線の幅。 window_border_width より小さい必要があります。
これはウィンドウの境界線の幅に追加されるのではなく、その一部であるためです。

window_border_active_color (文字列/色)
フォーカスされたウィンドウの境界線の色。

window_border_normal_color (文字列/色)
フォーカスのないウィンドウの境界線の色。

window_border_urgent_color (文字列/色)
焦点が合っていないが緊急を要するウィンドウの境界線の色。

window_border_inner_color (文字列/色)
ウィンドウの内側の境界線の色。

always_show_frame (整数)
設定すると、すべてのフレームが表示されます。 設定されていない場合、フォーカスのあるフレームまたはウィンドウが含まれるフレームのみが表示されます。
表示されます。

Frame_active_opacity (整数)
フォーカスされたフレームの不透明度 (パーセント)。 実行中の合成マネージャーが取得する必要があります
実際の効果。

Frame_normal_opacity (整数)
フォーカスされていないフレームの不透明度 (パーセント)。 実行中の合成マネージャーが取得する必要があります
実際の効果。

default_frame_layout (整数)
フレーム レイアウトのインデックス。新しいフレームが (分割または分割によって) 作成される場合に使用されます。
新しいタグ）。 有効なインデックスとその意味のリストについては、レイアウトのリストを確認してください。
上記のアルゴリズム。

デフォルトの方向_外部のみ (整数)
この設定は、フォーカスとシフトの動作を制御します (そうでない場合)。 -e or -i 引数は
与えられた。 設定されている場合、他のフレームがある場合でも、フォーカスとシフトによりフォーカスされたフレームが変更されます。
指定されたフレーム内のクライアント 方向。 それ以外の場合、現在のフレーム内のクライアント
指定された範囲内にある場合に選択されます 方向.

ギャップレスグリッド (整数)
この設定は、グリッドによって配置されたフレーム内の最後のクライアントのサイズに影響します。
レイアウト。 設定すると、最後のクライアントが常にこのフレーム内のギャップを埋めます。 未設定の場合、
この場合、最後のクライアントのサイズは、このフレーム内の他のすべてのクライアントと同じになります。

スマートフレーム周囲 (整数)
設定すると、フレームの境界線とギャップは、曖昧さがない場合に削除されます。
集中したフレーム。

スマートウィンドウ周囲 (整数)
設定すると、ウィンドウの境界線と隙間が削除され、曖昧さがなくなると最小限になります。
フォーカスされたウィンドウについて。 この最小限のウィンドウ装飾は、
テーマ.ミニマルオブジェクト。

focus_follows_mouse (整数)
設定されており、マウス カーソルによってウィンドウがフォーカスされている場合、このウィンドウもフォーカスされます (この機能
ずさんなフォーカスとも呼ばれます)。 設定されていない場合は、クリックしてウィンドウのフォーカスを変更する必要があります
マウスで。

フォーカスの変更によって別のウィンドウが非表示になった場合 (たとえば、疑似タイル化されたウィンドウがある場合)
最大レイアウトの場合)、フォーカスを変更するには追加のクリックが必要です。

focus_stealing_prevention (整数)
設定すると、ページャーとタスクバーのみがフォーカスを変更できます。 未設定の場合はすべて
アプリケーションはフォーカスの変更を要求できます。

モニターロック (整数)
0 より大きい場合、すべてのモニター上のクライアントは移動またはサイズ変更されません。
0 に設定すると、モニターの配置が再び有効になり、すべてのモニターが
その間に内容が変更された場合は再配置されます。 変えるべきではない
この設定は同時実行の問題により手動で行われます。 コマンドを使用する ロック & アンロック
を代わりにお使いください。

swap_monitors_to_get_tag (整数)
設定した場合: すでに別のモニターで表示されているタグを表示したい場合は、
モニターの内容が交換され、フォーカスされたモニターに必要なタグが表示されます。 もし
設定されていない場合、目的のタグが表示されている場合は、他のモニターがフォーカスされます。

auto_detect_monitors (整数)
設定すると、モニターが接続されるたびに detect_monitors が自動的に実行されます。
切断されているか、サイズが変更されています。

ツリースタイル (文字列)
これには、適切な ASCII ツリーを出力するために使用される文字が含まれています。 を含む必要があります
少なくとも 8 文字。 例: X|:#+*-。 次のようなツリーが生成されます。

X-.root
#-。 子0
| #-* 子01
| +-*子02
+-。 子供1
: #-* 子10
：+-*子01

有用な値 ツリースタイル は: ╾│ § └╼─┐ または -| |'--。 または╾│ §╰╼─╮。

wmname (文字列)
これは、ルート ウィンドウの _NET_WM_NAME プロパティの値を制御します。
実行中のウィンドウマネージャーの名前。 次の場合、この設定の値は更新されません。
ルート ウィンドウ上の実際の _NET_WM_NAME プロパティは外部から変更されます。 例
使用法：

·cycle_value wmname herbstluftwm LG3D

pseudotile_center_threshold (Int)
0 より大きい場合、中心の擬似タイル間の最小距離を指定します。
ウィンドウと、そのウィンドウが割り当てられているフレームまたはタイルの境界線。 この距離なら
より低い pseudotile_center_threshold、クライアントの左上に揃えられます。
タイル。

update_dragged_clients (整数)
設定されている場合、クライアントのウィンドウ コンテンツは、
ねずみ。 設定されていない場合、マウス ボタンを放した後にクライアントのコンテンツのサイズが変更されます。

RULES

ルールは、特定のクライアントが表示されたときに、そのクライアントのデフォルトのプロパティを変更するために使用されます。 それぞれ
ルールはすべてのクライアントの特定のサブセットと照合し、クライアントのプロパティのセットを定義します。
彼ら（と呼ばれる） 結果s）。 ルールは次のコマンドで定義できます。

ルール [[ - ]FLAG|[--]LABEL|[--]調子|[--]結果 ...]

各ルールは次のリストで構成されます。 FLAGs, 調子s, 結果s、およびオプションで、 LABEL.
(オプションで、それぞれの先頭に XNUMX つのダッシュ (--) を付けることで、より多くの情報を提供できます。
iptables(8)っぽい感じ）。

を指定することで、各ルールにカスタム ラベルを付けることができます。 LABEL プロパティ：

· [--]ラベル=VALUE

複数のラベルが指定されている場合は、リストの最後のラベルが適用されます。 ラベルがない場合は、
指定すると、ルールにはルールのインデックスを表す整数の名前が付けられます。
最後から ルールを解除する -F コマンド (デフォルトの自動起動でトリガーされます)。

先端
ルールラベルのデフォルトは増分インデックスです。 これらのデフォルトのラベルは、次の場合を除き、一意です。
別のルールにカスタム整数を割り当てる LABEL。 デフォルトのラベルをキャプチャできます
印刷ラベル フラグ。

新しいクライアントが表示されると、herbstluftwm はこの新しいクライアントに次のように各ルールを適用しようとします。
次のようになります: それぞれの場合 調子 このルールはこのクライアントと一致し、その後、すべての
結果 が実行されます。 (条件が指定されていない場合、このルールは
各クライアント）

各 調子 で構成されてい 財産 名前、演算子、 値。 有効な演算子は次のとおりです。

· ~ はクライアントの場合に一致します 財産 正規表現と一致する 値.

· = クライアントの場合に一致します 正しく 文字列は次と等しい 値.

有効な プロパティ には次の値があります:


クライアントの WM_CLASS の最初のエントリ。

class
クライアントの WM_CLASS の XNUMX 番目のエントリ。

タイトル
クライアントのウィンドウのタイトル。

ピッド
クライアントのプロセス ID (警告: PID はすべてのクライアントで使用できるわけではありません。これのみです)
クライアントが _NET_WM_PID を pid 自体に設定する場合に一致します)。

最大値
秒単位で測定されたルールの経過時間が以下の場合に一致します 値。 この
条件は = 演算子と一緒にのみ使用できます。 すでに最大値を超えている場合 (および
二度と一致することはありません)、このルールは削除されます。 (これでルールを構築できます
一定期間しか生きられないもの。）

ウィンドウタイプ
ウィンドウの _NET_WM_WINDOW_TYPE プロパティと一致します。

窓の役割
ウィンドウによって設定されている場合、ウィンドウの WM_WINDOW_ROLE プロパティと一致します。

各 結果 で構成されてい NAME=VALUE ペア。 有効 名前 には次の値があります:

タグ
クライアントをタグに移動します VALUE.

モニター
クライアントをモニター上のタグに移動します VALUE。 タグの結果も
が指定され、クライアントに switchtag が設定されている場合は、クライアントをそのタグに移動してから、
そのタグをモニターに表示する VALUE。 タグの結果が指定されているが、switchtag が指定されている場合
そうではありませんでした。この結果は無視してください。

フォーカス
クライアントがタグの入力フォーカスを取得するかどうかを決定します。 デフォルトは オフ. VALUE
することができます on, オフ or トグル.

スイッチタグ
フォーカスがアクティブ化され、クライアントがフォーカスされていないタグに置かれた場合、switchtag は次のように伝えます。
クライアントのタグが表示されるかどうか。 タグがどのモニターにも表示されている場合でも、
がフォーカスされていない場合、クライアントのタグのみが現在のモニターに表示されます。
swap_monitors_to_get_tag 活性化されます。 VALUE することができます on, オフ or トグル.

管理します
クライアントを管理するかどうかを決定します。 デフォルトは on. VALUE することができます
on, オフ or トグル.

index
ウィンドウをツリー内の指定されたインデックスに移動します。 VALUE 　 フレーム index.

擬似タイル
クライアントの擬似タイル状態を設定します。 VALUE することができます on, オフ or トグル.

うーんリクエスト
ウィンドウの状態 (全画面状態と注意を要求するフラグ) を設定するかどうかを設定します。
ewmh 自体を介してアプリケーションによって変更できます。 これは初期設定には影響しません
ウィンドウによって要求された全画面状態。 VALUE することができます on, オフ or トグル、デフォルトです
〜へ on.

通知する
hlwm がクライアントに EMWH の変更を通知するかどうかを設定します (現在、
全画面状態）。 これが設定されている場合、アプリケーションはフルスクリーン モードに変更されません。
まだ全画面のままです。 VALUE することができます on, オフ or トグル、デフォルトでは on.

フルスクリーン
クライアントの全画面フラグを設定します。 VALUE することができます on, オフ or トグル.

フック
カスタムフックルールを発行します VALUE WINID このルールが新しいウィンドウによってトリガーされたとき
ID付き WINID。 この結果は複数回使用される可能性があり、
フックの結果が発生するたびにフックが発行されます。

キーマスク
クライアントのキーマスクを設定します。 キーマスクは一致する正規表現です
文字列表現に反対します (list_keybinds を参照)。 一致する場合、キーバインドは次のようになります。
このクライアントがフォーカスされている場合はアクティブですが、それ以外の場合は無効になります。 デフォルトのキーマスクは次のとおりです
空の文字列 ("")。キーバインドは無効になりません。

ルールの動作は特別な方法で設定できます。 FLAGS:

· not: 次の条件を否定します。 調子.

· !: ないのと同じ。

· XNUMX 回: このルールを XNUMX 回だけ適用します (その後削除します)。

· printlabel: 新しく作成されたルールのラベルを標準出力に出力します。

· prepend: ルールを追加するのではなく、ルールのリストの先頭に追加します。 っていうことは
結果は既存のルールによって上書きされる可能性があります。

例：

· ルール --class=Netscape --tag=6 --focus=off

すべての Netscape インスタンスをタグ 6 に移動しますが、それらにはフォーカスを与えません。

· ルールが class~.*[Tt]erm tag=2 ではありません

クラスが term または Term で終わっていない場合、すべてのクライアントをタグ 2 に移動します。

· ルールクラス=Thunderbirdインデックス=/0

フォーカスのないツリーと最初のツリーにすべての Thunderbird インスタンスを挿入します。
子。

· ルール --windowtype=_NET_WM_WINDOW_TYPE_DIALOG --focus=on

_NET_WM_WINDOW_TYPE を正しく設定する新しいダイアログにフォーカスを設定します。

窓 IDS

いくつかのコマンドは、ウィンドウを参照として受け入れます (close など)。 構文は次のとおりです。

· 空の文字列 (または引数が欠落している) は、現在フォーカスされているウィンドウを参照します。

· 緊急は緊急のウィンドウを参照します。

· 0倍ヘキシド - どこ ヘキシド は XNUMX 進数です — ウィンドウを参照します
11 進数の XXNUMX ウィンドウ ID は ヘキシド.

· 決定 - どこ 決定 は XNUMX 進数 — XNUMX 進数でウィンドウを参照します
X11ウィンドウID 決定.

OBJECTS

警告
オブジェクト ツリーはまだ安定していません。つまり、そのインターフェイスは次に安定するまで変更される可能性があります。
リリース。 したがって、次回アップグレード後にこのドキュメントをもう一度確認してください。

オブジェクト ツリーは、次のような属性を持つオブジェクトのコレクションです。 / sys から知られている
Linux カーネル。 多くのエンティティ (タグ、モニター、クライアントなど) にはアクセスするオブジェクトがあります。
彼らの属性を直接伝えます。 ツリーは object_tree コマンドによって出力され、より詳細に表示されます。
以下のとおりです。

$ herbstclient object_tree
╾─┐
§─┐ のタグ
│ §─┐ 別名
│ │ §─╼ 1
│ │ ...
│ │ └─╼ 9
│ └─╼フォーカス
§─┐ クライアント
│ §─╼ 0x1400022
│ └─╼フォーカス
└─┐ モニター
§─╼ 別名
└─╼フォーカス

特定のオブジェクトから始まるサブツリーを出力するには、 パス オブジェクトの
オブジェクトツリー。 オブジェクト パス は区切り文字を使用したパスです。 (ドット)、例: tags.by-name:

$ herbstclient object_tree tags.by-name。
╾─┐ タグ.名前別。
§─╼ 1
§─╼ 2
...
━─╼9

オブジェクトのすべての属性と子をクエリするには、そのオブジェクトを渡します。 パス 属性:

$ herbstclient 属性タグ。
2人の子供：
名前で。
フォーカス。

1 属性:
。 - - タイプ
| .-- 書き込み可能
VV
u - カウント = 9

$ herbstclient attr tags.focus.
0人の子供。
6 属性:
。 - - タイプ
| .-- 書き込み可能
VV
sw 名 = "1"
bw フローティング = false
i - フレーム数 = 2
i - クライアント数 = 1
i - curframe_windex = 0
i - curframe_wcount = 1

これですでに出力が直感的にわかります。attr は最初に子の名前をリストします。
オブジェクト、次にすべての属性、各属性について次のように伝えます。

· その種類

· 文字列の場合は s

· i は整数を表します

· b はブール値の場合

· u は符号なし整数を表します

· ユーザーが書き込み可能な場合: w はいの場合、-そうでない場合。

· 属性の名前

· 現在の値 (文字列の場合のみ引用符で囲まれます)

特定の属性の引用符で囲まれていない値を取得するには、同じ属性を使用して属性をアドレス指定します。
オブジェクト パスの構文を作成し、それを attr または get_attr に渡します。

$ herbstclient attr clients.focus.title
ハーブストルフトwm.txt = (~/dev/c/herbstluftwm/doc) - VIM
$ herbstclient get_attr clients.focus.title
ハーブストルフトwm.txt = (~/dev/c/herbstluftwm/doc) - VIM

書き込み可能な属性値を変更するには、新しい値を attr または set_attr に渡します。

$ herbstclient attr tags.focus.floating
false
$ herbstclient attr tags.focus.floating true
$ herbstclient attr tags.focus.floating
true
$ herbstclient set_attr tags.focus.floating false
$ herbstclient attr tags.focus.floating
false

周りを見回して、そこに何があるのか​​を感じてください。 詳細なツリーの内容は次のようにリストされます。
以下：

· タグ: タグのサブツリー。

┌─────┬───────┐
│u - カウント │ タグの数 │
━─────┴───────┘

· index: インデックス付きタグのオブジェクト index.

・ 名前で

· TAG: 名前を持つ各タグのオブジェクト TAG

┌─────────┬─────────── ────┐
│SW名 │ タグ名 │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ────┤
│bw フローティング │ フローティング モードの場合 │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ────┤
│i - インデックス │ このタグのインデックス │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ────┤
│i - Frame_count │ フレーム数 │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ────┤
│i - client_count │ このタグのクライアント数 │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ────┤
│i - curframe_windex │ フォーカスされているクライアントのインデックス │
│ │ 選択フレーム │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ────┤
│i - curframe_wcount │ 内のクライアントの数 │
│ │ 選択したフレーム │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ────┘

· focus: フォーカスされているタグのオブジェクト

· クライアント

· WINID: 各クライアントのオブジェクトとそのオブジェクト WINID

┌───────────────┬─────────── ─────┐
│s - winid │ そのウィンドウ ID │
§─────────────┼───────── ─────┤
│s - タイトル │ そのウィンドウのタイトル │
§─────────────┼───────── ─────┤
│s - タグ │ 現在付けられているタグ │
§─────────────┼───────── ─────┤
│i - pid │ そのプロセス ID (-1 の場合 │
│ │ 未設定） │
§─────────────┼───────── ─────┤
│s - class │ そのクラス (│ の XNUMX 番目のエントリ)
│ │ WM_CLASS) │
§─────────────┼───────── ─────┤
│s - インスタンス │ そのインスタンス (最初のエントリ │
│ │ WM_CLASS 内) │
§─────────────┼───────── ─────┤
│bwフルスクリーン│ │
§─────────────┼───────── ─────┤
│bw疑似タイル │ │
§─────────────┼───────── ─────┤
│bw ewmhrequests │ ewmh リクエストが許可されているかどうか │
│ │ このクライアントの場合 │
§─────────────┼───────── ─────┤
│bw ewmhnotify │ クライアントがそのことについて知らされた場合 │
│ │ ewmh による状態 │
§─────────────┼───────── ─────┤
│bw 緊急 │ 緊急状態 │
§─────────────┼───────── ─────┤
│bw sizehints_tiling │ このクライアントのサイズヒントの場合 │
│ │ タイリングでは尊重されるべきです │
│ │ モード │
§─────────────┼───────── ─────┤
│bw sizehints_flaoting │ このクライアントのサイズヒントの場合 │
│ │ フローティングでは尊重されるべきです │
│ │ モード │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ─────┘

· focus: フォーカスされたクライアントのオブジェクト (存在する場合)

· ドラッグ: マウスによってドラッグされたクライアントのオブジェクト (存在する場合)。 を参照してください。
例については、mousebind コマンドのドキュメントを参照してください。

· モニター

┌─────┬─────────┐
│u - カウント │ モニターの数 │
━─────┴───────────┘

· INDEX: 各モニターのオブジェクトとそのオブジェクト INDEX

・ 名前で

· NAME: 名前付きモニターごとのオブジェクト

┌──────────────┬────────────────────────────────┐
│s - 名前 │ その名前 │
├──────────────┼────────────────────────────────┤
│i - インデックス │ そのインデックス │
├──────────────┼────────────────────────────────┤
│s - タグ │ 現在表示されているタグ │
├──────────────┼────────────────────────────────┤
│b - ロックタグ │ │
└──────────────┴────────────────────────────────┘

· focus: フォーカスされたモニターのオブジェクト

・settingsは設定ごとに属性を持ちます。 見る SETTINGS リスト用。

· テーマにはウィンドウの装飾を設定するための属性があります。 テーマとその子要素の多く
オブジェクトには次の属性があります

┌─────────────┬───────────── ───┐
│iw border_width │ ボーダーのベースの幅 │
§───────────┼─────────── ────┤
│iwpadding_top │ 上の追加の境界線の幅 │
│ │ トップ │
§───────────┼─────────── ────┤
│iwpadding_right │ 右側 │
§───────────┼─────────── ────┤
│iwpadding_bottom │ 一番下 │
§───────────┼─────────── ────┤
│iwpadding_left │そして境界線の左側 │
§───────────┼─────────── ────┤
│cw color │ の基本背景色 │
│ │ 境界線 │
§───────────┼─────────── ────┤
│iw inner_width │ 周囲の境界線の幅 │
│ │ クライアントのコンテンツ │
§───────────┼─────────── ────┤
│cw inner_color │ その色 │
§───────────┼─────────── ────┤
│iw inner_width │ 追加ボーダーの幅 │
│ │ 端に近い │
§───────────┼─────────── ────┤
│cw inner_color │ その色 │
§───────────┼─────────── ────┤
│cw 背景色 │ ウィンドウ内容の背後の色 │
│ │ サイズを変更すると表示されます │
§───────────┼─────────── ────┤
│swリセット │ これを書くと全てリセット │
│ │ デフォルト値に属性 │
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ────┘

内側の色/内側の幅
╻ 外側の色/外側の幅
│ ╻
││
┌────╴│╶───────┷─────┐ ╮ border_width
│ │ カラー │ ┝ +
│ ┌──┷─────────────┐ │ ╯padding_top
│ │====================....│ │
│ │== ウィンドウの内容 ==....│ │
│ │====================..╾────background_color
│ │………………………………│ │
│ ━━━━━━━━━━┘ │ ⎱ border_width +
━━━━━━━━━━━┘ ⎰padding_bottom

テーマ オブジェクトの属性を設定すると、値がそれぞれのオブジェクトに伝播されるだけです。
タイリングとフローティング オブジェクトの属性。

· タイリングは、タイル化されたクライアントの装飾を構成し、その属性の XNUMX つを設定します
アクティブ、通常、および緊急の子のそれぞれの属性を伝播します。
オブジェクト。

· active は、フォーカスされたクライアントとタイル化されたクライアントの装飾を構成します

· 通常は、フォーカスされていないクライアントとタイル化されたクライアントの装飾を構成します

·緊急は、緊急およびタイル化されたクライアントの装飾を構成します

· フローティングはタイリングと同様に動作します

· minimum はタイリングと同様に動作し、最小限の装飾を構成します。
Smart_window_surroundings によってトリガーされます。

· active は属性値を tiling.active および float.active に伝播します。

· Normal は属性値を tiling.normal と float.normal に伝播します。

·urgent は属性値を tiling.urgent および float.urgent に伝播します。

自動スタート FILE

構成ファイルはありませんが、起動時に実行される自動起動ファイルがあります。 それは
コマンドでも実行される リロード。 指定がない場合は、 - 自動スタート 引数、自動開始
ファイルは次の場所にあります $XDG_CONFIG_HOME/herbstluftwm/autostart またはで
~/.config/herbstluftwm/autostart。 通常はいくつかの要素から構成されます ハーブストクライアント 呼び出します。 もし
ユーザーのホームで自動起動ファイルを実行すると、グローバル自動起動ファイル (ほとんどの場合、
/etc/xdg/herbstluftwm/autostart に配置されます) がフォールバックとして実行されます。

簡単にインストールするには、デフォルトの自動起動ファイルを次の場所にコピーします。 ~/.config/herbstluftwm/.

フック

特別なイベントでは、herbstluftwm はいくつかのフック (パラメーター付き) を発行します。 受け取ったり、
一緒に彼らを待ちます ハーブストクライアント(1)。 また、カスタムフックは エミットフック
指示。 次のフックは、herbstluftwm 自体によって発行されます。

フルスクリーン[オン|オフ] WINID 状態
ウィンドウの全画面状態 WINID [オン|オフ]に変更されました。

タグ変更済み TAG MONITOR
タグ TAG に選ばれました MONITOR.

フォーカス変更済み WINID TITLE
窓 WINID 集中していました。 そのウィンドウのタイトルは TITLE.

window_title_changed WINID TITLE
タイトル 焦点を当て 窓が変わりました。 そのウィンドウIDは WINID そしてその新しいタイトル
is TITLE.

タグフラグ
フラグ (つまり、緊急または満員状態) が変更されました。

タグ追加済み TAG
という名前のタグ TAG を添加した。

タグ_削除されました TAG
という名前のタグ TAG 除去された。

緊急 [オン|オフ] WINID
指定されたクライアントの緊急状態 WINID [on|off]に変更されました。

ルール NAME WINID
ID を持つウィンドウ WINID 出現し、結果を伴うルールをトリガーしました
フック=NAME.

他にも便利なフックがありますが、これらは herbstluftwm 自体によって発行されることはありません。
で放出できる エミットフック コマンド：

終了パネル
パネルに終了するよう指示します。 デフォルトのpanel.shはこのフックで終了します。 多くのスクリプトが使用しています
このフック。

リロード
すべてのデーモンに次のように伝えます。 自動スタート ファイルがリロードされ、終了するよう指示されます。 これ
フック すべき すべての行の最初の行で発行されます 自動スタート ファイルにソフトウェアを指定する必要があります。

スタック

すべてのタグには、このタグ上にある独自のクライアントのスタックがあります。 EWMHに似ている
仕様の各タグ スタックには、上から下まで複数のレイヤーが含まれています。

· フォーカスされたクライアント (raise_on_focus_temporarily が有効な場合)

· 全画面表示のクライアント

・一般のお客様

・フレーム装飾

すべてのモニターは、次のスタックのみで構成される XNUMX つの大きなスタックで管理されます。
可視タグを上下に重ねて配置します。 これらのモニターの積み重ね順序は独立しています
インデックスから取得され、次を使用して変更できます。 raise_monitor 指示。 現在のスタック
によって図示されています スタック

EWMH

herbstluftwm は可能な限り EWMH に準拠するよう努めます。 これには以下が含まれます:

· タグ名とクライアント リストに関する情報が提供されます。

· デスクトップ環境のデスクトップ ウィンドウは管理されず、他のウィンドウの下に保持されます。
窓。

· フォーカスの取得などのクライアント要求は、設定されている場合にのみ処理されます。
フォーカス_盗み_防止 無効になっています。

ENVIRONMENT 変数

DISPLAY
指定する DISPLAY 使用しています。

onworks.net サービスを使用してオンラインで herbstluftwm を使用する