Download CSV Charset Analysis Tool

Get the Python script to analyze character encodings of your CSV files locally. Your data stays on your machine - no uploads, no external processing.

Easy Mode: Double-Click Launchers

True double-click experience - downloads everything you need!

🍎

macOS

Download .command
🪟

Windows

Download .bat
🐧

Linux

Download .sh

📦 Complete Package Included:

• ✅ Web interface (charset_web_gui.py)
• ✅ Analysis engine (check_csv_charset.py)
• ✅ Double-click launcher
• ✅ Auto-dependency installation
⚠️

Security Notice

Executable files may trigger security warnings. See full disclaimer below for platform-specific instructions.

Advanced: Individual Files

For developers who want individual components

Web Interface

charset_web_gui.py

Analysis Engine

check_csv_charset.py

GUI Setup (Recommended)

Easy setup for the graphical interface

1. Install Python Dependencies

pip3 install chardet

2. Run Web Interface

python3 charset_web_gui.py

💡 Make sure both files are in the same folder, then double-click or run the command

🌐 Browser will open automatically with the interface

Command Line Setup

Setup for advanced users and automation

1. Install Dependencies

pip3 install chardet

2. Make Executable (Optional)

chmod +x check_csv_charset.py

Privacy & Security

Why download instead of upload?

100% Local Processing

Your CSV files never leave your computer

No Data Transmission

No uploads, downloads, or network requests

Open Source

Full transparency - review the code yourself

Usage Examples

Common ways to use the charset analysis tool

Basic Analysis

python3 check_csv_charset.py /path/to/your/csv/files

View All Options

python3 check_csv_charset.py --help

Advanced Examples:

# Convert files to UTF-8 with backup
python3 check_csv_charset.py data/ --convert-to utf-8
# Fast scan of large dataset
python3 check_csv_charset.py bigdata/ --fast -j 8 --summary-only
# Preview conversion without changes
python3 check_csv_charset.py files/ --convert-to utf-8 --dry-run

Features

🔍 Detection

  • • UTF-8, UTF-16, UTF-32
  • • ISO-8859-* variants
  • • Windows-125x encodings
  • • ASCII detection

🔄 Conversion

  • • Automatic backups
  • • Dry-run preview
  • • Rollback support
  • • Batch processing

⚡ Performance

  • • Parallel processing
  • • Progress tracking
  • • Smart sampling
  • • Fast mode option

⚠️ Important Security & Legal Information

🚨 Security Warnings for Executable Files

Antivirus & Security Software:

Your antivirus or security software may flag the launcher files (.bat, .command, .sh) as potentially dangerous because they are executable scripts. This is normal security behavior.

Platform-Specific Security Steps:

🍎 macOS:

  • Right-click the .command file → “Open” (don't double-click first time)
  • Click “Open” when prompted about unidentified developer
  • May need: System Preferences → Security & Privacy → Allow anyway
  • Terminal permissions may be required

🪟 Windows:

  • Windows Defender may block execution initially
  • Click “More info” → “Run anyway” if SmartScreen appears
  • Add to Windows Defender exclusions if needed
  • UAC prompt may appear - click “Yes” to allow

🐧 Linux:

  • Make executable: chmod +x run_charset_analyzer.sh
  • Run from terminal or double-click if file manager supports it
  • Some distributions may require manual execution permission

📋 Legal Disclaimer

NO WARRANTY OR LIABILITY:

  • This software is provided “AS IS” without warranty of any kind
  • No liability is accepted for any damage, data loss, or security issues
  • Use at your own risk and responsibility
  • Always backup your data before running any conversion operations
  • Test on sample data first before processing important files

SECURITY RESPONSIBILITY:

  • You are responsible for verifying the safety of downloaded files
  • Review the source code if you have security concerns
  • Configure your security software appropriately
  • Understand the risks of running executable scripts

✅ Why These Warnings Exist

These launcher files are legitimate scripts that automatically install dependencies and start the tool. Security software flags them because executable scripts can be misused by malicious software. Our launchers only install Python packages and run the charset analyzer - you can review the code yourself.

🔍 Alternative: Manual Installation

If you prefer not to use the launcher files, you can download the individual Python files and run them manually. This avoids all executable security warnings but requires manual dependency installation.