i3status文檔摘要

i3status - 為i3bardzen2xmobarlemonbar生成一個(gè)狀態(tài)行
格式: i3status [-c configfile] [-h] [-v]

選項(xiàng):

    -c      指定備用配置文件路徑。 默認(rèn)情況下蓖捶,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是一個(gè)小程序(大約1500 SLOC)刻像,用于為i3bar,dzen2并闲,xmobar细睡,lemonbar或類似程序生成狀態(tài)欄。
它通過發(fā)布極少數(shù)系統(tǒng)調(diào)用而設(shè)計(jì)為非常高效帝火,因?yàn)槿藗兺ǔOM棵敫乱淮芜@種狀態(tài)行溜徙。
這可確保即使在高負(fù)載情況下,狀態(tài)欄也能正確更新犀填。
而且蠢壹,它不會(huì)像占用相應(yīng)數(shù)量的shell命令那樣占用CPU,而是節(jié)省一點(diǎn)資源九巡。

配置:

i3status的基本思想是你可以指定應(yīng)該使用哪些“模塊”(順序指令)图贸。然后您可以使用各自的部分配置每個(gè)模塊。
對(duì)于每個(gè)模塊,您可以指定輸出格式疏日。 請(qǐng)參閱下面的完整參考偿洁。
示例配置:

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設(shè)置為false,colors指令將禁用所有顏色沟优。
interval指令指定i3status在打印下一個(gè)狀態(tài)行之前將要休眠的時(shí)間(以秒為單位)涕滋。

Time

輸出當(dāng)?shù)貢r(shí)區(qū)的當(dāng)前時(shí)間。要使用不同的時(shí)區(qū)净神,可以設(shè)置TZ環(huán)境變量何吝,或使用tztime模塊。
有關(guān)格式字符串的詳細(xì)信息鹃唯,請(qǐng)參閱strftime(3)爱榕。
例 order: time
例 format: %Y-%m-%d %H:%M:%S

TzTime

輸出給定時(shí)區(qū)中的當(dāng)前時(shí)間。如果沒有給出時(shí)區(qū)坡慌,則使用本地時(shí)間黔酥。 有關(guān)格式字符串的詳細(xì)信息,請(qǐng)參閱strftime(3)洪橘。
系統(tǒng)的時(shí)區(qū)數(shù)據(jù)庫(kù)通常安裝在/usr/share/zoneinfo中跪者。該路徑下的文件使得有效的時(shí)區(qū)字符串成為可能,
例如 對(duì)于/usr/share/zoneinfo/Europe/Berlin熄求,您可以在tztime模塊中設(shè)置時(shí)區(qū)為Europe/Berlin渣玲。
要覆蓋您的環(huán)境的區(qū)域設(shè)置,請(qǐng)?jiān)O(shè)置區(qū)域設(shè)置選項(xiàng)弟晚。
例 order: tztime berlin
例 format: %Y-%m-%d %H:%M:%S %Z
例 timezone: Europe/Berlin
例 locale: de_DE.UTF-8
如果您想在本節(jié)中使用markup忘衍,則會(huì)自動(dòng)轉(zhuǎn)義一個(gè)單獨(dú)的format_time選項(xiàng)。
然后它的輸出將替換格式字符串中的%time卿城。
示例配置(markup):

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

DDate

以用戶指定的格式輸出當(dāng)前的日期枚钓。有關(guān)格式字符串的詳細(xì)信息,請(qǐng)參閱ddate(1)瑟押。
注意:沒有%. 也沒有 %X 搀捷。
例 order: ddate
例 format: %{%a, %b %d%}, %Y%N - %H

CPU Usage

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

可以定義一個(gè)max_threshold多望,以便在最后一個(gè)時(shí)間間隔內(nèi)CPU的平均值高于配置的閾值時(shí)使負(fù)載值變?yōu)榧t色嫩舟。默認(rèn)為95。
max_threshold的輸出格式可以使用format_above_threshold進(jìn)行定制怀偷。

可以定義一個(gè)degraded_threshold至壤,以便在最后一個(gè)時(shí)間間隔內(nèi)CPU的平均值高于配置的閾值時(shí)將負(fù)載值變?yōu)辄S色。默認(rèn)為90枢纠。
可以使用format_above_degraded_threshold定制高于降級(jí)閾值時(shí)的輸出格式像街。
例 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地址和(如果可能)給定以太網(wǎng)接口的鏈接速度黎棠。
獲得鏈接速度需要cap_net_admin功能。 使用setcap cap_net_admin=ep $(其中i3status)進(jìn)行設(shè)置镰绎。
特殊接口名稱_first_將被系統(tǒng)中第一個(gè)非無線網(wǎng)絡(luò)接口(不包括以“l(fā)o”開頭的設(shè)備)取代脓斩。
例 order: ethernet eth0
例 format: E: %ip (%speed)

CPU-Temperature

獲取給定熱區(qū)的溫度。 可以定義一個(gè)max_threshold畴栖,以便在指定的散熱區(qū)變得太熱的情況下使溫度變成紅色随静。默認(rèn)為75攝氏度
在max_threshold以上時(shí)的輸出格式可以使用format_above_threshold進(jìn)行定制。
例 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
如果溫度報(bào)告它無法讀取溫度數(shù)值吗讶,那修改一句:
path = "/sys/class/thermal/thermal_zone0/temp"

Load

獲取系統(tǒng)負(fù)載(在最后1分鐘燎猛,5分鐘和15分鐘內(nèi)等待CPU時(shí)間的進(jìn)程數(shù)量)。
可以定義一個(gè)max_threshold照皆,以便在最后一分鐘的負(fù)載平均值高于配置的閾值的情況下將負(fù)載值變成紅色重绷。 默認(rèn)為5。
max_threshold的輸出格式可以使用format_above_threshold進(jìn)行定制膜毁。
例 order: load
例 format: %1min %5min %15min
例 max_threshold: "0,1"
例 format_above_threshold: Warning: %1min %5min %15min

官方文檔

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末昭卓,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子瘟滨,更是在濱河造成了極大的恐慌候醒,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,542評(píng)論 6 504
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件杂瘸,死亡現(xiàn)場(chǎng)離奇詭異倒淫,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)败玉,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,822評(píng)論 3 394
  • 文/潘曉璐 我一進(jìn)店門敌土,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人绒怨,你說我怎么就攤上這事∏玻” “怎么了南蹂?”我有些...
    開封第一講書人閱讀 163,912評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)念恍。 經(jīng)常有香客問我六剥,道長(zhǎng),這世上最難降的妖魔是什么峰伙? 我笑而不...
    開封第一講書人閱讀 58,449評(píng)論 1 293
  • 正文 為了忘掉前任疗疟,我火速辦了婚禮,結(jié)果婚禮上瞳氓,老公的妹妹穿的比我還像新娘策彤。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,500評(píng)論 6 392
  • 文/花漫 我一把揭開白布店诗。 她就那樣靜靜地躺著裹刮,像睡著了一般。 火紅的嫁衣襯著肌膚如雪庞瘸。 梳的紋絲不亂的頭發(fā)上捧弃,一...
    開封第一講書人閱讀 51,370評(píng)論 1 302
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死斧抱,一個(gè)胖子當(dāng)著我的面吹牛弹澎,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播腾节,決...
    沈念sama閱讀 40,193評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了癞谒?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,074評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤刃榨,失蹤者是張志新(化名)和其女友劉穎弹砚,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體枢希,經(jīng)...
    沈念sama閱讀 45,505評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡桌吃,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,722評(píng)論 3 335
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了苞轿。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片茅诱。...
    茶點(diǎn)故事閱讀 39,841評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖搬卒,靈堂內(nèi)的尸體忽然破棺而出瑟俭,到底是詐尸還是另有隱情,我是刑警寧澤契邀,帶...
    沈念sama閱讀 35,569評(píng)論 5 345
  • 正文 年R本政府宣布摆寄,位于F島的核電站,受9級(jí)特大地震影響坯门,放射性物質(zhì)發(fā)生泄漏微饥。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,168評(píng)論 3 328
  • 文/蒙蒙 一古戴、第九天 我趴在偏房一處隱蔽的房頂上張望欠橘。 院中可真熱鬧,春花似錦现恼、人聲如沸肃续。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,783評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽痹升。三九已至建炫,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間疼蛾,已是汗流浹背肛跌。 一陣腳步聲響...
    開封第一講書人閱讀 32,918評(píng)論 1 269
  • 我被黑心中介騙來泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留察郁,地道東北人衍慎。 一個(gè)月前我還...
    沈念sama閱讀 47,962評(píng)論 2 370
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像皮钠,于是被迫代替她去往敵國(guó)和親稳捆。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,781評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容