TurboDL

🚀 Overview

TurboDL is an extremely smart, fast, and efficient download manager designed to optimize your downloading experience.

✨ Key Features

• Smart Connection Management: Dynamically calculates the optimal number of connections based on file size and network speed
• Intelligent Acceleration: Built-in sophisticated download acceleration techniques that split downloads into multiple parallel streams
• Automatic Retry System: Efficiently retries failed requests with exponential backoff strategy
• Pre-Download Intelligence: Automatically detects file information, size, and type before download begins
• Seamless Redirection: Handles HTTP redirects automatically for successful downloads
• Memory Optimization: Intelligently uses RAM buffering to reduce disk I/O overhead
• Data Integrity: Supports post-download hash verification (MD5, SHA256, etc.)
• Real-time Feedback: Provides an elegant, accurate progress bar with detailed statistics
• Cross-platform Compatibility: Works consistently across all major operating systems

Additional Built-in Features

• YouTube Support: Download YouTube videos in the highest available quality and automatically merge audio and video streams using StreamSnapper library

📦 Installation

# Install the stable version of TurboDL from PyPI
pip install --upgrade turbodl

# Install the beta version of TurboDL from GitHub
pip install --upgrade git+https://github.com/henrique-coder/turbodl.git@main

# Install the development version of TurboDL from GitHub
pip install --upgrade git+https://github.com/henrique-coder/turbodl.git@dev

🔍 Examples

Basic Usage

from turbodl import TurboDL

turbodl = TurboDL()
turbodl.download(
    url="https://example.com/file.txt",  # Your download URL
    output_path="path/to/file"  # The file/path to save the downloaded file
)

# Access the absolute path to the downloaded file
print(turbodl.output_path)

Advanced Usage

from turbodl import TurboDL

turbodl = TurboDL(
    max_connections="auto",
    connection_speed_mbps=100,
    show_progress_bar=True,
)
turbodl.download(
    url="https://example.com/file.txt",
    output_path="path/to/file",
    pre_allocate_space=False,
    use_ram_buffer="auto",
    overwrite=True,
    headers=None,
    inactivity_timeout=120,
    timeout=None,
    expected_hash=None,
    hash_type="md5",
)

# Access the absolute path to the downloaded file
print(turbodl.output_path)

Command Line Interface

# Show help for all commands
turbodl --help

# Show help for the download command
turbodl download --help

# Download a file
turbodl download [...] https://example.com/file.txt path/to/file

📊 CLI Demo

📋 Parameters

TurboDL Class Parameters

Download Method Parameters

🛠️ Development

# [!] Make sure you have git, make and uv installed

# Clone the repository
git clone https://github.com/henrique-coder/turbodl.git

# Enter the project directory
cd turbodl

# Install project dependencies (using uv)
make install

# Lint and format code
make lint
make format

# Run tests
make tests

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

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

👥 Contributors

📄 License

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

📊 Project Status

TurboDL is in active development. Check the releases page for the latest updates.

🌟 Star the Project

If you find this project useful, please consider giving it a star on GitHub.