🗜️ ZIP Extractor Tool

A powerful, user-friendly command-line tool to extract multiple ZIP files from a source directory to multiple destination directories simultaneously.

✨ Features

🚀 Batch Extraction - Extract all ZIP files from a directory at once
🎯 Multiple Destinations - Extract to multiple locations simultaneously
📁 Auto Directory Creation - Creates destination folders if they don't exist
🛡️ Error Handling - Gracefully handles corrupted or invalid ZIP files
📊 Progress Tracking - Shows detailed progress and file information
🎨 User-Friendly Interface - Clear messages and helpful guidance
💾 Preserve Structure - Maintains folder structure within ZIP files
📈 File Size Display - Shows ZIP file sizes in human-readable format

🚀 Quick Start

Download & Run (Easiest)

Download the executable from the Releases page
Run the executable:
- Windows: Double-click zip_extractor.exe or run from Command Prompt
- Linux/macOS: Run ./zip_extractor in terminal

Command Line Usage

# Run the tool
./extractor


# Show help
./extractor --help

📖 How to Use

Step-by-Step Guide

Start the tool by running the executable

Enter source path - The folder containing your ZIP files

Enter source folder path for ZIP files: C:\Downloads\ZipFiles

Add destinations - Enter one or more destination folders

Enter destination folder path: C:\Extracted
Enter another destination path (or press Enter to continue): D:\Backup\Extracted
Enter another destination path (or press Enter to continue): [Press Enter]

Watch the magic happen - The tool will extract all ZIP files to all destinations

Example Workflow

🗜️  Welcome to ZIP Extractor Tool!
========================================

Enter source folder path for ZIP files: /home/user/downloads
✅ Source folder found: /home/user/downloads

📂 Setting up destination folders:
Enter destination folder path: /home/user/extracted
✅ Destination added: /home/user/extracted
Enter another destination path (or press Enter to continue): /backup/extracted
✅ Destination added: /backup/extracted
Enter another destination path (or press Enter to continue): 

🔍 Searching for ZIP files in /home/user/downloads...
✅ Found 3 ZIP file(s):
  📦 project1.zip (2.5 MB)
  📦 documents.zip (1.2 MB)
  📦 photos.zip (15.3 MB)

🚀 Starting extraction process...

📦 Processing: project1.zip
  📄 Archive contains 25 file(s)
  ✅ Extracted 25 file(s) to: /home/user/extracted/project1
  ✅ Extracted 25 file(s) to: /backup/extracted/project1

🎉 EXTRACTION COMPLETE!

💻 System Requirements

Operating System: Windows 10+, Linux, or macOS
Memory: 100MB RAM minimum
Storage: 50MB free space for the tool
Permissions: Read access to source directory, write access to destination directories

🛠️ Installation Options

Option 1: Download Executable (Recommended)

Download from Releases page
No installation required - just run!

Option 2: Build from Source

If you have Dart SDK installed:

# Clone the repository
git clone https://github.com/Qharny/zip_extractor.git
cd zip-extractor-tool

# Install dependencies
dart pub get

# Build executable
dart compile exe main.dart -o zip_extractor.exe

🛠️ Developer Note: Modular Structure

The codebase is now modularized! Core logic is split into components in lib/components/.
The main entry point for CLI is now main.dart (not extractor.dart).
To run from source, use:
```
dart run main.dart
```
For building executables, workflows and scripts now compile main.dart.

📚 Help & Documentation

Command Line Options

Option	Description
`--help`, `-h`	Show detailed help information

Getting Help

./extractor --help

This will show:

Detailed usage instructions
Feature explanations
Examples and tips
Troubleshooting guidance

🔧 Troubleshooting

Common Issues

"Source folder does not exist"

✅ Check the path is correct
✅ Use absolute paths (full path from root)
✅ Ensure you have read permissions

"No ZIP files found"

✅ Verify ZIP files have .zip extension
✅ Check files aren't corrupted
✅ Ensure ZIP files are directly in the source folder

"Permission denied"

✅ Run as administrator (Windows) or with sudo (Linux/macOS)
✅ Check destination folder permissions
✅ Ensure antivirus isn't blocking the tool

"Extraction failed"

✅ ZIP file might be corrupted
✅ Check available disk space
✅ Verify destination path is valid

Performance Tips

Large ZIP files: Be patient, large archives take time
Many destinations: Each destination doubles processing time
Network drives: Local drives are faster than network locations
Antivirus: Add tool to antivirus exclusions for better performance

🌟 Use Cases

Personal Use

📁 Organizing downloaded ZIP files
🎮 Extracting game files to multiple locations
📸 Processing photo archives
📚 Managing document collections

Professional Use

🏢 IT deployments to multiple servers
📊 Data processing workflows
🔄 Backup and archival processes
👥 Team file distribution

Development

📦 Package distribution
🛠️ Build artifact extraction
🔧 Environment setup automation
📋 Project template deployment

🤝 Contributing

We welcome contributions! Here's how you can help:

Report Bugs - Open an issue with details
Suggest Features - Share your ideas
Submit Pull Requests - Help improve the code
Improve Documentation - Help others understand better

Development Setup

# Clone the repository
git clone https://github.com/Qharny/zip_extractor.git
cd zip-extractor-tool

# Install Dart SDK (if not already installed)
# Visit: https://dart.dev/get-dart

# Install dependencies
dart pub get

# Run the tool
dart run main.dart

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Built with Dart programming language
Uses the archive package for ZIP handling
Inspired by the need for efficient batch ZIP extraction

📞 Support

🐛 Bug Reports: Open an issue
💡 Feature Requests: Open an issue
📧 Email: kabuteymanasseh5@gmail.com
💬 Discussions: GitHub Discussions

🚀 What's Next?

Planned features for future versions:

🎨 GUI version
🔐 Password-protected ZIP support
📊 Extraction statistics export
🔄 Watch folder mode
🎯 Selective file extraction
📱 Mobile companion app

Made with ❤️ for the community

⭐ Star this repository if you find it helpful! ⭐

Download Latest Release | Report Issue | Request Feature

rsenthilkumar6/zip_extractor