i3blocks - Online na nuvem

PROGRAMA:

NOME

i3blocks - Um agendador flexível para i3bar

SINOPSE

i3blocks [-c arquivo de configuração] [-v] ... [-h] [-V]

DESCRIÇÃO

i3blocks permite descrever facilmente os blocos em um formato simples e gerar um status
linha para i3bar(1). Ele lida com cliques, sinais e intervalo de tempo para scripts de usuário.

OPÇÕES

-c arquivo de configuração
Especifica um caminho de arquivo de configuração alternativo. Por padrão, o i3blocks procura
arquivos de configuração na seguinte ordem (observe que / Etc pode ser prefixado com
/ usr / local dependendo dos sinalizadores de compilação):

1. ~ / .config / i3blocks / config (ou $ XDG_CONFIG_HOME / i3blocks / config se definido)
2. ~ / .i3blocks.conf
3. / etc / xdg / i3blocks / config (ou $ XDG_CONFIG_DIRS / i3blocks / config se definido)
4. /etc/i3blocks.conf

-v
Nível de registro. Esta opção é cumulativa. Por padrão, as mensagens de erro são exibidas no stderr.
Aprovado uma vez, uma falha durante uma atualização é mostrada dentro do bloco. Aprovado duas vezes habilita
as mensagens de depuração em stderr.

-V
Imprima a versão e saia.

-h
Imprima a mensagem de ajuda e saia.

CONFIGURAÇÃO

O arquivo de configuração é um arquivo ini. Cada seção descreve um novo bloco. Uma linha
começando com um # sinal é um comentário e as linhas vazias são ignoradas. Uma propriedade é um
chave = valor par por linha, sem espaço ao redor do sinal de igual. Propriedades declaradas fora
um bloco (ou seja, no início do arquivo) descreve as configurações globais.

Aqui está um arquivo de configuração de exemplo:

# Este é um comentário
intervalo = 5
color = # 00FF00

[clima]
comando =~ / bin / weather.pl
intervalo = 1800

[Tempo]
comando = data +% T

Para usar i3blocks como sua linha de status, defina-o em um Barra bloco do seu ~ / i3 / config arquivo:

Barra {
status_command i3blocks
}

BLOCO

As propriedades usadas para descrever um bloco são as chaves especificadas no protocolo i3bar
http://i3wm.org/docs/i3bar-protocol.html, além de propriedades adicionais usadas por i3blocks para
descreva quando e como atualizar um bloco. Todas as propriedades com suporte são descritas a seguir.

As seguintes chaves são padrão, consulte http://i3wm.org/docs/i3bar-protocol.html para obter detalhes.

· texto completo

· pequeno texto

· cor

· largura_min

· alinhar

· nome

· instância

· urgente

· separator

· separador_block_width

· marcação

As seguintes chaves são específicas para i3blocks.

comando
O comando executado por um shell, usado para atualizar o bloco. O comportamento esperado é
descrito abaixo, no COMANDO seção.

intervalo
Se for um número inteiro positivo, o bloco é gerado na inicialização e o valor é
usado como um intervalo de tempo em segundos para agendar atualizações futuras. Se não for especificado ou 0,
o bloco não será executado na inicialização (o que é útil para simular botões). Se
"uma vez" (ou -1), o bloco será executado apenas na inicialização (observe que um clique ou
sinal ainda acionará uma atualização). Se "repetir" (ou -2), o bloco será
gerado na inicialização, e assim que termina (útil para repetir o bloqueio
comandos). Use com cuidado! Se "persist" (ou -3), o bloco será executado apenas
na inicialização e atualizado assim que produzir uma linha. Portanto, limitado a uma única linha
atualizações.

sinal O número do sinal usado para atualizar o bloco. Tudo em tempo real (pense priorizado
e que podem ser colocados em fila) estão disponíveis para o usuário. O número é válido entre 1 e
N, onde SIGRTMIN + N = SIGRTMAX. (Nota: existem 31 sinais em tempo real no Linux.)
Por exemplo, a sinal = 10 significa que este bloco será atualizado quando i3blocks
recebe SIGRTMIN + 10.

rótulo Um rótulo opcional para preprender ao texto completo após uma atualização.

formato Esta propriedade especifica o formato do texto de saída. O formato padrão é simples
texto, conforme descrito no COMANDO seção. Se "json" (ou 1) for usado, o bloco
a saída é analisada como JSON.

COMANDO

O valor do comando a chave será passada e executada como está por um shell.

A saída padrão da linha de comando é usada para atualizar o conteúdo do bloco. Cada
a linha não vazia da saída substituirá a propriedade correspondente:

1. texto_completo

2. texto_curto

3. cor

Por exemplo, este script define o texto completo em azul mas não pequeno texto:

echo "Aqui está a minha etiqueta"
eco
echo \ # 0000FF

Se a linha de comando retornar 0 ou 33, o bloco é atualizado. Caso contrário, é considerado um
falha e a primeira linha (se houver) ainda é exibida. Observe que stderr é ignorado. UMA
código de retorno de 33 irá definir o urgente sinalizar para verdadeiro.

Por exemplo, este script imprime a porcentagem da bateria e define o sinalizador de urgência se for
abaixo de 10%:

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

echo "BAT: $ BAT"
teste $ {BAT%?} -le 10 && exit 33 || saída 0

Ao bifurcar um comando de bloco, i3blocks irá definir o ambiente com alguns BLOQUEAR_*
variáveis. As seguintes variáveis ​​são sempre fornecidas, eventualmente com uma string vazia como
O valor que.

BLOCO_NAME
O nome do bloco (geralmente o nome da seção).

BLOCK_INSTANCE
Um argumento opcional para o script.

BLOCO_BUTTON
Botão do mouse (1, 2 ou 3) se o bloco foi clicado.

BLOCO_X e BLOCO_Y
Coordenadas onde ocorreu o clique, se o bloco foi clicado.

Aqui está um exemplo usando o ambiente:

[bloquear]
comando = nome do eco = instância $ BLOCK_NAME = $ BLOCK_INSTANCE
intervalo = 1

[clique-me]
full_text = Clique aqui!
comando = botão de eco = $ BLOCK_BUTTON x = $ BLOCK_X y = $ BLOCK_Y
largura_min = botão = 1 x = 1366 y = 768
alinhar = esquerda

Observe que i3blocks fornece um conjunto de scripts opcionais para conveniência, como rede
status, verificação da bateria, carga da CPU, volume, etc.

EXEMPLOS

Por exemplo, aqui está uma configuração próxima para status i3(1) configurações padrão:

TUDO

intervalo = 5
sinal = 10

[ipv6]

[livre]

[dhcp]

[VPN]

[Wi-fi]

[Ethernet]
min_width = E: 255.255.255.255 (1000 Mbit / s)

[bateria]

[CPU]

[data e hora]

O bloco a seguir mostra o uso de sinal com algum i3(1) ligações que ajustam o
volume, antes de emitir um pkill -RTMIN + 1 i3blocks:

[volume]
comando = echo -n ´Volume: ´; amixer get Master | grep -E -o ´ [0-9] [0-9]?% ´
intervalo = uma vez
sinal = 1
# sem intervalo, verifique apenas no SIGRTMIN + 1

Aqui está um exemplo de configuração muito minimalista, supondo que você tenha um monte de scripts sob
~ / bin / blocks / com o mesmo nome dos blocos:

comando =~ / bin / blocks /$ BLOCK_NAME
intervalo = 1

[livre]
[Wi-fi]
[Ethernet]
[bateria]
[CPU]
[data e hora]

Use i3blocks online usando serviços onworks.net