i3blocks - 云端在线

程序：

您的姓名

i3块 - i3bar 的灵活调度器

概要

i3块 [-C 配置文件] [-v]... [-h] [-V]

商品描述

i3块 允许以简单的格式轻松描述块，并生成状态
线为 i3吧(1). 它处理用户脚本的点击、信号和时间间隔。

配置

-c 配置文件
指定备用配置文件路径。 默认情况下，i3blocks 寻找
配置文件按以下顺序排列（注意 /等 可能以
在/ usr /本地 取决于编译标志）：

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 上。
通过一次，更新期间的失败显示在块中。 通过两次使能
stderr 上的调试消息。

-V
打印版本并退出。

-h
打印帮助信息并退出。

配置

配置文件是一个ini文件。 每个部分描述一个新块。 一条线
以一个开头 # sign 是注释，空行被忽略。 一个属性是一个
键=值 每行一对，等号周围没有空格。 在外面声明的属性
一个块（即在文件的开头）描述全局设置。

这是一个示例配置文件：

#这是一条评论
间隔=5
颜色=#00FF00

[天气]
命令=〜/bin/weather.pl
间隔=1800

[时间]
命令=日期+%T

要将 i3blocks 用作您的状态行，请将其定义在 酒吧 你的块 ~/i3/配置 文件：

酒吧 {
status_command i3blocks
}

BLOCK

用于描述块的属性是 i3bar 协议中指定的键
http://i3wm.org/docs/i3bar-protocol.html, 加上使用的其他属性 i3块 至
描述何时以及如何更新块。 下面描述了所有支持的属性。

以下键是标准键，请参阅 http://i3wm.org/docs/i3bar-protocol.html 了解详情。

· 全文

· 短文

· 颜色

· 最小宽度

· 对齐

· 姓名

· 例

· 紧急

· 分离器

· 分隔块宽度

· 标记

以下键是特定的 i3块.

命令
由 shell 执行的命令，用于更新块。 预期的行为是
如下所述，在 指挥 部分。

间隔
如果它是一个正整数，则块在启动时产生并且值为
用作以秒为单位的时间间隔来安排未来的更新。 如果未指定或为 0，
该块不会在启动时执行（这对于模拟按钮很有用）。 如果
“一次”（或 -1），该块将仅在启动时执行（注意单击或
信号仍将触发更新）。 如果“重复”（或 -2），块将是
在启动时生成，并在它终止时生成（用于重复阻塞
命令）。 谨慎使用！ 如果“persist”（或 -3），则块将只执行
在启动时，并在输出一行时立即更新。 因此仅限于单行
更新。

信号 用于更新块的信号编号。 所有实时（考​​虑优先
和可排队）信号可供用户使用。 该数字在 1 和
N，其中 SIGRTMIN+N = SIGRTMAX。 （注：Linux 有 31 个实时信号。）
例如， 信号=10 意味着这个块将在什么时候更新 i3块
收到 SIGRTMIN+10。

标签 一个可选的标签，用于预先添加到 全文 更新后。

格式 此属性指定输出文本的格式。 默认格式是普通的
文本，如 指挥 部分。 如果使用“json”（或 1），则块
输出被解析为 JSON。

指挥

的值 命令 密钥将按原样由外壳传递和执行。

命令行的标准输出用于更新块内容。 每个
输出的非空行将覆盖相应的属性：

1.全文

2. 短文

3.颜色

例如，此脚本设置 全文 蓝色但没有 短文:

echo "这是我的标签"
回音
回声\#0000FF

如果命令行返回 0 或 33，则块被更新。 否则，它被认为是一个
失败，第一行（如果有）仍然显示。 请注意，stderr 被忽略。 一种
返回码 33 将设置 紧急 标志为真。

例如，此脚本打印电池百分比并设置紧急标志（如果是）
低于 10%：

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

回声“BAT：$ BAT”
测试 ${BAT%?} -le 10 && exit 33 || 退出 0

当分叉一个块命令时， i3块 将设置一些环境 堵塞_*
变量。 始终提供以下变量，最终为空字符串
价值。

BLOCK_NAME
块的名称（通常是部分名称）。

BLOCK_INSTANCE
脚本的可选参数。

BLOCK_BUTTON 按钮
如果块被点击，鼠标按钮（1、2 或 3）。

块_X 和 块_Y
点击发生的坐标，如果块被点击。

这是使用环境的示例：

[堵塞]
命令=回显名称=$BLOCK_NAME 实例=$BLOCK_INSTANCE
间隔=1

[点击我]
full_text=点击我！
命令=回显按钮=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
最小宽度=按钮=1 x=1366 y=768
align =左

需要注意的是 i3块 为方便起见，提供了一组可选的脚本，例如网络
状态、电池检查、CPU 负载、音量等。

示例

例如，这是一个接近的配置 i3状态(1) 默认设置：

ALL

间隔=5
信号=10

[ipv6]

[自由]

[DHCP]

[VPN]

[无线上网]

[以太网]
最小宽度=E: 255.255.255.255 (1000 Mbit/s)

[电池]

[中央处理器]

[约会时间]

以下块显示了使用 信号 和一些 i3(1) 调整绑定
量，在发出之前 杀人 -RTMIN+1 i3块:

[体积]
命令=echo -n '音量：'; amixer 获得大师 | grep -E -o ´[0-9][0-9]?%´
间隔=一次
信号=1
# 无间隔，只检查 SIGRTMIN+1

这是一个非常简约的配置示例，假设您在下面有一堆脚本
〜/斌/块/ 与块同名：

命令=〜/斌/块/$BLOCK_NAME
间隔=1

[自由]
[无线上网]
[以太网]
[电池]
[中央处理器]
[约会时间]

使用 onworks.net 服务在线使用 i3blocks