Como usar o BrWeather - Parte 1

Saudações!

Começarei agora, uma série de posts que ensinarão como utilizar o BrWeather.

Serão abordados os modos de uso, as opções disponíveis, e a melhor forma de utilizá-las.

Após ter instalado e configurado o BrWeather corretamente, vamos detalhar as suas funções:

Opções Gerais

O BrWeather pode ser utilizado diretamente no terminal. Todas as opções dele funcionam tanto no terminal quanto no Conky.

Por isso, ele possui algumas opções que não fazem parte do Conky, mas que ajudam (ou não) na hora de utilizar o programa. Confira:

Retorna a versão do programa:

$ brweather --version

Changelog de versões. Muito útil para descobrir novas funções e eventuais modificações no uso do programa:

$ brweather --changelog

O autor do programa, útil se você necessita contatar o "suporte" ;)

$ brweather --autor

Opções de ajuda gerais:

$ brweather --help

Menu de ajuda para o modo padrão (INPE):

$ brweather --help-default

Menu de ajuda para o modo OPEN:

$ brweather --help-open

Menu de ajuda para o modo Híbrido:

$ brweather --help-hibrido

Lista o total de opções de imagens (maiores detalhes no decorrer do tutorial):

$ brweather --total-imagens

Limpa o cache de logs e previsões. Útil quando ocorrerem erros na exibição das previsões no Conky. Para maiores detalhes confira a página de "erros":

$ brweather --clean-cache

Gerar relatório de logs. Maiores detalhes, consulte a página de "erros", também:

$ brweather --gerar-log

Mostrar qual modo está ativo (INPE, OPEN ou Híbrido):
$ brweather --mode

Função Fases da Lua

Esta função não precisa de acesso à Internet para funcionar. Ela utiliza uma base de dados própria. Sendo que esta base é atualizada a cada versão (a versão 0.4.0-RC4, por exemplo, possui dados para até 2021).

Vou listar as opções de uso, depois explicarei como acrescentá-las no conkyrc.

Obs.: Como teste, você pode executar todas as opções abaixo no próprio terminal.

Fase atual:

brweather --option=LUA1

Exibe a fase atual da Lua no formato abreviado: Che, Min, etc.

brweather --option=LUA1T

Exibe a fase atual da Lua por extenso.

brweather --option=LUA1D

A data de hoje (no formato DD MÊS)

Para se utilizar as opções acima, basta utilizar a sintaxe no conkyrc:

${execi <segundos> brweather --option=LUA<Opção>}

Exemplo, para exibir a fase atual da Lua por extenso, use:

${execi 3600 brweather --option=LUA1T}

Exibição por ícones:

brweather --option=LUA1F

e

brweather --option=LUA1f

Estas opções exibem, em tempo real a fase atual da l=Lua. A cada dia, o ícone muda:

A diferença entre o "f" e o "F" são os ícones:

Para se utilizar esta opção, você deve ter a fonte "Moon Phases" instalada. Para adicionar no Conky, basta então utilizar a sintaxe:

${font Moon Phases:size=<tamanho>}${execi <segundos> brweather --option=LUA<opção>}

Exemplo, para exibir a opção 1F:

${font Moon Phases:size=32}${execi 3600 brweather --option=LUA1F}

Exibição por imagens:

Você também pode utilizar imagens para exibir as fases da Lua, seguindo o mesmo estilo dos ícones:

Basta utilizar a opção:

brweather --option=LUA1I

E, no conkyrc, utilizar:

${execpi <segundos> brweather --option=LUA1I -p <posição> -s <tamanho>}

Exemplo, para exibir a fase atual, na posição 10,5 do Conky e com o tamanho de 80x80:

${execpi 3600 brweather --option=LUA1I -p 10,5 -s 80x80}

Observação importante:

Para utilizar as imagens do BrWeather, deve-se sempre utilizar a opção "execpi" no conkyrc.

Isso é importante, pois ele tratará o resultado do comando como um comando do próprio Conky. Exemplo:

Se você colocar a seguinte sintaxe no conkyrc:

${execi 3600 echo "\${CPU CPU1}"}

Tudo o que vai aparecer no Conky é "${CPU CPU1}".

Agora, se você utilizar a sintaxe:

${execpi 3600 echo "\${CPU CPU1}"}

O Conky exibirá o consumo da CPU. Ou seja, ele tratará o resultado do

comando "echo" como uma opção do Conky (${CPU CPU1}).

Outras fases da Lua:

Agora vamos às demais fases da Lua.

Todas as opções abaixo são iguais às utilizadas para a fase atual:

brweather --option=LUA2

brweather --option=LUA3

brweather --option=LUA4

Exibe as próximas fases da Lua, no formato abreviado.

brweather --option=LUA2T
brweather --option=LUA3T
brweather --option=LUA4T

Exibe as próximas fases da Lua por extenso.

brweather --option=LUA2D
brweather --option=LUA3D
brweather --option=LUA4D

As datas de quando ocorrerão as próximas mudanças de fase.

Para se utilizar as opções acima, basta utilizar a sintaxe no conkyrc:

${execi <segundos> brweather --option=LUA<Opção>}

Exemplo, para exibir a data da próxima mudança de fase, use:

${execi 3600 brweather --option=LUA2D}

Exibição por ícones:

As opções abaixo exibem os ícones das próximas fases da Lua. Ao contrário da fase atual, eles não são atualizados diariamente, apenas quando ocorre a passagem de fase.

brweather --option=LUA2F

brweather --option=LUA2f

brweather --option=LUA3F

brweather --option=LUA3f

brweather --option=LUA4F
brweather --option=LUA4f

Deve-se lembrar, que estas opções só funcionam com a fonte "Moon Phases" instalada.

Para utilizar esta opção no conkyrc, basta utilizar a sintaxe:

${font Moon Phases:size=<tamanho>}${execi <segundos> brweather --option=LUA<opção>}

Por exemplo, para mostrar o ícone da próxima fase da Lua:

${font Moon Phases:size=35}${execi 3600 brweather --option=LUA2F}

Exibição por imagens:



O mesmo caso da fase atual, basta utilizar as opções:

brweather --option=LUA2I

brweather --option=LUA3I

brweather --option=LUA4I

Lembre-se de utilizar a sintaxe "execpi" no conkyrc:

${execpi <segundos> brweather --option=LUA<opção> -p <posição> -s <tamanho>}

Exemplo, para exibir a próxima fase da Lua, na posição 5,15 do Conky e com o tamanho de 40x40:

${execpi 3600 brweather --option=LUA2I -p 5,15 -s 40x40}

Com isso terminamos as opções da função Fases da Lua, e esta primeira parte do tutorial.


Continua em: Como usar o BrWeather - Parte 2