Skip to main content

A simple downloader written in Python with an awesome progressbar.

Project description


A simple downloader written in Python with an awesome progressbar.

Installation   |   Requirements   |   Usage   |   Use It   |   Other examples   

forthebadge made-with-python

License PyPI AUR PRs Welcome


The package is available in PyPi here

Install it using

pip install downloader-cli

If you want to manuall install, clone the repo and run the following command

sudo python install

The packages available in PyPi and AUR contain the last release, if you want all the latest changes, clone the repo and install manually or wait for the next release.


downloader-cli requires just one external module.


The script also allows some other values from the commandline.

usage: dw [-h] [-f | -c] [-e] [-q] SOURCE [TARGET]

positional arguments:
  SOURCE           URL of the file
  TARGET           target filepath (existing directories will be treated as
                   the target location)

optional arguments:
  -h, --help       show this help message and exit
  -f, -o, --force  overwrite if the file already exists
  -c, --resume     resume failed or cancelled download (partial sanity check)
  -e, --echo       print the filepath to stdout after downloading (other
                   output will be redirected to stderr)
  -q, --quiet      suppress filesize and progress info

Use It

Want to use it in your project?

Import the Download class using the following.

from import Download

Above is the simplest way to use it in your app. The other arguments are optional.


The module takes 8 arguments. Only one is required though.

Name required default
des No None (Current directory is selected and the name is extracted from the URL)
overwrite No False
continue_download No False
echo No False
quiet No False
icon_done No
icon_left No

NOTE For details regarding the arguments, check Usage

NOTE In case the file size is not available, the bar is shown as indefinite, in which case the icon_left by default space(" ").

Other examples

In case you want to experiment with the progress bar's icons, here's some examples.

  • This is when I passed icon_done as # and icon_left as space.

  • In case a file's size is not available from the server, the progressbar is indefinite.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for downloader-cli, version 0.1.0.post2
Filename, size File type Python version Upload date Hashes
Filename, size downloader_cli-0.1.0.post2-py3-none-any.whl (7.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size downloader_cli-0.1.0.post2.tar.gz (6.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page