i3blocks - Online nel cloud

PROGRAMMA:

NOME

i3blocchi - Uno scheduler flessibile per i3bar

SINOSSI

i3blocchi [-C file di configurazione] [-v]... [-h] [-V]

DESCRIZIONE

i3blocchi consente di descrivere facilmente i blocchi in un formato semplice e generare uno stato
linea per i3bar(1). Gestisce clic, segnali e intervallo di tempo per gli script utente.

VERSIONI

-c file di configurazione
Specifica un percorso del file di configurazione alternativo. Per impostazione predefinita, i3blocks cerca
file di configurazione nel seguente ordine (notare che / Etc può essere preceduto da
/ Usr / local a seconda dei flag di compilazione):

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

-v
Livello di registro. Questa opzione è cumulativa. Per impostazione predefinita, i messaggi di errore vengono visualizzati su stderr.
Superato una volta, un errore durante un aggiornamento viene mostrato all'interno del blocco. Superato due volte abilita
i messaggi di debug su stderr.

-V
Stampa la versione ed esci.

-h
Stampa il messaggio di aiuto ed esci.

CONFIGURAZIONE

Il file di configurazione è un file ini. Ogni sezione descrive un nuovo blocco. una linea
cominciando con a # sign è un commento e le righe vuote vengono ignorate. Una proprietà è un
chiave=valore coppia per riga, senza spazi intorno al segno di uguale. Proprietà dichiarate all'esterno
un blocco (cioè all'inizio del file) descrive le impostazioni globali.

Ecco un file di configurazione di esempio:

# Questo è un commento
intervallo=5
colore=#00FF00

[tempo metereologico]
comando =~/bin/meteo.pl
intervallo=1800

[tempo]
comando=data +%T

Per utilizzare i3blocks come linea di stato, definiscilo in a bar blocco del tuo ~/i3/config file:

sbarra {
status_command i3blocks
}

BLOCCO

Le proprietà usate per descrivere un blocco sono le chiavi specificate nel protocollo i3bar
http://i3wm.org/docs/i3bar-protocol.html, oltre a proprietà aggiuntive utilizzate da i3blocchi a
descrivere quando e come aggiornare un blocco. Tutte le proprietà supportate sono descritte di seguito.

I seguenti tasti sono standard, vedere http://i3wm.org/docs/i3bar-protocol.html per i dettagli.

· testo intero

· testo_breve

· colore

· min_larghezza

· allineare

· Nome

· esempio

· urgente

· separatore

· larghezza_blocco_separatore

· markup

I seguenti tasti sono specifici per i3blocchi.

command
Il comando eseguito da una shell, utilizzato per aggiornare il blocco. Il comportamento previsto è
descritto di seguito, nel COMANDO .

intervallo
Se è un numero intero positivo, il blocco viene generato all'avvio e il valore è
utilizzato come intervallo di tempo in secondi per programmare aggiornamenti futuri. Se non specificato o 0,
il blocco non verrà eseguito all'avvio (utile per simulare i pulsanti). Se
"una volta" (o -1), il blocco verrà eseguito solo all'avvio (notare che un clic o
segnale attiverà comunque un aggiornamento). Se "ripeti" (o -2), il blocco sarà
generato all'avvio e non appena termina (utile per ripetere il blocco
comandi). Usare con cautela! Se "persiste" (o -3), il blocco verrà eseguito solo
all'avvio e aggiornato non appena emette una riga. Quindi limitato alla singola riga
aggiornamenti.

segnale Il numero del segnale utilizzato per aggiornare il blocco. Tutto in tempo reale (pensa prioritario
e accodabili) i segnali sono disponibili per l'utente. Il numero è valido tra 1 e
N, dove SIGRTMIN+N = SIGRTMAX. (Nota: ci sono 31 segnali in tempo reale in Linux.)
Per esempio, segnale=10 significa che questo blocco verrà aggiornato quando i3blocchi
riceve SIGRTMIN+10.

etichetta Un'etichetta opzionale da anteporre al testo intero dopo un aggiornamento.

formato Questa proprietà specifica il formato del testo di output. Il formato predefinito è normale
testo, come descritto nel COMANDO sezione. Se si usa "json" (o 1), il blocco
l'output viene analizzato come JSON.

COMANDO

Il valore del command key verrà passato ed eseguito così com'è da una shell.

L'output standard della riga di comando viene utilizzato per aggiornare il contenuto del blocco. Ogni
la riga non vuota dell'output sovrascriverà la proprietà corrispondente:

1. testo_intero

2. testo_breve

3. colore

Ad esempio, questo script imposta il testo intero in blu ma no testo_breve:

echo "Ecco la mia etichetta"
eco
eco \#0000FF

Se la riga di comando restituisce 0 o 33, il blocco viene aggiornato. In caso contrario, è considerato a
errore e la prima riga (se presente) è ancora visualizzata. Nota che stderr viene ignorato. UN
il codice di ritorno di 33 imposterà il urgente bandiera a vero.

Ad esempio, questo script stampa la percentuale della batteria e imposta il flag urgente se lo è
inferiore al 10%:

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

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

Quando si biforca un comando di blocco, i3blocchi imposterà l'ambiente con un po' BLOCCARE_*
variabili. Vengono sempre fornite le seguenti variabili, eventualmente con una stringa vuota come
il valore.

BLOCCO_NOME
Il nome del blocco (di solito il nome della sezione).

BLOCK_ISTANCE
Un argomento facoltativo per lo script.

BLOCCO_PULSANTE
Pulsante del mouse (1, 2 o 3) se il blocco è stato cliccato.

BLOCCO_X ed BLOCCO_Y
Coordinate in cui si è verificato il clic, se è stato fatto clic sul blocco.

Ecco un esempio che utilizza l'ambiente:

[bloccare]
command=echo name=$BLOCK_NAME istanza=$BLOCK_INSTANCE
intervallo=1

[cliccami]
full_text=Cliccami!
comando=pulsante eco=$BLOCCO_BUTTON x=$BLOCCO_X y=$BLOCCO_Y
min_width=pulsante=1 x=1366 y=768
allinea = sinistra

Si noti che i3blocchi fornisce una serie di script opzionali per comodità, come network
stato, controllo della batteria, carico della cpu, volume, ecc.

ESEMPI

Ad esempio, ecco una configurazione vicina a i3stato(1) impostazioni predefinite:

TUTTO

intervallo=5
segnale=10

[ipv6]

[gratuito]

[DHCP]

[VPN]

[Wifi]

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

[batteria]

[processore]

[appuntamento]

Il blocco seguente mostra l'uso di segnale con alcune i3(1) attacchi che regolano il
volume, prima di emettere a uccisione -RTMIN+1 i3blocchi:

[volume]
comando=echo -n ´Volume: ´; amixer get Master | grep -E -o ´[0-9][0-9]?%´
intervallo=una volta
segnale=1
# nessun intervallo, controlla solo su SIGRTMIN+1

Ecco un esempio di una configurazione molto minimalista, supponendo che tu abbia un sacco di script sotto
~/bin/blocchi/ con lo stesso nome dei blocchi:

comando =~/bin/blocchi/$BLOCK_NAME
intervallo=1

[gratuito]
[Wifi]
[Ethernet]
[batteria]
[processore]
[appuntamento]

Usa i3blocks online utilizzando i servizi onworks.net