Astuces - Gadgets Linux - Conky

Conky - Variables

Variables

Ci dessous la liste (non exhaustive) des variables à placer après TEXT dans votre(vos) fichier(s) conky.

VariablesVer.ArgumentsDéfinitions
acpiacadapter ACPI ; état branché/débranché
acpifan ACPI ; état ventilateur
acpitemp ACPI ; température en °C.
acpitempf ACPI ; température en °F.
addr[interface] Adresse IP de l'interface spécifié (eth0 par exemple) si aucune adresse indiqué, affiche 'No Address'
adt746xcpu CPU température via la sonde therm_adt746x (iBook notamment)
adt746xfan Vitesse ventilateur via la sonde therm_adt746x
alignr[num] Texte aligné à droite, avec 'num' espaces
alignc[num] Texte centré
apm_adapter État branché/débraché APM (FreeBSD seulement)
apm_battery_life Pourcentage charge batterie APM (FreeBSD seulement)
apm_battery_time Affiche l'autonomie restante sur la batterie (HH:MM:SS) ou "unkown" si branché sur le secteur ou en train de charger (FreeBSD seulement)
↓↓ Spécificité - Audacious ↓↓
audacious_bar [height],[width]Barre de progression d'Audacious [hauteur],[largeur]
audacious_bitrate Bitrate du titre en cours
audacious_channels Nombre de canaux audio du titre en cours
audacious_filename Chemin complet et nom de fichier du titre en cours
audacious_frequency fréquence d'échantillonnage du titre en cours
audacious_length Durée totale du titre en cours (MM:SS)
audacious_length_seconds Durée totale du titre en cours en seconde
audacious_playlist_position Position dans la liste de lecture du titre en cours
audacious_playlist_length Nombre de titres dans la liste de lecture
audacious_position Position dans le titre en cours (MM:SS)
audacious_position_seconds Position dansle titre en cours en seconde
audacious_status État du lecteur (Playing/Paused/Stopped/Not running)
audacious_title [longeur] Titre du morceau en cours
↑↑ Spécificité - Audacious ↑↑
battery[num] Capacité restante de la batterie (ACPI ou APM). Le numéro de la batterie ACPI peut être fournie en argument (par défaut BAT0).
battery_bar[height],[width] [num] Graphique de l'état de la baterie (par défaut num=BAT0).
battery_percent[num] État de la batterie en % (par défaut num=BAT0).
battery_short 1.7.2 [num] État de la batterie simplifié (C en charge, D déchargé, F pleine charge, N non présent, E vide U inconnu).
battery_time[num] Temps restant de la batterie (par défaut num=BAT0).
blink[texte quelconque] Texte clignotant.
bmpx_artist Artiste du morceau en cours (BMPx)
bmpx_album Album du morceau en cours
bmpx_title Titre du morceau en cours
bmpx_track Numéro du titre en cours
bmpx_bitrate Bitrate du titre en cours
bmpx_uri URI du titre en cours
buffers Quantité de mémoire mise en tampon
cached Quantité de mémoire en cache
color[couleur en hexadecimal ex ffffff ou fff (blanc)] Change la couleur d'affichage
colorN [colorN] Change la couleur d'affichage où N est un chiffre compris entre 0 et 9, inclusivement.
conky_build_arch L'architecture de CPU du conky a été compilé pour
conky_build_date Date de compilation du conky
conky_version Version du conky
cpu[cpuN] Utilisation CPU en pourcentage. Pour les machines SMP/dualcare, le numéro du CPU peut être passé en argument : ${cpu 0} désigne l'utilisation totale, ${cpu X} (X >= 1) désigne l'utilisation de chaque CPU (ou de chaque coeur).
cpubar [cpu number] [height],[width] Barre d'activité CPU, 'height' est la hauteur en pixel, 'width' est la largeur en pixel. Voir $cpu pour l'argument 'cpu number'.
cpugauge 1.7.2 [cpu number] [height],[width] Jauge elliptique qui indique l'utilisation du CPU, 'height' est la hauteur en pixel, 'width' est la largeur en pixel. Voir $cpu pour l'argument 'cpu number'.
cpugraph [cpu number] [height],[width] [gradient colour 1] [gradient colour 2] Graphe de l'utilisation CPU, avec des couleurs facultatives en hexa (sans le #). Voir $cpu pour l'argument 'cpu number'.
curl 1.7.2 [http] [port] Téléchargement de données en utilisant Curl, par exemple
${curl http://ouahpiti.info:6097/ip 1440}, donne votre adresse ip toutes les 24h (1440/60) (ne fonctionne pas pour ipv6)
desktop_name 1.7.2 Nom du bureau
desktop 1.7.2 Numéro de bureau courant
desktop_number 1.7.2 Le nombre total de bureaux disponibles
diskio [device] Affiche le débit des entrées/sorties du DD utilisé.
diskiograph[device] [height],[width] [gradient colour 1] [gradient colour 2] [scale] [-t] [-l] Graphe du débit des entrées/sorties du DD, couleurs en hexa (sans le #). Si 'scale' est non-nul, ça devient l'échelle du graphe.
downspeed[net] Vitesse de téléchargement en kilo-octets (net représentant l'interface)
downspeedf[net] Vitesse de téléchargement en kilo-octets avec une décimale
downspeedgraph [net] [height],[width] [gradient colour 1] [gradient colour 2] [scale] Graphe de la vitesse de téléchargement, couleurs en hexa (sans le #). Si 'scale' est non-nul, ça devient l'échelle du graphe.
else Texte à afficher si quelque chose est faux. 'Else' s'utilise avec les variables $if_*. Voir l'explication dans ce post (merci à lol.2.dol pour sa contribution)
exec[command] Exécute la commande indiquée et affiche le résultat dans Conky. Attention : ceci requiert beaucoup plus de ressources que les autres variables. L'auteur conseille de coder la fonction désirée en C et de lui envoyé un patch.
execbar[command] Idem que $exec, sauf que si la première valeur retournée est un nombre entre 0 et 100, ça va utiliser ce nombre pour afficher une barre. La taille de la barre est fixée pour le moment mais ça pourrait changer.
execgauge 1.7.2 [command] Idem que $exec, sauf que si la première valeur retournée est un nombre entre 0 et 100, ça va utiliser ce nombre pour afficher une jauge. La taille de la jauge peut être contrôlé via le paramètre de configuration default_gauge_size.
execgraph[command] idem que $execbar, mais dessine un graphe.
execi[interval] [command] Idem que $exec mais avec un intervalle spécifié. Intervalle qui ne peut être inférieure à $update_interval dans la configuration. Voir aussi $texeci
execibar[interval] [command] idem que execbar, mais avec un intervalle
execigauge 1.7.2 [interval] [command] idem que execgauge, mais avec un intervalle
execigraph[interval] [command] idem que execgraph, mais avec un intervalle
font[font] Spécifie une police différente. Cette nouvelle police sera appliqué à la ligne en cours et à tout ce qui suit. Vous pouvez utilisez $font sans argument pour revenir à la police par défaut (comme avec $color)
freq 1.7.2 [n] Affiche la fréquence du CPU 'n' en MHz. Les CPU sont comptés à partir de 1. (par défaut : 1) "version 1.7.2 donne directement en GHz"
freq_g 1.7.2 [n] Affiche la fréquence du CPU 'n' en GHz. (par défaut : 1) "version 1.7.2 n'est plus utilisé"
freq_dyn 1.7.2 Affiche la fréquence du CPU en MHz mais celle-ci est calculée en comptant les cycles d'horloge pour exécuté une instruction. Seulement disponible sur x86 et amd64. "version 1.7.2 donne directement en GHz"
freq_dyn_g 1.7.2 Comme au dessus mais résultat en GHz. "version 1.7.2 n'est plus utilisé"
fs_bar [height],[width] [fs] Barre affichant l'espace disponible pour la partition désignée. 'height' hauteur en pixel. fs est le nom de la partition. /home par exemple
fs_free[fs] Espace libre diponible aux utilisateurs pour un système de fichiers.
fs_free_perc[fs] Idem mais en pourcetage.
fs_size[fs] taille du système de fichiers.
fs_used[fs] Espace utilisé du système de fichiers
goto[x] L'élément suivant suivant sera affiché à la position 'x'.
hddtemp[device], [host,[port]] Affiche la température du disque indiqué reportée par le démon hddtemp tournant sur la machine host:port. Machine par défaut : 127.0.0.1, port par défaut : 7634.
head[logfile] [N] [interval] Affiche N lignes du fichier indiqué. Si l'intervalle n'est pas spécifié Conky prendra 2 fois l'intervalle par défaut. Maximum de 30 lignes (ou moins si le tampon est plein).
hr [height] Ligne horizontale, 'height' en pixel
i2c [device] [type] [n] Sonde I2C du sysfs (Linux 2.6). "device" peut ne pas être spécifié si vous n'avez qu'une seule sonde I2C. "type" est soit "in" (ou "vol") affichant une tension, "fan" affichant la vitesse du ventilateur ou "temp"/"tempf" (la première en °C, la seconde en °F) affichant la température. "n" est le numéro de la sonde. Voir /sys/bus/i2c/devices/ sur votre machine.
i8k_ac_status Statut branché/débranché tel qu'indiqué dans /proc/i8k par le module i8k du noyau (portables Inspiron).
i8k_bios Version du bios telle qu'indiquée dans /proc/i8k par le module i8k du noyau (portables Inspiron)
i8k_buttons_status Volume audio tel qu'indiqué dans /proc/i8k par le module i8k du noyau (portables Inspiron)
i8k_cpu_temp Température CPU en °C telle qu'indiquée dans /proc/i8k par le module i8k du noyau (portables Inspiron)
i8k_cpu_tempf Température CPU en °F telle qu'indiquée dans /proc/i8k par le module i8k du noyau (portables Inspiron)
i8k_left_fan_rpm Vitesse du ventilateur gauche telle qu'indiquée dans /proc/i8k par le module i8k du noyau (portables Inspiron). Attention, certains portables i8k inversent l'ordre des ventilateurs.
i8k_left_fan_status Statut du ventilateur gauche tel qu'indiqué dans /proc/i8k par le module i8k du noyau (portables Inspiron). Attention, certains portables i8k inversent l'ordre des ventilateurs.
i8k_right_fan_rpm Vitesse du ventilateur droit telle qu'indiquée dans /proc/i8k par le module i8k du noyau (portables Inspiron). Attention, certains portables i8k inversent l'ordre des ventilateurs.
i8k_right_fan_status Statut du ventilateur droit tel qu'indiqué dans /proc/i8k par le module i8k du noyau (portables Inspiron). Attention, certains portables i8k inversent l'ordre des ventilateurs.
i8k_serial Numéro de série du portable tel qu'indiqué dans /proc/i8k par le module i8k du noyau (portables Inspiron).
i8k_version Numéro de version i8k (portables Inspiron).
ibm_fan Vitesse ventilateur (nécessite l'ACPI IBM)
ibm_temps[N] Affiche la température de la sonde N (de 0 à 7). 0 correspond au CPU, 3 au GPU (nécessite l'ACPI IBM)
ibm_volume Volume audio (de 0 à 14) (nécessite l'ACPI IBM)
ibm_brightness [0-7] Luminosité de l'écran (de 0 à 7) (nécessite l'ACPI IBM)
iconv_start[codeset_from] [codeset_to] Convertie du texte d'un encodage à un autre (avec GNU iconv). À stopper avec $iconv_stop.
iconv_stop Stop la conversion de texte démarrée avec $iconv.
if_running[process] Si le processus 'process' tourne, affiche tout entre ce if_running et le $endif correspondant. (cf l'exemple de $if_mounted)
if_existing[file] Si le fichier 'file' existe, affiche tout entre ce if_existing et le $endif correspondant. (cf l'exemple de $if_mounted)
if_mounted[mountpoint] Si le point de montage 'mountpouint' est monté, affiche tout entre ce if_mounted et le $endif correspondant. (cf la variable $else ou ce post, merci à lol.2.dol pour cette contribution)
image 1.7.2 [chemin de l'image] [-p x,y] [-s LxH] [-n] [-f intervalle] Affiche une image à partir du chemin spécifié à l'aide Imlib2', voici un exemple :
    ${image $HOME/mon image.jpg -p 10,10 -s 300x300}
et un cadeau merci à wido pour l'idée:
    ${image $HOME/.aeroport.jpg -p 10,10 -s 300x300}${texeci 300 /usr/bin/wget -q http://www.aeroport.public.lu/webcam/webcam2.jpg -O $HOME/.aeroport-cache.jpg && mv $HOME/.aeroport-cache.jpg $HOME/.aeroport.jpg}${voffset 260}.
imap_messages [args] Affiche le nombre de message dans votre boîte IMAP par globale. Vous pouvez définir des boîtes IMAP individuelles avec les arguments suivants : "host user pass [-i interval] [-p port] [-e command]". Port par défaut : 110, intervalle par défaut : 5 minutes. Si le mot de passe est '*', il vous sera demander au démarrage de Conky.
imap_unseen[args] Afiche le nombre de message non-lus dans votre boîte IMAP globale. Vous pouvez définir des boîtes IMAP individuelles avec les arguments suivants : "host user pass [-i interval] [-p port] [-e command]". Port par défaut : 110, intervalle par défaut : 5 minutes. Si le mot de passe est '*', il vous sera demander au démarrage de Conky.
kernel Version du noyau
linkstatus[interface] affiche le statut des connections sans fils
loadavg[1,2,3] Charge moyenne du système : 1 pour la minute passée, 2 pour les 5 dernières minutes, 3 pour les 15 dernières minutes.
machine "architecture" de la machine, i686 par example
mails nombre de mail dans votre boîte. Vous pouvez utilisez un programme comme fetchmail pour rapatrier vos mails depuis un serveur. Voir aussi $new_mails.
mem Quantité de mémoire utilisée
membar [height],[width] Barre de la mémoire utilisée
memmax Quantité totale de mémoire
memperc pourcentage de mémoire utilisée
↓↓ Spécificité - MPD ↓↓
mpd_artist Artiste du titre en cours (MPD)
mpd_album Album du titre en cours
mpd_bar[height],[width] barre de progression du titre en cours
mpd_bitrate Bitrate du titre en cours
mpd_status statut de MPD (en pause etc)
mpd_title titre du morceau en cours
mpd_vol volume de MPD
mpd_elapsed temps écoulé du morceau en cours
mpd_length durée du morceau en cours
mpd_percent pourcentage de progression du morceau en cours
mpd_random[on|off] Mode aléatoire (On/Off)
mpd_repeat[on|off] Mode répétition (On/Off)
mpd_track Morceau en cours
mpd_name Prints the MPD name field (qu'est-ce que c'est ? à tester)
mpd_file nom de fichier du morceau en cours
mpd_smart affiche le titre de la chanson sous la forme "artiste - titre" ou le nom de fichier en fonction de ce qui est disponible
↑↑ Spécificité - MPD ↑↑
new_mails Mails non lus dans la boîte
nodename nom de la machine
outlinecolor[color] change la couleur du contour
pb_battery item[status|percent|time] Pour Apple powerbook/ibook, affiche le statut de la batterie. Item représente le paramètre à afficher. Exacement un paramètre doit être spécifié.
Paramètres valides :
- status : affiche si la batterie est complètement chargée, en chargement, en train de se décharger ou absente (machine branchés sur le secteur
- percent : affiche le pourcentage de charge (si en train de se charger ou de se décharger). Rien ne sera affiché si la batterie est complètement chargée ou si la machine est branchée sur le secteur
- time : affiche le temps restant avant que la batterie soit complètement chargée ou déchargée selon l'utilisation en cours. Rien ne sera affiché si la batterie est absente ou si elle ne se décharge pas.
pop3_unseen[args] Affiche le nombre d'emails non lus dans la boîte POP3 globale. Vous pouvez définir des boîtes POP3 individuelles avec les arguments suivants : "host user pass [-i interval] [-p port] [-e command]". Port par défaut : 110, intervalle par défaut : 5 minutes. Si le mot de passe est '*', il vous sera demander au démarrage de Conky.
pop3_used[args] Affiche l'espace utilisé dans votre boîte POP3 globale (en MiB). Vous pouvez définir des boîtes POP3 individuelles avec les arguments suivants : "host user pass [-i interval] [-p port] [-e command]". Port par défaut : 110, intervalle par défaut : 5 minutes. Si le mot de passe est '*', il vous sera demander au démarrage de Conky.
pre_exec[shell] [command] Exécute la commande une fois avant le premier affichage de Conky et affiche la sortie en texte.
processes Nombre totals de processus.
running_processes Nombre de processus tournants (nécessite un noyau 2.6)
shadecolor[color] Change la couleur de l'ombre
stippled_hr[space] Barre horizontale en pointillés
swapbar[height],[width] Barre affichant la swap utilisée
swap Swap utilisée
swapfree 1.7.2 Swap libre
swapmax Swap totale
swapperc Pourcentage de swap utilisée
sysname Nom du système, Linux par exemple
tcp_portmon[port_begin] [port_end] [argument] [index] Moniteur de ports TCP. Les numéros de port doivent doivent être dans l'intervalle 1 à 65535.
Les [arguments] possibles sont :
count : nombre total de connexions dans l'intervalle spécifié
rip : adresse ip distante
rhost : nom de l'hôte distant
rport : numéro du port distant
rservice : nom du service distant (depuis /etc/services)
lip : adresse ip locale
lhost : nom de l'hôte local
lport : numéro du port local
lservice : nom du service local (depuis /etc/services)
– L'index de connexion fournit l'accès à chaque connexion au moniteur de port. Celui-ci vous retourne les informations pour des valeurs d'index comprises entre les connexions 0 et n-1. Les valeurs au-dessus de n-1 sont ignorées. Pour l'argument 'count', l'index de connection ne doit pas être spécifié mais est requis pour tous les autres arguments.
Exemples :
${tcp_portmon 6881 6999 count} affiche le nombre de connexions dans la plage d'ip bittorrent.
${tcp_portmon 22 22 rip 0} affiche l'adresse ip distante de la première connexion ssh
${tcp_portmon 22 22 rip 9} affiche l'adresse ip distante de la dixième connexion ssh
${tcp_portmon 1 1024 rhost 0} affiche le nom d'hôte distant de la première connexion sur le port indiqué (1024 ici)
${tcp_portmon 1 1024 rport 4} affiche le port distant de la cinquième connexion sur le port indiqué
${tcp_portmon 1 65535 lservice 14} affiche le nom du service local de la quinzième connexion dans la plage complète (1 à 65535)
– NB: les variables du moniteur de port qui partage le même port font référence au même moniteur, ainsi plusieurs références à une plage particulière pour différentes infos et différents index utilisent en interne le même moniteur. Autrement dit Conky ne crée pas de moniteurs redondants.
texeci [interval] [commande] Exécute la commande spécifiée dans une tâche toutes les 'interval' secondes et affiche la sortie. Identique à $execi, excepté que la commande est exécutée dans une tâche porpre. Utilisez cette variable si vous avez un script assez lent afin que Conky continue le rafraîchissement. Vous devriez mettre un intervalle légèrement plus long que le temps d'éxécution que votre script. Par exemple si votre script met 5 secondes à s'exécuter vous devriez mettre un intervalle d'au moins 6 secondes. Voir aussi $execi.
offset [pixels] bouge le texte de N pixels. Voir aussi $voffset.
tab [width, [start]] met une tabulation de largeur 'width' démarrant à la colonne 'start'. (à tester)
tail[logfile] [N] [interval] Affiche les dernières N lignes du ficher texte en question. Intervalle par défaut : 2 fois le temps de raffraîchissement de Conkyl. Maximum de 30 lignes (ou moins si le tampon de texte est plein) (à tester)
time[format] Heure locale (cf man strftime pour plus d'information sur la syntaxe)
utime[format] Affiche l'heure en UTC (universal coordinate time). (man strftime pour la syntaxe)
tztime [timezone] [format] Heure locale du fuseau horaire spécifié. (man strftime pour la syntaxe). Le fuseau horaire est spécifié de la même manière que la variable d'environnement TZ. Regardez du côté de /usr/share/zoneinfo pour toutes les zones possibles.
totaldown[net] Taille totale des données téléchargées. Il est indiqué une remise à zéro à 4 Go sur un noyau 32bits mais il me semble avoir vu des quatités supérieurs à ça sur mon P4C donc à vérifier).
top [type] [num] Processus classés par ordre décroissant d'utilisation CPU (ce qui correpond à 'num' : 1 étant le plus gourmand). Les types peuvent être : "name", "pid", "cpu", and "mem". Affichage maximal de 10 processusThere can be a max of 10 processes listed.
top_mem[type] [num] Comme top mais considère la consommation mémoire des processus.
totalup[net] quantité totale de données envoyées.
updates nombre de rafraîchissement (utile pour le debuggage)
upspeed[net] Débit d'envoi en Ko
upspeedf[net] Débit d'envoi en Ko avec une décimale
upspeedgraph[net] [height],[width] [gradient colour 1] [gradient colour 2] [scale] [-t] [-l] Graphe du débit d'envoi, couleurs en hexa sans le #. Si scale (l'échelle) est différent de 0, ça devient l'échelle du graphe.
uptime Temps depuis que l'ordinateur à démarré
uptime_short uptime (format plus court)
voffset[pixels] Modifie l'alignement vertical de N pixels. Des valeurs négatives provoqueront le chevauchement du texte. Voir aussi $offset.
voltage_mv[n] Affiche la tension du CPU numéro N en mV. Les CPUs sont comptés à partir de 1. Par défaut n=1.
voltage_v[n] Affiche la tension du CPU numéro N en V. Syntaxe identique à voltage_mv.

 

Liens

FAQ Conky Variables : http://conky.sourceforge.net/variables.html [en]
Traduction Variables : http://www.pcinpact.com/forum/index.php?s=&showtopic=97542&view=findpost&p=1688803 [fr]