segunda-feira, 4 de junho de 2012

Configuração do BrWeather

Saudações!
Aqui veremos um passo a passo de como configurar o BrWeather.


Após ter instalado o BrWeather, é preciso configurá-lo. Para isso, você deve, primeiro, obter o arquivo "brweather.conf", há quatro formas fáceis de configurá-lo. Basta escolher uma delas e seguir.



1- A mais fácil de todas. Basta iniciar o BrWeather no terminal (como usuário normal), que ele criará a pasta na /home e o arquivo de configuração. Você pode utilizar qualquer opção para isso, ou executá-lo sem nenhuma opção:

$ brweather

2- Se você instalou o arquivo tar.gz, ele vem com um arquivo "brweather.conf" na pasta de instalação. Basta abri-lo, configurar e salvar na sua /home com o nome de ".brweather.conf" (atenção para o "." ponto antes do nome, ele é um arquivo oculto).

3- Abrir um editor de texto, copiar o conteúdo abaixo e salvar na sua pasta pessoal com no nome de ".brweather.conf":
# Arquivo de configuração do BrWeather
# Autor: LeandroNKZ
# Acesse o site para maiores instruções:
# http://brweatherproject.blogspot.com/

# Agora você pode escolher quais serviços de meteorologia utilizar no BrWeather: O nacional INPE ou o internacional Open Weather.
# Recomenda-se que utilize os serviços do Open Weather, apenas se o serviço nacional não funcionar. Como no caso de você residir no exterior,
# ou, no caso de o INPE não fornecer os dados completos para a usa cidade (como as condições atuais).
# Nota: Por questões de compatibilidade e confiabilidade de informações, só é possível utilizar um tipo de serviço ao mesmo tempo.


# No campo abaixo você ativa/desativa o modo Open Weather.
# Escolha:
# "0" = ATIVAR o serviço Nacinal INPE.
# "1" = DESATIVAR o INPE e utilizar APENAS o serviço internacional Open Weather.
# "2" = ATIVAR o modo Híbrido. Mais informações aqui:
# http://brweatherproject.blogspot.com/2012/06/configuracao-do-brweather.html
OPEN="0"

# Escolha o tempo de espera (em segundos) para a conexão.
# Isso é útil para diminuir o tempo de resposta do programa.
# Para conexões rápidas (banda larga), é recomendável deixar entre 5~10.
# Já para conexões lentas, deixe entre 15~20 segundos.
TIME="10"

# Especifique o intervalo de funcionamento (em segundos) do programa.
# O BrWeather só atualizará as previsões quando este invervalo for alcançado.
# Como os sites que o BrWeather busca os dados costumam atualizar as previsões
# a cada hora, um tempo entre 1800 (30min) e 3600 (1H) já está de bom tamanho.
# Um invervalo menor do que 30min não é recomendado, uma vez que o BrWeather baixaria apenas
# as mesmas previsões.
TIMER="3600"


# Especifique a codificação de caracteres.
# Na dúvida, deixe o padrão (UTF-8).
# Altere apenas se ocorrer problemas com os acentos das palavras.
CODIGO="UTF-8"

### Serviço Nacional ###
# Para exibir informações mais precisas e, contar com várias opções, 
# o BrWeather utiliza o serviço de meteorologia do CPTEC/INPE (Instituto Nacional de Pesquisas Espaciais).
# Nota: Preencha o campo abaixo, apenas se estiver utilizando o serviço nacional.
# Se estiver utilizando apenas o Open Weather pule para o campo "Serviço Internacional".
# Se estiver utilizando o modo Híbrido, este campo é obrigatório

# CPTEC/INPE
# Acesse o site:
# http://www.cptec.inpe.br/cidades/
# Digite apenas as primeiras letras de sua cidade e clique em "OK".
# Ex.: guaru , são, rio, maca, floria, etc..
# Nota: Deve-se colocar apenas as primeiras letras do nome da sua cidade. 
# Do contrário, se você colocar o nome inteiro, a tela exibirá diretamente as previsões,
# porém, sem o código numérico (necessário para o funcionamento do programa).
# Ao clicar em ok, aparecerá uma lista de cidades que começa com as letras especificadas.
# Selecione e clique em sua cidade.
# Na barra de URL, constará um código numérico.
# Ex.: http://www.cptec.inpe.br/cidades/tempo/4901
# Anote o número e coloque no campo abaixo, no lugar de "2247".
CPTEC_INPE="2247"


### Observação importante: ###
# Se a sua cidade constar no site do INPE, mas não possuir a previsão completa (com dados como condições atuais, temperatura atual, nível de umidade atual, etc), você deve utilizar o BrWeather no modo Open.


### Serviço Internacional ###
# Importante: Não é necessário preencher estes campos se você utiliza somente o serviço nacional
# Se utiliza o modo Híbrido, este campo é obrigatório
# Acesse o site: http://openweathermap.org
# Procure pela sua cidade no mapa, e clique no ícone de previsão da mesma
# Assim que abrir a página com a previsão completa, veja que na barra de URL constará um código númérico.
# Ex.: http://openweathermap.org/city/3461786
# Anote o número e adicione no campo abaixo, no lugar de "3461786".
OPEN_ID="3461786"




4- Simplesmente copiar o arquivo de configuração default para a sua pasta pessoal. Para isso, é só rodar o comando abaixo como usuário normal:

$ cp /opt/brweather/doc/brweather.conf.default ~/.brweather.conf

Depois criado o seu arquivo de configuração, basta abri-lo com um editor de textos e configurar seguindo as instruções.


Modos de uso


MODO  INPE  -  O  modo  padrão  de  uso do programa. Ele é destinado às cidades que possuem previsão completa no  site  do  INPE  (vide  sessão INFORMAÇÕES,  no  final deste manual).  Utilize a opção 0 no arquivo de configuração:

OPEN="0"

E preencha o campo correspondente com o código de sua cidade:

CPTEC_INPE="código_do_inpe"

MODO OPEN - O modo alternativo. Ele utiliza  os  dados  do  OpenWeather (vide  sessão  INFORMAÇÕES)  para  exibir  a  previsão.  É destinado às cidades que não constam no site do INPE, ou que constam, mas  não  pos‐ suem  a previsão completa (com condições atuais, como Sensação térmica, temperatura atual, umidade relativa atual etc).  Utilize a opção  1  no arquivo de configuração:

OPEN="1"

E preencha o campo correspondente com o código de sua cidade:

OPEN_ID="código_do_open"


MODO  HÍBRIDO  -  O  modo híbrido. Ele mescla os dados dos modos INPE e OPEN. É destinado àquelas cidades que constam no site do  INPE,  porém, não  possuem a previsão completa (com dados de condições atuais).  Utilize a opção 2 no arquivo de configuração:

OPEN="2"

E preencha os campos dos dois modos:

CPTEC_INPE="código_do_inpe"

OPEN_ID="código_do_open"


Configurações avançadas

A partir desta versão estão disponíveis algumas configurações avançadas. Elas só devem ser editadas por quem já possui alguma experiência com edições de arquivos e/ou terminal.

Para ter acesso a estas opções, basta abrir o arquivo executável principal: brweather.

Logo no começo do arquivo, há as opções:

#!/bin/bash
# BrWeather
# Criado por LeandroNKZ 
# Se encontrar BUGs, ou erros no programa, favor reportar ao desenvolvedor
# Acesse o site para maiores instruções:
# http://brweatherproject.blogspot.com/
# Distribuído sob licença GPLv3

################################################################

##Opções avançadas (Edite apenas se estritamente necessário)

##Diretório base (evite atalhos como ~/ ou $HOME, use caminhos completos:/home/seu_usuario/brweather):
##Créditos a rhatto pela implementação
DIRNAME="/opt/brweather" #Diretório de instalação padrão

##Timer para apagar arquivos de logs:
TIME_COUNT="10800" #A cada três horas, verificar e apagar logs antigos

##Permitir execução pelo usuário root (1=sim ; 0=não):
ROOT="0"

################################################################

Onde:

DIRNAME - É possível alterar a pasta padrão do BrWeather (o padrão é /opt). Para alterar, por exemplo, para a pasta /usr/local/share, basta modificar esta linha para:

DIRNAME="/usr/local/share/brweather"

Outro exemplo, para a pasta /home/seu_usuário/scripts:

DIRNAME="/home/seu_usuário/scripts/brweather"

Sendo que, o "brweather" é a pasta inteira do programa.

Este recurso foi criado originalmente pelo usuário rhatto, que me enviou as modificações. Eu apenas modifiquei levemente para deixar como uma opção alternativa aos outros usuários.

TIME_COUNT - É o tempo de vida dos logs de erros. O padrão é 10800 (3 horas). Ou seja, se em três horas o erro não se repetir, o BrWeather entende que era uma falha passageira do fornecedor de dados e apaga o arquivo.

Se você quiser um maior controle das mensagens, altere este valor. Lembrando que deve-se colocar o valor em segundos.

ROOT
- Por padrão, o BrWeather não pode ser executado com poderes de superusuário (root). Isso evita a criação desnecessária de pastas de configuração no diretório do administrador.

Além disso, se você configura o BrWeather como root, mas executa o Conky (que "chama" o BrWeather) como usuário normal, as suas configurações não surtirão efeito.

Mas, se você precisa mesmo usar o BrWeather como root (no caso de você só possuir ele de usuário no sistema), altere este campo para "1":

ROOT="1"

Sendo assim, deve-se sempre seguir a regra:
  •     BrWeather como usuário normal = Conky como usuário normal
  •     BrWeather como root = Conky como root

18 comentários:

  1. Olá Leandro.
    Primeiro quero parabénliza-lo pelo projeto.
    Fiz todo processo,porém nada apareceu na areá de trabalho. É necessário alguma configuração adicional?

    ResponderExcluir
    Respostas
    1. Olá, Leandro.

      Se você seguiu esta página corretamente, a configuração está pronta. Ou seja, o programa está pronto para uso.

      Agora, você só precisa criar uma configuração do Conky (arquivo "conkyrc") utilizando alguma das sintaxes do BrWeather: http://brweatherproject.blogspot.com.br/2012/07/como-usar-o-brweather-parte-1.html

      Se você não está familiarizado com o Conky, basta utilizar um dos "Conkys-brinde":

      http://brweatherproject.blogspot.com.br/p/conkys.html

      Mais informações sobre o uso do Conky, nos links:

      http://ubuntued.info/conky-o-gestor-de-sistema-para-a-area-de-trabalho
      http://www.vivaolinux.com.br/artigo/Monitore-o-seu-Linux-com-o-Conky

      Qualquer dúvida é só falar.
      Abraço!

      Excluir
  2. Se eu quiser mostrar o clima de duas cidades no meu desktop? Como faço?
    Se eu tiver que executar duas instâncias do BrWeather, como as referencio no arquivo de configuração do Conky?

    ResponderExcluir
    Respostas
    1. Infelizmente, isso ainda não é possível. Só há uma instância do BrWeather para cada usuário.

      Isso porque, só é criada uma pasta de configuração (que está localizada no diretório do usuário). Uma solução é você alterar os executáveis do BrWeather, setando uma outra pasta de configuração. E, ao usar, executar os dois:

      Cidade 1 - Com a pasta de configuração padrão em ~/.brweather:

      $ brweather --option=city

      Cidade 2 - BrWeather modificado, com a pasta de configuração em ~/.brweather2:

      $ /caminho_para_o_executavel_modificado/brweather --option=city

      Vou testar esta solução. Se der certo, eu lhe passo um patch com as alterações.

      Abraço.

      Excluir
  3. Patch aqui: http://dl.dropboxusercontent.com/u/67723624/brweather-0.6.0_patch.diff

    Para usá-lo, basta baixar um novo brweather-0.6.0, descompactar, copiar o patch para dentro da pasta criada e aplicá-lo com o comando (como usuário normal e dentro da pasta descompactada):

    patch -p1 < brweather-0.6.0_patch.diff

    Depois, altere no executável principal modificado, as opções avançadas:

    - DIRNAME (Explicado no post acima);
    - CONFIG_DIR - Nova pasta de configuração. O padrão é criar uma pasta oculta dentro da home do seu usuário.
    - CONFIG_FILE - Novo arquivo de configuração. Deixei como um arquivo oculto na sua home, mas você pode alterá-lo aqui.

    Agora, para finalizar, edite os arquivos de configuração brweather.conf e brweather.conf2 a seu gosto e execute:

    BrWeather em instalação padrão (cidade 1):

    $ brweather --option=city

    BrWeather modificado (cidade 2):

    $ caminho_para_o_executável/brweather --option=city

    Veja se funciona.
    Abraço.


    ResponderExcluir
  4. Baixei a versão 0.6, o pacote de imagens e o Conky HTC do Brweather. Não funcionou. E aí, o que faço?

    ResponderExcluir
  5. Boa noite!

    Assim de bate-pronto fica meio difícil de te ajudar. Tente passar mais informações:

    - Qual pacote do BrWeather você baixou? O .deb ou o tar.gz?
    - Como você instalou o BrWeather?
    - O erro foi durante a instalação ou ele instala mas não funciona?

    Abraço.

    ResponderExcluir
  6. Baixei versão 0.6, instalei os ícones (temas), o conky HTC, instalei mas nada aconteceu. Já possuoo conkys funcionando. Queria testar o BRWeather em detrimento do Conky Forecast. Como faço para ele funcionar?

    ResponderExcluir
    Respostas
    1. Hum, tente postar o resultado dos comandos abaixo:

      brweather --mode
      brweather --option=city
      brweather --imagem10=CN

      O primeiro vai retornar em qual modo o BrWeather está operando, o segundo, a sua cidade e o terceiro comando, vai retornar uma imagem.

      Estes comandos devem ser executados sem erros. Se aparecer erros, pode estar havendo algum problema na execução do BrWeather.

      Abraço.

      Excluir
  7. Leandro, fiz como vc disse e aqui estão os resultados porém continua sem funcionar. Meus outros conkys funcionam normal:
    brweather --mode
    Criando arquivo de configuração ~/.brweather.conf
    O modo INPE está ativado.

    brweather --option=city
    Guarulhos-SP

    brweather --imagem10=CN
    ${image /opt/brweather/imagens/imagem10/c.png --imagem10=CN }

    E aí, o que fazer?

    ResponderExcluir
    Respostas
    1. Bom, já descartamos uma possibilidade. O BrWeather está funcionando normal.

      Agora, vamos checar o Conky HTC:

      O comando abaixo gera algum erro?

      bash ~/.conky6_start.sh

      Obs.: ele demora 20 segundos antes de retornar alguma informação.

      Excluir
  8. Bem, testei outros conkys e todos funcionaram.

    bash ~/.conky6_start.sh

    RESULTADOS:
    Conky: forked to background, pid is 9783

    Conky: desktop window (1000095) is subwindow of root window (ae)
    Conky: window type - override
    Conky: drawing to created window (0x4200001)
    Conky: drawing to double buffer

    ResponderExcluir
  9. Leandro, não sei porque mas agora funcionou. Só estou reconfigurando os locais e dimensionando o conky exatamente para o tamanho correto das imagens. Obrigado e adeus Conky Forecast. Projeto brasileiro deve ser apoiado. Sucesso!

    ResponderExcluir
    Respostas
    1. Puxa, que bom que funcionou!

      Qualquer dúvida, tamos aí! =)

      Obrigado.

      Excluir
  10. Leandro, tem algo "engraçado" acontecendo. Agora ele não funciona novamente e voltou a dar aquela mesma mensagem.

    Conky: forked to background, pid is 29556

    Conky: desktop window (1000095) is subwindow of root window (ae)
    Conky: window type - override
    Conky: drawing to created window (0x1600001)
    Conky: drawing to double buffer

    ResponderExcluir
    Respostas
    1. O mais estranho é que não há mensagem de erro.

      Estas mensagens que você citou são normais, elas sempre aparecem quando chamamos o Conky pelo terminal.

      O mais provável é que ainda haja alguma configuração a ser corrigida no conkyrc.

      Tente fazer o seguinte: escolha um conky que esteja funcionando normal, e poste o conteúdo do arquivo conkyrc dele aqui.

      Se for muito grande, use o Pastebin: http://pastebin.com/

      Abraço.

      Excluir
  11. Oi, Leandro,
    Estou usando o Manjaro 16.06.1 com o XFCE, então fiz a instalação pelo 8.tar.gz. Movi a pasta para o /opt, copiei o .brweather.conf... mas não tenho o print do programa, nem mesmo pelo terminal, ele não apresenta mensagem de erro, mas também não tenho o resultado da opção como "$ brwaether --LUA1T", ou o "... --seasons 1"...

    Pode me ajudar?
    Obrigado.

    ResponderExcluir
    Respostas
    1. Tudo bem?
      Esse era um problema "geral", que afeta todos que possuem as versões mais recentes do comando "date".

      Eu corrigi e lancei uma versão com essa correção:
      http://brweatherproject.blogspot.com/2016/08/nova-versao-brweather-073.html

      Obrigado por relatar o problema.

      Excluir