---
title: pyLoad
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, downloads, python, jdownloader, hosters, free, premium]
confidence: medium
contested: false
sources: [https://selfh.st/apps/?tag=downloads, https://github.com/pyload/pyload]
---

# pyLoad

> **Download manager historique en Python** : alternative libre et légère à JDownloader, avec support des **hébergeurs de fichiers** (Rapidgator, Uploaded, 1fichier, etc.) et des **liens premium**. Cible les utilisateurs NAS et serveurs headless.

| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | https://pyload.net/ |
| **GitHub** | https://github.com/pyload/pyload |
| **License** | GPL-3.0 |
| **Langage** | Python 3 |
| **Étoiles GitHub** | 747 ⭐ |
| **Dernière MAJ** | 2026-03 |
| **Catégorie** | [[cat-downloads]] |

## Description

pyLoad est un **gestionnaire de téléchargements** écrit en Python qui se distingue par son support des **hébergeurs de fichiers** (cyberlockers) : 1fichier, Uptobox, Rapidgator, Uploaded, Turbobit, etc. Là où un gestionnaire classique type [[app-jdownloader]] (qui est en Java) demande d'installer une JVM, pyLoad est un **daemon Python** léger idéal pour les **NAS Synology/QNAP**, Raspberry Pi, ou serveurs headless.

Le projet existe depuis 2008 (à l'origine par la team pyLoad) et a été repris par la communauté. Il propose une **WebUI** accessible à distance, une **API JSON** pour l'intégration, un système de **plugins** (chacun gérant un hébergeur), un **extracteur d'archives automatique** (dézippage, dépaquetage, vérification des checksum) et un **link checker** pour tester la validité des liens avant téléchargement.

pyLoad est un projet **mature mais à maintenance ralentie** : il fonctionne, les plugins sont à jour pour la plupart des hébergeurs populaires, mais le rythme de release est plus lent que des concurrents plus modernes comme [[app-metube]] ou [[app-cobalt]]. Il reste néanmoins une **référence** pour qui veut automatiser des téléchargements depuis des hébergeurs, en mode **free** (avec captchas et temps d'attente) ou **premium** (avec compte payant).

## Installation

### Option 1 : Docker Compose (recommandé)

```yaml
services:
  pyload:
    image: writl/pyload:latest
    container_name: pyload
    restart: unless-stopped
    ports:
      - "8000:8000"   # WebUI
      - "7227:7227"   # CLI / API
      - "9666:9666"   # interface alternative
    environment:
      - UID=1000
      - GID=1000
      - TZ=Europe/Paris
    volumes:
      - ./config:/config
      - ./downloads:/downloads
```

UI sur `http://localhost:8000`. Compte par défaut : `pyload` / `pyload`.

### Option 2 : Installation manuelle (NAS / Raspberry)

```bash
git clone https://github.com/pyload/pyload
cd pyload
pip install -r requirements.txt
python -m pyload.core
```

## Configuration

1. **Comptes premium** : *Addons → Accounts* → ajouter les identifiants Rapidgator/Uptobox/1fichier/etc. pour bénéficier des vitesses maximales.
2. **Plugins** : *Addons → Plugin Manager* → activer les hébergeurs cibles (plugins officiels + communautaires via `pyloadng`).
3. **Dossier de destination** : *Settings → Storage* → configurer le dossier par défaut, activer l'extraction automatique d'archives.
4. **Click'N'Load** : *Settings → Webserver* → activer la JDLN port 9666 pour le « click and load » depuis le navigateur (équivalent JDownloader).
5. **Planificateur** : *Settings → Scheduler* → programmer des téléchargements nocturnes.
6. **API** : token à générer pour les scripts externes (curl, [[app-sonarr]] n'est pas concerné, mais des outils de curation oui).

## Alternatives

### Open Source
- [[app-jdownloader]] — Concurrent Java, GUI desktop plus complète mais plus lourd
- [[app-metube]] / [[app-cobalt]] — Orientés vidéo (yt-dlp), pas d'hébergeurs
- **aria2** — Download accelerator CLI pur, pas d'UI, à scripter
- **pyget** / **pynzb** — Outils Python pour NZB (Usenet)
- **Internet Archive** — Bibliothèque publique libre de droits, alternative pour contenu légal

### Propriétaires
- **JDownloader** (officiel) — L'original, en Java, fermé bien que gratuit
- **FreeRapid** — Ancien clone Java, abandonné
- **Premium link generators (PLG)** — Sites tiers, peu fiables

## Sécurité

- pyLoad n'a pas d'authentification forte par défaut : **changer le mot de passe admin** (par défaut `pyload`)
- Protéger la WebUI derrière un reverse proxy authentifié ([[app-authelia]])
- ⚠️ Le téléchargement de contenu protégé par le droit d'auteur est **illégal** dans la plupart des juridictions
- Les plugins tiers peuvent exécuter du code arbitraire : ne charger que des plugins de confiance (officiels ou repo pyloadng)
- Les **comptes premium** doivent être stockés de manière sécurisée (ne pas commiter le `config/`)
- pyLoad est en maintenance ralentie : surveiller les CVE et mettre à jour régulièrement

## Ressources

- Site officiel : https://pyload.net/
- Code source : https://github.com/pyload/pyload
- Documentation : https://github.com/pyload/pyload/wiki
- Forum : https://forum.pyload.net/
- Liste des plugins : https://github.com/pyload/pyload/tree/main/src/pyload/core/plugins

## Pages Liées
- [[cat-downloads]] — Vue d'ensemble de la catégorie Downloads
- [[app-jdownloader]] — Concurrent principal
- [[app-metube]] — Spécialisé vidéo
- [[app-authelia]] — SSO pour restreindre l'accès
- [[recettes-docker-compose]] — Templates Docker