1. Stephan Thamm
  2. pyLoad




pyLoad is a free and open source personal cloud storage as well as download manager for all kind of operating systems and devices, designed to be extremly lightweight and runnable on personal pc or headless server.

You can easily manage your files, downloads, media content and access it from anywhere. All common video-sites, one-click-hoster, container formats and well known web standards are supported to download files for you. Additionaly it has a great variety of plugins to automate common tasks and make unattended running possible.

pyLoad has a full featured and well documented API, is easily extendable and accessible by external tools. It is written entirely in Python and currently under heavy development.

For news, downloads, wiki, forum and further information visit http://pyload.org/

To report bugs, suggest features, ask a question, get the developer version or help us out, visit http://bitbucket.org/spoob/pyload/

Documentation about extending pyLoad can be found at http://docs.pyload.org or join us at #pyload on irc.freenode.net


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


  • pycurl a.k.a python-curl
  • jinja2
  • beaker
  • thrift >= 0.8
  • simplejson (for python 2.5)

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): Used for several hoster, ClickNLoad
  • feedparser
  • BeautifulSoup
  • pyOpenSSL: For SSL connection

First start

Note: If you installed pyload via package-manager python pyLoadCore.py is probably equivalent to pyLoadCore


python pyLoadCore.py

and follow the instructions of the setup assistent.

For a list of options use:

python pyLoadCore.py -h


After finishing the setup assistent 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 http://pyload.org/configuration.

To restart the configure assistent run:

python pyLoadCore.py -s

Adding downloads

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

python pyLoadCli.py -l

for more options refer to:

python pyLoadCli.py -h

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


For more information, see http://pyload.org/