i3blocks - クラウドでオンライン

プログラム：

NAME

i3block - i3bar の柔軟なスケジューラ

SYNOPSIS

i3block [-NS 構成ファイル] [-v]...[-h] [-V]

DESCRIPTION

i3block 簡単な形式で簡単にブロックを記述し、ステータスを生成することができます
のためのライン i3バー(1)。 ユーザースクリプトのクリック、シグナル、時間間隔を処理します。

OPTIONS

-c 構成ファイル
代替構成ファイルのパスを指定します。 デフォルトでは、i3blocks は
構成ファイルを次の順序で並べます (注: の/ etc の接頭辞を付けることができます
/ usr / local コンパイルフラグに応じて):

1. ~/.config/i3blocks/config (または、設定されている場合は $XDG_CONFIG_HOME/i3blocks/config)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (または設定されている場合は $XDG_CONFIG_DIRS/i3blocks/config)
4. /etc/i3blocks.conf

-v
ログレベル。 このオプションは累積的です。 デフォルトでは、エラー メッセージは stderr に表示されます。
一度渡され、更新中の失敗はブロック内に表示されます。 XNUMX回合格すると有効になります
stderr のデバッグ メッセージ。

-V
バージョンを印刷して終了します。

-h
ヘルプ メッセージを出力して終了します。

CONFIGURATION

設定ファイルはiniファイルです。 各セクションでは、新しいブロックについて説明します。 ライン
で始まる # 記号はコメントで、空行は無視されます。 プロパティは
key = value 等号の前後にスペースを入れずに、XNUMX 行に XNUMX つずつ入力します。 外部で宣言されたプロパティ
ブロック (つまり、ファイルの先頭) は、グローバル設定を記述します。

構成ファイルの例を次に示します。

#これはコメントです
間隔=5
色=#00FF00

[天気]
コマンド=~/bin/weather.pl
間隔=1800

[時間]
コマンド=日付 +%T

i3blocks をステータス ラインとして使用するには、 バー あなたのブロック ~/i3/config ファイル：

バー {
status_command i3blocks
}

BLOCK

ブロックを記述するために使用されるプロパティは、i3bar プロトコルで指定されたキーです
http://i3wm.org/docs/i3bar-protocol.html、およびによって使用される追加のプロパティ i3block 〜へ
ブロックをいつどのように更新するかを説明します。 サポートされているすべてのプロパティを以下に説明します。

次のキーが標準です。 http://i3wm.org/docs/i3bar-protocol.html 詳細については。

· 全文

· 短いテキスト

· カラー

· 最小幅

· 整列する

· 名

·

· 緊急

· セパレーター

· separator_block_width

· マークアップ

次のキーは i3block.

command
ブロックを更新するために使用される、シェルによって実行されるコマンド。 期待される動作は
以下の COMMAND のセクションから無料でダウンロードできます。

インターバル
正の整数の場合、ブロックは起動時に生成され、値は
将来の更新をスケジュールするための秒単位の時間間隔として使用されます。 未指定または 0 の場合、
ブロックは起動時に実行されません (ボタンをシミュレートするのに役立ちます)。 もしも
"once" (または -1)、ブロックは起動時にのみ実行されます (クリックまたは
シグナルは引き続き更新をトリガーします)。 「繰り返し」（または-2）の場合、ブロックは
起動時に生成され、終了するとすぐに (ブロックを繰り返すのに便利です)
コマンド)。 注意して使用してください！ "persist" (または -3) の場合、ブロックは実行のみになります。
行を出力するとすぐに更新されます。 したがって、単一行に限定されます
アップデート。

信号 ブロックの更新に使用されるシグナル番号。 すべてリアルタイム（優先順位を考えて
ユーザーはシグナルを利用できます。 番号は 1 ～ の間で有効です
N、ここで SIGRTMIN+N = SIGRTMAX。 (注: Linux には 31 個のリアルタイム シグナルがあります。)
例えば、 シグナル=10 このブロックが次の場合に更新されることを意味します。 i3block
SIGRTMIN+10 を受け取ります。

ラベル の先頭に付加するオプションのラベル 全文 アップデート後。

形式でアーカイブしたプロジェクトを保存します． このプロパティは、出力テキストの形式を指定します。 デフォルトのフォーマットはプレーンです
で説明されているように、テキスト COMMAND セクション。 "json" (または 1) が使用されている場合、ブロック
出力は JSON として解析されます。

COMMAND

の値 command キーはシェルによってそのまま渡され、実行されます。

コマンド ラインの標準出力は、ブロックの内容を更新するために使用されます。 各
出力の空でない行は、対応するプロパティを上書きします:

1.全文

2.ショートテキスト

3.色

たとえば、このスクリプトは 全文 青色だがなし 短いテキスト:

echo "これが私のラベルです"
echo
エコー \#0000FF

コマンド ラインが 0 または 33 を返す場合、ブロックは更新されます。 それ以外の場合は、
失敗し、最初の行 (存在する場合) がまだ表示されます。 stderr は無視されることに注意してください。 あ
戻りコード 33 は、 緊急 フラグを true にします。

たとえば、次のスクリプトはバッテリーのパーセンテージを出力し、そうであれば緊急フラグを設定します。
10%未満:

BAT=`acpi -b | grep -E -o '[0-9][0-9]?%'`

echo "BAT: $BAT"
test ${BAT%?} -le 10 && exit 33 || 出口0

ブロックコマンドをフォークすると、 i3block いくつかの環境を設定します ブロック_*
変数。 次の変数は常に提供され、最終的には空の文字列が
値。

BLOCK_NAME
ブロックの名前 (通常はセクション名)。

BLOCK_INSTANCE
スクリプトへのオプションの引数。

ブロックボタン
ブロックがクリックされた場合のマウス ボタン (1、2、または 3)。

ブロック_X & ブロック_Y
ブロックがクリックされた場合、クリックが発生した座標。

環境を使用した例を次に示します。

[ブロック]
コマンド=エコー名=$BLOCK_NAME インスタンス=$BLOCK_INSTANCE
間隔=1

[クリックミー]
full_text=クリックしてください!
コマンド=エコー ボタン=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=ボタン=1 x=1366 y=768
整列=左

注意してください i3block network などの便利なオプションのスクリプトのセットを提供します。
ステータス、バッテリーチェック、CPU負荷、音量など

例

例として、以下に近い構成を示します。 i3ステータス(1) デフォルト設定:

すべて

間隔=5
シグナル=10

[IPv6]

[無料]

[dhcp]

[VPN]

[Wi-Fi]

[イーサネット]
min_width=E: 255.255.255.255 (1000 メガビット/秒)

[バッテリー]

[CPU]

[日付時刻]

次のブロックは、の使用法を示しています 信号 いくつかの i3(1) 調整するビンディング
ボリュームを発行する前に pkill -RTMIN+1 i3block:

[音量]
command=echo -n 'ボリューム: '; amixer マスターを取得 | grep -E -o '[0-9][0-9]?%'
間隔=XNUMX回
シグナル=1
# 間隔なし、SIGRTMIN+1 のみチェック

これは、非常に最小限の構成の例です。下に多数のスクリプトがあると仮定します。
〜/ビン/ブロック/ ブロックと同じ名前:

コマンド=〜/ビン/ブロック/$BLOCK_NAME
間隔=1

[無料]
[Wi-Fi]
[イーサネット]
[バッテリー]
[CPU]
[日付時刻]

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