viniciusccosta / clipbarcode

Aplicação Windows que facilita a leitura de códigos de barras e obtenção da linha digitável.

ClipBarcode

O ClipBarcode é um projeto open source que tem como objetivo oferecer praticidade na leitura de códigos de barras e obtenção da linha digitável. Com o ClipBarcode, os usuários podem capturar uma imagem de um código de barras usando um print screen e o programa realizará a leitura do código de barras, fornecendo a linha digitável pronta para copiar e colar.

Recursos Principais

O ClipBarcode oferece os seguintes recursos principais:

• Leitura de Código de Barras: Com o ClipBarcode, os usuários podem facilmente capturar códigos de barras presentes em boletos de cobrança, guias de impostos, convênios, QR Codes e Notas Fiscais. Basta utilizar o print screen para capturar a imagem e o programa realizará a leitura do código de barras automaticamente. O resultado será a linha digitável pronta para ser utilizada em pagamentos ou outras finalidades.
• Leitura da Linha Digitável: Se o código de barras estiver danificado ou for muito pequeno para ser capturado com precisão, o usuário tem a opção de fazer um print diretamente da linha digitável. O ClipBarcode será capaz de ler a imagem e extrair os dados necessários. Essa opção oferece flexibilidade em casos onde o código de barras não é legível, garantindo a obtenção da linha digitável de forma confiável.

Com esses recursos, o ClipBarcode simplifica o processo de leitura de códigos de barras e linha digitável, permitindo que os usuários realizem pagamentos e preenchimento de dados com facilidade e agilidade.

Instalação

Para instalar o ClipBarcode, siga as etapas abaixo:

1. Baixe o arquivo de Instalação: clipbarcode_v2.0.2_win64.exe
2. Execute o instalador como Administrador e siga as instruções fornecidas.
3. Caso o Tesseract na versão 5.2.0 e/ou o Microsoft Visual C++ na versão 12.0.40664 não estejam instalados em seu sistema, os instaladores correspondentes serão abertos automaticamente durante o processo de instalação do ClipBarcode.

   • Durante a instalação do Tesseract, certifique-se de selecionar "Portuguese" dentre as opções de "Additional language data (download)":

     
     

Como Usar

1. Capture uma imagem do código de barras ou da linha digitável:
   • Utilize o comando Windows + Shift + S para selecionar apenas a área desejada da tela.
   • Se preferir, configure a tecla PrintScreen para capturar a tela.
     • No Windows 11, acesse Configurações > Acessibilidade > Teclado > Usar o botão PrintScreen para abrir a captura de tela.
   • Verifique se o print contém apenas um código de barras.
   • Ajuste o zoom para obter o código de barras no maior tamanho possível.
2. Abra o ClipBarcode.
   • Execute o programa ClipBarcode no seu computador.
3. Realize a leitura da imagem:
   • A leitura da imagem será realizada automaticamente assim que o ClipBarcode for aberto.
   • Caso o programa já esteja aberto, clique no botão "Ler Print" para iniciar a leitura da imagem capturada.
4. Aguarde o processamento e a leitura do código de barras:
   • Aguarde alguns instantes enquanto o ClipBarcode processa a imagem e realiza a leitura do código de barras.
5. Visualize a linha digitável:
   • O ClipBarcode exibirá a linha digitável obtida na interface do programa.
   • Copie e cole a linha digitável conforme necessário para realizar pagamentos ou outras finalidades.
6. Navegue entre os registros:
   • Utilize as setas do teclado (cima e baixo) para transitar entre os registros salvos na lista de leituras.
7. Exclua um registro:
   • Utilize a tecla "Delete" para remover um registro específico da lista de leituras.

Instruções Adicionais

Aqui estão algumas informações adicionais sobre o ClipBarcode:

• Histórico de Leituras: O programa salvará todas as capturas de tela localmente no seu computador e fornecerá um histórico para acessar suas leituras anteriores. Isso permite que você tenha acesso fácil às suas capturas anteriores de uma forma conveniente.
• Contorno Vermelho: Um contorno vermelho será adicionado ao redor do código de barras lido, facilitando a identificação visual da captura correta da imagem fornecida pelo usuário.
• Tipo de Leitura: O programa exibirá na tela o tipo de leitura realizada, identificando se é um QR Code, Boleto, Nota Fiscal ou simplesmente Texto. Isso oferece uma visão clara do tipo de dado que foi extraído da imagem.
• Campo de Descrição: O programa oferece um campo de texto livre para adicionar uma descrição personalizada a cada leitura, facilitando a identificação dos registros.

Temas

O ClipBarcode tem suporte aos seguintes temas:

• Cosmo
• Darkly
• Journal
• Sandstorm
• Superhero
• Vapor
• Yeti

Troubleshooting

Se você encontrar algum problema ao utilizar o ClipBarcode, aqui estão algumas soluções comuns para ajudar a resolver possíveis dificuldades:

• Não realizou a leitura do código de barras: Caso o programa não consiga ler o código de barras corretamente, tente aumentar o zoom na imagem antes de capturá-la. Ampliar o tamanho do código de barras na imagem pode melhorar a precisão da leitura.

Desenvolvimento

Para gerar uma nova release é necessário ter o instalador do tesseract e do MVS na pasta "compiler"

• Tesseract 5.2.0 (12/07/2022):

  1. GitHub
  2. Site para Download
  3. Link para Download x64

• Microsoft Visual C++ 12.0.40664:

  1. GitHub
  2. Site para Download
  3. Link para Download x64 (EN-US)
  4. Link para Download x64 (PT-BR)

Contribuição

O ClipBarcode é um projeto open source e recebe contribuições da comunidade. Caso você queira contribuir, siga os passos abaixo:

• Faça um fork do repositório do ClipBarcode.
• Implemente as alterações desejadas ou corrija bugs.
• Faça um pull request para enviar suas alterações.
• Aguarde a análise e a revisão da sua contribuição pela equipe responsável.

Licença

O ClipBarcode é distribuído sob a licença MIT. Para mais detalhes, consulte o arquivo LICENSE.

clipbarcode's Issues

Erro na leitura de código de barras

Exemplo 1:

• Linha digitável: 033990067.2 9371010098.8 6849070101.5 6 93930000015898
• Código lido: 03396939300000158989006793710100986849070101
• Código convertido: 03399006729371010098868490701015693930000015897

Exemplo 2:

• Linha digitável: 033990067.2 9371010098.8 6840060101.6 1 93900000015898
• Código lido: 03391939000000158989006793710100986840060101
• Código convertido: 03399006729371010098868400601016193900000015897

Verificação de novas versões

Testes unitários

Os testes unitários abrangentes ajudarão a validar cada componente e a detectar possíveis problemas precocemente.

Erro ao rodar o PyInstaller com app.spec

Unable to find "...clipbarcode\venv\Lib\site-packages\pyzbar\libiconv.dll" when adding binary and data files."

Problema de Atualização Automática

Descrição do Problema:

Não é possível realizar a atualização automática do software, pois o instalador tenta fechar o programa, mas não consegue.
Isso pode estar ocorrendo porque o instalador é chamado pelo próprio programa.

Detalhes Adicionais:

• Sistema Operacional: Windows 11 Versão 22H2 (Compilação 22621.2283)
• Versão do Software: v2.0.1

Utilização de Tkinter Bootstrap

Inclusão do Tkinter Bootstrap ou, pelo menos, ttk widgets no projeto.

A adição do Tkinter Bootstrap ou o uso dos ttk widgets nativos do Tkinter traria melhorias significativas à interface gráfica do aplicativo. Essas opções oferecem estilos e temas pré-definidos que resultam em uma aparência mais moderna e agradável para os usuários.

Leitura automática (programa rodando)

Uma maneira de aprimorar o programa seria implementar a funcionalidade de leitura automática sempre que um novo print fosse tirado. Isso eliminaria a necessidade do usuário pressionar repetidamente o botão "Ler Print" e tornaria o processo mais conveniente e simplificado.

Falso Código Inválido

Linha Digitável: 03399.00672 93710.100970 64014.701011 8 93830000015898
Código de Barras: 03398938300000158989006793710100976401470101

Está informando "Código de Barras Inválido", mas não é o caso.

Descrição, TAGs ou Título

Fornecer a opção de dá um título ou inserir TAGs para cada leitura

Leitura automática de prints para o Clipboard

Seria útil disponibilizar uma opção para ativar ou desativar a leitura automática de prints para o Clipboard, permitindo que o usuário tenha controle sobre essa funcionalidade. Quando ativado, os dados convertidos seriam enviados automaticamente para o Clipboard (Ctrl + V) assim que o print fosse lido, agilizando o processo de transferência de informações.

Verificação de novas versões não funciona

Descrição do Problema:

Após a atualização para a versão 2.0.0, a funcionalidade de verificação automática de novas versões deixou de funcionar corretamente. Os usuários não estão mais recebendo notificações sobre atualizações disponíveis, o que pode resultar em perda de melhorias importantes e correções de bugs.

Modo Dark

Inclusão do modo dark na aplicação, a fim de aprimorar a experiência dos usuários em ambientes com pouca iluminação e evitar fadiga visual causada pelo uso prolongado. A implementação desse recurso oferecerá uma opção de visualização mais confortável, contribuindo para a usabilidade e satisfação dos usuários.

Junção dos campos "Código Lido" e "Código Convertido"

Acredito que fique muito confuso para os usuários.
Poderia ter apenas 1 campo, caso seja lido um código de barras, automaticamente converte e insere no campo único.
Se não for um código de barras, apenas insere nesse campo único.
Para eventuais conferências, poderia ter um botão adicional que mostrasse o código lido vs código convertido aos ser pressionado.

Verificação de duplicidade ao ler prints na área de transferência

Atualmente, no programa, o usuário tem a possibilidade de clicar várias vezes no botão "Ler Print" mesmo com a mesma imagem na área de transferência. Isso resulta em uma duplicidade indesejada na leitura dos prints.

Para melhorar a experiência do usuário e evitar a repetição desnecessária da mesma imagem, seria interessante implementar uma verificação no programa para identificar se o print atual é igual ao último print lido. Dessa forma, caso haja duplicidade, o programa poderá evitar a leitura repetida da imagem e notificar o usuário sobre a situação.

Timeout do requests

Se o usuário está sem acesso à internet ou enfrenta problemas de conexão, o request não está respeitando o tempo limite estabelecido, resultando em um atraso de no mínimo 10 segundos para a inicialização/aparecimento do programa ao usuário.

Remover .exe do último commit

Utilizar um gerenciador de dependências

Sugestão: Poetry

Alerta de código de barras duplicado

Para evitar pagamentos duplicados de boletos, seria benéfico implementar um recurso no programa que possa alertar o usuário caso o código de barras já tenha sido lido anteriormente.

Atualmente, o programa permite a leitura de códigos de barras de boletos, porém não há uma verificação automática para identificar duplicidades. Com a inclusão desse recurso, o programa poderia comparar o código de barras atual com os códigos previamente lidos e exibir um aviso ao usuário, caso seja encontrado um código de barras duplicado.

Organizando módulos com o pacote 'clipbarcode'

Seria mais apropriado criar um pacote denominado "clipbarcode" para organizar os módulos, em vez de deixá-los soltos na raiz.