Manualinux
http://www.nvu.com http://www.gimp.org InicioPresentaciónActualizacionesManualesDescargasNoticiasAgradecimientoEnlaces

Entornos GráficosAplicaciones

Administradores de SesionesAdministradores de VentanasEscritoriosUtilidades de Escritorio

Utilidades de Escritorio - BMPanelUtilidades de Escritorio - CWallpaper

Utilidades de Escritorio - Conky




Utilidades de Escritorio - Conky



Copyright

Copyright © José Luis Lara Carrascal  2009-2024   http://manualinux.es


Sumario

Introducción
Preliminares
Instalación
Opciones de línea de comandos
Configuración
Iniciamos Conky
Utilizar una imagen de fondo
Enlaces


Introducción  

Conky es un monitor del sistema que muestra el texto en el fondo del escritorio o en una ventana transparente. Basado en Torsmo, ha ampliado considerablemente, las posibilidades de monitoreo de este último, a otros apartados cómo puedan ser el soporte de protocolos de correo como IMAP y POP3 o el de reproductores musicales como MPD o XMMS2, entre otros. 


Preliminares  

1) Comprobar que la ruta de instalación de los binarios del programa la tenemos en nuestro PATH

Abrimos una ventana de terminal y ejecutamos el siguiente comando:

[jose@Fedora-18 ~]$ echo $PATH
/usr/lib/qt-3.3/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:/home/jose/bin

Si no aparece entre las rutas mostradas el directorio /usr/local/bin, abrimos un editor de texto y añadimos lo siguiente:

#!/bin/sh

export PATH=/usr/local/bin:$PATH

Lo guardamos con el nombre variables.sh, y lo instalamos en /etc/profile.d.

$ su -c "install -m755 variables.sh /etc/profile.d"

Tenemos que cerrar el emulador de terminal y volverlo a abrir para que la variable de entorno aplicada sea efectiva. Es conveniente guardar una copia de este script para posteriores instalaciones de nuestro sistema, teniendo en cuenta que es el que se va a utilizar a partir de ahora en todos los manuales de esta web, para establecer variables de entorno globales, excepto en aquellas que sólo afectan al usuario, en las que se utilizará el archivo de configuración personal, ~/.bashrc.

La ventaja de utilizar el directorio /etc/profile.d es que es común a todas las distribuciones y nos evita tener que editar otros archivos del sistema como por ejemplo, /etc/profile.

2) Desinstalar versiones anteriores del programa ubicadas en el directorio /usr

Aún en el caso de que la versión a compilar la vayamos a instalar en el mismo directorio que la que proporciona la distribución, siempre se debe desinstalar previamente la versión antigua, para evitar conflictos innecesarios.


Instalación  

Dependencias

Herramientas de Compilación

Entre paréntesis la versión con la que se ha compilado Conky para la elaboración de este documento.

* GCC - (13.2.0) o Clang - (18.1.4)
* CMake - (3.29.2)
* Ninja - (1.12.0)
* Pkg-config - (0.29.2)

Librerías de Desarrollo

* Xorg - (7.7 / xorg-server 21.1.13)
   LibICE - (1.1.1)
   LibSM - (1.2.4)
   LibX11 - (1.8.9)
   LibXdamage - (1.1.6)
   LibXext - (1.3.6)
   LibXfixes - (6.0.1)
   LibXft - (2.3.8)
   LibXinerama - (1.1.5)
* Freetype2 - (2.13.2)
* Imlib2 - (1.12.2)
* Lua - (5.4.6)
* Ncurses - (6.4)
* Zlib - (1.3.1)

Intérpretes de Lenguaje de Programación

* Python - (3.12.3)
   Jinja2 - (3.1.3)
   PyYAML - (6.0.1)

Aplicaciones

* Pandoc - (3.1.13) - [1]

[1] - Requerido para generar la página de manual de Conky.


Descarga

conky-1.20.2.tar.gz

Optimizaciones

$ export {C,CXX}FLAGS='-O3 -march=znver3 -mtune=znver3'

Donde pone znver3 se indica el procesador respectivo de cada sistema seleccionándolo de la siguiente tabla:
Nota informativa sobre las optimizaciones para GCC
* La opción '-march=' establece el procesador mínimo con el que funcionará el programa compilado, la opción '-mtune=' el procesador específico para el que será optimizado. 

* Los valores separados por comas, son equivalentes, es decir, que lo mismo da poner '-march=k8' que '-march=athlon64'.

* En versiones de GCC 3.2 e inferiores se utiliza la opción '-mcpu=' en lugar de '-mtune='.
Nota informativa sobre las optimizaciones para Clang
* La opción '-mtune=' está soportada a partir de la versión 3.4 de Clang.

* Los valores de color azul no son compatibles con Clang.

* Las filas con el fondo de color amarillo son valores exclusivos de Clang y, por lo tanto, no son aplicables con GCC.
Valores CPU
Genéricos
Intel
AMD

Optimizaciones adicionales

Optimizaciones adicionales
GCC
Graphite
$ export {C,CXX}FLAGS+=' -ftree-loop-linear -floop-strip-mine -floop-block'
IPA
$ export {C,CXX}FLAGS+=' -fipa-pta'
LTO
$ export {C,CXX}FLAGS+=' -fuse-linker-plugin -flto=auto'
En versiones inferiores a GCC 10, sustituir auto por el número de núcleos que tenga nuestro procesador. Si sólo tiene uno, utilizar el parámetro -flto
Clang
Polly
$ export {C,CXX}FLAGS+=' -O3 -mllvm -polly -mllvm -polly-vectorizer=stripmine'
LTO
$ export {C,CXX}FLAGS+=' -flto'
ThinLTO
$ export {C,CXX}FLAGS+=' -flto=thin'
La aplicación de esta optimización es alternativa a la tradicional LTO, a partir de Clang 3.9 y, por lo tanto, no es combinable con la misma.
Unified LTO
LTO >> ThinLTO
$ export {C,CXX}FLAGS+=' -flto -funified-lto'
$ export LDFLAGS+=' -Wl,--lto=thin'
ThinLTO >> LTO
$ export {C,CXX}FLAGS+=' -flto=thin -funified-lto'
$ export LDFLAGS+=' -Wl,--lto=full'
La aplicación de esta optimización es aplicable, a partir de Clang 17, y sólo es combinable con LLD.

Parámetros adicionales

Parámetros adicionales de eliminación de avisos en el proceso de compilación
$ export {C,CXX}FLAGS+=' -w'

Establecer la ruta de búsqueda de directorios de librerías en sistemas de 64 bits multiarquitectura
$ export LDFLAGS+=" -L/usr/lib64 -L/usr/local/lib64 -L/opt/gcc13/lib64"
Cada usuario tendrá que establecer la ruta de búsqueda de directorios, en función de la distribución que utilice.

Establecer el uso de librería estándar de C++ para Libc++
Clang
$ export CXXFLAGS+=" -stdlib=libc++ -I$(llvm-config --includedir)/c++/v1"
$ export LDFLAGS+=" -L$(llvm-config --libdir) -lc++"

Establecer el uso de enlazador dinámico para Mold
$ export LDFLAGS+=' -fuse-ld=mold'

Establecer el uso de enlazador dinámico para LLD
Clang
$ export LDFLAGS+=' -fuse-ld=lld'
Optimizaciones complementarias LTO/ThinLTO de LLD
$ export LDFLAGS+=' -Wl,--lto-aa-pipeline=globals-aa -Wl,--lto-newpm-passes=memcpyopt'
Optimizaciones complementarias LTO de LLD
$ export LDFLAGS+=" -Wl,--lto-partitions=$(expr $(nproc) / 2)"
Optimizaciones complementarias ThinLTO de LLD
$ export LDFLAGS+=" -Wl,--thinlto-jobs=$(expr $(nproc) / 2)"

Establecer la variable de entorno de uso de compilador para Clang
$ export CC=clang CXX=clang++

Extracción y Configuración  Bloc de Notas Información general sobre el uso de los comandos

$ tar zxvf conky-1.20.2.tar.gz
$ cd conky-1.20.2
$ cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DBUILD_IMLIB2=ON \
-DBUILD_DOCS=ON -DLIB_SUFFIX=64 -DBUILD_WAYLAND=OFF -G Ninja

Explicación de los comandos

-S . -B build : Establece el directorio del código fuente y crea de forma automática el directorio de compilación.

-DCMAKE_BUILD_TYPE=Release : Compila la versión optimizada de Conky.

-DBUILD_IMLIB2=ON : Activa el soporte de Imlib2 para el renderizado de imágenes a utilizar en el fondo de Conky.

-DBUILD_DOCS=ON : Crea e instala la página de manual  y la documentación en formato HTML del programa.

-DLIB_SUFFIX=64 : Instala la librería estática libtcp-portmon.a en /usr/local/lib64, en sistemas de 64 bits multiarquitectura.

-DBUILD_WAYLAND=OFF : Desactiva el soporte del servidor gráfico Wayland, en el que caso de que no lo tengamos instalado o, lo tengamos instalado y no vayamos a hacer uso del mismo.

-G Ninja : Utiliza Ninja en lugar de GNU Make para compilar el paquete (opcional).

Parámetros de configuración opcionales

-DBUILD_DOCS=OFF : Desactiva la creación de la página de manual del programa, en el caso de que no tengamos instalada la aplicación Pandoc, lo que produce un error en la configuración del paquete.

-DBUILD_AUDACIOUS=ON : Activa el soporte de monitorización del reproductor musical Audacious.
-DBUILD_CMUS=ON : Activa el soporte de monitorización del reproductor musical Cmus.
-DBUILD_CURL=ON : Activa el soporte de monitorización de transferencia de archivos mediante el uso de  Curl.

-DBUILD_HTTP=ON : Activa el soporte del protocolo de red, HTTP.
-DBUILD_IRC=ON : Activa el soporte del protocolo de red, IRC.

-DBUILD_ICAL=ON : Activa el soporte de iCalendar (RFC 5545).
-DBUILD_LUA_CAIRO=ON : Activa el soporte de adaptaciones de la librería gráfica Cairo, para el lenguaje de programación, Lua.
-DBUILD_LUA_IMLIB2=ON : Activa el soporte de adaptaciones de la librería gráfica Imlib2, para el lenguaje de programación, Lua.
-DBUILD_LUA_RSVG=ON : Activa el soporte de adaptaciones de la librería gráfica Librsvg, para el lenguaje de programación, Lua.

-DBUILD_XMMS2=ON : Activa el soporte de monitorización del reproductor musical XMMS2
-DBUILD_RSS=ON : Activa el soporte de monitorización de datos desde canales RSS
-DBUILD_WEATHER_METAR=ON : Activa el soporte de monitorización meteorológica de METAR.

-DBUILD_MYSQL=ON : Activa el soporte de monitorización de bases de datos MySQL.
-DBUILD_WEATHER_XOAP=ON : Activa el soporte de monitorización meteorológica de XOAP.
-DBUILD_WLAN=ON : Activa el soporte de monitorización de las conexiones de redes inalámbricas

-DBUILD_NVIDIA=ON : Activa el soporte de monitorización de las tarjetas gráficas NVIDIA.
-DBUILD_PULSEAUDIO=ON : Activa el soporte de monitorización del control de volumen de PulseAudio.
-DBUILD_IOSTATS=OFF : Desactiva el soporte de estadísticas de consumo E/S por proceso (per-task I/O), que viene activado por defecto.

-DBUILD_IPV6=OFF : Desactiva el soporte del protocolo de red, IPV6, que viene activado por defecto.
-DBUILD_IBM=OFF : Desactiva el soporte de monitorización de los portátiles IBM/Lenovo, que viene activado por defecto.
-DBUILD_MOC=OFF : Desactiva el soporte de monitorización del reproductor musical MOC, que viene activado por defecto.

-DBUILD_MPD=OFF : Desactiva el soporte de monitorización del reproductor musical MPD, que viene activado por defecto.
-DBUILD_HDDTEMP=OFF : Desactiva el soporte de monitorización de la temperatura de las unidades de disco duro, mediante el programa Hddtemp, que viene activado por defecto.

-DBUILD_PORT_MONITORS=OFF : Desactiva el soporte de monitorización del tráfico de red que utiliza el protocolo TCP (ipv4), que viene activado por defecto.
-DBUILD_XFT=OFF : Desactiva el suavizado de las fuentes que se muestran en Conky, que viene activado por defecto.

Compilación

$ ninja -C build

Parámetros de compilación opcionales

-v : Muestra más información en el proceso de compilación.

-j$(nproc) : Establece el número de procesos de compilación en paralelo, en función del número de núcleos e hilos que tenga nuestro procesador, tomando como referencia la información mostrada por el sistema con el comando correspondiente. Si nuestro procesador es mononúcleo de un solo hilo, no añadir esta opción.

Instalación como root

$ su
# ninja -C build install/strip
# install -dm755 /etc/conky
# install -m644 data/conky.conf /etc/conky
# mv /usr/local/share/doc/conky-1.20.2{_pre,}

Instalación del archivo de ejemplo de configuración personal en nuestro home

$ mkdir -p ~/.config/conky
$ cp /etc/conky/conky.conf ~/.config/conky

Desde la versión 1.7.0 también se puede crear desde la línea de comandos, sin necesidad de copiar el de ejemplo, el resultado es el mismo. Un ejemplo:

$ mkdir -p ~/.config/conky
$ conky -C > ~/.config/conky/conky.conf

Estadísticas de Compilación e Instalación de Conky

Estadísticas de Compilación e Instalación de Conky
CPU AMD Ryzen 5 5500
MHz 3600 (BoostMax=4457)
RAM 32 GB
Sistema de archivos XFS
Versión del Kernel 6.8.7-ml SMP PREEMPT_DYNAMIC x86_64
Modo de frecuencia de la CPU powersave (balance performance)
Planificador de CPU BMQ
Versión de Glibc 2.39
Librería estándar de C++ Libc++ 18.1.4
Enlazador dinámico LLD 18.1.4
Compilador Clang 18.1.4
Parámetros de optimización -03 -march=znver3 -mtune=znver3 -mllvm -polly-vectorizer=stripmine -flto -funified-lto -Wl,--lto=thin -Wl,--thinlto-jobs=6 -Wl,--lto-aa-pipeline=globals-aa -Wl,--lto-newpm-passes=memcpyopt
Parámetros de compilación -v -j12
Tiempo de compilación 10"
Archivos instalados 9
Mostrar/Ocultar la lista de archivos instalados
Ocupación de espacio en disco 1,4 MB

Consumo inicial de CPU y RAM de Conky

Consumo inicial de CPU y RAM de Conky
Programa
 CPU RAM
conky 1 % 7,3 MB
Para medir el consumo de CPU se utiliza el programa top, y para medir el consumo de RAM se utiliza el script de Python, ps_mem.py, creado por Pádraig Brady, que podemos encontrar en este enlace.

Directorio de configuración personal

~/.config/conky Es el directorio de configuración personal de Conky en nuestro home.
~/.config/conky/conky.conf Es el archivo de configuración personal de Conky en nuestro home.

Desinstalación como root

1) MODO TRADICIONAL

En el directorio de compilación ejecutamos el siguiente comando:

$ su -c "make uninstall"

2) MODO MANUALINUX

El principal inconveniente del comando anterior es que tenemos que tener el directorio de compilación en nuestro sistema para poder desinstalar el programa. En algunos casos esto supone muchos megas de espacio en disco. Con el paquete de scripts que pongo a continuación logramos evitar el único inconveniente que tiene la compilación de programas, y es el tema de la desinstalación de los mismos sin la necesidad de tener obligatoriamente una copia de las fuentes compiladas.

conky-1.20.2-scripts.tar.gz

$ su
# tar zxvf conky-1.20.2-scripts.tar.gz
# cd conky-1.20.2-scripts
# ./Desinstalar_conky-1.20.2

Copia de Seguridad como root

Con este otro script creamos una copia de seguridad de los binarios compilados, recreando la estructura de directorios de los mismos en un directorio de copias de seguridad (copibin) que se crea en el directorio /var. Cuando se haya creado el paquete comprimido de los binarios podemos copiarlo como usuario a nuestro home y borrar el que ha creado el script de respaldo, teniendo en cuenta que si queremos volver a restaurar la copia, tendremos que volver a copiarlo al lugar donde se ha creado.

$ su
# tar zxvf conky-1.20.2-scripts.tar.gz
# cd conky-1.20.2-scripts
# ./Respaldar_conky-1.20.2

Restaurar la Copia de Seguridad como root

Y con este otro script (que se copia de forma automática cuando creamos la copia de respaldo del programa) restauramos la copia de seguridad como root cuando resulte necesario.

$ su
# cd /var/copibin/restaurar_copias
# ./Restaurar_conky-1.20.2


Opciones de línea de comandos  

A continuación, las opciones de línea de comandos del programa con los comentarios traducidos al español.

[jose@localhost ~]$ conky --help
Uso: conky [OPCIÓN]...
Conky es un monitor del sistema que renderiza el texto en el escritorio o en
una ventana transparente. Las opciones de línea de comandos sobreescriben las
configuraciones definidas en el archivo de configuración.
   -v, --version             versión
   -q, --quiet               modo silencioso
   -D, --debug               incrementa los mensajes de salida. -DD para más mensajes.
   -c, --config=ARCHIVO      archivo config para cargar
   -C, --print-config        imprime la configuración por defecto a la salida estándar
                             ej. 'conky -C > ~/.conkyrc' creará un nuevo archivo config por defecto.
   -d, --daemonize           se ejecuta en 2º plano
   -h, --help                ayuda
   -a, --alignment=ALINEACIÓN alineación del texto en la pantalla, {top,bottom,middle}_{left,right,middle}
                                                                   {arriba,abajo,centro}_{izquierda,derecha,centro}
   -f, --font=FUENTE         fuente a usar para el texto
   -X, --display=PANTALLA    Pantalla X11 a utilizar
   -o, --own-window          se ejecuta en una ventana 
   -b, --double-buffer       doble buffer (previene el parpadeo del texto en la pantalla)
   -w, --window-id=WIN_ID    identificación de la ventana normal
   -x X                      posición x
   -y Y                      posición y
   -t, --text=TEXTO          texto a dibujar, utilizar comillas simples, como -t '$uptime'
   -u, --interval=SEGUNDOS   intervalo de actualización
   -i NÚMERO                 número de veces para actualizar Conky (y salir)
   -p --pause=SEGUNDOS       pausa en SEGUNDOS al inicio antes de realizar cualquier tarea


Configuración de Conky  Bloc de Notas

Sirva de ejemplo el archivo de configuración que hemos copiado a nuestro directorio home, el texto mostrado en pantalla lo podemos traducir a nuestro idioma sin ningún problema, cómo se puede ver en este archivo de configuración de ejemplo, que he personalizado un poco. 

-- vim: ts=4 sw=4 noet ai cindent syntax=lua
--[[
Conky, a system monitor, based on torsmo

Any original torsmo code is licensed under the BSD license

All code written since the fork of torsmo is licensed under the GPL

Please see COPYING for details

Copyright (c) 2004, Hannu Saransaari and Lauri Hakkarainen
Copyright (c) 2005-2012 Brenden Matthews, Philip Kovacs, et. al. (see AUTHORS)
All rights reserved.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
]]

conky.config = {
    alignment = 'top_left',
    background = false,
    border_width = 1,
    cpu_avg_samples = 2,
    default_color = 'white',
    default_outline_color = 'white',
    default_shade_color = 'white',
    draw_borders = false,
    draw_graph_borders = true,
    draw_outline = false,
    draw_shades = false,
    use_xft = true,
    font = 'DejaVu Sans Mono:size=10',
    gap_x = 5,
    gap_y = 60,
    minimum_height = 5,
    minimum_width = 5,
    net_avg_samples = 2,
    no_buffers = true,
    out_to_console = false,
    out_to_stderr = false,
    extra_newline = false,
    own_window = true,
    own_window_class = 'Conky',
    own_window_type = 'desktop',
    stippled_borders = 0,
    update_interval = 1.0,
    uppercase = false,
    use_spacer = 'none',
    show_graph_scale = false,
    show_graph_range = false
}

conky.text = [[
${scroll 16 $nodename - $sysname $kernel on $machine | }
$hr
${color grey}Encendido:$color $uptime
${color grey}Frecuencia (en MHz):$color $freq
${color grey}Frecuencia (en GHz):$color $freq_g
${color grey}RAM usada:$color $mem/$memmax - $memperc% ${membar 4}
${color grey}Swap usada:$color $swap/$swapmax - $swapperc% ${swapbar 4}
${color grey}CPU 0 usada:$color ${cpu cpu1}% ${cpubar 4}
${color grey}CPU 1 usada:$color ${cpu cpu2}% ${cpubar 4}
${color grey}Procesos:$color $processes  ${color grey}Corriendo:$color $running_processes
$hr
${color grey}Particiones:
/ $color${fs_free /}/${fs_size /} ${fs_bar 6 /}
home $color${fs_free /home}/${fs_size /home} ${fs_bar 6 /home}
win_c $color${fs_free /mnt/win_c}/${fs_size /mnt/win_c} ${fs_bar 6 /mnt/win_c}
win_d $color${fs_free /mnt/win_d}/${fs_size /mnt/win_d} ${fs_bar 6 /mnt/win_d}
win_e $color${fs_free /mnt/win_e}/${fs_size /mnt/win_e} ${fs_bar 6 /mnt/win_e}
${color grey}Internet:
Subida:$color ${upspeed ppp0} k/s${color grey} - Bajada:$color ${downspeed ppp0} k/s
$hr
${color grey}Nombre                  PID   CPU%   MEM%
${color lightgrey} ${top name 1} ${top pid 1} ${top cpu 1} ${top mem 1}
${color lightgrey} ${top name 2} ${top pid 2} ${top cpu 2} ${top mem 2}
${color lightgrey} ${top name 3} ${top pid 3} ${top cpu 3} ${top mem 3}
${color lightgrey} ${top name 4} ${top pid 4} ${top cpu 4} ${top mem 4}
]]

Definición de los elementos del archivo de configuración
Variable Descripción
alignment Define la posición de Conky en la pantalla que puede ser: top_left (arriba a la izquierda), top_right (arriba a la derecha), top_middle (arriba en el centro), bottom_left (abajo a la izquierda), botton_right (abajo a la derecha), bottom_middle (abajo en el centro), middle_left (en el centro a la izquierda), middle_right (en el centro a la derecha) o none (ninguna). También se pueden abreviar como tl, tr, tm, bl, br, bm, ml, mr
append_file Anexa un archivo determinado como un argumento.
background Si se pone en true, el programa se ejecutará en 2º plano, como un demonio.
forced_redraw Si se pone en true, el programa se redibujará cuando se cambie de escritorio virtual.
border_inner_margin Define el margen interior del borde en píxeles. (el margen entre el borde y el texto)
border_outer_margin Define el margen exterior del borde en píxeles. (el margen entre el borde y el borde de la ventana)
border_width Define la anchura del borde en píxeles.
colorN Define un color predefinido para utilizar en la sección conky.text. Sustituir N por un dígito comprendido entre 0 y 9, inclusive. Si se especifica el color en valores hexadecimales omitir el prefijo #.
console_bar_fill Define un carácter para rellenar las barras de la consola (valor predefinido: #).
console_bar_unfill Define un carácter para vaciar las barras de la consola (valor predefinido: .).
console_graph_ticks Define una lista separada por comas de cadenas a usar como las barras de un gráfico de salida a la consola. El primer elemento de la lista se utiliza para la altura mínima de la barra y el último elemento para la altura máxima.

Ejemplo: ", _, ▁, ▂, ▃, ▄, ▅, ▆, ▇, █".
cpu_avg_samples Define el número de muestras para promediar el monitoreo de la cpu.
default_bar_height Define una altura específica para el tamaño de las barras. Esto es particularmente útil para las variables 'execbar' y 'execibar' cuando no contienen los parámetros del tamaño. El valor por defecto es 6.
default_bar_width Define una anchura específica para el tamaño de las barras. Esto es particularmente útil para las variables 'execbar' y 'execibar' cuando no contienen los parámetros del tamaño. El valor por defecto es 10.
default_color Define el color por defecto, incluyendo el borde.
default_gauge_height Define una altura específica para los medidores. Esto es particularmente útil para las variables 'execgauge' y 'execigauge' cuando no contienen los parámetros del tamaño. El valor por defecto es 25.
default_gauge_width Define una anchura específica para los medidores. Esto es particularmente útil para las variables 'execgauge' y 'execigauge' cuando no contienen los parámetros del tamaño. El valor por defecto es 40.
default_graph_height Define una altura específica para los gráficos. Esto es particularmente útil para las variables 'execgraph' y 'execigraph' cuando no contienen los parámetros del tamaño. El valor por defecto es 25.
default_graph_width Define una anchura específica para los gráficos. Esto es particularmente útil para las variables 'execgraph' y 'execigraph' cuando no contienen los parámetros del tamaño. El valor por defecto es 0.
default_outline_color Define el color del contorno por defecto.
default_shade_color Define el color de la sombra, incluyendo el borde.
disable_auto_reload Activa o desactiva la recarga automática de la configuración del programa.
diskio_avg_samples Define el número de muestras para promediar el monitoreo de las entradas y salidas (I/O) de los discos.
display Especifica una pantalla X a la que conectar
xinerama_head Especifica una pantalla a la que conectar cuando tenemos más de un monitor conectados.
double_buffer Si se pone en true, elimina el parpadeo del texto en la pantalla.
draw_blended Si se pone en false, no se fusionará la imagen de fondo del escritorio con la superficie de Conky.
draw_borders Si se pone en true, se dibujarán bordes alrededor del texto.
draw_graph_borders Si se pone en true, se dibujarán bordes alrededor de los gráficos.
draw_outline Si se pone en true, se dibujarán los contornos.
draw_shades Si se pone en true, se dibujarán las sombras.
extra_newline Coloca una línea extra al final cuando se escribe en la salida estándar.
font Define la fuente de texto a utilizar. Ejecutar xfontsel para saber las que tenemos instaladas. O cualquier otro programa que permita seleccionar las fuentes a usar.
fontN Define una fuente de texto predefinida para utilizar en la sección conky.text. Sustituir N por un dígito comprendido entre 0 y 9, inclusive. Utilice el mismo formato que una variable de fuente.
format_human_readable Si se pone en true, los bytes serán mostrados en un formato humanamente entendible, cómo KiB, MiB, etc.
gap_x Define las coordenadas de posición horizontal entre el borde de Conky y el borde derecho o izquierdo de la pantalla. Por ejemplo: gap_x 10
gap_y Define las coordenadas de posición vertical entre el borde de Conky y el borde derecho o izquierdo de la pantalla. Por ejemplo: gap_y 10
github_token Define el token de la API para las notificaciones de GitHub.
https://github.com/settings/tokens/new?scopes=notifications&description=conky
hddtemp_host Define el nombre del servidor a conectar para el programa de monitorización de temperatura de los discos duros, Hddtemp. Por defecto es "127.0.0.1".
hddtemp_port Define el número de puerto que se usará para las conexiones de Hddtemp. Por defecto el 7634.
http_port Define el puerto de escucha para las conexiones HTTP. El valor por defecto es 10080, pero este es bloqueado por Firefox y Chrome, por lo que, habrá que cambiarlo.
http_refresh Cuando se establece, la página generada con out_to_http, se actualizará automáticamente cada intervalo. El valor predefinido es no.
if_up_strictness Cómo de estricto tiene que ser if_up para comprobar una interfaz de red para la subida de datos. El valor posible es up, link o address. Si es up, sólo la comprueba si está enviando datos, si es link, la comprueba si está enviando datos y existe un enlace, y si es address, la comprueba si está enviando datos, existe un enlace y una dirección IP asignada.
imap Define el servidor global IMAP por defecto. Los argumentos son "host usuario contraseña [-i intervalo] [-f carpeta] [-p puerto] [-e comando] [-r reintentos]". El puerto por defecto es el 143, la carpeta por defecto es 'INBOX', el intervalo por defecto es 5 minutos y el número de reintentos predefinidos es 5, antes de cortar la conexión. Si la contraseña es definida con un asterisco '*', usted tendrá que introducirla cuando Conky se inicie.
imlib_cache_flush_interval Define el intervalo en segundos para vaciar la caché de Imlib2.
imlib_cache_size Define el tamaño de la caché de imagen de Imlib2, en bytes. Por defecto es 4 MB. Incrementarla si se utilizan muchas variables $image, es decir, muchas imágenes. Ajustarlo a 0 para desactivar la caché de imagen.
lua_draw_hook_post Si está definida, esta función será llamada por Conky a través de cada iteracción después de dibujar la ventana. Requiere soporte de X. Toma cualquier número de argumentos opcionales. Use este conector para dibujar objetos por encima de los que dibuja Conky. Conky coloca 'conky_' por delante del nombre de la función para prevenir llamadas accidentales a la función incorrecta.
lua_draw_hook_pre Si está definida, esta función será llamada por Conky a través de cada iteracción antes de dibujar la ventana. Requiere soporte de X. Toma cualquier número de argumentos opcionales. Use este conector para dibujar objetos por encima de los que dibuja Conky. Conky coloca 'conky_' por delante del nombre de la función para prevenir llamadas accidentales a la función incorrecta.
lua_load Carga los script de Lua separados por espacios.
lua_shutdown_hook Si está definida, esta función será llamada por Conky al salir o cuando la configuración sea recargada. Use este conector para una limpieza posterior, cómo liberar la memoria que ha sido asignada por las librerías, vía Lua. Conky coloca 'conky_' por delante del nombre de la función para prevenir llamadas accidentales a la función incorrecta.
lua_startup_hook Si está definida, esta función será llamada por Conky al iniciar o cuando la configuración sea recargada. Use este conector para inicializar los valores, o para ejecutar cualquier aplicación. Conky coloca 'conky_' por delante del nombre de la función para prevenir llamadas accidentales a la función incorrecta.
mail_spool Define el directorio de comprobación del correo.
max_port_monitor_connections Define el número máximo de conexiones a rastrear por cada puerto monitorizado (si se pone 0 se desactiva esta opción, por defecto es 256)
max_specials Define el número máximo de objetos especiales, por ejemplo las fuentes, los desplazamientos, alineaciones, etc. (el valor por defecto es 512)
max_text_width Cuando una línea contiene caracteres 'width' en la salida estándar y el final no se alcanza, el siguiente caracter se iniciará en una nueva línea. Si usted quiere asegurarse de que las líneas no se rompan, establezca 'width' a 0.
max_user_text Define el tamaño máximo de la caché de memoria del texto del usuario, es decir, el contenido por encima de la línea conky.text = [[ del archivo de configuración (por defecto es 16384 bytes)
maximum_width Define la anchura máxima de la ventana de Conky.
minimum_height Define la altura mínima de la ventana de Conky.
minimum_width Define la anchura mínima de la ventana de Conky.
mpd_host Define el host del servidor MPD. 
mpd_password Define la contraseña de conexión al servidor MPD.
mpd_port Define el puerto del servidor MPD. 
mysql_host Define el host del servidor MySQL. Por defecto es localhost.
mysql_port Define el puerto del servidor MySQL. Por defecto es el puerto mysql.
mysql_user Define el nombre de usuario para conectar al servidor MySQL. Por defecto es su nombre de usuario.
mysql_password Define la contraseña de conexión al servidor al servidor MySQL. Colóquelo entre comillas, cuando no exista contraseña para acceder al servidor MySQL.
mysql_db Define el nombre de la base de datos MySQL. Por defecto es mysql.
music_player_interval Define el intervalo de actualización de MPD. Por defecto es el mismo de Conky.
net_avg_samples Define el número de muestras para promediar el monitoreo del tráfico de red.
no_buffers Si se pone en true, se utilizará el sistema de archivos en vez de la memoria física para almacenar los datos de la caché de Conky.
nvidia_display Define la sesión del servidor gráfico que será utilizada por la variable de nvidia. Por defecto utiliza el valor definido por la variable display.
out_to_console Imprime el texto a la salida estándar (stdout).
out_to_http Convierte a Conky en un pequeño servidor HTTP de texto.
out_to_ncurses Imprime el texto en la consola, pero usa ncurses para que conky pueda imprimir el texto de una nueva actualización sobre el texto antiguo. (En el futuro esto proporcionará las cosas más útiles).
out_to_stderr Imprime el texto a la salida estándar de errores (stderr).
out_to_x Cuando esté ajustado en false, no habrá ninguna salida en X (útil cuando se está utilizando variables como out_to_console). Si usted lo establece en false, asegúrese de colocarlo por encima de cualquier otro ajuste relacionado con el servidor X, lo mejor es colocarlo en la primera línea del archivo de configuración. El valor por defecto es true.
override_utf8_locale Si se pone en true, fuerza a utilizar las locales con la codificación de caracteres, UTF-8. Sólo es posible si está activado el uso de XFT.
overwrite_file Sobreescribe el archivo indicado como un argumento.
own_window Si se pone en true, Conky se ejecutará en una ventana. Esta opción viene activada por defecto en la versión 1.7.0, su uso no es nada recomendable con administradores de ventanas como IceWM.
own_window_class Establece manualmente el nombre de la ventana WM_CLASS. Por defecto es 'Conky'
own_window_colour Si own_window_transparent está ajustado a false, establece el color de fondo de la ventana (por defecto es black [negro]). Se puede utilizar valores hexadecimales (#ffffff) o nombres de color: black, blue, yellow, white, etc.
own_window_hints Si se pone en true y own_window también está en true, Conky utilizará las características de disposición de ventanas del administrador de ventanas con el que se ejecute. Esto también se puede hacer de forma directa con el uso de la variable own_window_type.
own_window_title Ajusta de forma manual el nombre de la ventana. Predefinido a "<máquina> - conky".
own_window_argb_visual Si se pone en true, activa el soporte de transparencia real del servidor gráfico X, se requiere del uso de un gestor de ventanas compuesto. Esta opción no funciona como debería de ser (en la mayoría de los casos) en combinación con own_window_type override.
own_window_argb_value Si está activado el soporte de transparencia real, con este parámetro se regula el nivel de transparencia a usar, en un rango de 0 a 255, donde 0 es transparencia total y 255 es opacidad total. Si  own_window_transparent está activado, este valor no produce efecto alguno.
own_window_transparent Si se pone en true, activa la pseudotransparencia.
own_window_type Si own_window está en true, se puede definir normal, desktop, dock, panel u override (predefinido: normal). Las ventanas desktop son unas ventanas especiales que no tienen decoración, están siempre visibles en su escritorio, no aparecen en el paginador ni en la barra de tareas; y se muestran en todos los escritorios virtuales. Las ventanas panel reservan el espacio a lo largo de un borde del escritorio, tal cómo paneles y barras de tareas, preservando que las ventanas maximizadas puedan cubrirlos. El borde es elegido basado en la opción alignment. Las ventanas override no están bajo el control del administrador de ventanas. Este tipo de ventana puede ser útil para ciertas situaciones.
pad_percents Rellena los porcentajes con este número de decimales (0 = sin relleno).
pop3 Define el servidor global POP3 por defecto. Los argumentos son "host usuario contraseña [-i intervalo] [-f carpeta] [-p puerto] [-e comando] [-r reintentos]". El puerto por defecto es el 110, el intervalo por defecto es 5 minutos y el número de reintentos predefinidos es 5, antes de cortar la conexión. Si la contraseña es definida con un asterisco '*', habrá que introducirla cuando Conky se inicie.
short_units Reduce las unidades a un solo carácter (el kiB->k, GiB->G, etc.). el valor por defecto es false.
show_graph_range Muestra el rango de tiempo cubierto por un gráfico.
show_graph_scale Muestra el valor máximo en gráficos escalados.
stippled_borders Define el borde de mezcla en píxeles.
temperature_unit Define la unidad de medida deseada para todos los objetos que despliegan una temperatura. Los parámetros son "fahrenheit" o "celsius". La unidad predefinida es el grado Celsius.
templateN Define una plantilla para utilizar después dentro de los segmentos conky.text. Sustituir N por un dígito comprendido entre 0 y 9, inclusive. El valor de la variable es insertado dentro del contenido debajo de conky.text y en la posición correspondiente, pero antes de que algunas sustituciones sean aplicadas:

*  '\n' -> nueva-línea
*  '\\' -> contrabarra
*  '\ ' -> espacio
*  '\N' -> argumento plantilla N
text_buffer_size Define el tamaño de la caché de memoria estándar (por defecto es 256 bytes). Esta caché es usada por el texto intermedio, las líneas individuales, la salida desde $exec vars y otras variables. Si incrementa el tamaño de esta caché puede reducir considerablemente el rendimiento de Conky, pero le permite mostrar más texto por cada variable. El tamaño nunca debe de ser menor del predefinido (256 bytes).
times_in_seconds Si se pone en true, las variables que contengan salida de tiempos mostrarán un número que represente los segundos. Esto no afecta a $time, $tztime y $utime 
top_cpu_separate Si se pone en true, se mostrará el uso de los procesadores que puedan haber en el sistema de forma independiente, si se pone en false, se mostrará el uso combinado de todos los procesadores que puedan haber en el sistema.
top_name_verbose Si se pone en true, el nombre de la variable $top mostrará la línea de comandos completa de cada proceso, incluyendo argumentos (siempre que sea posible). De lo contrario se mostrará sólo el nombre base.
top_name_width Define la anchura del valor del nombre de la variable $top (Por defecto son 15 caracteres)
total_run_times Número total de veces para que Conky se actualice antes de terminar. 0 hace que Conky esté corriendo siempre.
units_spacer Cadena a colocar entre los valores y las unidades. (por defecto: vacío)
update_interval Define el intervalo de actualización en segundos.
update_interval_on_battery Define el intervalo de actualización en segundos cuando el sistema operativo está corriendo en un ordenador portátil.
detect_battery Define una o más baterías para utilizar con update_interval_on_battery (separados por comas, el valor por defecto es BAT0).
uppercase Si se pone en true, el texto se mostrará en letras mayúsculas.
lowercase Si se pone en true, el texto se mostrará en letras minúsculas.
use_spacer Añade espacios alrededor de ciertos objetos para detener el movimiento de otros objetos de alrededor. Los argumentos son left (a la izquierda), right (a la derecha) o none (ninguno) (predefinido). Esto sólo es efectivo si se utiliza una fuente mono, como la Bitstream Vera Sans Mono.
use_xft Si se pone en true, se activará el suavizado de las fuentes.
xftalpha Define el valor alfa de la fuente Xft. El valor tiene que estar comprendido entre 0 y 1.


Configurar el inicio de Conky  

A continuación varios ejemplos de inicio de Conky con algunos de los administradores de ventanas cuya documentación está disponible en la web. El uso del comando sleep para retardar el inicio de Conky, es necesario para conseguir una correcta integración con la imagen del fondo del escritorio.

1) Blackbox

Siguiendo el método que se utiliza en el manual de Blackbox, lo añadimos al script ~/.blackbox/autostart de la siguiente forma.

#!/bin/sh

(sleep 2; bbkeys &) &
bsetbg -f ~/Fotos/40.jpg
sleep 5; conky -a br &

2) Fluxbox

Añadimos el comando de ejecución en la sección correspondiente del script de inicio ~/.fluxbox/startup,

# Applications you want to run with fluxbox.
# MAKE SURE THAT APPS THAT KEEP RUNNING HAVE AN ''&'' AT THE END.
#
# unclutter -idle 2 &
# wmnd &
# wmsmixer -w &
wmix &
idesk &
sleep 5; conky -a br &

3) Fvwm

Añadimos el comando de ejecución en la sección correspondiente del archivo autostart, cuya configuración se explica en el manual de Fvwm.

AddToFunc StartFunction  I     Test (Init) Exec exec xscreensaver
AddToFunc StartFunction  I     Test (Init) Exec exec conky -a mr

4) IceWM

Añadimos el comando de ejecución al script de inicio ~/.icewm/startup,

#!bin/sh

sleep 5; conky &
gai-bgswitcher &
bluecombo &
sleep 5 && wmix &

5) JWM

Añadimos el comando de ejecución en la sección correspondiente del archivo de configuración ~/.jwmrc, en la versión original y ~/.jwm/autostart.xml en la versión en español disponible en la web.

~/.jwmrc
    <StartupCommand>
        sleep 5; conky -a tr -x 100 -y 190 &
        idesk & 
    </StartupCommand>

~/.jwm/autostart.xml
<?xml version="1.0"?>

<JWM>

    <StartupCommand>
        idesk &
        sleep 5; conky -a tr -x 100 -y 190 &
    </StartupCommand>
   
    <RestartCommand>
   
    </RestartCommand>
   
     <ShutdownCommand>
        killall -9 idesk &> /dev/null
        killall -9 conky &> /dev/null
    </ShutdownCommand>
  
</JWM>  

6) Openbox

Añadimos el comando de ejecución al script de inicio ~/.config/openbox/autostart, autostart.sh en versiones inferiores a la 3.5.x.

sleep 5; conky &
sleep 5; pypanel &
xbindkeys &

7) Pekwm

Añadimos el comando de ejecución en la sección correspondiente del script de inicio ~/.pekwm/start

# There's probably a few other good uses for it, too. I mainly pushed for it
# because when I was doing fluxbox's docs, people used to complain that there
# wasn't one, and I wanted to avoid that for pekwm. ;) --eyez

sleep 5; conky &
numlockx &
fbpanel &

8) Window Maker

Añadimos el comando de ejecución al script de inicio ~/GNUSTEP/Library/WindowMaker/autostart

#!/bin/sh
#
# Place applications to be executed when WindowMaker is started here.
# This should only be used for non-X applications or applications that
# do not support session management. Other applications should be restarted
# by the WindowMaker session restoring mechanism. For that, you should
# either set SaveSessionOnExit=YES or select "Save Session" in the Workspace
# submenu of the root menu when all applications you want started are
# running.
#
# WindowMaker will wait until this script finishes, so if you run any
# commands that take long to execute (like a xterm), put a ``&'' in the
# end of the command line.
#
# This file must be executable.
#

sleep 5; conky -a ml &

9) Para los que inician X desde terminal con el comando startx

Para los usuarios que inician los entornos gráficos con el comando startx, pueden añadir el comando de ejecución al archivo .xinitrc que se encuentra en nuestro home, si no existe lo creamos, y añadimos lo siguiente:

sleep 5; conky &
exec fvwm

10) XDM

Añadimos el comando de ejecución al archivo .xsession que se encuentra en nuestro home, si no existe lo creamos, y añadimos lo siguiente:

sleep 5; conky &
exec fvwm

Para otros administradores de ventanas, consultar sus respectivos manuales, en lo que haga referencia a la ejecución de programas al inicio de estos. 


Iniciamos Conky  
Captura Conky + JWM
Conky + JWM
Captura Conky + IceWM
Conky + IceWM



Utilizar una imagen de fondo  

Esto sólo es funcional si hemos compilado el programa con soporte de Imlib2. Una manera rápida de utilizar una imagen de fondo que se ajuste de manera proporcional al espacio que ocupa Conky en la pantalla, es saber en primer lugar el tamaño de éste, y para ello nos valdremos de la utilidad, xwininfo. Abrimos una ventana de terminal y ejecutamos Conky con la opción -o para que se muestre en modo de ventana (es el predefinido del programa), abrimos otra ventana o pestaña de terminal y ejecutamos xwininfo, el puntero del ratón se convertirá en una cruceta y con la misma hacemos clic sobre Conky, de la información que se muestre en la ventana de terminal, nos tenemos que quedar siempre con el valor que está en rojo (339x410).

[jose@localhost ~]$ xwininfo

xwininfo: Please select the window about which you
          would like information by clicking the
          mouse in that window.

xwininfo: Window id: 0x2000001 "conky (localhost)"

  Absolute upper-left X:  1528
  Absolute upper-left Y:  54
  Relative upper-left X:  0
  Relative upper-left Y:  0
  Width: 339
  Height: 410
  Depth: 24
  Visual: 0x21
  Visual Class: TrueColor
  Border width: 0
  Class: InputOutput
  Colormap: 0x20 (installed)
  Bit Gravity State: ForgetGravity
  Window Gravity State: NorthWestGravity
  Backing Store State: Always
  Save Under State: no
  Map State: IsViewable
  Override Redirect State: no
  Corners:  +1528+54  -53+54  -53-616  +1528-616
  -geometry 339x410-53+54

Ahora creamos una imagen o recortamos cualquier fondo de escritorio que tengamos a mano a una medida de 339x410 píxeles. Y añadimos la variable correspondiente en el archivo de configuración del programa con la ruta a la imagen que vamos a utilizar. Si está Conky en ejecución no es necesario reiniciarlo, detecta de forma automática los cambios que realicemos en el archivo de configuración.

conky.text = [[
${image /home/jose/Fondos/kelly_brook_1.jpg}
${scroll 16 $nodename - $sysname $kernel on $machine | }
$hr
${color grey}Encendido:$color $uptime
${color grey}Frecuencia (en MHz):$color $freq
${color grey}Frecuencia (en GHz):$color $freq_g

Y el resultado es el siguiente:
Captura Conky + Fluxbox
Conky + Fluxbox



Enlaces  

https://conky.cc >> La web de Conky.

https://github.com/brndnmtthws/conky >> Enlace al proyecto en GitHub.

Foro Galería Blog

Actualizado el 25-04-2024

Utilidades de Escritorio - Conky

Utilidades de Escritorio - BMPanelUtilidades de Escritorio - CWallpaper