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