i3blocks – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

i3blocks - Ein flexibler Planer für i3bar

ZUSAMMENFASSUNG

i3blocks [-C Konfigurationsdatei] [-v]... [-h] [-V]

BESCHREIBUNG

i3blocks ermöglicht die einfache Beschreibung von Blöcken in einem einfachen Format und die Generierung eines Status
Linie für i3bar(1). Es verarbeitet Klicks, Signale und Zeitintervalle für Benutzerskripte.

OPTIONAL

-c Konfigurationsdatei
Gibt einen alternativen Konfigurationsdateipfad an. Standardmäßig sucht i3blocks nach
Konfigurationsdateien in der folgenden Reihenfolge (beachten Sie, dass / Etc kann mit vorangestellt werden
Verzeichnis / usr / local abhängig von den Kompilierungsflags):

1. ~/.config/i3blocks/config (oder $XDG_CONFIG_HOME/i3blocks/config, falls festgelegt)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (oder $XDG_CONFIG_DIRS/i3blocks/config, falls festgelegt)
4. /etc/i3blocks.conf

-v
Protokollebene. Diese Option ist kumulativ. Standardmäßig werden Fehlermeldungen auf stderr angezeigt.
Einmal bestanden, wird ein Fehler während eines Updates im Block angezeigt. Zweimal bestanden aktiviert
die Debug-Meldungen auf stderr.

-V
Version drucken und beenden.

-h
Drucken Sie die Hilfenachricht und beenden Sie das Programm.

CONFIGURATION

Die Konfigurationsdatei ist eine INI-Datei. Jeder Abschnitt beschreibt einen neuen Block. Eine Linie
beginnend mit a # sign ist ein Kommentar und leere Zeilen werden ignoriert. Eine Eigenschaft ist eine
Schlüssel=Wert Paar pro Zeile, ohne Leerzeichen um das Gleichheitszeichen. Außerhalb deklarierte Eigenschaften
Ein Block (also am Anfang der Datei) beschreibt globale Einstellungen.

Hier ist eine Beispielkonfigurationsdatei:

# Dies ist ein Kommentar
Intervall=5
Farbe=#00FF00

[Wetter]
Befehl =~/bin/weather.pl
Intervall=1800

[Zeit]
Befehl=Datum +%T

Um i3blocks als Statuszeile zu verwenden, definieren Sie es in a Bar Block von Ihrem ~/i3/config Datei:

Bar {
status_command i3blocks
}

BLOCK

Die zur Beschreibung eines Blocks verwendeten Eigenschaften sind die im i3bar-Protokoll angegebenen Schlüssel
http://i3wm.org/docs/i3bar-protocol.html, plus zusätzliche Eigenschaften, die von verwendet werden i3blocks zu
Beschreiben Sie, wann und wie ein Block aktualisiert wird. Alle unterstützten Eigenschaften werden unten beschrieben.

Die folgenden Schlüssel sind Standard, siehe http://i3wm.org/docs/i3bar-protocol.html für weitere Einzelheiten.

· voller Text

· kurzer Text

· Farbe

· min_width

· ausrichten

· Name

· Instanz

· dringend

· Separator

· Separator_Block_Breite

· Auszeichnungs

Die folgenden Schlüssel sind spezifisch für i3blocks.

Befehl
Der von einer Shell ausgeführte Befehl, der zum Aktualisieren des Blocks verwendet wird. Das erwartete Verhalten ist
unten beschrieben, in der COMMAND .

Intervall
Wenn es sich um eine positive Ganzzahl handelt, wird der Block beim Start erzeugt und der Wert ist
Wird als Zeitintervall in Sekunden verwendet, um zukünftige Updates zu planen. Wenn nicht angegeben oder 0,
Der Block wird beim Start nicht ausgeführt (was nützlich ist, um Schaltflächen zu simulieren). Wenn
„once“ (oder -1), der Block wird nur beim Start ausgeführt (beachten Sie, dass ein Klick auf oder
Signal wird trotzdem ein Update auslösen). Bei „Wiederholen“ (oder -2) wird der Block ausgeführt
wird beim Start erzeugt und sobald es beendet wird (nützlich, um das Blockieren zu wiederholen
Befehle). Mit Vorsicht verwenden! Bei „persist“ (oder -3) wird der Block nur ausgeführt
beim Start und wird aktualisiert, sobald eine Zeile ausgegeben wird. Somit auf eine einzelne Zeile beschränkt
Updates.

Signal Die Signalnummer, die zum Aktualisieren des Blocks verwendet wird. Alles in Echtzeit (denken Sie priorisiert).
und warteschlangenfähige) Signale stehen dem Benutzer zur Verfügung. Die Zahl ist zwischen 1 und gültig
N, wobei SIGRTMIN+N = SIGRTMAX. (Hinweis: Unter Linux gibt es 31 Echtzeitsignale.)
Zum Beispiel Signal=10 bedeutet, dass dieser Block aktualisiert wird, wenn i3blocks
erhält SIGRTMIN+10.

Etikette Eine optionale Beschriftung, die dem vorangestellt werden soll voller Text nach einem Update.

Format Diese Eigenschaft gibt das Format des Ausgabetextes an. Das Standardformat ist schlicht
Text, wie im beschrieben COMMAND Abschnitt. Wenn „json“ (oder 1) verwendet wird, ist der Block
Die Ausgabe wird als JSON analysiert.

COMMAND

Der Wert der Befehl Der Schlüssel wird unverändert von einer Shell übergeben und ausgeführt.

Die Standardausgabe der Befehlszeile wird zum Aktualisieren des Blockinhalts verwendet. Jede
Eine nicht leere Zeile der Ausgabe überschreibt die entsprechende Eigenschaft:

1. Volltext

2. Kurztext

3. Farbe

Dieses Skript legt beispielsweise fest voller Text in blau aber nein kurzer Text:

echo „Hier ist mein Label“
Echo
echo \#0000FF

Wenn die Befehlszeile 0 oder 33 zurückgibt, wird der Block aktualisiert. Andernfalls gilt es als a
Fehler und die erste Zeile (falls vorhanden) wird weiterhin angezeigt. Beachten Sie, dass stderr ignoriert wird. A
Der Rückkehrcode 33 legt fest dringend Flag auf true setzen.

Dieses Skript gibt beispielsweise den Batterieprozentsatz aus und setzt die Dringlichkeitskennzeichnung, wenn dies der Fall ist
unter 10 %:

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

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

Wenn Sie einen Blockbefehl forken, i3blocks werde die Umgebung mit einigen einstellen BLOCK_*
Variablen. Die folgenden Variablen werden immer bereitgestellt, eventuell mit einer leeren Zeichenfolge als
der Wert.

BLOCK_NAME
Der Name des Blocks (normalerweise der Abschnittsname).

BLOCK_INSTANCE
Ein optionales Argument für das Skript.

BLOCK_BUTTON
Maustaste (1, 2 oder 3), wenn auf den Block geklickt wurde.

BLOCK_X und BLOCKIG
Koordinaten, an denen der Klick stattgefunden hat, sofern auf den Block geklickt wurde.

Hier ist ein Beispiel mit der Umgebung:

[Block]
Befehl=Echoname=$BLOCK_NAME Instanz=$BLOCK_INSTANCE
Intervall=1

[Klick mich]
full_text=Klick mich!
command=echo button=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=button=1 x=1366 y=768
ausrichten = links

Beachten Sie, dass i3blocks Bietet zur Vereinfachung eine Reihe optionaler Skripte, z. B. Netzwerk
Status, Batterietest, CPU-Auslastung, Lautstärke usw.

Beispiele:

Als Beispiel sehen Sie hier eine enge Konfiguration i3status(1) Standardeinstellungen:

ALLES

Intervall=5
Signal=10

[ipv6]

[frei]

[dhcp]

[vpn]

[W-lan]

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

[Batterie]

[Zentralprozessor]

[Terminzeit]

Der folgende Block zeigt die Verwendung von Signal mit einigen i3(1) Bindungen, die die anpassen
Volumen, bevor ein ausgegeben wird pkill -RTMIN+1 i3blocks:

[Volumen]
command=echo -n ´Volume: ´; amixer get Master | grep -E -o ´[0-9][0-9]?%´
Intervall = einmal
Signal=1
# kein Intervall, nur Prüfung auf SIGRTMIN+1

Hier ist ein Beispiel einer sehr minimalistischen Konfiguration, vorausgesetzt, Sie haben eine Reihe von Skripten darunter
~/bin/blocks/ mit dem gleichen Namen wie die Blöcke:

Befehl =~/bin/blocks/$BLOCK_NAME
Intervall=1

[frei]
[W-lan]
[Ethernet]
[Batterie]
[Zentralprozessor]
[Terminzeit]

Nutzen Sie i3blocks online über die Dienste von onworks.net