Estas configurações devem ser declaradas na primeira parte de seu arquivo de configuração, acima da sessão "TEXT", que você conhecerá adiante.
A localização do arquivo de configuração padrão é: ${sysconfdir}/conky/conky.conf. Na maioria dos sistemas, sysconfdir é o diretório /etc, e você pode encontrar o arquivo de configuração exemplo em (/etc/conky/conky.conf).
Você pode querer copiá-lo para $HOME primeiro, para começar a modificá-lo.
cp /etc/conky/conky.conf ${HOME}
As possíveis configurações são:
alignment
Posição de alinhamento na tela. Argumentos: top_left, top_right, top_middle, bottom_left, bottom_right, bottom_middle, middle_left, middle_middle, middle_right ou nenhum (none). Também pode ser abreviado como tl, tr, tm, bl, br, bm, ml, mm, mr. Veja também gap_x e gap_y.
append_file
Anexar o arquivo informado como argumento.
background
Valor boolean ("true", "false" ou, "yes", "no"), se for verdade (true/yes), o Conky será executado e jogado para background quando iniciar, assim caso você feche seu terminal, ele continua rodando.
border_inner_margin
Margem de borda interna em pixels (a margem entre a borda e o texto).
border_outer_margin
Margem de borda externa em pixels (a margem entre a borda do conky e a borda da janela).
border_width
Largura da borda em pixels.
colorN
Predefinir uma cor para uso dentro dos segmentos conky.text. Substitua N por um dígito entre 0 e 9, inclusive. Ao especificar o valor da cor em hexadecimal, omita o hash principal (#).
cpu_avg_samples
O número de amostras para a média de monitoramento da CPU.
default_bar_height
Especifique uma altura padrão para barras. Isso é particularmente útil para execbar e execibar, pois eles não tomam argumentos de tamanho.
default_bar_width
Especifique uma largura padrão para barras.
default_color
Cor padrão do conky.
default_gauge_height
Especifique uma altura padrão para medidores. Isso é particularmente útil para execgauge e execigauge, pois eles não tomam argumentos de tamanho.
default_gauge_width
Especifique uma largura padrão para medidores.
default_graph_height
Especifique uma altura padrão para gráficos. Isso é particularmente útil para execgraph e execigraph, pois eles não tomam argumentos de tamanho.
default_graph_width
Especifique uma largura padrão para gráficos.
default_outline_color
Cor padrão da estrutura.
default_shade_color
Cor padrão de sombreamento.
disable_auto_reload
Habilite para desativar o recurso de recarga de configuração automática inotify-based. Assim o conky não recarrega seu arquivo de configuração.
diskio_avg_samples
O número de amostras para a média de monitoramento de I/O do disco.
display
Especifique a tela X11 à se conectar.
double_buffer
Usa a extensão Xdbe, e ajuda a eliminar a "cintilação". É recomendável usar uma própria janela com este, então o buffer duplo não será tão grande.
draw_borders
Desenha bordas.
draw_graph_borders
Desenha bordas em torno de gráficos.
draw_outline
Desenha esquemas em torno do conky.
draw_shades
Desenhar sombras.
extra_newline
Coloque uma nova linha extra no final ao escrever para a saída, útil para escrever para wiboxes.
font
Nome da fonte X, xfontsel pode ser usado para obter uma fonte agradável.
format_human_readable
Se ativado, os valores que estão em bytes serão impressos em formato legível para humanos (ou seja, KiB, MiB etc.). Se desativado, o número de bytes é impresso.
gap_x
Posição do conky na reta X (horizontal), em relação à posição declarada em 'alignment'. Isto é o mesmo que passar -x na linha de comando. (ex: gap_x 10).
gap_y
Posição do conky na reta Y (vertical), em relação à posição declarada em 'alignment'. Isto é o mesmo que passar -y na linha de comando. (ex: gap_y 10).
hddtemp_host
Hostname para se conectar aos objetos hddtemp. Por padrão, "127.0.0.1" (localhost).
hddtemp_port
Porta à se usar para conexões hddtemp. Padrões para 7634.
http_refresh
Quando isso é configurado, a página gerada com out_to_http irá atualizar automaticamente a cada intervalo. O valor padrão é "no".
imap
Servidor IMAP global padrão. Argumentos são: "host user pass [-i interval (in seconds)] [-f 'folder'] [-p port] [-e 'command'] [-r retries]". A porta padrão é 143, a pasta padrão é 'INBOX', o intervalo padrão é de 5 minutos e o número padrão de tentativas antes de desistir é 5. Se a senha for fornecida como '*', você será solicitado a inserir a senha quando o Conky iniciar.
imlib_cache_flush_interval
Intervalo (em segundos) para eliminar o cache Imlib2.
imlib_cache_size
Tamanho do cache de imagem Imlib2, em bytes. Padrões para 4MiB. Aumente esse valor se você usar $image lots. Defina como "0" para desativar o cache da imagem.
lua_draw_hook_post function_name [function arguments]
Esta função, se definida, será chamada pelo Conky através de cada iteração após o desenho para a janela. Requer suporte X. Toma qualquer número de argumentos opcionais. Use esse gancho para desenhar coisas sobre o que o conky desenha. O conky coloca 'conky_' na frente de function_name para evitar chamadas acidentais para a função errada a menos que você mesmo coloque.
lua_draw_hook_pre function_name [function arguments]
Esta função, se definida, será chamada por Conky através de cada iteração antes de desenhar para a janela. Requer suporte X. Toma qualquer número de argumentos opcionais. Use esse gancho para desenhar coisas sobre o que o conky desenha. O conky coloca 'conky_' na frente de function_name para evitar chamadas acidentais para a função errada a menos que você mesmo coloque.
lua_load
Carrega os scripts Lua separados por espaços.
lua_shutdown_hook function_name [function arguments]
Esta função, se definida, será chamada pelo Conky no desligamento ou quando a configuração for recarregada. Use este gancho para limpar depois de você, como a liberação de memória que foi atribuída por bibliotecas externas via Lua. O conky coloca 'conky_' na frente de function_name para evitar chamadas acidentais para a função errada a menos que você mesmo coloque.
lua_startup_hook function_name [function arguments]
Esta função, se definida, será chamada pelo Conky na inicialização ou quando a configuração for recarregada. Use este gancho para inicializar valores ou para qualquer aplicativo executado uma vez. O conky coloca 'conky_' na frente de function_name para evitar chamadas acidentais para a função errada a menos que você mesmo coloque.
mail_spool
Correio eletrônico para verificar e-mails.
max_port_monitor_connections
Permita que cada monitor de porta rastreie, no máximo, "x" conexões (se 0 ou não estiver definido, o padrão é 256).
max_text_width width
Quando uma linha, na saída contém caracteres de "largura" e o final não é alcançado, o próximo caractere começará em uma nova linha. Se quiser certificar-se de que as linhas não sejam quebradas, defina 'width' como "0".
max_user_text bytes
Tamanho máximo do buffer de texto do usuário, ou seja, texto dentro da seção conky.text no arquivo de configuração (o padrão é 16384 bytes).
maximum_width pixels
Largura máxima da janela.
minimum_height height
Altura mínima da janela
minimum_width width
Largura mínima da janela
mpd_host
Host do servidor MPD
mpd_password
Senha do servidor MPD
mpd_port
Porta do servidor MPD
mysql_host
Host do servidor MySQL. Padrão para localhost
mysql_port
Porta do servidor MySQL. Padrão para a porta mysql padrão
mysql_user
Nome do usuário MySQL a ser usado ao conectar-se ao servidor. Padrão para o seu nome de usuário
mysql_password
Senha do usuário MySQL. Coloque-o entre "-chars. Quando isso não está configurado, não há senha usada
mysql_db
Banco de dados MySQL para usar. Padrões para mysql
music_player_interval
Intervalo de atualização de thread do player de música (padrão para o intervalo de atualização do Conky)
net_avg_samples
O número de amostras para média de dados da internet
no_buffers
Subtrair os buffers usados da memória (Boolean)
nvidia_display
Display que a variável nvidia usará (padrão para o valor da variável de exibição)
out_to_console
Imprima texto para saída.
out_to_http
Deixe o conky agir como um pequeno servidor http que "serve" seu texto.
out_to_ncurses
Imprima texto no terminal, mas use ncurses para que o conky possa imprimir o texto de uma nova atualização sobre o texto antigo (no futuro, isso proporcionará coisas mais úteis).
out_to_stderr
Imprima texto para saída de erro.
out_to_x
Quando definido como "no", não haverá saída em X (útil quando você também usa coisas como out_to_console). Se você configurá-lo como "no", certifique-se de que ele é colocado antes de todas as outras configurações relacionadas ao X (pegue a primeira linha do seu arquivo de configuração para ter certeza). O valor padrão é "yes".
override_utf8_locale
Força codificação UTF8. Requer XFT.
overwrite_file
Substitua o arquivo informado como argumento.
own_window
Boolean, crie uma janela própria para desenhar.
own_window_class
Defina manualmente o nome WM_CLASS. Por padrão, "Conky".
own_window_colour color
Se own_window_transparent, for "no", defina uma cor de fundo especificada (padrão, preto). Obtém um valor hexadecimal (por exemplo, ffffff, observe a falta de '#') ou um nome RGB válido (veja /usr/lib/X11/rgb.txt).
own_window_hints undecorated,below,above,sticky,skip_taskbar,skip_pager
Se own_window, for "sim", você pode usar essas sugestões do gerenciador de janelas para afetar a maneira como o Conky é exibido. Notas: Use a área de trabalho own_window_type como outra maneira de implementar muitas dessas dicas de forma implícita. Se você usar a substituição own_window_type, as sugestões do gerenciador de janelas não têm significado e são ignoradas.
own_window_title
Defina manualmente o nome da janela. Por padrão, "conky (<hostname>)".
own_window_argb_visual
Boolean, use o visual ARGB. O ARGB pode ser usado para transparência real, note que é necessário um gerenciador composto para transparência real. Esta opção não funcionará como desejado (na maioria dos casos) em conjunto com 'own_window_type override'.
own_window_argb_value
Quando os recursos visuais da ARGB estão ativados, use isso para modificar o valor alfa usado. O intervalo válido é 0-255, onde 0 é opacidade de 0% e 255 é opacidade de 100%.
own_window_transparent
Boolean, defina a transparência. Se o ARGB visual estiver habilitado, este, configura a opacidade de fundo para 0%.
own_window_type
Se own_window, for "yes", você pode especificar o tipo {normal, desktop, dock, panel ou override} (padrão: normal). As janelas da área de trabalho são janelas especiais que não possuem decorações para janelas; são sempre visíveis na sua área de trabalho; não aparece no seu pager ou na barra de tarefas; e são acessíveis em todos os espaços de trabalho. O espaço de reserva do painel de janelas ao longo da borda da área de trabalho, assim como painéis e barras de tarefas, evitando que o Windows maximizado as sobrepõe. A borda é escolhida com base na opção de alinhamento. Override windows não está sob o controle do gerenciador de janelas. As dicas são ignoradas. Este tipo de janela pode ser útil para determinadas situações.
pad_percents
Porcentagens de preenchimento para este número de decimais (0=sem preenchimento).
pop3
Servidor POP3 global padrão. Argumentos são: "host user pass [-i interval (in seconds)] [-p port] [-e 'command'] [-r retries]". A porta padrão é 110, o intervalo padrão é de 5 minutos e o número padrão de tentativas antes de desistir é 5. Se a senha for fornecida como '*', você será solicitado a inserir a senha quando o Conky começar.
short_units
Reduz as unidades à um único caractere (kiB-> k, GiB-> G etc.). O padrão é "off".
show_graph_range
Mostra o intervalo de tempo coberto por um gráfico.
show_graph_scale
Mostra o valor máximo em gráficos escalados.
stippled_borders
Bordas pontilhadas.
temperature_unit
Unidade de saída desejada de todos os objetos que exibem uma temperatura. Parâmetros são "Fahrenheit" ou "Celsius". A unidade padrão é o grau Celsius.
templateN
Defina um modelo para uso posterior dentro dos segmentos conky.text. Substitua N por um dígito entre 0 e 9, inclusive. O valor da variável está sendo inserido no material dentro de conky.text na posição correspondente, mas antes de serem aplicadas algumas substituições:
- '\n' -> newline
- '\\' -> backslash
- '\ ' -> space
- '\N' -> template argument N (starting from 1)
text_buffer_size bytes
Tamanho do buffer de texto (o padrão é 256 bytes). Esse buffer é usado para texto intermediário, como linhas individuais, saída de $exec vars e várias outras variáveis. Aumentar o tamanho desse buffer pode reduzir drasticamente o desempenho do conky, mas permitirá a exibição de texto por variável. O tamanho desse buffer não pode ser menor do que o valor padrão de 256 bytes.
times_in_seconds
Se for verdade (true), as variáveis que exibem os tempos produzem um número que representa segundos. Isso não afeta $time, $tztime e $utime
top_cpu_separate
Se for verdade (true), a CPU mostrará o uso da potência de um processador. Se for falso (false), a CPU mostrará o uso de todos os processadores de energia combinada.
top_name_verbose
Se for verdade, o nome acima mostra a linha de comando completa de cada processo, incluindo argumentos (sempre que possível). Caso contrário, apenas o nome do banco de dados é exibido. O valor padrão é "false".
top_name_width
Largura para o valor $top name (padrão para 15 caracteres).
total_run_times
Número total de vezes para o Conky atualizar antes de sair. Zero faz Conky correr para sempre
update_interval seconds
Intervalo de atualização
update_interval_on_battery seconds
Intervalo de atualização quando executado em baterias (Máquina fora da tomada)
uppercase
Boolean, se verdadeiro, o texto é exibido em letra MAIÚSCULA.
use_spacer
Adiciona espaços em torno de certos objetos para impedir que movam outras coisas ao redor. Argumentos são left, right, e none (padrão). Os valores true/false antigos são obsoletos e padrão para o right/none, respectivamente. Observe que isso só ajuda se você estiver usando uma fonte mono, como o Bitstream Vera Sans Mono.
use_xft
Usar fontes padrão XFT fonte e material anti-alias). Se ficou curioso, dê uma olhada:
https://keithp.com/~keithp/render/Xft.tutorial
xftalpha
Alfa para fonte Xft. Deve ser um valor em ou entre 1 e 0.