====== Mise à jour du wiki Conky 1.10 ======

  * Objet : Conky 1.10
  * Niveau requis : {{tag>débutant avisé}}
  * Commentaires : Monitorage graphique du système.
  * Débutant, à savoir : [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-)
  * Info : suite du wiki [[doc:systeme:conky|Conky]] dû au changement dans l'écriture lua entre la version 1.09 et la version 1.10 de conky
  * Suivi : {{tag>en-chantier à-tester à-placer}} - FIXME Pour choisir, voir les autres Tags possibles dans [[:atelier:#tags|l'Atelier]].
    * Création par [[user>jeremix]] 01/11/2020
    * Testé par <...> le <...> FIXME
  * Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?id=2038 | Lien vers le forum concernant ce tuto]] ((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))
===== Introduction =====

Conky est un moniteur système gratuit et léger pour X, qui affiche tout type d'informations sur votre bureau. \\
Il s'affiche soit dans sa propre fenêtre, soit intégré au bureau.

Conky peut afficher plus de 300 objets intégrés, y compris la prise en charge de: \\

*Une pléthore de statistiques du système d'exploitation (uname, uptime, CPU usage, mem usage, disk usage, "top" like process stats, and network monitoring, pour n'en nommer que quelques-unes). \\
*Prise en charge IMAP et POP3 intégrée.
*Prise en charge intégrée de nombreux lecteurs de musique populaires (MPD, XMMS2, Audacious). \\
*Peut être étendu en utilisant le support Lua intégré, ou l'un de vos propres scripts et programmes. \\
*Liaisons Imlib2 et Cairo intégrées pour le dessin arbitraire avec Lua. \\
*Fonctionne sous Linux, FreeBSD, OpenBSD, DragonFlyBSD, NetBSD, Solaris, Haiku OS et macOS! \\
... et bien plus encore. \\

Conky peut afficher des informations sous forme de texte ou en utilisant de simples barres de progression et des widgets graphiques, avec différentes polices et couleurs. \\

Source : readme [[https://github.com/brndnmtthws/conky/blob/master/README.md]]

===== Installation =====

Pour installer le paquet de base de Conky, saisissez en tant que root :
<code root>apt-get update && apt-get install conky</code>

Mais vous souhaiterez plutôt une installation complète : 
<code root>apt-get update && apt-get install conky-all</code>

===== Configuration =====

Avant toutes choses, il est nécessaire d'indiquer à Conky ce qu'il doit faire. \\
Ces informations sont à placer dans le fichier caché //.conkyrc// situé dans votre dossier utilisateur.
Fichier que vous renseignerez à l'aide d'un éditeur, par exemple [[:doc:editeurs:nano]] :
<code user>nano ~/.conkyrc</code>

Ce fichier, se divise en 2 parties distinctes, il utilise la syntaxe Lua\\
la première : conky.config \\
<file config conkyrc_incomplet>
conky.config = {
background = false,
update_interval = 1,
cpu_avg_samples = 2,
net_avg_samples = 2,
override_utf8_locale = true,
double_buffer = true,
no_buffers = true,
text_buffer_size = 2048,
own_window = true,
own_window_type = 'normal',
own_window_transparent = true,
own_window_argb_visual = true,
own_window_hints = 'undecorated,sticky,skip_taskbar,skip_pager,below',
border_inner_margin = 0,
border_outer_margin = 0,
alignment = 'top_right',
gap_x = 35,
gap_y = 55,
draw_shades = false,
draw_outline = false,
draw_borders = false,
draw_graph_borders = false,
use_xft = true,
font = 'DejaVu Sans Mono:size=12',
xftalpha = 0.5 ,
uppercase = false,
temperature_unit = 'celsius',
default_color = 'FFFFFF',

}

conky.text = [[
ici commence la personnalisation du conky (ici coller la 2ème partie, présente ci dessous)
]]
</file>


la seconde : conky.text \\
voici un exemple, en partie récupéré ici [[https://www.linuxtricks.fr/wiki/conky-des-variables-systeme-sur-le-bureau]]

{{/file-R014a7ba596710ed916f2076a8ab32784.png}} image à supprimer du serveur svp \\
{{/file-Rd02aa5514174c53030b30801fbb54b81.png}}


<file config conkyrc_texte à coller>
conky.text = [[
${font Droid Sans Mono:size=9}
${color black}SYSTEM:${color #510289}
${color black}Distribution:${color #510289} ${texeci 900 cat /etc/issue.net} 
${color black}kernel${color #510289} $kernel 
${color black}Uptime:${color #510289} $uptime
${color black}Utilisation RAM: ${color #510289} $mem / $memmax ($memperc%)  
${color black}Root: ${color #510289}${fs_used /} / ${fs_size /} (${fs_used_perc /}%)
${color black}Home: ${color #510289}${fs_used /home} / ${fs_size /home} (${fs_used_perc /home}%)
${color black}IP eth0 : ${color #510289}${addr eth0} ${goto 250}${color black}DL:${color #510289} ${downspeedf eth0}k/s ${goto 350} ${color black}UP:${color #510289} ${upspeedf eth0}k/s

${goto 10}${color black}Météo : 
${goto 10}${color #510289}${texeci 3600 curl -s 'wttr.in/grenoble?qT0&lang=fr' | head -7}

]]

</file>



Lorsque vous éditez votre fichier de configuration, à chaque enregistrement, conky recharge le fichier automatiquement et applique les changements de suite ! \\
N'hésitez pas à tester et revenir en arrière si nécessaire ! (ctrl+z fonctionne très bien, même après une sauvegarde)
 
=== Les variables de configuration ===
[[http://conky.sourceforge.net/config_settings.html|Lien externe]] \\
Pour la première partie du conkyrc


^ Désignations         ^ Explications           ^ Valeurs                            ^
| alignment   | Permet de régler le point de repère pour l'alignement de conky     | top_right / top_left / bottom_right / bottom_left  |                     
| background | Permet de choisir si conky doit être "intégré" au fond d'écran | true / false |
| border_margin | Permet de régler la marge entre les bordures et le texte | En nombre de pixels |
| border_width | Permet de régler l'épaisseur de la marge | En nombre de pixels |
| color[0-9] | Permet de définir différentes couleurs pour la zone Conky Text | Code Hexadécimal ou une couleur (en anglais) |
| cpu_avg_samples | Nombre d'échantillons CPU pour faire la moyenne | un nombre (1 désactive la moyenne) |
| default_color | Permet de régler la couleur par défaut du texte | Code Hexadécimal ou une couleur (en anglais) |
| default_outline_color | Permet de régler la couleur par défaut des contours | Code Hexadécimal ou une couleur (en anglais) |
| default_shade_color | Permet de régler la couleur par défaut des ombres des textes | Code Hexadécimal ou une couleur (en anglais) |
| double_buffer | Permet d'utiliser ou non l'extension Xdbe (si problèmes de clignotements) | true / false |
| draw_borders | Permet de dessiner des bordures autour des textes (?) | true / falsee |
| draw_graph_borders | Permet de dessiner des bordures autour des graphes (?) | true / false |
| draw_outline | Permet de dessiner des contours (?) | true / false |
| draw_shades | Permet d'afficher les ombres au texte ou non | true / false |
| font | Permet de choisir le type de police | nom_de_la_police:size=8 |
| gap_x | Permet de régler la distance horizontale  | En nombre de pixels |
| gap_y | Permet de régler la distance verticale  | En nombre de pixels |
| minimum_size | Permet de fixer la taille minimum de Conky (1ere valeur : largeur, 2eme valeur : hauteur) | 2 nombres en pixels |
| net_avg_samples | Nombre d'échantillons réseau pour faire la moyenne | un nombre (1 désactive la moyenne) |
| on_bottom | Permet de laisser conky toujours derrière les fenêtres ou non | true / false |
| stippled_borders | Permet de régler le nombre de pointillés des bordures | En nombre de pixels |
| update_interval | Permet de fixer la valeur de rafraîchissement des données en secondes (utile pour les machines peu puissantes)| Nombres à 1 décimale |
| use_spacer | Permet d'ajouter des espaces après certaines données afin de mieux gérer la mise en place | true / false |
| use_xft | Permet d'utiliser ou non des paramètres xft renseignés plus bas pour la mise en forme (du texte principalement) | true / false |

=== Les variables d'affichage ===
[[http://conky.sourceforge.net/variables.html|Lien externe]] \\
Pour la deuxième partie du conkyrc


^ Désignations         ^ Explications           ^ Syntaxe à utiliser //à modifier//                           ^
| addr   | Adresse IP d'une interface     | ${addr eth0}  |                     
| alignc | Place le texte au centre | ${alignc} |
| alignr | Place le texte vers la droite | ${alignr} |
| color | Change la couleur du texte après la balise | ${color //FFFFFF//} |
| font | Change la police après la balise | ${font //Droid Sans Mono:size=9//} |
| fs_free | Espace libre d'une partition en % | ${fs_free /} |
| fs_use | Espace utilisé d'une partition en % | ${fs_used ///home//} |
| fs_size | Taille d'une partition en % | ${fs_size ///media//} |
| downspeedf | Débit descendant en kb/s | ${downspeedf eth0} |
| upspeedf | Débit montant en kb/s | ${upspeedf eth0} |
| goto | Décale l'élément suivant de x pixels | ${goto //250//} |
| texeci | Permet d'éxecuter une commande toute les x secondes | ${texeci //900// cat } |
| kernel | Affiche votre kernel | $kernel |
| uptime | Affiche le temps passé depuis l'ouverture de votre session | $uptime |
| | | |
| | | | 
| | | | 
| | | | 
===== Utilisation =====
Lancer Conky, tout simplement en entrant dans le terminal
<code user>conky</code>

===== Lancement automatique =====
Si vous souhaitez voir Conky démarrer à l'ouverture de votre session, deux possibilités s'offrent à vous.

==== Par un gestionnaire de session ====
Créez une entrée dans votre gestionnaire de session. \\
Exemple pour Xfce : menu //Paramètres//, puis //Session et démarrage//, onglet //Démarrage automatique//, bouton //Ajouter//. \\
La commande à saisir est :
<code bash>conky -p 2</code>
ou
<code bash>sh -c "sleep 2; conky;"</code>
Le retard à l'allumage (en secondes) est à adapter aux besoins de votre système. \\
\\
Les utilisateurs de LXDE pourront, quant à eux, consulter la rubrique [[:doc:environnements:lxde:lxde#lancer-un-programme-au-demarrage|Lancer un programme au démarrage]].

==== Par un script ====
Le script en question est placé, par exemple, dans le dossier utilisateur et nommé //.conkyboot.sh// :
<file ~/.conkyboot.sh ~/.conkyboot.sh>
#!/bin/bash
sleep 2
conky -d
</file>

Ce script doit être rendu exécutable :
<code user>chmod +x ~/.conkyboot.sh</code>

Il vous reste alors à l'inclure parmi les //applications lancées au démarrage//.
Veuillez pour cela vous reporter à la documentation de votre environnement de bureau.

Le lancement par script est utilisé, en particulier, pour démarrer plusieurs instances de Conky. \\
Il nécessite alors autant de fichiers de configuration que d'instances de Conky souhaitées :
<file ~/.conkyboot.sh ~/.conkyboot.sh>
#!/bin/bash
sleep 2
conky -c ~/conkyrc1 &
sleep 5
conky -c ~/conkyrc2 &
</file>

===== Pour aller plus loin =====
Dans les forums : 
  * [[https://debian-facile.org/viewtopic.php?id=27092|Partagez vos conky ! ]]
  * [[https://debian-facile.org/viewtopic.php?id=2038|Wiki - Conky - surveiller les fonctionnements de son système ]]

Quelques modèles :
  * [[https://github.com/brndnmtthws/conky/wiki/Configs#contributed-configs|ici]]

===== Références =====

  * [[https://github.com/brndnmtthws/conky|Conky - Site ]]