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.
Parte 3: 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.
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:
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 janelaminimum_width width
Largura mínima da janelampd_host
Host do servidor MPDmpd_password
Senha do servidor MPDmpd_port
Porta do servidor MPDmysql_host
Host do servidor MySQL. Padrão para localhostmysql_port
Porta do servidor MySQL. Padrão para a porta mysql padrãomysql_user
Nome do usuário MySQL a ser usado ao conectar-se ao servidor. Padrão para o seu nome de usuáriomysql_password
Senha do usuário MySQL. Coloque-o entre "-chars. Quando isso não está configurado, não há senha usadamysql_db
Banco de dados MySQL para usar. Padrões para mysqlmusic_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 internetno_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)