wgetx

A modern CLI tool for downloading files with customizable progress bars and advanced features.

Features

• Fast Downloads: Efficient file downloading with resume capability
• Progress Visualization: Customizable progress bars with colors and icons
• Batch Downloads: Download multiple files from a URL list
• Resume Support: Continue interrupted downloads
• Flexible Output: Control verbosity and output formatting
• Cross-Platform: Works on Windows, macOS, and Linux

Installation

pip install wgetx

Usage

Basic Download

wgetx https://example.com/file.zip

Download to Specific Directory

wgetx https://example.com/file.zip /path/to/save/

Resume Interrupted Download

wgetx --resume https://example.com/large-file.zip

Batch Download from File

wgetx --batch urls.txt

Force Overwrite Existing Files

wgetx --force https://example.com/file.zip

Command Line Options

Basic Options

• URL - URL to download or path to file containing URLs (with --batch)
• DESTINATION - Destination path (file or directory)

Behavior Options

• -f, --force - Overwrite existing files
• -c, --resume - Resume interrupted downloads

Output Options

• -e, --echo - Print file path to stdout after download
• -q, --quiet - Suppress progress information
• -b, --batch - Download multiple URLs from a file

UI Customization

• --done - Icon for completed progress (default: ▓)
• --left - Icon for remaining progress (default: ░)
• --current - Icon for current progress position (default: ▓)
• --border - Border characters for progress bar (default: |)

Color Options

• --color-done - Color for completed progress icon
• --color-left - Color for remaining progress icon
• --color-current - Color for current progress icon

Examples

Custom Progress Bar

wgetx --done "█" --left "─" --current ">" --border "[]" https://example.com/file.zip

Colored Progress Bar

wgetx --color-done green --color-current yellow --color-left red https://example.com/file.zip

Quiet Download with Echo

wgetx --quiet --echo https://example.com/file.zip

Batch Download

Create a file urls.txt with URLs:

https://example.com/file1.zip
https://example.com/file2.tar.gz
https://example.com/file3.pdf

Then run:

wgetx --batch urls.txt

Supported Colors

You can use the following color names:

• black, red, green, yellow
• blue, magenta, cyan, white
• Custom ANSI escape sequences

License

This project is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later).

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

If you encounter any issues or have questions, please open an issue in the project repository.