i3blocks - Online in de Cloud

PROGRAMMA:

NAAM

i3blokken - Een flexibele planner voor i3bar

KORTE INHOUD

i3blokken [-C configuratiebestand] [-v]... [-h] [-V]

PRODUCTBESCHRIJVING

i3blokken maakt het mogelijk om blokken eenvoudig in een eenvoudig formaat te beschrijven en een status te genereren
regel voor i3bar(1). Het verwerkt klikken, signalen en tijdsintervallen voor gebruikersscripts.

OPTIES

-c configuratiebestand
Specificeert een alternatief configuratiebestandspad. Standaard zoekt i3blocks naar
configuratiebestanden in de volgende volgorde (merk op dat / Etc kan worden voorafgegaan door
/ Usr / local afhankelijk van de compilatievlaggen):

1. ~/.config/i3blocks/config (of $XDG_CONFIG_HOME/i3blocks/config indien ingesteld)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (of $XDG_CONFIG_DIRS/i3blocks/config indien ingesteld)
4. /etc/i3blocks.conf

-v
Log niveau. Deze optie is cumulatief. Standaard worden foutmeldingen weergegeven op stderr.
Eenmaal geslaagd, wordt een fout tijdens een update binnen het blok weergegeven. Twee keer geslaagd, maakt het mogelijk
de debug-berichten op stderr.

-V
Print de versie en sluit af.

-h
Druk het helpbericht af en sluit af.

CONFIGURATIE

Het configuratiebestand is een ini-bestand. Elke sectie beschrijft een nieuw blok. Een lijn
beginnend met a # teken is commentaar en lege regels worden genegeerd. Een eigendom is een
sleutel=waarde paar per regel, zonder spatie rond het gelijkteken. Eigenschappen buiten aangegeven
een blok (dwz aan het begin van het bestand) beschrijft de globale instellingen.

Hier is een voorbeeld van een configuratiebestand:

# Dit is een reactie
interval=5
kleur=#00FF00

[weer]
commando =~/bin/weer.pl
interval=1800

[tijd]
commando=datum +%T

Om i3blocks als uw statusregel te gebruiken, definieert u deze in a bars blok van jouw ~/i3/config file:

bar {
status_commando i3blocks
}

BLOCK

De eigenschappen die worden gebruikt om een ​​blok te beschrijven zijn de sleutels die zijn gespecificeerd in het i3bar-protocol
http://i3wm.org/docs/i3bar-protocol.html, plus aanvullende eigenschappen die worden gebruikt door i3blokken naar
beschrijf wanneer en hoe een blok moet worden bijgewerkt. Alle ondersteunde eigenschappen worden hieronder beschreven.

De volgende sleutels zijn standaard, zie http://i3wm.org/docs/i3bar-protocol.html voor meer info.

· hele tekst

· korte tekst

· kleur

· min_breedte

· richten

· naam

· instantie

· dringend

· afscheider

· scheidingsteken_blok_breedte

· markup

De volgende sleutels zijn specifiek voor i3blokken.

commando
De opdracht die wordt uitgevoerd door een shell en wordt gebruikt om het blok bij te werken. Het verwachte gedrag is
hieronder beschreven, in de COMMAND pagina.

interval
Als het een positief geheel getal is, wordt het blok bij het opstarten voortgebracht en is de waarde dat ook
gebruikt als een tijdsinterval in seconden om toekomstige updates te plannen. Indien niet gespecificeerd of 0,
het blok wordt niet uitgevoerd bij het opstarten (wat handig is om knoppen te simuleren). Als
"eenmaal" (of -1), wordt het blok alleen uitgevoerd bij het opstarten (merk op dat een klik of
signaal zal nog steeds een update activeren). Als "herhaal" (of -2), zal het blok dat zijn
voortgebracht bij het opstarten, en zodra het eindigt (handig om het blokkeren te herhalen
commando's). Voorzichtig gebruiken! Als "persist" (of -3) wordt het blok alleen uitgevoerd
bij het opstarten en bijgewerkt zodra er een regel wordt weergegeven. Dus beperkt tot één lijn
updates.

signaal Het signaalnummer dat wordt gebruikt om het blok bij te werken. Allemaal realtime (denk aan prioriteit
en wachtrijen) signalen beschikbaar zijn voor de gebruiker. Het nummer is geldig tussen 1 en
N, waarbij SIGRTMIN+N = SIGRTMAX. (Opmerking: er zijn 31 real-time signalen in Linux.)
Bijvoorbeeld, signaal=10 betekent dat dit blok wanneer wordt bijgewerkt i3blokken
ontvangt SIGRTMIN+10.

label Een optioneel label om op te preppen hele tekst na een update.

formaat Deze eigenschap specificeert het formaat van de uitvoertekst. Het standaardformaat is gewoon
tekst, zoals beschreven in de COMMAND sectie. Als "json" (of 1) wordt gebruikt, wordt het block
uitvoer wordt geparseerd als JSON.

COMMAND

De waarde van de commando sleutel zal worden doorgegeven en uitgevoerd zoals het is door een shell.

De standaarduitvoer van de opdrachtregel wordt gebruikt om de blokinhoud bij te werken. Elk
niet-lege regel van de uitvoer overschrijft de overeenkomstige eigenschap:

1. volledige_tekst

2. korte_tekst

3. kleur

Dit script stelt bijvoorbeeld de hele tekst in het blauw, maar nee korte tekst:

echo "Hier is mijn label"
echo
echo\#0000FF

Als de opdrachtregel 0 of 33 retourneert, wordt het blok bijgewerkt. Anders wordt het beschouwd als een
mislukt en de eerste regel (indien aanwezig) wordt nog steeds weergegeven. Merk op dat stderr wordt genegeerd. A
retourcode 33 stelt de dringend vlag naar waar.

Dit script drukt bijvoorbeeld het batterijpercentage af en stelt de urgentie-vlag in als dit het geval is
onder de 10%:

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

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

Bij het forken van een blokcommando, i3blokken zal bij sommigen de omgeving bepalen BLOK_*
variabelen. De volgende variabelen worden altijd verstrekt, met eventueel een lege string as
de waarde.

BLOCK_NAME
De naam van het blok (meestal de sectienaam).

BLOCK_INSTANCE
Een optioneel argument voor het script.

BLOCK_BUTTON
Muisknop (1, 2 of 3) als op het blok is geklikt.

BLOCK_X en BLOCK_Y
Coördinaten waar de klik plaatsvond, als er op het blok werd geklikt.

Hier is een voorbeeld waarbij de omgeving wordt gebruikt:

[blok]
command=echonaam=$BLOCK_NAME exemplaar=$BLOCK_INSTANCE
interval=1

[Klik hier]
full_text=Klik mij!
commando=echoknop=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=knop=1 x=1366 y=768
uitlijnen=links

Merk op dat i3blokken biedt voor het gemak een reeks optionele scripts, zoals netwerk
status, batterijcontrole, CPU-belasting, volume, enz.

Voorbeelden

Als voorbeeld is hier een nauwe configuratie i3status(1) standaardinstellingen:

ALLES

interval=5
signaal=10

[ipv6]

[vrij]

[dhcp]

[vpn]

[Wifi]

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

[accu]

[CPU]

[datum Tijd]

Het volgende blok toont het gebruik van signaal met wat i3(1) bindingen die de
volume, alvorens een doden -RTMIN+1 i3blokken:

[volume]
commando=echo -n ´Volume: ´; amixer krijg Master | grep -E -o ´[0-9][0-9]?%´
interval=eenmaal
signaal=1
# geen interval, controleer alleen SIGRTMIN+1

Hier is een voorbeeld van een zeer minimalistische configuratie, ervan uitgaande dat je een aantal scripts eronder hebt
~/bin/blokken/ met dezelfde naam als de blokken:

commando =~/bin/blokken/$BLOCK_NAME
interval=1

[vrij]
[Wifi]
[ethernet]
[accu]
[CPU]
[datum Tijd]

Gebruik i3blocks online met behulp van onworks.net-services