i3: i3status.conf - tradução

i3status (1)
Michael Stapelberg
<[email protected]>
versão 2.10, janeiro 2016


1. NOME
i3status - Gera uma linha de status para i3bar, dzen2, xmobar ou lemonbar

2. SINOPSE
i3status [-c configfile] [-h] [-v]

3. OPÇÕES
Especifica um caminho de arquivo de configuração alternativo. Por padrão, i3status procura por arquivos de configuração na seguinte ordem:

~/.i3status.conf
~/.config/i3status/config (or $XDG_CONFIG_HOME/i3status/config if set)
/etc/i3status.conf
/etc/xdg/i3status/config (or $XDG_CONFIG_DIRS/i3status/config if set)

4. DESCRIÇÃO

i3status é um pequeno programa (cerca de 1500 SLOC) para gerar uma barra de status para i3bar, dzen2, xmobar, lemonbar ou programas similares. Foi concebido para ser muito eficaz através da emissão de um número muito pequeno de chamadas do sistema, como um modo geral quer actualizar uma tal linha de estado em cada segundo. Isso garante que mesmo sob carga alta, sua barra de status é atualizado corretamente. Além disso, ele salva um pouco de energia, não sobrecarregando o seu CPU, tanto quanto gerando a quantidade correspondente de comandos shell faria.

5. Configuração

A idéia básica do i3status é que você pode especificar quais "módulos" deve ser usado (a directiva ordem). Em seguida, você pode configurar cada módulo com sua própria seção. Para cada módulo, você pode especificar o formato de saída. Veja abaixo para uma referência completa.

Exemplo de configuração:

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_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"
}

5.1. Geral
A directiva cores irá desativar todas as cores se você defini-la como falsa. Você também pode especificar as cores que serão utilizadas para apresentar "good", "degraded" or "bad" valores usando color_good, color_degraded or color_bad, respectivamente. Estas directivas são utilizados apenas se o suporte a cor não é desativado pela directiva cores. O formato de entrada para valores de cor é o tripleto hexadecimal RGB canônico (sem separadores entre as cores), prefixado por um caractere de contenção ("#").

Exemplo de configuração:
color_good = "#00FF00"