Free and Open Source download manager written in Pure Python and designed to be extremely lightweight, fully customizable and remotely manageable
Clone or download
Latest commit e471367 Oct 20, 2018


pyLoad wiki support Join the chat IRC Freenode Twitter Facebook

pyLoad is a free and open source downloader for 1-click-hosting sites. It supports link decryption as well as all important container formats. Targeted for headless NASs it is designed to be extremely lightweight, fully customizable and remotely manageable via web interface.


You need at least Python 2.5 to run pyLoad and all of these required libraries. They should be automatically installed when using pip install. The prebuilt pyLoad packages also install these dependencies or have them included, so manual install is only needed when installing pyLoad from source.


  • pycurl a.k.a python-curl
  • jinja2
  • beaker
  • thrift

Some plugins require additional packages, only install these when needed.


  • pycrypto: RSDF/CCF/DLC support
  • tesseract, python-pil a.k.a python-imaging: Automatic captcha recognition for a small amount of plugins
  • jsengine (spidermonkey, ossp-js, pyv8, rhino, js2py): Used for several hoster, ClickNLoad
  • feedparser
  • BeautifulSoup
  • pyOpenSSL: For SSL connection

First start

Note: If you installed pyLoad via package-manager python is probably equivalent to pyLoadCore



and follow the instructions of the setup assistant.

For a list of options use:

python -h


After finishing the setup assistant pyLoad is ready to use and more configuration can be done via webinterface. Additionally you could simply edit the config files located in your pyLoad home dir (defaults to: ~/.pyload) with your favorite editor and edit the appropriate options. For a short description of the options take a look at

To restart the configure assistant run:

python -s

Adding downloads

To start the CLI and connect to a local server, run:

python -l

for more options refer to:

python -h

The webinterface can be accessed when pointing your web browser to the ip and configured port, defaults to http://localhost:8000


For more information, see