i3blocks - Online w chmurze

PROGRAM:

IMIĘ

i3blocki - Elastyczny harmonogram dla i3bar

STRESZCZENIE

i3blocki [-C plik konfiguracyjny] [-v]... [-h] [-V]

OPIS

i3blocki pozwala łatwo opisać bloki w prostym formacie i wygenerować status
linia do i3bar(1). Obsługuje kliknięcia, sygnały i interwał czasowy dla skryptów użytkownika.

OPCJE

-c plik konfiguracyjny
Określa alternatywną ścieżkę pliku konfiguracyjnego. Domyślnie szuka i3blocks
pliki konfiguracyjne w następującej kolejności (pamiętaj, że / Etc może być poprzedzony
/ Usr / local w zależności od flag kompilacji):

1. ~/.config/i3blocks/config (lub $XDG_CONFIG_HOME/i3blocks/config, jeśli ustawione)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (lub $XDG_CONFIG_DIRS/i3blocks/config, jeśli ustawione)
4. /etc/i3blocks.conf

-v
Poziom dziennika. Ta opcja ma charakter kumulacyjny. Domyślnie komunikaty o błędach są wyświetlane na stderr.
Po jednokrotnym przejściu w bloku wyświetlana jest awaria podczas aktualizacji. Przekazane dwa razy umożliwia
komunikaty debugowania na stderr.

-V
Wydrukuj wersję i wyjdź.

-h
Wydrukuj komunikat pomocy i wyjdź.

KONFIGURACJA

Plik konfiguracyjny jest plikiem ini. Każda sekcja opisuje nowy blok. Linia
zaczynając od a # znak jest komentarzem, a puste linie są ignorowane. Nieruchomość to
klucz=wartość pary w wierszu, bez spacji wokół znaku równości. Właściwości zadeklarowane na zewnątrz
blok (tj. na początku pliku) opisuje ustawienia globalne.

Oto przykładowy plik konfiguracyjny:

# To jest komentarz
interwał=5
kolor=#00FF00

[pogoda]
polecenie =~/bin/pogoda.pl
interwał=1800

[czas]
polecenie=data +%T

Aby użyć i3blocks jako linii stanu, zdefiniuj ją w a bar blok twojego ~/i3/konfiguracja file:

bar {
polecenie_statusu i3blocks
}

BLOK

Właściwości używane do opisu bloku to klucze określone w protokole i3bar
http://i3wm.org/docs/i3bar-protocol.html, plus dodatkowe właściwości używane przez i3blocki do
opisz, kiedy i jak zaktualizować blok. Wszystkie obsługiwane właściwości zostały opisane poniżej.

Następujące klucze są standardowe, patrz http://i3wm.org/docs/i3bar-protocol.html dla szczegółów.

· pełny tekst

· krótki tekst

· kolor

· min_szerokość

· wyrównać

· Nazwa

· przykład

· pilny

· separator

· szerokość_bloku_separatora

· narzut

Następujące klawisze są specyficzne dla i3blocki.

komenda
Polecenie wykonywane przez powłokę, używane do aktualizacji bloku. Oczekiwane zachowanie to
opisane poniżej, w COMMAND

interwał
Jeśli jest to dodatnia liczba całkowita, blok jest odradzany przy starcie, a wartość wynosi
używany jako przedział czasu w sekundach do planowania przyszłych aktualizacji. Jeśli nie określono lub 0,
blok nie zostanie wykonany przy starcie (co jest przydatne do symulacji przycisków). Gdyby
"raz" (lub -1), blok zostanie wykonany tylko przy starcie (zauważ, że kliknięcie lub
sygnał będzie nadal wyzwalał aktualizację). Jeśli "powtórz" (lub -2), blok będzie
pojawia się przy starcie i zaraz po jego zakończeniu (przydatne do powtórzenia blokowania)
polecenia). Używaj ostrożnie! Jeśli "perist" (lub -3), blok zostanie wykonany tylko
podczas uruchamiania i aktualizowane, gdy tylko wypisze wiersz. W ten sposób ograniczone do jednej linii
aktualizacje.

sygnał Numer sygnału używany do aktualizacji bloku. Cały czas w czasie rzeczywistym (myśl priorytetowe
i kolejkowania) sygnały są dostępne dla użytkownika. Numer jest ważny od 1 do
N, gdzie SIGRTMIN+N = SIGRTMAX. (Uwaga: w systemie Linux jest 31 sygnałów czasu rzeczywistego.)
Na przykład, sygnał=10 oznacza, że ​​ten blok zostanie zaktualizowany, gdy i3blocki
otrzymuje SIGRTMIN+10.

etykieta Opcjonalna etykieta do prepredowania do pełny tekst po aktualizacji.

format Ta właściwość określa format tekstu wyjściowego. Domyślny format to zwykły
tekst, jak opisano w COMMAND Sekcja. Jeśli użyto „json” (lub 1), blok
dane wyjściowe są analizowane jako JSON.

COMMAND

Wartość komenda klucz zostanie przekazany i wykonany tak, jak jest przez powłokę.

Standardowe wyjście wiersza poleceń jest używane do aktualizacji zawartości bloku. Każdy
niepusty wiersz wyjścia nadpisze odpowiednią właściwość:

1. pełny tekst

2. krótki_tekst

3. kolor

Na przykład ten skrypt ustawia pełny tekst na niebiesko, ale nie krótki tekst:

echo "Oto moja etykieta"
przegapić
echo \#0000FF

Jeśli wiersz poleceń zwraca 0 lub 33, blok jest aktualizowany. W przeciwnym razie uważa się to za
awaria i nadal wyświetlany jest pierwszy wiersz (jeśli istnieje). Zauważ, że stderr jest ignorowany. A
kod powrotu 33 ustawi pilny flaga na prawdę.

Na przykład ten skrypt wypisuje procent baterii i ustawia flagę pilne, jeśli tak jest
poniżej 10%:

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

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

Podczas rozwidlania polecenia bloku, i3blocki ustawi środowisko z niektórymi BLOK_*
zmienne. Następujące zmienne są zawsze dostarczane, z ostatecznie pustym ciągiem jako
wartość.

NAZWA_BLOKU
Nazwa bloku (zwykle nazwa sekcji).

BLOK_INSTANCJA
Opcjonalny argument skryptu.

PRZYCISK_BLOKU
Przycisk myszy (1, 2 lub 3), jeśli kliknięto blok.

BLOK_X i BLOK_Y
Współrzędne miejsca kliknięcia, jeśli blok został kliknięty.

Oto przykład z wykorzystaniem środowiska:

[blok]
command=echo name=$BLOCK_NAME instancja=$BLOCK_INSTANCE
interwał=1

[Kliknij]
full_text=Kliknij mnie!
polecenie=przycisk echa=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=przycisk=1 x=1366 y=768
wyrównaj=w lewo

Należy pamiętać, że i3blocki zapewnia zestaw opcjonalnych skryptów dla wygody, takich jak sieć
stan, sprawdzenie baterii, obciążenie procesora, głośność itp.

PRZYKŁADY

Jako przykład, tutaj jest bliska konfiguracja do stan i3(1) ustawienia domyślne:

WSZYSTKO

interwał=5
sygnał=10

[ipv6]

[darmowy]

[dhcp]

[VPN]

[Wi-Fi]

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

[bateria]

[procesor]

[data i godzina]

Poniższy blok pokazuje użycie sygnał z niektórymi i3(1) wiązania, które dostosowują
objętość, przed wydaniem zabić -RTMIN+1 i3blocki:

[Tom]
polecenie=echo -n ´Głośność: ´; mikser zdobądź Mistrza | grep -E -o ´[0-9][0-9]?%´
interwał=raz
sygnał=1
# brak interwału, sprawdź tylko SIGRTMIN+1

Oto przykład bardzo minimalistycznej konfiguracji, zakładając, że masz kilka skryptów pod
~/kosz/bloki/ o tej samej nazwie co klocki:

polecenie =~/kosz/bloki/$BLOK_NAZWA
interwał=1

[darmowy]
[Wi-Fi]
[Ethernet]
[bateria]
[procesor]
[data i godzina]

Korzystaj z i3blocks online za pomocą usług onworks.net