pyLoad

Lightweight Python download manager with web interface

pyLoad is a free, open-source download manager written in Python, designed to be extremely lightweight and easily extensible. It supports downloading from one-click hosters, container formats (DLC, CCF, RSDF), and video sites through its plugin system—all fully manageable via a modern web interface.

Python-Based

Runs in an isolated Python 3.9 virtual environment for stability

Web Interface

Modern PyPlex theme with full download management via browser

Plugin System

Extensible architecture supporting 100+ hosting sites

SSL Support

Auto-generated SSL certificates for secure connections

Default Password

After installation, the default password is pyload. The username is automatically set to your QuickBox username. Change your password immediately via the web interface settings.

Installation

Install from the Dashboard

Open App Dashboard → Package Management (/dashboard?mode=packages), find pyLoad in the catalog (browse Download Clients or search), and click Install. The dashboard sets up the isolated Python virtual environment automatically, streams the install log live, and pyLoad appears in your Application Control panel when it finishes. Reinstall, Update, and Remove are available from the same panel.

What you see and can manage is gated by your account: admins manage any user’s apps; regular users manage their own. For the full package flow see App Management.

Install from the CLI (automation)

The CLI runs the same install and is suited to automation and scripting:


qb install pyload -u username

Command	Description
`qb install pyload -u username`	Install pyLoad for the specified user
`qb reinstall pyload -u username`	Reinstall while preserving configuration
`qb remove pyload -u username`	Remove pyLoad and clean up files
`qb update pyload -u username`	Update pyLoad to the latest version

CLI Options

-u, --usernameRequired

Target QuickBox username for install/remove/update operations

Directory Layout

/opt/username/pyLoad

.venv/# Python 3.9 virtual environment

.venv/bin/pyload# pyLoad executable

/home/username/.config/pyLoad

user/settings/pyload.cfg# Main configuration file

user/data/pyload.db# User database (accounts, settings)

user/data/ssl.key# SSL private key (symlink)

user/data/ssl.crt# SSL certificate (symlink)

downloads/# Default download directory

tmp/# Temporary files during download

Network & Access

pyLoad runs on an auto-assigned port (default 8001) and is accessible through the nginx reverse proxy:


https://yourserver.com/username/pyload/

Default credentials:

Username: Your QuickBox username
Password: pyload (change immediately after first login)

Security Notice

The default password is pyload for all installations. Change it immediately via Settings → User Manager in the web interface.

Services

pyLoad uses a templated systemd unit (pyload@.service) running as a forking daemon:


# Check status
systemctl status pyload@username
 
# View logs
journalctl -u pyload@username -f
 
# Restart service
systemctl restart pyload@username

Best Practices

Do

Change the default password immediately after installation.
Use the PyPlex theme (default) for the best user experience.
Configure account credentials for premium hosting sites in Settings.
Use qb update pyload to keep pyLoad updated.

Don't

Do not leave the default password unchanged.
Do not manually edit systemd or nginx files—use qb commands.
Do not modify files in the virtual environment directly.

Additional Resources

Resources

pyLoad GitHub Repository

pyLoad Documentation

Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

Dedicated Support

Feature Previews

Community Configs

Active Discussions

Join Discord Server