conky

Conky est une application qui délivre en temps réel des informations sur votre système. Ces informations s'affichent sur votre bureau, dans une fenêtre classique, dans une barre de status comme dzen ou dans une barre de statut propre à un gestionnaire de fenêtres, comme dwm ou wmfs.
Conky est livré avec de nombreuses options internes mais peut aussi faire appel à des scripts (bash,python,lua…), ce qui lui permet d'afficher à peu près tout ce que vous voulez et comme vous le voulez.
La configuration de Conky passe par l'édition du fichier de type .conkyrc* situé dans votre dossier ~/.conky sur livarp.
Ce fichier se divise en deux parties:

les ”fonctions“ déterminent l'emplacement, la dimension, le type de fenêtre, la couleur du texte…
les ”variables“ déterminent la nature des informations à afficher.

La séparation se fait par la ligne “TEXT” dans le conkyrc; tout ce qui vient après TEXT sera affiché dans votre conky.
Si vous désirez vous appuyer sur des exemples pour construire votre conky, vous pouvez vous inspirez des conkys présent sur livarp ou visiter ma page gallerie'conky (conkyrc, script, fonts, walls inclus).

conky sur livarp

livarp utilise conky de différentes manières selon les sessions:

conky affiché dans la barre de statut pour dwm et wmfs (conkyd*)
conky affiché à l'écran pour les sessions vtwm, awesome, evilwm, pekwm, fluxbox et openbox

la configuration des différents conkys passe par l'édition de leurs fichiers respectifs situés dans ~/.conky/* et nommés par le gestionnaire de fenêtre dans lequel ils sont utilisés: ~/.conky/.conkyrc_dwm, ~/.conky/.conkyrc_evil ...

les autres conkys présents dans ~/.conky, nommés ~/.conky/livarp_cky* étaient utilisés par conky-switcher dans livarp_0.3.9 et sont là pour tester.

*conkyd est une copie de conky destinée à préserver l'affichage des barres de status lors d'un 'killall conky'.

configuration de conky

livarp fournit assez d'exemples pour vous faire une idée du "comment fonctionne conky". un wiki complet en français est disponible en ligne. je vous livre ici une liste simplifiée des fonctions et variable disponibles (traduction du man)

les fonctions

format: fonction [arguments]: description

alignment [top_left,top_right,top_middle,bottom_left,bottom_right,bottom_middle,middle_left,middle_middle,middle_right]: position de conky sur l'écran
apend_file [adresse_du_fichier]: prend en compte un fichier: les fonctions seront rejoutées à celles du conky en cours

background [yes ou no]: si yes, conky sera lancé en “background”: il vous rendra la main
border_inner_margin [nombre (pixels)]: espace en pixels entre le texte et la bordure
border_outer_margin [nombre (pixels)]: espace en pixels entre la bordure et le bord de la fenêtre
border_width [nombre (pixels)]: épaisseur de la bordure en pixels

colorN(0→9) [hexadecimal “XXXXXX” sans ”#“]: couleur prédéfinie (de 0 à 9) à utiliser dans la zone TEXT
cpu_avg_samples [nombre]: échantillon à prendre en compte pour le monitoring du cpu

default_bar_size [nombre(pixels) hauteur longueur]: dimensions par défaut des barres, ex: 'default_bar_size 4 10'. très utile pour les fonctions execbar et execibar
default_color [hexadécimal/couleur]: couleur par défaut du texte et des bordures, ex: 'default_color ffffff' ou 'default_color white'
default_gauge_size [(pixels) hauteur longueur]: dimensions par défaut des compteurs, ex 'default_gauge_size 15 15'
default_graph-size [(pixels) hauteur longueur]: dimensions par défaut des graphiques, ex 'default_graph-size 4 10'
default_outline_color [hexadécimal/couleur]: couleur par défaut du contour de la police
default_shade_color [hexadécimal/couleur]: couleur par défaut de l'ombre de la police et des graphiques
disable_auto_reload [yes ou no]: si yes, conky ne recharge pas son fichier de configuration après une modification
diskio_avg_samples [nombre]: échantillon à prendre en compte pour le monitoring du la lecture/écriture
display [nombre]: choix de l'écran pour l'affichage
double_buffer [yes ou no]: si yes, utilise l'extension Xdbe: permet d'éliminer le clignotement. Il est recommandé d'utiliser une fenêtre propre pour Conky afin de limiter la taille du double tampon
draw_borders [yes ou no]: si yes, conky affiche une bordure autour du texte
draw_graph_borders [yes ou no]: si yes, conky dessine une bordure autour des graphiques
draw_outline [yes ou no]: si yes, conky utilise la police avec un contour
draw_shades [yes ou no]: si yes, conky affiche les ombres sous le texte et les graphiques

extra_newline [yes ou no]: si yes et si 'out_to_console yes', conky rajoute une ligne en fin de fichier. Utile pour “piper” conky dans une wibox d'awesome

font [nom_de_la_police]: détermine la police utilisée par conky. -- obsolète -- voir xftfont
format_human_readable [yes ou no]: si yes, conky tente d'afficher les valeurs dans un format lisible (Kib,Mib,Gib). si no, conky affiche toutes les valeurs en bytes

gap_x [nombre (pixels)]: marge en pixels entre le bord de l'écran et le coté droit/gauche de la fenêtre conky
gap_y [nombre (pixels)]: marge en pixels entre le bord de l'écran et le haut/bas de la fenêtre conky

hddtemp_host [XXX.X.X.X]: hôte sur lequel se connecte hddtemp, défaut: 127.0.0.1
hddtemp_port: port utilisé par hddtemp, défaut: 7634

if_up_sctrictness [up, link, address]: détermine comment conky évalue la connexion réseau
imap: serveur gloal IMAP; arguments : “host user pass [-i interval] [-f folder] [-p port] [-e command]”. Port par défaut: 143, dossier par défaut: 'INBOX', intervalle par défaut: 5 minutes. Si le mot de passe est '*', il vous sera demandé au démarrage de Conky.
imlib_cache_flush_interval [nombre(secondes)]: intervalle de rafraichissement du cache imlib en secondes
imlib_cache_size [nombre (bytes)]: taille du cache imlib, par défaut: 4MiB. Si conky affiche de nombreuses images, il est conseillé de le désactiver avec 'imlib_cache_size 0'

lua_draw_hook_post [nom_de_la_fonction]: FIXME
lua_draw_hook_pre [nom_de_la_fonction]: FIXME
lua_load [adresse du/des script(s)]: conky charge le(s) script(s) lua, ex: 'lua_load ~/.conky/clock.lua'.
lua_shutdown_hook [nom_de_la_fonction]: vide le cache de la 'fonction' afin préserver le système à l'extinction
lua_startup_hook [nom_de_la_fonction]: FIXME

mail_spool: mail spool pour la vérification des mails
max_port_monitor_connections [nombre]: nombre maximum de scan par port, par défaut 256.
max_specials [nombre]: nombre maximal de variables spéciales; fonts, offsets, aligns… par défaut 512
max_user_text [nombre (bytes)]: taille maximale du buffer utilisateur, par défaut 16384 bytes
maximum_width [nombre (pixels)]: largeur maximale de la fenêtre conky en pixels
minimum_size [largeur hauteur (pixels)]: dimension minimale de la fenêtre conky, ex: 'minimum_size 200 500'
mpd_host: hôte pour mpd music player daemon
mpd_password: mot de passe du serveur mpd
mpd_port: port pour mpd
music_player_interval [nombre (seconds)]: intervalle de vérification des données des lecteurs audio, par défaut: celui de conky

net_avg_samples [nombre]: échantillon à prendre en compte pour le monitoring du net
no_buffers [yes ou no]: si oui, conky ne prend pas en compte le buffer dans le calcul de l'utilisation mémoire

out_to_console [yes ou no]: si yes, envoi des informations de conky au STDOUT. Utile pour “piper” conky dans une statusbar
out_to_ncurses [yes ou no]: si yes, comme 'out_to_console' mais avec un rafraichissement de l'affichage au lieu d'une succession d'informations
out_to_stderr [yes ou no]: si yes, envoi des informations de conky au STDERR
out_to_x [yes ou no]: si no, pas d'affichage dans X: vérifier qu'aucune fonction graphique ne soit enclenchée, et vérifier l'envoi des informations vers STDOUT ou STDERR
override_utf8_locale [yes ou no]: si yes, conky force l'encodage local utf-8. requiert XFT
overwrite_file [adresse_du_fichier]: écrase le fichier donné en argument
own_window [yes ou no]: si yes, conky dessine sa propre fenêtre
own_window_class [nom 'WM_CLASS']: determine manuellement le 'WM-CLASS' de conky, par défaut: Conky
own_window_color [hexadécimal/couleur]: couleur de la fenêtre conky, ex: 'own_window_color 000000' ou 'own_window_color black'
own_window_hints [undecorated,below,above,sticky,skip_taskbar,skip_pager]: si 'own_window yes', configure les propriétés de conky dans le WM. si 'own_window_type desktop', certaines valeurs sont définies par défaut. si 'own_window_type override', ces valeurs sont ignorées.
own_window_title [titre]: determine manuellement le titre de la fenêtre conky, par défaut: 'hôte - conky'
own_window_argb_visual [yes ou no]: ARGB est utilisé pour les effets de transparence. Notez que vous aurez besoin d'un gestionnaire composite pour cela. Cette option fonctionne avec la fonction 'own_window_type override'.
own_window_argb_value [nombre (0~255)]: niveau de transparence pour conky, où 0=transparent et 255=opaque. Notez que si 'own_window_transparent yes', cette fonction n'a pas d'effet.
own_window_transparent [yes ou no]: si yes, conky est transparent: comme 'own_window_argb_value 0'
own_window_type [normal,desktop,dock,panel,override]: si 'own_window yes', determine le type de fenêtre utilisé par conky, par défaut: 'normal': conky est traité comme les autre fenêtres et est controlé par le WM.
'desktop': aucune décoration, pas dans la barre des taches, visible sur tous les bureaux virtuels.
'dock': conky est placé dans le dock et en prend les propriétés, utile pour les wm possédant cette option (*box, pekwm..).
'panel': conky adopte les propriétés d'une barre de tache: pas de décoration, non-recouvrable par les fenêtres maximisées, visible sur tous les bureaux.
'override': conky n'est pas contrôlé par le WM, les 'hints'(conseils) sont ignorés. Cette option peut être utile pour les tilingWM (dwm,awesome,xmonad…).

pad_percents: FIXME
pop3: serveur global POP3; arguments : “host user pass [-i interval] [-p port] [-e command]”. Port par défaut : 110, intevalle par défaut : 5 minutes. Si le mot de passe est '*', il vous sera demandé au démarrage de Conky

short_units [yes ou no]: réduit l'affichage des unités: kiB=k, GiB=G, … 'no' par défaut
show_graph_range [yes ou no]: si yes, conky affiche l'amplitude des graphiques. 'no' par défaut
show_graph_scale [yes ou no]: si yes, affiche la valeur maximale dans les graphiques
stippled_borders [nombre (pixels)]: si 'draw_borders yes', taille en pixels des pointillés de la bordure de conky

temperature_unit [farenheit ou celsius]: détermine les unités de température, par défaut: celsius
templateN [nombre (0~9)]: determine un modèle à utiliser après TEXT.FIXME expliquer la syntaxe des modèles
text_buffer_size [nombre (bytes)]: taille du buffer utilisé par conky, par défaut/minimum: 256. Ce tampon est utilisé pour stocker les informations renvoyées par les variables. tester plusieurs valeurs pour choisir entre la quantité de variables affichées et les performances de conky
times_in_seconds [yes ou no]: si yes, les variables de temps sont affichées en secondes. cette fonctions n'affecte pas $time, $tztime, ou $utime
top_cpu_separate [yes ou no]: si yes, la variable 'top' renvoie l'usage d'1 processeur, si no, 'top' renvoi l'usage des processeurs combinés.
top_name_width [nombre]: longueur des noms des processus renvoyés par 'top', par défaut: 15
total_run_times [nombre]: nombre de rechargements de conky avant de quitter. 0 fait tourner conky indéfiniment

update_interval [nombre (secondes)]: fréquence de rafraichissement de conky
update_interval_on_battery [nombre (secondes)]: fréquence de rafraichissement de conky sur battery
uppercase [yes ou no]: si yes, affiche les caractères en majuscules
use_spacer [left,right,none]: ajoute un espace avant ou après certaines variables pour les empêcher de bouger. ne fonctionne qu'avec une police à chasse fixe
use_xft [yes ou no]: si yes, conky utilise les polices 'xft', active l'anti-crenelage

xftalpha [nombre (0~1)]: opacité de la police définie par 'xftfont', 0=transparent, 1=opaque
xftfont [nom_de_la_police:size=nombre]: si 'use_xft yes', détermine la police par défaut utilisée par conky. ex: 'xftfont Terminus:pixelsize=10' - 'xftfont Aller:size=8:bold'
TEXT: ici commence l'affichage des variables

les variables

format: variable [arguments]: description

acpiacadapter: indique l'état du chargeur acpi: branché/débranché
acpifan: indique les infos du capteur acpi pour le ventilateur
acpitemp: indique la temperature captée par acpi
addr [interface]: adresse IP pour l'interface désignée, ex: '${addr eth0}'
addrs [interface]: comme 'addr' pour linux seulement
adt746xcpu: température du capteur therm_adt746x
adt746xfan: vitesse du ventilateur captée par therm_adt746x
alignc [nombre ('n'pixels)]: alignement du texte au centre de la ligne, avec un décallage de 'n'(en option), ex: '${alignc 10}'
alignr [nombre ('n'pixels)]: alignement du texte à droite de la ligne, avec un décallage de 'n', ex: '${alignr 5}'

battery [nom_de_la_batterie]: affiche le statut de la batterie et la charge en pourcentage, ex: '${battery BAT0}'
battery_bar [hauteur,longueur][nom_de_la_batterie]: affiche une barre de progression de la charge de la batterie, ex: ${battery_bar 4,40 BAT0}'
battery_percent [nom_de_la_batterie]: affiche la charge de la batterie en pourcentage, ex: '${battery BAT0}%'
battery_short [nom_de_la_batterie]: affiche le statut de la batterie en format court et la charge en pourcentage
battery_time [nom_de_la_batterie]: temps restant avant la (de)charge complète de la batterie
blink ['text' ou 'variable']: fait clignoter 'text' et/ou 'conky_variables' au rhytme de 'update_interval'
buffers [nombre (bytes)]: taille de la mémoire tampon

cached [nombre (bytes)]: taille de la mémoire en cache
color [#hexadécimal/couleur]: change la couleurdu texte qui suit, ex: '${color #01AB2C}${cpu cpu0}%${color}'. notez la variable '${color}' en fin de ligne pour rétablir la couleur par défaut.
colorN: change la couleur du texte qui suit en utilisant un couleur prédéfinie par la fonction 'colorN'. ex: '${color1}${cpu cpu0}%${color2}${cpugraph cpu0 6,40}${color}'.
conky_build_arch: architecture du processeur sur lequel conky a été construit
conky_build_date: date à laquelle conky a été construit
conky_version: version du conky utilisé
cpu [cpu'x']: utilisation du/des processeur(s) 'x' en pourcentage. '${cpu}' ou '${cpu cpu0}', affiche l'utilisation totale des processeurs. '${cpu cpux}' ou x>=1, affiche l'utilisation individuelle des processeurs.
cpubar [cpux hauteur,longueur]: affiche une barre d'état pour l'utilisation du/des processeur(s), ex: '${cpubar cpu0 10,60}'
cpugauge [cpux hauteur,largeur]: affiche un compteur d'utilisation du/des processeurs 'x', ex: '${cpugauge cpu2 25,25}'
cpugraph [hauteur,longueur couleur1 couleur2 scale -t -l]: affiche un graphique de progression de l'usage du/des processeurs. ex: '${cpugraph cpu0 20,120 222222 D7D7D7 -t}'
curl [url temps (minutes)]: récupère des données d'une adresse 'url' à un intervalle 'temps', par défaut: 15 minutes

desktop: numéro du bureau sur lequel conky est affiché
desktop_name: nom du bureau sur lequel conky est affiché
desktop_number: nombre total de bureaux sur lequel conky peut s'afficher
disk_protect [disque]: état de protection du disque 'disque' si supporté par le noyau
diskio [disque]: affiche la quantité de données en lecture/écriture sur le disque 'disque', ex: '${diskio /dev/sda}/s'.
diskio_read [disque]: affiche la quantité de donnée en lecture sur le disque 'disque'
diskio_write [disque]: affiche la quantité de donnée en écriture sur le disque 'disque'
diskiograph [disque hauteur,longueur couleur1 couleur2 scale -t -l]: affiche un graphique de progression des données en lecture/écriture sur le disque 'disque'. ex: '${diskiograph /dev/sda3 15,70 ffffff 000000 -t}'
diskiograph_read [disque hauteur,longueur couleur1 couleur2 scale -t -l]: affiche un graphique de progression des données en lecture sur le disque 'disque'
diskiograph_write [disque hauteur,longueur couleur1 couleur2 scale -t -l]: affiche un graphique de progression des données en écriture sur le disque 'disque'
downspeed [interface]: affiche la quantité de données téléchargées pour 'interface', ex: '${downspeed eth0}/s'
downspeedf [interface]: affiche la quantitée de données téléchargées en KiB pour 'interface'
downspeedgraph [interface hauteur,longueur couleur1 couleur2 scale -t -l]: affiche un graphique des données téléchargées pour 'interface', ex: '${downspeedgraph eth0 10,60 FFFFFF 000000}'
draft_mails [maildir intervalle]: affiche le nombre de mails marqué comme brouillons dans 'maildir'

else: texte à afficher si la condition “if” n'est pas valide, ex: '${if_up eth0}réseau ethernet disponible${else}pas de réseau ethernet${endif}'
endif: fin un bloc 'if'/'else'
exec [commande]: execute une commande au rhytme de 'update_interval',et affiche son résultat dans conky, ex: '${exec cat ~/todo | grep important}'. préférez la commande '$execi' pour préserver vos ressources. voir aussi "texec*"
execbar [commande]: affiche une barre d'état de la 'commande' si celle-ci renvoie un résultat entre 0et100. les dimensions de la barre peuvent être réglées grâce à 'default_bar_size'
execgauge [commande]: affiche un compteur d'état de la 'commande' si celle-ci renvoie un résultat entre 0et100. les dimensions du compteur peuvent être géglées grâce à 'default_gauge_size'
execgraph [-t -l commande]: affiche un graphique d'état de la 'commande' si celle-ci renvoie un résultat entre 0et100. les dimensions du graphique peuvent être réglées grâce à 'default_graph_size'. si le premier argument est '-t' ou '-l', pensez à le faire précéder d'un espace ' '
execi [intervalle commande]: idem que 'exec' mais la 'commande' se lance à un 'intervalle' spécifique. l''intervalle' doit être >= 'update_interval'. voir aussi '$texeci'.
execibar [intervalle commande]: idem que 'execbar' mais la 'commande' se lance à un 'intervalle' spécifique
execigauge [intervalle commande]: idem que 'execgauge' mais la 'commande' se lance à un 'intervalle' spécifique
execigraph [-t -l commande]: idem que 'execgraph' mais la 'commande' se lance à un 'intervalle' spécifique
execp [commande]: exécute une commande et affiche son résultat dans conky. accepte la syntaxe de conky. vous pouvez inclure des expressions telles que '${color1}text${color}' dans votre 'commande'
execpi [intervalle commande]: idem que 'execp' mais la 'commande' se lance à un 'intervalle' spécifique

flagged_mails [maildir intervalle]: affiche le nombre de mails 'marqués' dans 'maildir'
font [nom_de_la_police:size=nombre]: spécifie une police particulière pour le texte qui suit, ex: '${font Terminus:pixelsize=10}${color1}heure:${time %I:%M}${font}${color}'. notez que '${font}' restaure la police par défaut
forwarded_mails [maildir intervalle]: affiche le nombre de mails marqués comme 'transférés' dans 'maildir'
freq [n]: affiche la fréquence du processeur 'n'>=1 en MHz.
freq_g [n]: affiche la fréquence du processeur 'n'>=1 en GHz.
fs_bar [hauteur,longeur fs]: affiche une barre d'état pour l'occupation de 'fs', ex: '${fs_bar /home/arp 6,20}'
fs_bar_free [hauteur,longeur fs]: affiche une barre d'état pour l'espace libre sur 'fs'
fs_free [fs]: affiche l'espace disponible sur 'fs', ex: ${fs_free /media/backup/}'
fs_free_perc [fs]: affiche le pourcentage d'espace disponible sur 'fs'
fs_size [fs]: affiche la taille de 'fs'
fs_type [fs]: affiche le type de système de fichiers de 'fs' (ext2,ext3,ext4,vfat,ntfs..)
fs_used [fs]: affiche l'espace utilisé sur 'fs'
fs_used_perc [fs]: affiche le pourcentage d'espace utilisé sur 'fs'

gid_name [gid]: affiche le groupe correspondant à 'gid'
goto [x]: déplace le prochain élément au pixel 'x'
gw_iface: affiche l'interface du router ou 'multiple' ou 'aucun' selon l'état
gw_ip: affiche l'IP de la passerelle par défaut ou 'multiple' ou 'aucune' selon l'état

hddtemp [disque]: affiche la température du 'disque'. nécessite que le démon hddtemp soit lancé et accessible par l'utilisateur
head [fichier nombre check]: affiche les 'n'(nombre) premières lignes du 'fichier' spécifié. l'intervalle de vérification est défini par 'check' en secondes, par defaut , check=2sec
hr [nombre ('n'pixels)]: trace une ligne horizontale d'épaisseur 'n'
hwmon [dev type n factor offset]: affiche les informations transmises par la sonde hwmon de sysfs (Linux2.6). 'dev' peut être ignoré si vous n'avez qu'un seul capteur. le type peut être 'in'/'vol' pour voltage, 'fan' ou 'temp'. 'n' est le numéro de la sonde (voir /sys/class/hwmon).'factor' et 'offset' sont optionnels et autorisent le recalcul des données entrantes

i2c [dev type n factor offset]: affiche les informations transmises par la sonde i2s de sysfs (Linux2.6). 'dev' peut être ignoré si vous n'avez qu'un seul capteur. le type peut être 'in'/'vol' pour voltage, 'fan' ou 'temp'. 'n' est le numéro de la sonde (voir /sys/bus/i2c/devices/). 'factor' et 'offset' sont optionnels et autorisent le recalcul des données entrantes
ibm_brightness: affiche la luminosité de l'écran des ordinateurs portables Ibm™
ibm_fan: affiche la vitesse de rotation du ventilateur des ordinateurs portables Ibm™
ibm_temps [nombre (0~7)]: affiche les températures 'n' des ordinateurs portables Ibm™. ex: 'T°cpu = ${ibm_temps 0}°C'. cpu:O, hdd:2, gpu:3
ibm_volume: affiche le volume interne des ordinateurs portables Ibm™ (de 0~14)
iconv_start [encodage entrée/sortie]: convertiseur d'encodage, utilise iconv, doit être stoppé avec 'iconv_stop'
iconv_stop: arrêt de la conversion de l'encodage enclenchée par 'iconv-start'
if_empty [variable]: si la 'variable' est vide, affiche tout entre '$if_empty' et son '$endif'
if_existing [fichier expression]: si le 'fichier' existe, affiche tout entre '$if_exist' et son '$endif'. le second paramêtre est optionnel et rajoute une précision sur le fichier.
if_gw: si il existe au moins une passerelle, affihe tout entre '$if_gw' et son '$endif'
if_match [expression]: si 'expression' remplit les conditions, affiche tout entre '$if_match' et son '$endif'. ex: '${if_match “${ibm_temps 0}” >= “80” }${color red}${ibm_temps 0}°C${else}${color green}${ibm_temps 0}°C${endif}'.
if_mixer_mute [mixer]: si le 'mixer' est en sourdine, affiche tout entre '$if_mixer_mute' et son '$endif', par défaut mixer=Master.
if_mounted [point_de_montage]: si le 'point_de_montage' est monté, affiche tout entre '$if_mounted' et son '$endif'
if_mpd_playing: si le serveur mpd est en lecture ou en pause, affiche tout entre '$if_mpd_playing' et son '$endif'
if_running [processus]: si le 'processus' est en cours, affiche tout entre '$if_running' et son '$endif'
if_up [interface]: si 'interface' est active, affiche tout entre '$if_up' et son '$endif'. voir aussi 'if_up_strictness'
if_updatenr [nombre d'updates 'n']: si conky s'est relancé 'n' fois, affiche tout entre '$if_updatenr' et son '$endif'
image [adresse -p x,y -s LxH -n -f intervalle]: affiche l'image selon son 'adresse' à la position -p ou 'x' est le décallage horizontal en pixels depuis le coin supérieur gauche de conky, et 'y' le décallage vertical. possibilité de '-s' redimensionner l'image en indiquant sa 'L'argeur et sa 'H'auteur, de ne pas mettre l'image en cache '-n', ou de vider le cache '-f' à un 'intervalle' déterminé
imap_messages: affiche le nombre de message dans votre boîte mail IMAP (voir imap). 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: idem que 'imap_messages' pour les nauveaux messages
include [adresse]: prend en compte le ficher indiqué par 'adresse', les fonctions se rajoutent aux fonctions du conky en cours, les avariables se placent à l'endroit où 'include' est lancé

kernel: affiche la version du kernel utilisé

laptop_mode: retourne les valeurs de /proc/sys/vm/laptop_mode
lines [fichier]: affiche le nombre de lignes contenues dans le 'fichier'
loadavg [1,2,3]: affiche la charge moyenne processeur; 1=dernière minute, 2=dernières 5 minutes, 3=dernières 15 minutes
loadgraph [hauteur,longueur couleur1 couleur2 scale -t -l]: affiche un graphique de progression de la charge moyenne système

machine: affiche l'architecture du noyau, ex: i686
mails [boîte_mail intervalle]: affiche le nombre de messages de votre 'boîte_mail' mbox et maildir supportés
mboxscan [-n 'nombre_de_messages' -fw 'longueur du mail' -sm 'longueur_du_sujet' mbox]: affiche un résumé des 'n' derniers messages de 'mbox', ex: '${mboxscan -n 10 "/home/arp/mailbox"}'
mem: affiche la quantité de mémoire vive utilisée
membar [hauteur,longueur]: affiche une barre d'état de l'utilisation de la mémoire vive
memeasyfree: affiche la quantité de mémoire vive disponible, en incluant buffer/cache
memfree: affiche la quantité de mémoire vive disponible
memgauge [hauteur,largeur]: affiche un compteur d'état de la quantité de mémoire vive utilisée
memgraph [hauteur,longueur couleur1 couleur2 scale -t -l]: affiche un graphique de la progression d'utilisation de la mémoire vive
memmax: affiche la quantité maximale de mémoire vive
memperc: affiche le pourcentage d'utilisation de la mémoire vive
mixer [sortie]: affiche le volume de 'sortie' du mixer, par défaut sortie=Master mais vous pouvez utiliser tout autre canal
mixerbar [sortie]: affiche une barre d'état du volume de 'sortie'
mixerl [sortie]: affiche le volume gauche de 'sortie'
mixerlbar [sortie]: affiche une barre d'état du volume gauche de 'sortie'
mixerr [sortie]: affiche le volume droit de 'sortie'
mixerrbar [sortie]: affiche une barre d'état du volume droit de 'sortie'
moc_album: affiche l'album courrant en lecture dans moc
moc_artist: affiche l'artiste en lecture dans moc
moc_bitrate: affiche le debit du morceau en lecture dans moc
moc_curtime: affiche le temps courant du morceau en lecture dans moc
moc_file: affiche le nom complet du fichier en lecture dans moc
moc_rate: affiche le classement du morceau en lecture dans moc
moc_song: affiche le nom du morceau en lecture dans moc
moc_state: affiche l'état de moc, 'en lecture' 'en pause' 'stoppé'...
moc_timeleft: affiche le temps restant dans le morceau en lecture dans moc
moc_title: affiche le titre du morceau en lecture dans moc
moc_totaltime: affiche la durée totale du morceau en lecture dans moc
monitor: affice le numéro du moniteur sur lequel tourne conky
monitor_number: affiche le nombre de moniteurs
mpd_album: affiche l'album en lecture dans mpd
mpd_artist: affiche l'artiste en lecture dans mpd
mpd_bar [hauteur,longueur]: affiche une barre d'état du morceau en lecture dans mpd
mpd_bitrate: affiche le debit du morceau en lecture dans mpd
mpd_elapsed: affiche le temps restant de la lecture en cours dans mpd
mpd_file: affiche le nom complet du fichier en lecture dans mpd
mpd_length: affiche la durée du morceau en lecture dans mpd
mpd_name: affiche le nom du morceau en lecture dans mpd
mpd_percent: affiche le pourcentage de progression du morceau en lecture dans mpd
mpd_random: affiche le statut du mode aléatoire
mpd_repeat: affiche le statut du mode répétition
mpd_smart[nombre 'n']: affiche le nom, sous la forme 'artiste - titre' selon les informations disponibles. taille maxi='n'
mpd_status: affiche le statut de mpd
mpd_title [nombre 'n']: : affiche le titre du morceau en lecture dans mpd. taille maxi='n'
mpd_track: affiche le numéro du morceau en lecture dans mpd
mpd_vol: affiche le volume de mpd

nameserver [index]: affiche les informations de 'nameserver', voir /etc/resolv.conf
new_mails [boîte_mail intervalle]: affiche le nombre de messages non-lus dans votre 'boîte_mail', vérifié tous le 'intervalles' en minutes
nodename: affiche le nom d'hôte du système
nvidia [threshold temp ambient gpufreq memfreq imagequality]: affiche les informations relative à votre carte grapique nvidia™

offset [nombre (pixels)]: déplace le prochain élément de 'n' pixels
outlinecolor [hexadécimal/couleur]: change la couleur du contour de la police

pb_battery [status,percent,time]: affiche des informations sur la batterie des pwerbook/ibook™
platform [dev type n factor offset]: affiche les informations transmises par la sonde platform de sysfs (Linux2.6). 'dev' peut être ignoré si vous n'avez qu'un seul capteur. le type peut être 'in'/'vol' pour voltage, 'fan' ou 'temp'. 'n' est le numéro de la sonde (voir /sys/bus/platform/devices/). 'factor' et 'offset' sont optionnels et autorisent le recalcul des données entrantes
pop3_unseen: affiche le nombre de message dans votre boîte mail POP3 (voir pop3). 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: affiche l'espace utilisé dans votre boîte mail POP3 (voir pop3). 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 commande]: execute une commande une fois avant que conky n'affiche quoi que ce soit, puis affiche le résultat dans la zone TEXT
processes: nombre total de processus (actif/au repos)

read_tcp [hôte port]: affiche les caractères visibles en se connectant via 'hôte' sur 'port' tcp
replied_mails [maildir intervalle]: nombre de mails auxquels vous avez répondus dans votre 'maildir'
rss [adresse intervalle action nombre'n' space_in_front]: télécharge les flux rss à un 'intervalle' déterminé (par défaut 15 minutes), et renvoi les 'actions': feed_title, item_title('n'), item_desc('n'), 'item_titles'. possibilité d'utiliser 'spaces_in_front' pour ajouter un espace avant chaque 'action'. ex(archwiki): '${rss http://planet.archlinux.org/rss20.xml 1 item_titles 10 }', affichera les dix premiers articles de archlinux planet
running_processes: affiche le nombre de processus actifs
running_threads: affiche le nombre de tâches en cours

scroll [longueur('l') step text]: affiche un 'text' défilant de 'l' caractères avec un défilement de 'step' caractères. 'text' peut contenir des variables, si une variable renvoi plusieurs lignes, elles seront placées à la suite avec un "|" de séparation. si vous changer la couleur , elle sera restaurée à la fin de '$scroll'. la fin et le début de 'text' sont séparés par 'l' espaces
seen_mails [maildir intervalle]: affiche le nombre de mails marqués comme "lus" dans votre 'maildir'
shadecolor [hexadécimal/couleur]: change la couleur de l'ombre des textes/graphs/bordures
sony_fanspeed: affiche la vitesse de rotation des ordinateurs portables SonyVAIO™
stippled_hr ['n' pixels]: trace une ligne horizontale en pointillés d'épaisseur 'n'
swap: affiche l'utilastion de l'espace d'échange 'swap'
swapbar [hauteur,longueur]: affiche une barre d'état de l'utilisation de la swap
swapfree: affiche la place disponible dans la swap
swapmax: affiche la taille totale de la swap
swapperc: affiche le pourcentage d'utilisation de la swap
sysname: affiche le nom du système, ex: Linux

tab [longueur'l',debut]: insère une tabulation de 'l' pixels commencant à la colonne 'début'
tail [fichier 'n'lignes check]: affiche les 'n' dernières lignes du 'fichier' vérifié tous les 'check'
tcp_portmon: 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. Examples:
'${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 [intervalle commande]: exécute 'commande' toutes les 'intervalle' secondes et affiche la sortie. idem que $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. mettez un intervalle plus long que le temps d'éxécution que votre script.
threads: affiche le nombre total de tâches
time [format]: affiche la date, l'heure… voir 'man stfrtime'
to_bytes [nombre]: si 'nombre' est suivi d'une unités de meure(KiB,MB,GiB..), il est convertit en bytes sans unités
top [type numéro]: classement (de 1~10) des processus selon leur utilisation processeur. les 'types' sont: 'name','pid','cpu','mem','mem_res','mem_vsize','time','io_perc','io_read','io_write'.
top_io [type numéro]: idem que 'top' mais les processus sont classés par la quantité de données en lecture/écriture pendant l'intervalle de lecture
top_mem [type numéro]: idem que 'top' mais les processus sont classés par leur taux d'occupation mémoire
top_time [type numéro]: idem que 'top' mais les processus sont classés par leur temps cpu
totaldown [interface]: affiche la quantité totale de données téléchargées (limité à 4GB)
trashed_mails [maildir intervalle]: affiche le nombre de mails dans la poubelle de 'maildir'
tztime [timezone format]: idem que 'time' mais pour un fuseau horraire spécifique. voir /usr/share/zoneinfo

uid_name [uid]: affiche le nom de l'utisateur 'uid'
unflagged_mails [maildir intervalle]: affiche le nombre de mails non classée dans 'maildir'
unforwarded_mails [maildir intervalle]: affiche le nombre de mails classés non transférés dans 'maildir'
unreplied_mails [maildir intervalle]: affiche le nombre de mails classés sans réponses dans 'maildir'
unseen_mails [maildir intervalle]: affiche le nombre de nouveaux mails dans 'maildir'
updates [nombre d'updates]: pour le débug
upspeed [interface]: affiche la quantité de données téléversées pour 'interface'
upspeedf [interface]: affiche la quantité de données téléversées en KiB avec une décimale pour 'interface'
upspeedgraph [interface hauteur,longueur couleur1 couleur2 scale -t -l]: affiche un graphique des données téléversées pour 'interface', ex: '${upspeedgraph wlan0 10,60 FFFFFF 000000}'
uptime: affiche le temps de connexion
uptime_short: affiche le temps de connexion en format court
user_names: affiche le nom des utilisateurs connectés
user_number: affiche le nombre d'utilisateurs connectés
user_terms: affiche une liste des consoles en utilisation
user_times: affiche les temps de connexion des utilisateurs
user_time [console]: affiche le temps de connexion de l'utilisateur connecté en 'console'
utime [format]: affiche l'heure UTC

voffset [nombre'n' (pixels)]: décallage vertical de 'n' pixels pour l'élément suivant
voltage_mv ['n']: affiche la consommation du cpu 'n' en mVolt
voltage_v ['n']: affiche la consommation du cpu 'n' en Volt

wireless_ap [interface]: affiche le point d'accès MAC du réseau
wireless_bitrate [interface]: affiche le débit du réseau sans-fil
wireless_essid [interface]: affiche le point d'accès ESSID du réseau
wireless_link_bar [hauteur,longueur interface]: affiche une barre d'état de la qualité du réseau
wireless_link_qual [interface]: affiche la qualité du signal sans-fil
wireless_link_qual_max [interface]: affiche la qualité maximale du signal disponible sur le réseau
wireless_link_qual_perc [interface]: affiche la qualité du signal en pourcentage
wireless_mode [interface]: affiche le mode du réseau (Managed/Ad-Hoc/Master)
words [fichier]: affiche le nombre de mots dans le 'fichier'

Happy Conkying !!

lang fr|gb

conky

conky sur livarp

configuration de conky

les fonctions

les variables