PNG para XLSX - Conversor de Imagens para Excel

Um conversor que extrai texto de imagens usando OCR (Reconhecimento Óptico de Caracteres) e salva os dados em planilhas Excel.

📋 Descrição

Este projeto foi desenvolvido para transformar texto contido em imagens (como tabelas, cotações ou listas) em planilhas Excel (.xlsx) organizadas. O programa utiliza técnicas de processamento de imagem para melhorar a precisão do OCR e é otimizado para texto em português.

🛠️ Tecnologias Utilizadas

• Python: Linguagem principal
• OpenCV: Processamento e manipulação de imagens
• Tesseract OCR: Extração de texto das imagens
• Pandas: Manipulação de dados
• OpenPyXL: Criação de arquivos Excel

🔧 Requisitos

• Python 3.6 ou superior
• Tesseract OCR instalado no sistema
  • Windows: Tesseract-OCR para Windows
  • Linux: sudo apt install tesseract-ocr
  • macOS: brew install tesseract
• Pacotes Python listados em requirements.txt

⚙️ Instalação

1. Clone este repositório:

   git clone git@github.com:Isaque-Ayupe/png-to-xsxl.git

2. Instale as dependências:

   pip install -r requirements.txt

3. Baixe automaticamente os modelos de idioma:

   python main.py --baixar-idiomas

   O programa baixará automaticamente os modelos de idioma necessários (português e inglês).

📂 Estrutura do Projeto

png-to-xlsx/
│
├── main.py          # Script principal
├── requirements.txt # Dependências do projeto
├── README.md        # Documentação
│
├── src/             # Código fonte modularizado
│   ├── config/      # Configurações do projeto
│   │   ├── __init__.py
│   │   └── settings.py    # Constantes e configurações
│   │
│   ├── utils/       # Utilitários do projeto
│   │   ├── __init__.py
│   │   ├── cli.py                # Interface de linha de comando
│   │   ├── image_processor.py    # Processamento de imagens
│   │   └── language_manager.py   # Gerenciador de idiomas
│   │
│   └── __init__.py
│
├── tessdata/        # Diretório para modelos de idioma do Tesseract
│   ├── por.traineddata  # Modelo português
│   ├── eng.traineddata  # Modelo inglês
│   └── osd.traineddata  # Modelo de orientação e detecção de script
│
└── data/            # Diretório para imagens de entrada
    └── png/         # Subdiretório alternativo para imagens

🚀 Como Usar

1. Coloque suas imagens na pasta data/ ou data/png/

   • Formatos suportados: JPG, JPEG, PNG, BMP, TIFF

2. Execute o script principal:

   python main.py

   Por padrão, o programa usa o idioma português (por).

3. Os arquivos Excel serão gerados na pasta raiz do projeto, com nomes correspondentes aos arquivos de imagem originais.

Opções Avançadas

O programa suporta vários argumentos de linha de comando:

• Escolher idioma específico:

  python main.py --idioma eng  # Usa inglês para OCR
  python main.py --idioma por  # Usa português para OCR (padrão)

• Baixar modelos de idioma:

  python main.py --baixar-idiomas  # Baixa os modelos se não existirem
  python main.py --forcar-download  # Força o download mesmo se já existirem

✨ Características

• Processamento de múltiplas imagens em lote
• Conversão automática para escala de cinza e binarização para melhorar resultados
• Suporte para diferentes formatos de imagem
• Tratamento de erros robusto
• Feedback detalhado do processo de conversão
• Download automático de modelos de idioma
• Compatibilidade com diferentes sistemas operacionais
• Estrutura de código modularizada e reutilizável

📝 Notas

• A qualidade do OCR depende muito da qualidade da imagem original
• Para melhores resultados, use imagens com texto claro e com bom contraste
• O programa usa o português como idioma padrão
• Os modelos de idioma são baixados automaticamente na primeira execução ou quando solicitado

🤝 Contribuições

Contribuições são bem-vindas!

• Isaque Ayupe