LinuxPedia

Wiki libre et indépendant dédié à GNU-Linux et BSD.

Outils pour utilisateurs

Outils du site


personaliser:conky:fonctions

Conky : les fonctions

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.

FonctionsArgumentsDéfinitions
alignmenttop_left,top_right,top_middle,
bottom_left,bottom_right,bottom_middle,
middle_left,middle_middle,middle_right.
position de conky sur l'écran.
apend_fileadresse_du_fichierprend en compte un fichier: les fonctions seront rejoutées à celles du conky en cours.
backgroundyes ou nosi yes, conky sera lancé en “background”: il vous rendra la main.
border_inner_marginnombre (pixels)espace en pixels entre le texte et la bordure.
border_outer_marginnombre (pixels)espace en pixels entre la bordure et le bord de la fenêtre.
border_widthnombre (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_samplesnombreéchantillon à prendre en compte pour le monitoring du cpu.
default_bar_sizenombre(pixels) hauteur longueurdimensions par défaut des barres, ex: 'default_bar_size 4 10'
très utile pour les fonctions execbar et execibar.
default_colorhexadécimal/couleurcouleur par défaut du texte et des bordures, ex: 'default_color ffffff'
ou 'default_color white'.
default_gauge_size(pixels) hauteur longueurdimensions 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 longueurdimensions par défaut des graphiques, ex 'default_graph-size 4 10'
très utile pour les fonctions execgraph et execigraph.
default_outline_colorhexadécimal/couleurcouleur par défaut du contour de la police.
default_shade_colorhexadécimal/couleurcouleur par défaut de l'ombre de la police et des graphiques.
disable_auto_reloadyes ou nosi yes, conky ne recharge pas son fichier de configuration après une modification.
diskio_avg_samplesnombreéchantillon à prendre en compte pour le monitoring du la lecture/écriture.
displaychoix de l'écran pour l'affichage.
double_bufferyes ou nosi 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_bordersyes ou nosi yes, conky affiche une bordure autour du texte.
draw_graph_bordersyes ou nosi yes, conky dessine une bordure autour des graphiques.
draw_outlineyes ou nosi yes, conky utilise la police avec un contour.
draw_shadesyes ou nosi yes, conky affiche les ombres sous le texte et les graphiques.
extra_newlineyes ou nosi yes et si 'out_to_console yes', conky rajoute une ligne en fin de fichier. Utile pour “piper” conky dans une wibox d'awesome.
fontnom_de_la_policedétermine la police utilisée par conky. obsolète»voir xftfont.
format_human_readableyes ou nosi yes, conky tente d'afficher les valeurs dans un format lisible (Kib,Mib,Gib).
si no, conky affiche toutes les valeurs en bytes.
gap_xnombre (pixels)marge en pixels entre le bord de l'écran et le coté droit/gauche de la fenêtre conky.
gap_ynombre (pixels)marge en pixels entre le bord de l'écran et le haut/bas de la fenêtre conky.
hddtemp_hostXXX.X.X.Xhôte sur lequel se connecte hddtemp, défaut: 127.0.0.1
hddtemp_portport utilisé par hddtemp, défaut: 7634
if_up_sctrictnessup, link, addressdétermine comment conky évalue la connexion réseau.
imapserveur 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_intervalnombre(secondes)intervalle de rafraichissement du cache imlib en secondes.
imlib_cache_sizenombre (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_postnom_de_la_fonctionFIXME
lua_draw_hook_prenom_de_la_fonctionFIXME
lua_loadadresse du/des script(s)conky charge le(s) script(s) lua, ex: 'lua_load ~/.conky/clock.lua'.
lua_shutdown_hooknom_de_la_fonctionvide le cache de la 'fonction' afin préserver le système à l'extinction.
lua_startup_hooknom_de_la_fonctionFIXME
mail_spoolmail spool pour la vérification des mails.
max_port_monitor_connectionsnombrenombre maximum de scan par port, par défaut 256.
max_specialsnombrenombre maximal de variables spéciales; fonts, offsets, aligns… par défaut 512.
max_user_textnombre (bytes)taille maximale du buffer utilisateur, par défaut 16384 bytes.
maximum_widthnombre (pixels)largeur maximale de la fenêtre conky en pixels.
minimum_size(pixels) largeur hauteurdimension minimale de la fenêtre conky, ex: 'minimum_size 200 500'.
mpd_hosthôte pour mpd music player daemon.
mpd_passwordmot de passe du serveur mpd.
mpd_portport pour mpd.
music_player_intervalnombre (seconds)intervalle de vérification des données des lecteurs audio, par défaut: celui de conky.
net_avg_samplesnombreéchantillon à prendre en compte pour le monitoring du net.
no_buffersyes ou nosi oui, conky ne prend pas en compte le buffer dans le calcul de l'utilisation mémoire.
out_to_consoleyes ou nosi yes, envoi des informations de conky au STDOUT. Utile pour “piper” conky dans une statusbar.
out_to_ncursesyes ou nosi yes, comme 'out_to_console' mais avec un rafraichissement de l'affichage au lieu d'une succession d'informations.
out_to_stderryes ou nosi yes, envoi des informations de conky au STDERR.
out_to_xyes ou nosi 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_localeyes ou nosi yes, conky force l'encodage local utf-8. requiert XFT.
overwrite_fileadresse_du_fichierécrase le fichier donné en argument.
own_windowyes ou nosi yes, conky dessine sa propre fenêtre.
own_window_classnom 'WM_CLASS'determine manuellement le 'WM-CLASS' de conky, par défaut: Conky.
own_window_colorhexadécimal/couleurcouleur de la fenêtre conky, ex: 'own_window_color 000000' ou 'own_window_color black'.
own_window_hintsundecorated,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_titletitredetermine manuellement le titre de la fenêtre conky, par défaut: '<hôte> - conky'.
own_window_argb_visualyes ou noARGB 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_valuenombre (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_transparentyes ou nosi yes, conky est transparent: comme 'own_window_argb_value 0'.
own_window_typenormal,desktop,dock,panel,overridesi '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_percentsFIXME
pop3serveur 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_unitsyes ou noréduit l'affichage des unités: kiB=k, GiB=G, … 'no' par défaut.
show_graph_rangeyes ou nosi yes, conky affiche l'amplitude des graphiques. 'no'par défaut.
show_graph_scaleyes ou nosi yes, affiche la valeur maximale dans les graphiques.
stippled_bordersnombre (pixels)si 'draw_borders yes', taille en pixels des pointillés de la bordure de conky.
temperature_unitfarenheit ou celsiusdétermine les unités de température, par défaut: celsius.
templateNnombre (0→9)determine un modèle à utiliser après TEXT.FIXME expliquer la syntaxe des modèles.
text_buffer_sizenombre (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_secondsyes ou nosi yes, les variables de temps sont affichées en secondes. cette fonctions n'affecte pas $time, $tztime, ou $utime.
top_cpu_separateyes ou nosi yes, la variable 'top' renvoie l'usage d'un processeur.
si no, 'top' renvoi l'usage des processeurs combinés.
top_name_widthnombrelongueur des noms des processus renvoyés par 'top', par défaut: 15.
total_run_timesnombrenombre de rechargements de conky avant de quitter. Zéro fait tourner conky indéfiniment.
update_intervalnombre (secondes)fréquence de rafraichissement de conky.
update_interval_on_batterynombre (secondes)fréquence de rafraichissement de conky sur battery.
uppercaseyes ou nosi yes, affiche les caractères en majuscules.
use_spacerleft,right,noneajoute un espace avant ou après certaines variables pour les empêcher de bouger. ne fonctionne qu'avec une police à chasse fixe.
use_xftyes ou nosi yes, conky utilise les polices 'xft', active l'anti-crenelage…
xftalphanombre (0→1)opacité de la police définie par 'xftfont', 0=transparent, 1=opaque.
xftfontnom_de_la_police:size=nombresi 'use_xft yes', détermine la police par défaut utilisée par conky.
ex: 'xftfont Terminus:pixelsize=10' - 'xftfont Aller:size=8:bold'.
TEXTici commence l'affichage des variables.
personaliser/conky/fonctions.txt · Dernière modification : 2018/11/17 12:54 de 127.0.0.1