zapdl

<div align="center">
  <h1>⚡️ ZapDL</h1>
  <p><strong>A lightning-fast, multi-threaded downloader CLI tool</strong></p>
  <p>
    <a href="#installation">Installation</a> •
    <a href="#usage">Usage</a> •
    <a href="#features">Features</a> •
    <a href="#examples">Examples</a> •
    <a href="#advanced-usage">Advanced Usage</a> •
    <a href="#contributing">Contributing</a> •
    <a href="#license">License</a>
  </p>
</div>

<hr>

## 🚀 Installation

Install ZapDL globally using npm:

```bash
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

These changes update both the CLI interface and the README to use the new parameter format:

- `-o` for output filename
- `-t` for number of threads
- `-r` for number of retries
- `-c` for number of connections
- `--debug` or `-d` for debug mode, with an optional true/false value

The README has been updated to reflect these changes in the Options table and in the Examples section. This new format should provide a more standard CLI experience for users while maintaining all the functionality of the original version.