This article will show you how to install and pyLoad for first use. pyLoad can be used as a download manager for different video sites and one-click hosters.

You'll need to execute some commands via SSH to install and configure this software. There is a separate guide on how to connect to your slot via SSH. Commands are kept as simple as possible and in most cases will simply need to be copied and pasted into the terminal window (then executed by pressing the Enter key).

Table of contents


Install pyLoad by logging in via SSH, then copying and pasting the following:

wget -qO ~/pyload.deb $(curl -s | grep 'browser_' | cut -d\" -f4 | head -n 1)
dpkg -x ~/pyload.deb ~/pyLoad
rm ~/pyLoad/usr/bin/pyLoadCli ~/pyLoad/usr/share/pyload/
cp -r ~/pyLoad/usr/* ~/
wget -qO ~/
unzip ~/ && cd ~/pyload-stable
cp -r ~/pyload-stable/* ~/share/pyload/
cd && rm -rf ~/pyLoad* ~/pyload-stable/ ~/pyload.deb

Installation notes

pyLoad requires pycurl. If you do not have pycurl available (or do not know if you do), copy and paste the following:

pip install --user pycurl

If your binary directory (~/bin) is not in PATH you'll need to give the full path when trying to run the software in that directory. A better alternative is to add the bin directory to PATH.

The rest of the guide assumes you have done this and will simply use pyLoadCore to run the software, instead of ~/bin/pyLoadCore.

Configuring before starting pyLoad

pyLoad requires some configuration before we can properly start it up and begin to use it. Fortunately, it comes with a config wizard which does a lot of the legwork for us. Start that wizard by executing pyLoadCore --configdir=$HOME/.pyload -s.

Throughout the wizard you'll see certain options surrounded by [] - this simply means that they're the default option and pressing enter with no options supplied will select that default option. Here are the options you should select:

Choose your Language
Enter the code for your language, default is English
When you are ready for system check...
Press enter
...see your status report
Press enter
Continue with setup?
Press enter
Change config path?
Press enter
Make basic setup?
Press enter
Your desired username here
Password (and confirmation)
Your desired password
Enable remote access
Enter the code for your language, default is English
A path to downloads, e.g. ~/Downloads
Max parallel downloads
Press enter
Use Reconnect?
Press enter
Configure ssl?
Press enter
Configure webinterface?
Press enter
Activate webinterface?
Press enter
Press enter
Put a random port number between 10000 and 30000.
Press enter
Choose the template you want

At this point, you'll need to press enter to close pyLoad. Contrary to how the message may be interpreted, pyLoad will not be restarted automatically and must be done so manually. The next section covers this.

Starting, stopping and restarting

This section covers the pyLoad process - starting it, stopping it and restarting it. It also covers checking if the process is running, in case that becomes necessary.

screen -dmS pyLoad -- pyLoadCore --configdir=$HOME/.pyload
check running
pgrep -fu "$(whoami)" "bin/pyLoadCore"
kill "$(pgrep -fu "$(whoami)" "pyLoadCore")"
kill "$(pgrep -fu "$(whoami)" "pyLoadCore")" && sleep 3 && screen -dmS pyLoad -- pyLoadCore --configdir=$HOME/.pyload
kill (force stop)
kill -9 "$(pgrep -fu "$(whoami)" "pyLoadCore")"

The check running command will return a process number if pyLoad is running. If it doesn't return anything, pyLoad is not running.

Automatically restarting pyLoad if it is not running

Cron jobs can be used to check if pyLoad is running and start it up if it is not. There is a separate page on configuring cron jobs.

Using pyLoad

To connect to pyLoad, enter the following into your web browser (where server is the name of your server (e.g. themis) and port is replaced by the port number you entered in the configuration wizard):

If you don't recall what the port was, you can retrieve it with the following command:

grep -A 7 'webinterface' ~/.pyload/pyload.conf | grep "Port"


kill -9 "$(pgrep -fu "$(whoami)" "pyLoadCore")"
rm -rf ~/bin/pyLoadCore ~/share/pyload ~/.pyload