Merge multiple CSV files into one mega CSV. Simple, fast, offline.

• 🎯 Drag & Drop - Interactive interface (Windows)
• Batch Processing - Merge 100+ files at once
• Smart Headers - Automatically keeps one header, skips duplicates
• Recursive Mode - Find CSVs in subfolders
• Organized Output - Timestamped folders in merge_vault/
• Cross-Platform - Windows, Linux, macOS
• No Dependencies - Just Python 3.x standard library
• No Size Limits - Handles huge files

# 1. Double-click to launch
CSV Merger.bat

# 2. Type or paste folder path - done!

chmod +x convert.sh
./convert.sh /path/to/csvs

# Merge entire folder
python3 csv_merger.py -d ./data -o merged.csv -v

# Merge specific files
python3 csv_merger.py file1.csv file2.csv file3.csv -o merged.csv -v

# Recursive merge (include subfolders)
python3 csv_merger.py -d ./data -o merged.csv --recursive -v

All outputs saved to timestamped folders:

CSV-Merger/
└── merge_vault/
    ├── 20241107_093015/
    │   └── MERGED_ALL.csv
    ├── 20241107_143022/
    │   └── MERGED_ALL.csv
    └── 20241107_201545/
        └── MERGED_ALL.csv

# Before: 50 CSV files scattered everywhere
# After: One clean CSV with all data combined

python3 csv_merger.py -d ~/data/csvs -o mega.csv -v
# Output: merge_vault/20241107_1430/MERGED_ALL.csv

1. Scans folder for .csv files
2. Reads header from first CSV
3. Writes that header to output file
4. Iterates through all files, skipping their headers
5. Appends all data rows to output
6. Skips empty rows and handles errors gracefully

✅ Combine monthly/weekly CSV reports ✅ Merge data exports from multiple sources ✅ Consolidate database dumps ✅ Aggregate Excel exports ✅ Combine WiGLE/Kismet wardriving data ✅ Merge sensor/IoT data logs ✅ Any CSV files!

No installation needed! Just requires Python 3.x:

Windows: Download Python Linux: sudo apt install python3 (Ubuntu/Debian) Mac: brew install python3

• START_HERE.txt - Quick start guide with ASCII art
• HOW_TO_USE.txt - Visual guide for Windows
• QUICKSTART.md - Platform-specific instructions
• README.md - This file

python3 csv_merger.py --help

Options:
  -d, --directory     Directory containing CSV files
  -o, --output        Output merged CSV file (required)
  -v, --verbose       Show detailed progress
  --recursive         Include CSVs in subfolders

• Python 3.6 or higher
• No external dependencies (uses standard library only)

MIT - See LICENSE

Made with ❤️ by ringmast4r