Conky: Manual traduzido pt-BR

Este artigo possui o manual completo e traduzido do monitor de sistema para X, Conky. Decidi fazer esta tradução em razão do fato de não dominar muito bem a língua inglesa. Então, havia um grande abismo em meio a meu aprendizado em relação a esta brilhante ferramenta. Utilizei de algumas ferramentas on-line para me ajudar nesta tarefa, fazendo as adaptações necessárias para tornar o documento o mais coerente e simples possível. A principal função deste artigo é servir como um guia de consulta, referente ao que cada objeto, variável ou opção do conky faz.

[ Hits: 9.677 ]

Por: User not found em 12/05/2018


Definições de configuração



Estas configurações devem ser declaradas na primeira parte de seu arquivo de configuração, acima da sessão "TEXT", que você conhecerá adiante.
Linux: Conky: Manual traduzido pt-BR
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.

Página anterior     Próxima página

Páginas do artigo
   1. Introdução
   2. Linha de comando
   3. Definições de configuração
   4. Objetos/Variáveis
   5. Objetos/Variáveis (parte 2)
   6. API Lua
   7. Exemplos {...}
Outros artigos deste autor

Qual distro escolher

Introdução ao Ubuntu - Instalação de programas e outras dicas

Leitura recomendada

Analogia: X-Window como um sistema operacional

Entendento o comando chmod

5 coisas que todo aluno de Sistemas de Informação deveria saber (e fazer)...

Storj - Armazenamento na Nuvem utilizando a tecnologia Blockchain

Ícones no Fluxbox, Openbox e Blackbox

  
Comentários
[1] Comentário enviado por fabio em 12/05/2018 - 15:35h

Parabéns pelo trabalho! Imagino a encrenca que foi fazer uma tradução desse tamanho.

[2] Comentário enviado por correalinux em 13/05/2018 - 18:14h


[1] Comentário enviado por fabio em 12/05/2018 - 15:35h

Parabéns pelo trabalho! Imagino a encrenca que foi fazer uma tradução desse tamanho.

Valeu Fábio,
Eu queria porque queria aprender a configurar o Conky, uma forma que encontrei de fazer isso foi traduzindo o manual, e ir treinando.
Foi algo que demorou bastante tempo, mas acho que não foi em vão.

[3] Comentário enviado por wadilson em 14/05/2018 - 10:46h

Muito bom!

Marcadíssimo nos Favoritos.


Contribuir com comentário