pysmartdl2

This software is a fork of the pySmartDL or Python Smart Download Manager by iTaybb which appears to not be maintained anymore. I (1) went through its codebase to check if things work as expected in modern (Python 3.8-12+) versions of Python, (2) did some modernizing fixes here and there, (3) fixed broken test suites, (4) implemented automated testing workflows, and (4) restructured the package to modern standards (e.g., pyproject.toml). I plan some feature additions, but original API will be retained, so that you can treat it as a drop-in replacement. Enjoy!

Test suites go over all popular Python versions (Python 3.8 - 3.13) on all four platforms enabled by GitHub Action Runners: Linux (Ubuntu), MacOS (Intel CPU), MacOS (M1 CPU), and Windows. Live status is shown below.

Per the original README, pysmartdl strives to be a full-fledged smart download manager for Python. Main features:

• Built-in download acceleration (with the multipart downloading technique).
• Mirrors support.
• Pause/Unpause feature.
• Speed limiting feature.
• Hash checking.
• Non-blocking, shows the progress bar, download speed and ETA.
• Full support for custom headers and methods.

Installation

You can install pysmartdl2 from PyPI through pip, with a simple:

pip install pysmartdl2

Or you can install from the source in editable mode, by cloning this repository and:

pip install -e .

Usage

Downloading with it is as simple as creating an instance and starting it:

from pysmartdl2 import SmartDL

url = "https://raw.githubusercontent.com/amkrajewski/pysmartdl2/master/test/7za920.zip"
dest = "."  # <-- To download to current directory 
            # or '~/Downloads/' for Downloads directory on Linux
            # or "C:\\Downloads\\" for Downloads directory on Windows

obj = SmartDL(url, dest)
obj.start()
# [*] 0.23 Mb / 0.37 Mb @ 88.00Kb/s [##########--------] [60%, 2s left]

path = obj.get_dest()

Copyright (C) 2023-2025 Adam M. Krajewski

Copyright (C) 2014-2020 Itay Brandes.