i3status文档摘要

i3status - 为i3bardzen2xmobarlemonbar生成一个状态行
格式: i3status [-c configfile] [-h] [-v]

选项:

    -c      指定备用配置文件路径。 默认情况下,i3status按以下顺序查找配置文件:
             1.~/.config/i3status/config (or  $XDG_CONFIG_HOME/i3status/config if set)
             2./etc/xdg/i3status/config (or  $XDG_CONFIG_DIRS/i3status/config if set)
             3.~/.i3status.conf  
             4./etc/i3status.conf

描述:

i3status是一个小程序(大约1500 SLOC),用于为i3bar,dzen2,xmobar,lemonbar或类似程序生成状态栏。
它通过发布极少数系统调用而设计为非常高效,因为人们通常希望每秒更新一次这种状态行。
这可确保即使在高负载情况下,状态栏也能正确更新。
而且,它不会像占用相应数量的shell命令那样占用CPU,而是节省一点资源。

配置:

i3status的基本思想是你可以指定应该使用哪些“模块”(顺序指令)。然后您可以使用各自的部分配置每个模块。
对于每个模块,您可以指定输出格式。 请参阅下面的完整参考。
示例配置:

general {
        output_format = "dzen2"
        colors = true
        interval = 5
}

order += "ipv6"
order += "disk /"
order += "run_watch DHCP"
order += "run_watch VPNC"
order += "path_exists VPN"
order += "wireless wlan0"
order += "ethernet eth0"
order += "battery 0"
order += "cpu_temperature 0"
order += "load"
order += "tztime local"
order += "tztime berlin"

wireless wlan0 {
        format_up = "W: (%quality at %essid, %bitrate) %ip"
        format_down = "W: down"
}

ethernet eth0 {
        # if you use %speed, i3status requires the cap_net_admin capability
        format_up = "E: %ip (%speed)"
        format_down = "E: down"
}

battery 0 {
        format = "%status %percentage %remaining %emptytime"
        format_down = "No battery"
        status_chr = "⚡ CHR"
        status_bat = "🔋 BAT"
        status_unk = "? UNK"
        status_full = "☻ FULL"
        path = "/sys/class/power_supply/BAT%d/uevent"
        low_threshold = 10
}

run_watch DHCP {
        pidfile = "/var/run/dhclient*.pid"
}

run_watch VPNC {
        # file containing the PID of a vpnc process
        pidfile = "/var/run/vpnc/pid"
}

path_exists VPN {
        # path exists when a VPN tunnel launched by nmcli/nm-applet is active
        path = "/proc/sys/net/ipv4/conf/tun0"
}

tztime local {
        format = "%Y-%m-%d %H:%M:%S"
}

tztime berlin {
        format = "%Y-%m-%d %H:%M:%S %Z"
        timezone = "Europe/Berlin"
}

load {
        format = "%5min"
}

cpu_temperature 0 {
        format = "T: %degrees °C"
        path = "/sys/devices/platform/coretemp.0/temp1_input"
}

disk "/" {
        format = "%free"
}

如果将colors设置为false,colors指令将禁用所有颜色。
interval指令指定i3status在打印下一个状态行之前将要休眠的时间(以秒为单位)。

Time

输出当地时区的当前时间。要使用不同的时区,可以设置TZ环境变量,或使用tztime模块。
有关格式字符串的详细信息,请参阅strftime(3)。
例 order: time
例 format: %Y-%m-%d %H:%M:%S

TzTime

输出给定时区中的当前时间。如果没有给出时区,则使用本地时间。 有关格式字符串的详细信息,请参阅strftime(3)。
系统的时区数据库通常安装在/usr/share/zoneinfo中。该路径下的文件使得有效的时区字符串成为可能,
例如 对于/usr/share/zoneinfo/Europe/Berlin,您可以在tztime模块中设置时区为Europe/Berlin
要覆盖您的环境的区域设置,请设置区域设置选项。
例 order: tztime berlin
例 format: %Y-%m-%d %H:%M:%S %Z
例 timezone: Europe/Berlin
例 locale: de_DE.UTF-8
如果您想在本节中使用markup,则会自动转义一个单独的format_time选项。
然后它的输出将替换格式字符串中的%time
示例配置(markup):

tztime berlin {
        format = "<span foreground='#ffffff'>time:</span> %time"
        format_time = "%H:%M %Z"
        timezone = "Europe/Berlin"
}

DDate

以用户指定的格式输出当前的日期。有关格式字符串的详细信息,请参阅ddate(1)。
注意:没有%. 也没有 %X 。
例 order: ddate
例 format: %{%a, %b %d%}, %Y%N - %H

CPU Usage

从 /proc/stat (Linux) 或 sysctl(3) (FreeBSD/OpenBSD) 获取百分比CPU使用率。

可以定义一个max_threshold,以便在最后一个时间间隔内CPU的平均值高于配置的阈值时使负载值变为红色。默认为95。
max_threshold的输出格式可以使用format_above_threshold进行定制。

可以定义一个degraded_threshold,以便在最后一个时间间隔内CPU的平均值高于配置的阈值时将负载值变为黄色。默认为90。
可以使用format_above_degraded_threshold定制高于降级阈值时的输出格式。
例 order: cpu_usage
例 format: %usage
例 max_threshold: 75
例 format_above_threshold: Warning above threshold: %usage
例 degraded_threshold: 25
例 format_above_degraded_threshold: Warning above degraded threshold: %usage

Ethernt

获取IP地址和(如果可能)给定以太网接口的链接速度。
获得链接速度需要cap_net_admin功能。 使用setcap cap_net_admin=ep $(其中i3status)进行设置。
特殊接口名称_first_将被系统中第一个非无线网络接口(不包括以“lo”开头的设备)取代。
例 order: ethernet eth0
例 format: E: %ip (%speed)

CPU-Temperature

获取给定热区的温度。 可以定义一个max_threshold,以便在指定的散热区变得太热的情况下使温度变成红色。默认为75摄氏度
在max_threshold以上时的输出格式可以使用format_above_threshold进行定制。
例 order: cpu_temperature 0
例 format: T: %degrees °C
例 max_threshold: 42
例 format_above_threshold: Warning T above threshold: %degrees °C
例 path: /sys/devices/platform/coretemp.0/temp1_input
如果温度报告它无法读取温度数值,那修改一句:
path = "/sys/class/thermal/thermal_zone0/temp"

Load

获取系统负载(在最后1分钟,5分钟和15分钟内等待CPU时间的进程数量)。
可以定义一个max_threshold,以便在最后一分钟的负载平均值高于配置的阈值的情况下将负载值变成红色。 默认为5。
max_threshold的输出格式可以使用format_above_threshold进行定制。
例 order: load
例 format: %1min %5min %15min
例 max_threshold: "0,1"
例 format_above_threshold: Warning: %1min %5min %15min

官方文档

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 200,841评论 5 472
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,415评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 147,904评论 0 333
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,051评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,055评论 5 363
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,255评论 1 278
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,729评论 3 393
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,377评论 0 255
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,517评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,420评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,467评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,144评论 3 317
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,735评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,812评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,029评论 1 256
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,528评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,126评论 2 341

推荐阅读更多精彩内容