Converts messy CSV files into clean, formatted Excel spreadsheets (.xlsx).

Blur was applied to the images below to prevent data leakage.

Before — raw CSV, no formatting:

After — processed and formatted spreadsheet:

Just run CSVInterpreter.exe — no Python or dependencies required.

1. Click Selecionar arquivo CSV and pick your file
2. Pick a theme color — all spreadsheet colors (header, footer, text) are derived automatically from your choice
3. Set how empty cells should appear in the output:
   • N/A — highlighted in red, italic grey text (default)
   • Vazio — blank cell, no formatting
   • Zero — fills with 0, no formatting
4. Click Processar e salvar and choose the output folder
5. Toggle 🔒 before processing to generate a protected (read-only) spreadsheet

The theme system derives all spreadsheet colors from a single base color:

Image columns (detected by name or file extension) are automatically moved to the rightmost position so data always comes first.

Python 3.12+ is required. Install all dependencies with:

pip install -r requirements.txt

tkinter is used for the GUI and comes built-in with Python on Windows — no install needed.

python src/app.py

Place CSV files in the data/ folder, then:

python src/main.py

Output files will be saved to the output/ folder.