i3blocks - Online în cloud

PROGRAM:

NUME

i3blocks - Un planificator flexibil pentru i3bar

REZUMAT

i3blocks [-c configfile] [-v]... [-h] [-V]

DESCRIERE

i3blocks vă permite să descrieți cu ușurință blocurile într-un format simplu și să generați o stare
linie pentru i3bar(1). Se ocupă de clicuri, semnale și interval de timp pentru scripturile utilizatorului.

OPŢIUNI

-c configfile
Specifică o cale alternativă a fișierului de configurare. În mod implicit, i3blocks caută
fișierele de configurare în următoarea ordine (rețineți că / Etc poate fi prefixat cu
/ Usr / local în funcție de steaguri de compilare):

1. ~/.config/i3blocks/config (sau $XDG_CONFIG_HOME/i3blocks/config dacă este setat)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (sau $XDG_CONFIG_DIRS/i3blocks/config dacă este setat)
4. /etc/i3blocks.conf

-v
Nivel de jurnal. Această opțiune este cumulativă. În mod implicit, mesajele de eroare sunt afișate pe stderr.
Trecută o dată, un eșec în timpul unei actualizări este afișat în bloc. Trecut de două ori activează
mesajele de depanare de pe stderr.

-V
Imprimați versiunea și ieșiți.

-h
Imprimați mesajul de ajutor și ieșiți.

CONFIGURARE

Fișierul de configurare este un fișier ini. Fiecare secțiune descrie un bloc nou. O linie
începând cu a # semnul este un comentariu, iar liniile goale sunt ignorate. O proprietate este o
cheie=valoare pereche pe linie, fără spațiu în jurul semnului egal. Proprietăți declarate în exterior
un bloc (adică la începutul fișierului) descrie setările globale.

Iată un exemplu de fișier de configurare:

# Acesta este un comentariu
interval=5
culoare=#00FF00

[vreme]
comanda =~/bin/weather.pl
interval=1800

[timp]
comanda=data +%T

Pentru a utiliza i3blocks ca linie de stare, definiți-o în a bar bloc al dvs ~/i3/config fișier:

bar {
status_command i3blocks
}

BLOC

Proprietățile folosite pentru a descrie un bloc sunt cheile specificate în protocolul i3bar
http://i3wm.org/docs/i3bar-protocol.html, plus proprietăți suplimentare utilizate de i3blocks la
descrieți când și cum să actualizați un bloc. Toate proprietățile acceptate sunt descrise mai jos.

Următoarele chei sunt standard, vezi http://i3wm.org/docs/i3bar-protocol.html pentru detalii.

· text complet

· text scurt

· culoare

· min_width

· alinia

· nume

· instanță

· urgent

· separator

· separator_block_width

· marcare

Următoarele taste sunt specifice i3blocks.

comandă
Comanda executată de un shell, folosită pentru a actualiza blocul. Comportamentul așteptat este
descris mai jos, în COMMAND secţiune.

interval
Dacă este un număr întreg pozitiv, atunci blocul este generat la pornire și valoarea este
utilizat ca interval de timp în secunde pentru a programa actualizări viitoare. Dacă nu este specificat sau 0,
blocul nu va fi executat la pornire (ceea ce este util pentru a simula butoanele). Dacă
„o dată” (sau -1), blocul va fi executat numai la pornire (rețineți că un clic sau
semnalul va declanșa în continuare o actualizare). Dacă „repetă” (sau -2), blocul va fi
a apărut la pornire și de îndată ce se încheie (util pentru a repeta blocarea
comenzi). Utilizați cu prudență! Dacă „persist” (sau -3), blocul va fi executat numai
la pornire și actualizat de îndată ce scoate o linie. Limitat astfel la o singură linie
actualizări.

semnal Numărul semnalului utilizat pentru actualizarea blocului. Tot în timp real (gândește-te cu prioritate
și semnale aflate în coadă) sunt disponibile utilizatorului. Numărul este valabil între 1 și
N, unde SIGRTMIN+N = SIGRTMAX. (Notă: există 31 de semnale în timp real în Linux.)
De exemplu, semnal=10 înseamnă că acest bloc va fi actualizat când i3blocks
primește SIGRTMIN+10.

etichetă O etichetă opțională pentru a pregăti text complet după o actualizare.

format Această proprietate specifică formatul textului de ieșire. Formatul implicit este simplu
text, așa cum este descris în COMMAND secțiune. Dacă se folosește „json” (sau 1), blocul
ieșirea este analizată ca JSON.

COMMAND

Valoarea lui comandă cheia va fi transmisă și executată așa cum este de către un shell.

Ieșirea standard a liniei de comandă este utilizată pentru a actualiza conținutul blocului. Fiecare
linia negoală a ieșirii va suprascrie proprietatea corespunzătoare:

1. text_complet

2. scurt_text

3. culoare

De exemplu, acest script setează text complet in albastru dar nu text scurt:

ecou „Iată eticheta mea”
ecou
ecou \#0000FF

Dacă linia de comandă returnează 0 sau 33, blocul este actualizat. În caz contrar, se consideră a
eșec și prima linie (dacă există) este încă afișată. Rețineți că stderr este ignorat. A
codul de returnare de 33 va seta urgent steag la adevărat.

De exemplu, acest script tipărește procentul bateriei și setează semnalul urgent dacă este
sub 10%:

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

echo „BAT: $BAT”
test ${BAT%?} -le 10 && exit 33 || iesirea 0

Când se furcă o comandă de bloc, i3blocks va stabili mediul cu unele BLOC_*
variabile. Următoarele variabile sunt întotdeauna furnizate, eventual cu un șir gol ca
valoarea.

BLOCK_NAME
Numele blocului (de obicei, numele secțiunii).

BLOCK_INSTANCE
Un argument opțional pentru script.

BLOCK_BUTTON
Butonul mouse-ului (1, 2 sau 3) dacă s-a făcut clic pe bloc.

BLOC_X și BLOC_Y
Coordonatele unde a avut loc clicul, dacă blocul a fost făcut clic.

Iată un exemplu de utilizare a mediului:

[bloc]
command=echo name=$BLOCK_NAME instance=$BLOCK_INSTANCE
interval=1

[clickme]
full_text=Clic pe mine!
comanda=buton echo=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=button=1 x=1366 y=768
align=stânga

Rețineți că i3blocks oferă un set de scripturi opționale pentru confort, cum ar fi rețea
starea, verificarea bateriei, încărcarea procesorului, volumul etc.

EXEMPLE

De exemplu, aici este o configurație apropiată de i3status(1) setări implicite:

TOATE

interval=5
semnal=10

[ipv6]

[gratuit]

[dhcp]

[vpn]

[Wifi]

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

[baterie]

[CPU]

[datatime]

Următorul bloc arată utilizarea semnal cu cineva i3(1) legături care ajustează
volum, înainte de a emite a pkill -RTMIN+1 i3blocks:

[volum]
command=echo -n ´Volum: ´; amixer obține Master | grep -E -o ´[0-9][0-9]?%´
interval=o dată
semnal=1
# fără interval, verificați doar SIGRTMIN+1

Iată un exemplu de configurație foarte minimalistă, presupunând că aveți o grămadă de scripturi sub
~/bin/blocks/ cu același nume ca și blocurile:

comanda =~/bin/blocks/$BLOCK_NAME
interval=1

[gratuit]
[Wifi]
[ethernet]
[baterie]
[CPU]
[datatime]

Utilizați i3blocks online folosind serviciile onworks.net