🚀 bwget - Better Wget

bwget is a minimalist yet powerful single-file downloader crafted in Python, designed to simplify and enhance your downloading experience. Inspired by the legendary GNU wget, bwget adds intuitive features, seamless torrent support, and sleek progress visuals all within a compact script.

---

🌟 Key Features

• 🌐 HTTP/HTTPS Downloads: Effortlessly download files with an elegant progress bar powered by Rich.
• 🔗 Torrent Support: Download .torrent files and magnet links with ease (single torrent at a time, no seeding).
• 📁 Automatic Filename Detection: Picks the perfect filename from URLs or server headers.
• ⏳ Resume Capability: Seamlessly continue interrupted downloads.
• 🔐 Secure Connections: Robust TLS verification, with an option to bypass (--no-check-certificate).
• 🛡️ SHA-256 Verification: Automatically verifies file integrity via SHA-256.
• 🔄 Automatic Retries: Smart retries with exponential backoff for robust downloads.
• 📃 Batch Downloads: Handle multiple downloads effortlessly from a list file (urls.txt).
• 🌀 Bandwidth Throttling: Limit download rates with --limit-rate or via configuration.
• 🌱 Torrent Controls: Restrict peer count with --max-seeds and configurable listen ports.
• 🛠️ Configurable: Customize behavior easily through a convenient TOML config file.

---

🛠️ Requirements

• Python 3.8+
• requests and rich packages
• libtorrent (optional, required for torrent and magnet downloads)
• tomli (Python <3.11) or built-in tomllib (Python ≥3.11)

Install the core dependencies:

pip install requests rich tomli

To enable torrent support you will also need libtorrent:

pip install libtorrent

---

⚙️ Installation

📂 From Source

Clone and install quickly:

git clone https://github.com/Sr-0w/bwget.git
cd bwget
chmod +x bwget.py
sudo mv bwget.py /usr/local/bin/bwget

Optionally, install the provided man page:

sudo install -Dm644 bwget.1 /usr/share/man/man1/bwget.1

📦 Packages

• Arch Linux (AUR): bwget

yay -S bwget
or
paru -S bwget

• Fedora (COPR): bwget

dnf copr enable srobin/bwget
dnf install bwget

Install from AUR manually:

git clone https://aur.archlinux.org/bwget.git
cd bwget
makepkg -si

---

📌 Usage Examples

Simple file download:

bwget https://example.com/file.tar.gz

Download torrent or magnet link:

bwget https://example.com/file.torrent
bwget "magnet:?xt=urn:btih:..."

Force new download (ignore resume):

bwget -c https://example.com/large.iso

SHA-256 verification:

bwget --sha256 0123456789abcdef... https://example.com/app.tar.gz

Using an HTTP proxy:

bwget --proxy http://proxy.local:3128 https://example.com/data.zip

Limit download rate:

bwget --limit-rate 500 https://example.com/large.iso

Limit torrent peers:

bwget --max-seeds 20 https://example.com/file.torrent

Disable TLS verification:

bwget --no-check-certificate https://example.com/file.tar.gz

Batch download:

bwget -i urls.txt

Custom user-agent:

bwget -U "MyDownloader/1.0" https://example.com/file.zip

Check version:

bwget --version

🗒️ Command-Line Options

Option	Description
-o, --output FILE	Save the download to FILE instead of the remote filename
-c, --cancel-resume	Disable resume and start the download from scratch
-q, --quiet	Suppress non-error output
--limit-rate KBPS	Limit download bandwidth in KiB/s
-i, --input FILE	Read URLs from FILE (one per line)
--sha256 DIGEST	Verify download against the given SHA-256 digest
--proxy PROXY_URL	Use the specified HTTP/HTTPS proxy
--max-seeds N	Limit active torrent peers
-U, --user-agent UA	Override the User-Agent header
--no-check-certificate	Disable TLS certificate verification (insecure)
--version	Display version information and exit

---

🔧 Configuration

On first launch, bwget creates a default configuration at:

~/.config/bwget/config.toml

Customize settings like proxies, retries, timeouts, chunk sizes, default resume behavior and torrent options directly:

[network]
# proxy = "http://user:pass@yourproxy.example.com:8080"
user_agent = "bwget/0.4.0 (Python/3.x)"
max_retries = 3
base_backoff = 1.0
request_timeout = 15
stream_timeout = 30
# verify TLS certificates (set to false to disable verification)
verify_tls = true

[download]
chunk_size_kb = 256
hash_chunk_size_mb = 1
resume_default = true
bandwidth_limit_kbps = 0

[torrent]
listen_interfaces = "0.0.0.0:6881-6891"
max_seeds = 0

---

🤝 Contributing

Your contributions are welcome! Feel free to open issues, request features, or submit pull requests to help improve bwget.

---

🙋 Author

Crafted with care by Robin Snyders (robin@snyders.xyz)

---

📝 License

This project is licensed under the MIT License.