Ceci est une ancienne révision du document !
Conky : Variables
Variables
Ci dessous la liste (non exhaustive) des variables à placer après TEXT dans votre(vos) fichier(s) conky.
| Fonctions | Ver. | Arguments | Définitions | |
|---|---|---|---|---|
| addr | [interface] | Adresse IP de l'interface spécifié (eth0 par exemple) si aucune adresse indiqué, affiche 'No Address' | ||
| acpiacadapter | ACPI ; état branché/débranché | |||
| acpifan | ACPI ; état ventilateur | |||
| acpitemp | ACPI ; température en °C. | |||
| acpitempf | ACPI ; température en °F. | |||
| 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) | |||
| ↓↓ 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 | ||
| ↑↑ 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 | [color] | Change la couleur d'affichage | ||
| 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. 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) |
|
| 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. | ||
| 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 | ||
| 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 | ||
| 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. | |||
| 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) | ||
| 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) | ||
| 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 | |||
| ↓↓ 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 | |||
| ↑↑ 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