i3blocks - En ligne dans le Cloud

PROGRAMME:

Nom

i3blocs - Un programmateur flexible pour i3bar

SYNOPSIS

i3blocs [-c fichier de configuration] [-v]... [-h] [-V]

DESCRIPTION

i3blocs permet de décrire facilement des blocs dans un format simple, et de générer un état
ligne pour i3bar(1). Il gère les clics, les signaux et l'intervalle de temps pour les scripts utilisateur.

OPTIONS

-c fichier de configuration
Spécifie un autre chemin d'accès au fichier de configuration. Par défaut, i3blocks recherche
fichiers de configuration dans l'ordre suivant (notez que / Etc peut être précédé de
/ Usr / local selon les drapeaux de compilation):

1. ~/.config/i3blocks/config (ou $XDG_CONFIG_HOME/i3blocks/config si défini)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (ou $XDG_CONFIG_DIRS/i3blocks/config si défini)
4. /etc/i3blocks.conf

-v
Niveau de journal. Cette option est cumulative. Par défaut, les messages d'erreur sont affichés sur stderr.
Passé une fois, un échec lors d'une mise à jour est signalé à l'intérieur du bloc. Passé deux fois permet
les messages de débogage sur stderr.

-V
Imprimez la version et quittez.

-h
Imprimez le message d'aide et quittez.

CONFIGURATION

Le fichier de configuration est un fichier ini. Chaque section décrit un nouveau bloc. Une ligne
commençant par un # Le signe est un commentaire et les lignes vides sont ignorées. Une propriété est un
key = paire par ligne, sans espace autour du signe égal. Propriétés déclarées à l'extérieur
un bloc (c'est-à-dire au début du fichier) décrit les paramètres globaux.

Voici un exemple de fichier de configuration :

# Ceci est un commentaire
intervalle=5
couleur=#00FF00

[conditions météorologiques]
commande =~/bin/météo.pl
intervalle=1800

[temps]
commande=date +%T

Pour utiliser i3blocks comme ligne d'état, définissez-le dans un barre bloc de votre ~/i3/config fichier:

bar {
status_command i3blocks
}

BLOC

Les propriétés utilisées pour décrire un bloc sont les clés spécifiées dans le protocole i3bar
http://i3wm.org/docs/i3bar-protocol.html, plus des propriétés supplémentaires utilisées par i3blocs à
décrire quand et comment mettre à jour un bloc. Toutes les propriétés prises en charge sont décrites ci-dessous.

Les touches suivantes sont standard, voir http://i3wm.org/docs/i3bar-protocol.html pour en savoir plus.

· texte intégral

· texte court

· Couleur

· largeur_min

· aligner

· prénom

· instance

· urgent

· séparateur

· séparateur_bloc_largeur

· balisage

Les touches suivantes sont spécifiques à i3blocs.

commander
La commande exécutée par un shell, utilisée pour mettre à jour le bloc. Le comportement attendu est
décrit ci-dessous, dans le COMMAND .

intervalle
S'il s'agit d'un entier positif, le bloc est généré au démarrage et la valeur est
utilisé comme intervalle de temps en secondes pour planifier les futures mises à jour. Si non spécifié ou 0,
le bloc ne sera pas exécuté au démarrage (ce qui est utile pour simuler des boutons). Si
"une fois" (ou -1), le bloc ne sera exécuté qu'au démarrage (notez qu'un clic ou
signal déclenchera toujours une mise à jour). Si "répéter" (ou -2), le bloc sera
généré au démarrage, et dès qu'il se termine (utile pour répéter le blocage
commandes). Utiliser avec précaution! Si "persist" (ou -3), le bloc ne sera exécuté que
au démarrage, et mis à jour dès qu'il sort une ligne. Ainsi limité à une seule ligne
mises à jour.

signal Le numéro de signal utilisé pour mettre à jour le bloc. Tout en temps réel (pensez priorisé
et en file d'attente) des signaux sont disponibles pour l'utilisateur. Le numéro est valable entre 1 et
N, où SIGRTMIN+N = SIGRTMAX. (Remarque : il y a 31 signaux en temps réel sous Linux.)
Par exemple, signal=10 signifie que ce bloc sera mis à jour lorsque i3blocs
reçoit SIGRTMIN+10.

étiquette Une étiquette facultative à insérer dans le texte intégral après une mise à jour.

le format Cette propriété spécifie le format du texte de sortie. Le format par défaut est simple
texte, tel que décrit dans le COMMAND section. Si "json" (ou 1) est utilisé, le bloc
la sortie est analysée en tant que JSON.

COMMAND

La valeur de l' commander key sera passé et exécuté tel quel par un shell.

La sortie standard de la ligne de commande est utilisée pour mettre à jour le contenu du bloc. Chaque
la ligne non vide de la sortie écrasera la propriété correspondante :

1. texte_intégral

2. texte_court

3. couleur

Par exemple, ce script définit le texte intégral en bleu mais non texte court:

echo "Voici mon étiquette"
echo
écho \#0000FF

Si la ligne de commande renvoie 0 ou 33, le bloc est mis à jour. Sinon, il est considéré comme un
échec et la première ligne (le cas échéant) est toujours affichée. Notez que stderr est ignoré. UNE
le code de retour de 33 définira le urgent indicateur à vrai.

Par exemple, ce script imprime le pourcentage de batterie et définit l'indicateur d'urgence s'il est
en dessous de 10 % :

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

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

Lors du fork d'une commande de bloc, i3blocs définira l'environnement avec certains BLOQUER_*
variables. Les variables suivantes sont toujours fournies, avec éventuellement une chaîne vide comme
la valeur.

BLOCK_NAME
Le nom du bloc (généralement le nom de la section).

BLOCK_INSTANCE
Un argument facultatif du script.

BLOCK_BUTTON
Bouton de la souris (1, 2 ou 3) si le bloc a été cliqué.

BLOC_X ainsi que BLOC_Y
Coordonnées où le clic s'est produit, si le bloc a été cliqué.

Voici un exemple utilisant l'environnement :

[bloquer]
command=nom d'écho=$BLOCK_NAME instance=$BLOCK_INSTANCE
intervalle=1

[cliquez moi]
full_text=Cliquez-moi !
command=bouton écho=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=bouton=1 x=1366 y=768
align = gauche

Notez que i3blocs fournit un ensemble de scripts facultatifs pour plus de commodité, tels que le réseau
état, vérification de la batterie, charge du processeur, volume, etc.

EXEMPLES

A titre d'exemple, voici une configuration proche de i3statut(1) paramètres par défaut :

TOUT

intervalle=5
signal=10

[ipv6]

[libre]

[dhcp]

[VPN]

[Wifi]

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

[batterie]

[CPU]

[dateheure]

Le bloc suivant montre l'utilisation de signal avec un certain i3(1) fixations qui ajustent la
volume, avant d'émettre un tuer -RTMIN+1 i3blocs:

[le volume]
command=echo -n ´Volume : ´; amixer obtenir Master | grep -E -o ´[0-9][0-9]?%´
intervalle=une fois
signal=1
# pas d'intervalle, vérifier uniquement sur SIGRTMIN+1

Voici un exemple de configuration très minimaliste, en supposant que vous ayez un tas de scripts sous
~/bin/blocs/ avec le même nom que les blocs :

commande =~/bin/blocs/$BLOCK_NAME
intervalle=1

[libre]
[Wifi]
[Ethernet]
[batterie]
[CPU]
[dateheure]

Utilisez i3blocks en ligne en utilisant les services onworks.net