i3blocks: en línea en la nube

PROGRAMA:

NOMBRE

i3bloques - Un programador flexible para i3bar

SINOPSIS

i3bloques [-C archivo de configuración] [-v] ... [-h] [-V]

DESCRIPCIÓN

i3bloques permite describir bloques fácilmente en un formato simple y generar un estado
línea para i3bar(1). Maneja clics, señales e intervalo de tiempo para scripts de usuario.

CAMPUS

-c archivo de configuración
Especifica una ruta de archivo de configuración alternativa. Por defecto, i3blocks busca
archivos de configuración en el siguiente orden (tenga en cuenta que / Etc puede tener el prefijo
/ usr / local dependiendo de las banderas de compilación):

1. ~ / .config / i3blocks / config (o $ XDG_CONFIG_HOME / i3blocks / config si está configurado)
2. ~ / .i3blocks.conf
3. / etc / xdg / i3blocks / config (o $ XDG_CONFIG_DIRS / i3blocks / config si está configurado)
4. /etc/i3blocks.conf

-v
Nivel de registro. Esta opción es acumulativa. De forma predeterminada, los mensajes de error se muestran en stderr.
Aprobado una vez, se muestra un error durante una actualización dentro del bloque. Aprobado dos veces habilita
los mensajes de depuración en stderr.

-V
Imprime la versión y sal.

-h
Imprima el mensaje de ayuda y salga.

CONFIGURACIÓN

El archivo de configuración es un archivo ini. Cada sección describe un nuevo bloque. Una linea
comenzando con un # el signo es un comentario y las líneas vacías se ignoran. Una propiedad es una
clave = valor par por línea, sin espacio alrededor del signo igual. Propiedades declaradas fuera
un bloque (es decir, al principio del archivo) describe la configuración global.

Aquí hay un archivo de configuración de ejemplo:

# Esto es un comentario
intervalo = 5
color = # 00FF00

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

[tiempo]
comando = fecha +% T

Para usar i3blocks como su línea de estado, defínalo en un de caramelos bloque de tu ~ / i3 / config archivo:

bar {
estado_comando i3blocks
}

BLOQUE

Las propiedades utilizadas para describir un bloque son las claves especificadas en el protocolo i3bar.
http://i3wm.org/docs/i3bar-protocol.html, además de propiedades adicionales utilizadas por i3bloques a
describir cuándo y cómo actualizar un bloque. Todas las propiedades admitidas se describen a continuación.

Las siguientes teclas son estándar, consulte http://i3wm.org/docs/i3bar-protocol.html para obtener más detalles.

· texto completo

· Texto corto

· Color

· ancho_mínimo

· alinear

· nombre

· ejemplo

· urgente

· separador

· ancho_bloque_separador

· margen

Las siguientes claves son específicas para i3bloques.

comando
El comando ejecutado por un shell, utilizado para actualizar el bloque. El comportamiento esperado es
descrito a continuación, en el COMANDO .

intervalo
Si es un entero positivo, entonces el bloque se genera al inicio y el valor es
se utiliza como intervalo de tiempo en segundos para programar actualizaciones futuras. Si no se especifica o 0,
el bloque no se ejecutará al inicio (lo cual es útil para simular botones). Si
"una vez" (o -1), el bloque se ejecutará solo al inicio (tenga en cuenta que un clic o
la señal seguirá activando una actualización). Si "repetir" (o -2), el bloque será
generado en el inicio, y tan pronto como termina (útil para repetir el bloqueo
comandos). ¡Úselo con precaución! Si "persiste" (o -3), el bloque se ejecutará solo
al inicio y se actualiza tan pronto como genera una línea. Por lo tanto, limitado a una sola línea
actualizaciones.

señal El número de señal utilizado para actualizar el bloque. Todo el tiempo real (piensa priorizado
y que se pueden poner en cola) están disponibles para el usuario. El número es válido entre 1 y
N, donde SIGRTMIN + N = SIGRTMAX. (Nota: hay 31 señales en tiempo real en Linux).
Por ejemplo, señal = 10 significa que este bloque se actualizará cuando i3bloques
recibe SIGRTMIN + 10.

Label Una etiqueta opcional para preprendir al texto completo después de una actualización.

formato Esta propiedad especifica el formato del texto de salida. El formato predeterminado es simple
texto, como se describe en el COMANDO sección. Si se usa "json" (o 1), el bloque
la salida se analiza como JSON.

COMANDO

El valor de la comando La clave será pasada y ejecutada tal cual por un shell.

La salida estándar de la línea de comando se usa para actualizar el contenido del bloque. Cada
La línea no vacía de la salida sobrescribirá la propiedad correspondiente:

1. texto_completo

2. texto_breve

3. color

Por ejemplo, este script establece el texto completo en azul pero no Texto corto:

echo "Aquí está mi etiqueta"
echo
echo \ # 0000FF

Si la línea de comando devuelve 0 o 33, el bloque se actualiza. De lo contrario, se considera un
falla y la primera línea (si la hay) todavía se muestra. Tenga en cuenta que stderr se ignora. A
el código de retorno de 33 establecerá el urgente bandera a verdadero.

Por ejemplo, este script imprime el porcentaje de batería y establece la bandera urgente si es
por debajo del 10%:

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

echo "BAT: $ BAT"
prueba $ {BAT%?} -le 10 && exit 33 || salir 0

Al bifurcar un comando de bloque, i3bloques establecerá el entorno con algunos CUADRA_*
variables. Siempre se proporcionan las siguientes variables, eventualmente con una cadena vacía como
el valor.

BLOQUE_NOMBRE
El nombre del bloque (generalmente el nombre de la sección).

BLOCK_INSTANCIA
Un argumento opcional para el script.

BLOQUE_BOTÓN
Botón del mouse (1, 2 o 3) si se hizo clic en el bloque.

BLOQUE_X y BLOQUE_Y
Coordenadas donde ocurrió el clic, si se hizo clic en el bloque.

A continuación, se muestra un ejemplo que utiliza el entorno:

[cuadra]
comando = nombre de eco = $ BLOCK_NAME instancia = $ BLOCK_INSTANCE
intervalo = 1

[Haz click en mi]
full_text = ¡Haz clic en mí!
comando = botón de eco = $ BLOCK_BUTTON x = $ BLOCK_X y = $ BLOCK_Y
min_width = botón = 1 x = 1366 y = 768
alinear = izquierda

Tenga en cuenta que i3bloques proporciona un conjunto de scripts opcionales para mayor comodidad, como redes
estado, comprobación de la batería, carga de la CPU, volumen, etc.

EJEMPLOS

Como ejemplo, aquí hay una configuración cercana a i3estado(1) configuración predeterminada:

TODO

intervalo = 5
señal = 10

[ipv6]

[gratis]

[DHCP]

[VPN]

[Wifi]

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

[batería]

[UPC]

[fecha y hora]

El siguiente bloque muestra el uso de señal con algunas i3(1) fijaciones que ajustan el
volumen, antes de emitir un pkill -RTMIN + 1 i3bloques:

[volumen]
comando = echo -n ´Volumen: ´; amixer obtener Master | grep -E -o ´ [0-9] [0-9]?% ´
intervalo = una vez
señal = 1
# sin intervalo, solo verifique en SIGRTMIN + 1

Aquí hay un ejemplo de una configuración muy minimalista, asumiendo que tiene un montón de scripts debajo
~ / bin / blocks / con el mismo nombre que los bloques:

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

[gratis]
[Wifi]
[Ethernet]
[batería]
[UPC]
[fecha y hora]

Use i3blocks en línea usando los servicios de onworks.net