OpenChatNav 0.5.3

hiten mitsurugi


  1. O que é o OpenChatNav?
  2. Quais são as vantagens?
  3. Novidades desta versão
  4. Requisitos do computador
  5. Como instalar?
  6. Como usar?
  7. Configurações
  8. E se der problema?
  9. Como o OpenChatNav é feito?
  10. Existe uma licença, termos de uso ou coisa do tipo?
  11. Arquivo de configuração: atualização da versão 0.5.2 pra 0.5.3


1. O que é o OpenChatNav?

O OpenChatNav é um programa que serve pra usar o bate-papo do Terra [http://terra.com.br/chat] sem as inconveniências da interface HTML. O programa agiliza o processo de login, envio de mensagem, escolha de carinhas, escolha de destinatário, etc.

O endereço na internet do OpenChatNav é [http://codigolivre.org.br/projects/openchatnav].

2. Quais são as vantagens?

Pra quem gosta de conversar bastante no chat, mas prefere a simplicidade dos chats web (que usam o navegador), o OpenChatNav pode solucionar várias inconveniências que existem em usar um navegador:

  1. No OpenChatNav, a lista de salas é mais acessível (apesar da aparência bagunçada da tela inicial, :-) ), sem a necessidade de clicar em vários links.

    Por exemplo, na página do Terra, é necessário carregar 4 páginas até poder entrar na sala de Santa Maria (RS): "página inicial" -> "cidades" -> "cidades S" -> "cidades Sa", e então escolher Santa Maria.

    Como funciona no OpenChatNav: assim que você abre o programa, você já vê uma lista com o item "Cidades S - Sabará a Santo Augusto". Selecione esse item e clique em "Listar salas". Pronto! Santa Maria já está listada no painel à direita (use a barra de rolagem, se precisar).

    Outra vantagem é que o OpenChatNav não carrega imagens desnecessárias. Somente as informações importantes são extraídas das páginas.

  2. É mais rápido tentar novamente caso a sala esteja cheia (ou caso você erre o código), porque o código numérico de acesso só é atualizado quando realmente necessário.

  3. Durante o chat, a lista de usuários fica sempre aberta, à esquerda. Isso facilita selecionar o destino das suas falas.

  4. O controle do programa pelo teclado (usando atalhos e as teclas TAB e SHIFT+TAB) possibilita conversar no chat usando o mouse em apenas poucos casos.

3. Novidades desta versão

A versão 0.5.0 tem as seguintes novidades:

  1. Novas carinhas adicionadas.

  2. Figuras extras.

  3. Tanto as figuras quanto as carinhas são escolhidas através de uma janelinha.

  4. Novas ações (verbos): "recebe apenas de", "voltar papo normal", "ver recados para mim".

  5. Os grupos de salas agora são salvos no arquivo de configuração (talvez não muito útil, mas é que eu não gostava de ter aqueles endereços fixos dentro do programa).

  6. Dicas aparecem quando o mouse pára sobre componentes na tela inicial (tirei aquele "Copie aqui o código ao lado" que aparecia dentro da caixa de texto, porque o usuário sempre precisava apagá-lo antes de digitar).

  7. Correção no acesso Cultura - Yu Yu Hakusho.

  8. Correção na exibição da imagem com código numérico.

  9. Configurações adicionadas: Porta do servidor proxy e tempo de timeout.

  10. Figuras animadas.

  11. As figuras vêm dentro de um módulo do programa e não como arquivos separados.

A versão 0.5.1 corrige um problema no login da versão 0.5.0. A versão 0.5.2 trata o problema do login também quando o usuário erra o código. A versão 0.5.3 só altera o arquivo de configuração, corrigindo o erro ao buscar lista de salas. Se você já tem a versão 0.5.2, não precisa atualizar o programa inteiro, veja a última seção desta página.

4. Requisitos do computador

Processador: Testei uma vez com um Pentium 75MHz (lá de 1995 ou 1996...) e funcionou bem devagar, mas funcionou!!

Memória: Acho que uns 32 MB ou 64 MB devem ser suficientes (Se você está curisoso, o P75 que citei acima tem 96 MB de memória. Não testei com menos.)

Espaço em disco: Aproximadamente 8 MB depois de instalado.

Sistema operacional: Deve funcionar com qualquer versão do Windows a partir do 98. Não testei no 95. É necessário ter o Internet Explorer (mas é só o Windows 95 que não vinha com o IE mesmo...). O OpenChatNav é feito no Windows XP. (Se tirar a dependência com o IE, deve funcionar também em Linux...)

5. Como instalar?

Baixe o instalador do site [http://codigolivre.org.br/projects/openchatnav].

Se tiver alguma versão anterior, é recomendável desinstalá-la primeiro, ou instalar a versão nova numa pasta diferente.

Execute o instalador (InstalarOpenChatNav.exe). Responda as perguntas do instalador (ou clique em "Avançar >" até o fim :-) ) e pronto! O instalador criará atalhos no menu iniciar (em versões do Windows com suporte a vários usuários, os atalhos estarão disponíveis pra todos os usuários se você for administrador). Use esses atalhos criados no Menu Iniciar pra executar o OpenChatNav ou pra desinstalá-lo. A desinstalação também pode ser feita através do Painel de Controle.

O OpenChatNav não usa chaves no registro do Windows nem copia arquivos a nenhum diretório do sistema. O instalador, por sua vez, precisa criar o item de desinstalação no painel controle, por isso ele grava no registro.

6. Como usar?

Bom, vou descrever a tela do programa, mostrando os passos pra entrar no chat.

6.1. Entrando na sala

À esquerda da tela, fica a Lista de grupos de salas. Selecione um grupo e clique em Listar salas (ou com o teclado: use as flechas Pra cima e Pra baixo de acordo com a necessidade, pressione Tab e depois Barra de espaço).

Agora vamos pro lado direito da tela: Digite o seu apelido no campo Nome: (Ou escolha um pré-existente. Ver seção Configurações.) Se quiser, escolha uma cor pro seu nome clicando em Cor. Escolha a sala. Se quiser, marque Entrar em outra sala de mesmo nome se a escolhida estiver cheia. Bem descritivo, né? Copie o código numérico da figura pro campo de texto (ao lado figura). Clique em Entrar na sala (ou aperte enter após digitar o código).

Se deu certo, você verá a tela de conversa. Se não der certo, aparecerá uma mensagem de erro (veja a seção Configurações pra mais detalhes sobre mensagens de erro). Se o erro for Sala cheia, basta clicar em Entrar na sala de novo, até funcionar (ou até o código expirar).

6.2. Conversando no chat

O uso do chat não é muito surpreendente pra quem já usou a interface web ou outro programa de chat. À esquerda, fica a lista de usuários. Nessa lista, você pode selecionar o destino da sua mensagem. A lista de usuários é atualizada a cada vez que você manda uma mensagem, portanto, se um usuário que a recém entrou não estiver aparecendo, apenas clique em "Enviar" sem digitar nenhuma mensagem. Isso vai atualizar a lista, sem enviar nenhuma mensagem.

Logo acima da lista de usuários, quase colado nela, fica um ComboBox com uma lista de ações ("fala com", "grita com", "ignora", etc.). É claro que o OpenChatNav permite que você escreva suas próprias mensagens nesse campo! (coisa que não dá pra fazer se estiver usando o navegador) E tem mais um detalhe: se quiser omitir o destino da mensagem, selecione o item invisível, abaixo do último nome da lista.

Você digita suas mensagens no campo de texto que está posicionado na parte inferior da tela. Pra enviar, aperte Enter ou clique em Enviar.

Quem já usou o chat antes já sabe o que significam as opções Reservado e Rolagem : "Reservado" é pra mandar uma mensagem pro destino escolhido e "Rolagem" serve pra que a janela de conversa desça à medida que novas mensagens chegam.

Ao lado dessas das opções descritas no parágrafo anterior, ficam dois botões: um pra escolher carinhas (aparecem antes das mensagens que o você escreve) e outro pra figuras (que aparecem depois das mensagens). Quando você clica num deles, abre-se uma janelinha pra escolher a carinha (ou figura). Dá pra deixar a janelinha aberta num canto, minimizá-la ou escondê-la (aperte Esc ou clique no botão de fechar a janela).

Pra sair, clique em Sair da sala, acima e à direita.

7. Configurações

Nesta versão, existem duas opções no menu Configurar: Apelidos e Mostrar erros em janelinha.

  1. Apelidos:

    Abre uma janela pra editar (primeiro botão), adicionar (segundo botão), apagar (terceiro botão, com um X vermelho; não é o X de fechar a janela!) ou mover itens (botões com flechas pra cima e pra baixo) da sua lista de nomes. Esses nomes aparecerão no ComboBox "Nome" da janela principal. Essa lista de apelidos é salva no arquivo nicks.txt quando o programa é fechado. Você pode editar esse arquivo manualmente, se quiser (Coloque um apelido por linha. Após o último apelido, pode colocar uma mudança de linha ou não.).

  2. Mostrar erros em janelinha:

    Esta é uma opção que pode ser marcada ou desmarcada. Se marcada, mensagens de erro ("Sala cheia", "Código errado") são mostradas numa janela de erros. Se desmarcada, os erros aparecem na barra de status (bem embaixo na janela do programa). Quando o programa é iniciado, ela está marcada pra evitar que mensagens de erro passem despercebidas. Se você estiver tentando entrar numa sala muito cheia, provavelmente as janelas de erro serão irritantes. Então, desmarque a opção "Mostrar erros em janelinha" pra poder tentar entrar de novo sem ter que fechar a mensagem (facilita bastante a entrada em salas cheias!).

  3. Salvamento de opções:

    Ao fechar o programa, são automaticamente salvas algumas configurações no arquivo openchatnav.cfg, como o "Mostrar erros em janelinha", a cor do apelido e as dimensões da janela. Ao contrário do arquivo "nicks.txt", o arquivo "openchatnav.cfg" não é projetado pra ser alterado pelo usuário (ex.: o formato pode mudar nas próximas versões, o programa pode apagar configurações que não entender do arquivo, etc.), mas talvez você encontre algumas coisas interessantes nele... (como, por exemplo, adicionar um grupo de salas ou corrigir um endereço)

  4. Pasta dos arquivos de configuração:

    Os arquivos openchatnav.cfg e nicks.txt (e README.txt também) são procurados pelo programa dentro da pasta atual. A pasta atual pode ser mudada clicando com o botão direito no atalho do programa (dentro do menu Iniciar), escolhendo "Propriedades" e mudando o nome da pasta no campo "Iniciar em:".

8. E se der problema?

Você pode reportar problemas no site ou por e-mail (hiten (a) users.codigolivre.org.br). Descreva exatamente o que você fez e o que aconteceu (e, dependendo do caso, inclua também o que você esperava que acontecesse!). Inclua a versão do seu sistema operacional também.

Um problema conhecido é o programa não abrir e criar um arquivo "openchatnav.exe.log". Isso geralmente é causado porque algum arquivo não foi encontrado. Você deve ter todos os arquivos do programa no mesmo diretório (E com os nomes dos arquivos em letras minúsculas! Uma vez não consegui executar meu próprio programa porque um arquivo estava com o nome "Zlib.pyd" em vez de "zlib.pyd"! Não foi rápido pra mim descobrir isso!). Esse problema deve ser mais comum em versões sem instalador. Espero que o instalador evite isso.

9. Como o OpenChatNav é feito?

O OpenChatNav é feito na linguagem Python 2.3.3 com a biblioteca wxWidgets 2.4.2.4 pra construir a interface. Uso o py2exe 0.5.0 pra gerar o arquivo ".exe" e a distribuição. O instalador é criado com o InnoSetup 4.2.1. Esta documentação (em HTML e txt) é gerada usando o txt2tags 2.0. O programa e a documentação são escritos usando o editor de textos Vim 6.3. Ainda bem que todas essas ferramentas são grátis, senão eu teria que cobrar pelo OpenChatNav!! A exibição da conversa é feita usando o Internet Explorer (pretendo retirar essa dependência do IE algum dia).

O código fonte está disponível no site também (pacote openchatnav-src). Pra rodar o programa a partir dos fontes, precisa instalar o Python e o wxPython. Se quiser alterar o código fonte, tudo bem. Gostaria que você me mandasse as alterações pra que elas sejam incluídas em novas versões, mas não precisa enviar se não quiser.

Sobre a linguagem Python: [http://python.org]

Sobre a biblioteca wxWidgets: [http://wxwidgets.org] [http://wxpython.org]

Sobre o py2exe: [http://starship.python.net/crew/theller/py2exe]

Sobre o Inno Setup: [http://jrsoftware.org]

Sobre o txt2tags: [http://txt2tags.sf.net]

Sobre o Vim: [http://www.vim.org]

10. Existe uma licença, termos de uso ou coisa do tipo?

Sim. O uso do OpenChatNav é bem livre, mas ele segue uma licença, conhecida como licença MIT. Ela está reproduzida abaixo. A idéia é a seguinte: você pode usar o OpenChatNav como quiser, mas se não gostar do programa ou se algo der errado, não me processem! :-) Mas a gente sempre pode conversar...


Copyright (c) 2005 hiten mitsurugi <hiten at users.codigolivre.org.br>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


11. Arquivo de configuração: atualização da versão 0.5.2 pra 0.5.3

Se você tem a versão 0.5.2 e está recebendo um erro ao buscar lista de salas, não precisa atualizar pra versão 0.5.3. É só abrir o arquivo openchatnav.cfg (que fica na pasta do programa, que você especifica durante a instalação; o padrão é C:\OpenChatNav\) no Bloco de Notas e trocar todas as ocorrências de http://chat6... por http://chat06.

Aqui está um exemplo de arquivo de configuração completo, pode copiá-lo para a pasta do programa se não quiser editar o seu arquivo manualmente.