zapdl-beta

⚡️ ZapDL

A lightning-fast, multi-threaded downloader CLI tool

Installation • Usage • Features • Examples • Advanced Usage • Contributing • License

---

🚀 Installation

Install ZapDL globally using npm:

npm install -g zapdl

🎯 Usage

Basic usage:

zapdl <URL>

With options:

zapdl <URL> [options]

Options

Option	Description	Default
-o <filename>	Specify output filename	Detected from URL
-t <number>	Number of download threads	4
-r <number>	Number of retries for failed chunks	3
-c <number>	Number of simultaneous connections	2
--debug, -d	Enable debug mode (optional: true/false)	false

✨ Features

• 🚄 Multi-threaded downloads: Significantly faster than single-threaded downloaders
• 🔁 Auto-retry: Automatically retries failed chunks
• 🔌 Connection control: Manage the number of simultaneous connections
• 📊 Real-time progress: View download progress, speed, and ETA in real-time
• 🔍 Debug mode: Detailed logging for troubleshooting
• 📁 Auto filename detection: Automatically detects filename from URL or headers

💡 Examples

1. Basic download:

zapdl https://example.com/largefile.zip

1. Download with 8 threads and 4 connections:

zapdl https://example.com/largefile.zip -t 8 -c 4

1. Download with custom filename and debug mode:

zapdl https://example.com/video.mp4 -o myvideo.mp4 --debug

1. Download with all options specified:

zapdl https://example.com/largefile.zip -o myfile.zip -t 6 -c 6 -r 5 -d true

🔧 Advanced Usage

As a Node.js module

You can also use ZapDL programmatically in your Node.js projects:

const createDownloader = require('zapdl');

const downloader = createDownloader();
downloader.setDebug(true);

downloader.downloadFile(
  'https://example.com/largefile.zip',
  'output.zip',
  8,  // threads
  3,  // retries
  4   // connections
)
.then(() => console.log('Download complete!'))
.catch(err => console.error('Download failed:', err));

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check issues page.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📜 License

Distributed under the MIT License. See LICENSE for more information.

🙏 Acknowledgements

• Axios for HTTP requests
• Chalk for terminal styling