• Objet : liste des fonctions disponibles pour l'afficheur Conky (avant conky-1.10)
• Niveau requis :

  débutant, avisé
• Commentaires : page complémentaire de la page principale.
• Débutant, à savoir : Utiliser GNU/Linux en ligne de commande, tout commence là !.

Les fonctions passées à conky déterminent sa position, ses dimensions, la police de caractères utilisée… bref, comment s'affiche conky. Cette page est une traduction (à compléter) de celle du manpage de Conky_1.8.0.

Fonctions	Arguments	Définitions
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' très utile pour les fonctions execgauge et execigauge.
default_graph-size	(pixels) hauteur longueur	dimensions par défaut des graphiques, ex 'default_graph-size 4 10' très utile pour les fonctions execgraph et execigraph.
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	–	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
lua_draw_hook_pre	nom_de_la_fonction
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
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	(pixels) largeur hauteur	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, toujours visible, 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, toujours visible, 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
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. 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'un 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. Zéro 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.

contributeur: arpinux