A professional tool for automatically extracting all text files from your projects and converting them into a unified report. Perfect for sending code to ChatGPT, Claude, and other LLMs, documenting entire projects, and automatic code backups.
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ CODE DUMP - DUAL MODE ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
| Feature | Description |
|---|---|
| ✅ Multi-Project Support | Process several projects simultaneously |
| ✅ JSON Configuration | Advanced settings with validation |
| ✅ Headless Mode | Automatic execution without user input |
| ✅ Auto Backup | Timestamped backups with retention policy |
| ✅ 20+ File Formats | Support for all major code file types |
| ✅ Filter System | Exclude directories, files, and patterns |
| ✅ Markdown Output | Standard format with syntax highlighting |
| ✅ Cross-Platform | Linux, macOS, and Windows (WSL) |
# Clone the repository
git clone https://github.com/esmaeil-ahmadipour/text-extractor.git
cd text-extractor
# Make scripts executable
chmod +x bin.sh code_dump.py
# Install jq (required for config validation)
# Ubuntu/Debian: sudo apt install jq
# macOS: brew install jq
# Run the tool
./bin.sh# Mode 1: Process ./code or ./CODE folder (simple)
./bin.sh
# Then select option 1
# Mode 2: Process projects from settings.json (advanced)
./bin.sh
# Then select option 2| Category | Extensions |
|---|---|
| Mobile | .dart, .java, .kt, .swift |
| Web | .js, .ts, .jsx, .tsx, .html, .css |
| Backend | .py, .sh, .bat, .ps1 |
| Data | .json, .yaml, .yml, .xml |
| Docs | .md, .txt, .rst |
| Mode | Input | Config Required | Backup | Output |
|---|---|---|---|---|
| Mode 1 | ./code or ./CODE folder |
No | No | code_report.txt |
| Mode 2 | settings.json projects |
Yes (with jq) |
Yes | code_report_{name}.txt |
text-extractor/
├── bin.sh # Main script (dual mode)
├── code_dump.py # Python engine
├── settings.json # Configuration (required for Mode 2)
├── code/ # Mode 1 input folder (or CODE/Code)
├── code_report.txt # Mode 1 output
├── code_report_Sample.txt # Mode 2 output for Sample project
├── code_report_Resume.txt # Mode 2 output for Resume project
└── backup/ # Automatic backups (Mode 2 only)
├── Sample_2026-05-20_22-06-17.txt
└── Resume_2026-05-20_22-06-18.txt
| Requirement | Minimum | Recommended |
|---|---|---|
| OS | Linux/macOS/WSL | Ubuntu 20.04+ |
| Python | 3.8+ | 3.10+ |
| Bash | 4.0+ | 5.0+ |
| jq | Required (Mode 2) | 1.6+ |
| RAM | 256 MB | 512 MB |
| Disk | 50 MB | 100 MB |
📦 Generated by CodeDump
🔗 GitHub: https://github.com/esmaeil-ahmadipour/CodeDump
⭐ Star this repo if it helped you!
# PROJECT: Sample
# PATH: /home/user/projects/sample
# Generated: 2026-05-20 22:06:17.053321
#----------------------------------------------------------------------
---
/_
FILE: src/main.js
SIZE: 2.5 KB
_/
console.log("Hello World");Mode 2 automatically validates your settings.json:
- ✓ Valid JSON syntax
- ✓ Required
projectsarray exists - ✓ At least one enabled project
- ✓ Project paths exist (warns if missing)
Speed: ~1000 files/second (depends on file size)
Memory: ~50 MB for 10,000 files
Concurrency: Sequential processing (configurable)
No external API calls
Local processing only
No data collection
Open source auditability
Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Open a Pull Request
MIT License - Free for any use
Esmaeil Ahmadipour
Email: software686@gmail.com
GitHub: @esmaeil-ahmadipour
LinkedIn: esmaeil-ahmadipour
Portfolio: https://ea2.ir Website: https://tarvix.org
If this tool helps you, please give it a star on GitHub!