📇 Conversor VCF para CSV

Bem-vindo ao Conversor VCF para CSV, uma ferramenta intuitiva e elegante desenvolvida pela Ezedy para converter arquivos vCard (.vcf) em formato CSV! 🚀

Esta aplicação desktop permite que você extraia rapidamente informações de contatos de arquivos VCF, gerando planilhas CSV limpas e organizadas com apenas alguns cliques.

✨ Características

• 🎨 Interface Moderna: Design escuro e elegante, perfeito para qualquer ambiente
• ⚡ Conversão Rápida: Processe múltiplos arquivos VCF simultaneamente
• 📊 Saída Simplificada: Extrai apenas as informações essenciais (nome e telefone celular)
• 📈 Barra de Progresso: Acompanhe o status da conversão em tempo real
• 💾 Salvamento Automático: Arquivos CSV são salvos na mesma pasta dos originais
• 🔄 Processamento em Lote: Selecione e converta vários arquivos de uma só vez

📋 O que a ferramenta extrai?

O Runus converte arquivos vCard (.vcf) em arquivos CSV contendo duas colunas:

Coluna	Origem (VCF)	Descrição
nome	Campo FN	Nome completo do contato
telefone	Campo TEL-CELL	Número de telefone celular

🚀 Instalação e Uso

Opção 1: Usar o Executável (Recomendado)

1. Baixe o executável Runus_VCF2CSV.exe da pasta dist/
2. Execute o arquivo - não é necessária instalação
3. Selecione seus arquivos VCF usando o botão roxo
4. Clique em "Converter para CSV" e pronto!

Os arquivos CSV serão gerados automaticamente na mesma pasta dos arquivos VCF originais.

Opção 2: Executar a partir do Código Fonte

Se você deseja executar o projeto a partir do código fonte, siga os passos abaixo:

Pré-requisitos

• Python 3.13 ou superior
• uv - Gerenciador de pacotes Python ultra-rápido

Instalação do uv

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Passos de Instalação

1. Clone ou baixe o repositório:

   git clone https://github.com/ezedy/vcf2csv.git
   cd vcf2csv

2. Sincronize as dependências:

   uv sync

3. Execute a aplicação:

   uv run python vcf_converter_gui.py

🔨 Compilar o Executável

Se você deseja criar seu próprio executável a partir do código fonte:

1. Certifique-se de que as dependências estão instaladas:

   uv sync

2. Execute o PyInstaller:

   uv run pyinstaller --onefile --windowed --name "Runus_VCF2CSV" --icon=NONE vcf_converter_gui.py

3. Localize o executável: O arquivo Runus_VCF2CSV.exe será gerado na pasta dist/

🛠️ Stack Tecnológica

• Interface Gráfica: PyQt6
• Processamento de Dados: Pandas
• Parser VCF: Regex customizado otimizado para vCard 3.0
• Build Tool: PyInstaller
• Gerenciador de Pacotes: uv

📖 Estrutura do Projeto

vcf2csv/
├── vcf_converter_gui.py    # Interface gráfica principal
├── vcf_parser.py            # Lógica de parsing de VCF
├── pyproject.toml           # Configuração do projeto
├── README.md                # Este arquivo
└── dist/                    # Pasta com o executável compilado
    └── Runus_VCF2CSV.exe

💡 Exemplos de Uso

Exemplo 1: Converter um único arquivo

1. Clique em "Selecionar Arquivo(s) VCF"
2. Escolha seu arquivo contatos.vcf
3. Clique em "Converter para CSV"
4. O arquivo contatos.csv será criado automaticamente

Exemplo 2: Conversão em lote

1. Clique em "Selecionar Arquivo(s) VCF"
2. Selecione múltiplos arquivos (Ctrl + clique)
3. Clique em "Converter para CSV"
4. Acompanhe o progresso na barra de conversão

🔧 Solução de Problemas

O arquivo CSV está vazio

• Verifique se o arquivo VCF contém campos FN (nome completo)
• Certifique-se de que os telefones estão marcados como tipo CELL

Caracteres especiais aparecem incorretamente

• Os arquivos CSV são salvos com encoding utf-8-sig para compatibilidade com Excel

A aplicação não abre

• Se estiver usando o executável, certifique-se de que não há antivírus bloqueando
• Tente executar como administrador (botão direito → Executar como administrador)

🗺️ Roadmap Futuro

Estamos trabalhando para adicionar mais funcionalidades:

• 📧 Suporte para extração de emails
• 🏢 Opção de incluir organização e cargo
• 🌐 Suporte para múltiplos formatos de export (Excel, JSON)
• 🔍 Filtros avançados de contatos
• 📱 Suporte para outros tipos de telefone (casa, trabalho)

Fique ligado para mais novidades!

©️ Licença e Copyright

Este software é propriedade exclusiva e confidencial da Ezedy.

Copyright © 2025 Ezedy. Todos os direitos reservados.

---

Desenvolvido com 💜 pela equipe Ezedy